安装教程 - Codex

Codex 是 OpenAI 出品的命令行 AI 编程助手，通过终端使用。本文介绍如何完成安装。

前置条件：安装 Node.js

Codex 同样依赖 Node.js 运行环境。

检查方法： 打开终端，输入：

txt

node -v

如果显示版本号（如 v20.x.x），说明已安装，跳过这一步。
如果提示"命令不存在"，请先去 https://nodejs.org 下载安装 LTS 版本。

⚠️ Node.js 版本要求 18 及以上。

Node.js 准备好之后，打开终端，输入以下命令并回车：

txt

npm install -g @openai/codex

等待安装完成（需要联网，视网速可能需要 1 ~ 3 分钟）。

Mac 用户提示： 如果提示权限不足，在命令前加 sudo：

txt

sudo npm install -g @openai/codex

Windows 用户提示： 如果提示权限不足，请右键点击「命令提示符」或「PowerShell」，选择「以管理员身份运行」后再执行。

安装完成后，输入以下命令检查是否成功：

txt

codex --version

显示版本号即代表安装成功。

在任意项目文件夹下，打开终端输入：

txt

codex

首次启动会引导你完成配置，按提示操作即可。

💡 如果你使用的是中转站而非官方账号，首次启动后需要配置 API Key 和地址，详见：
快速开始-ccswitch（推荐）
手动配置-Codex