第 18 卷

或者直接运行：

codex

方式二：使用 Homebrew 安装

Mac 用户也可以用 Homebrew：

brew install --cask codex

安装后运行：

codex

小白建议：

已经装过 Node.js，就用 npm。

已经习惯 Homebrew，就用 brew。

Windows 安装

Windows 用户建议使用 PowerShell 或 Windows Terminal。

第一步，安装 Node.js。

安装完成后，打开 PowerShell，输入：

node -v

npm -v

能看到版本号，说明安装成功。

第二步，安装 Codex CLI：

npm install -g @openai/codex

第三步，检查是否安装成功：

codex --version

或者直接运行：

Windows 用户第一次使用时，建议不要在系统目录里运行 Codex。

不要在这些位置直接操作：

C:\

系统目录

桌面

下载文件夹

重要资料文件夹

建议新建一个练习目录：

D:\AI-Codex-Projects\hello-codex

第一次运行

安装完成后，在终端输入：

codex

第一次运行时，Codex 会提示你登录。

Codex CLI 常见有两种登录方式：

1. 使用 ChatGPT 账号登录
2. 使用 OpenAI API Key 登录

新手优先推荐第一种：ChatGPT 账号登录。

方式一：使用 ChatGPT 账号登录

这是最适合普通用户和小白的方式。

在终端输入：

codex

或者：

codex login

登录流程大概是：

1. 终端输入 codex 或 codex login
2. 选择 Sign in with ChatGPT
3. 浏览器会自动打开登录页面
4. 输入你的 ChatGPT 账号
5. 登录成功后，浏览器会把登录结果传回终端
6. 回到终端，Codex CLI 就可以使用了

方式二：使用 API Key 登录

Codex CLI 也支持使用 OpenAI API Key 登录。

API Key 登录更适合开发者、自动化脚本、CI/CD、服务器任务等场景。

小白可以这样理解：

ChatGPT 登录 = 走 ChatGPT 账号和套餐额度

API Key 登录 = 走 OpenAI Platform API 计费

如果你要用 API Key 登录，先去 OpenAI Platform 创建 API Key。

然后在终端里设置环境变量。

macOS / Linux 可以这样写：

export OPENAI_API_KEY="你的_API_Key"

printenv OPENAI_API_KEY | codex login --with-api-key

Windows PowerShell 可以这样写：

$env:OPENAI_API_KEY="你的_API_Key"

$env:OPENAI_API_KEY | codex login --with-api-key

登录成功后，Codex CLI 会保存登录信息，后面再次运行：

codex

就可以继续使用。