Codex CLI 安装与配置教程

PS：已支持最新的 gpt-5.4，需要用的，在配置文件那里修改即可，下面的教程配置文件默认用 gpt-5.3-codex

📺 视频讲解：https://www.bilibili.com/video/BV15zwwzHEjD/?spm_id_from=333.1387.homepage.video_card.click&vd_source=3242ad7662aff0ee7a54be6044f2b7c0

🪟 Windows 版本教程

系统要求

Windows 10 或 Windows 11
Node.js 22+
npm 10+
网络连接

安装步骤

⚠️ 前置步骤！！！

安装 Git Bash，请访问 https://git-scm.com/downloads 下载对应您电脑系统的版本，之后一直点击"下一步"即可完成安装。

第一步：安装 Node.js

访问 Node.js 官网:https://nodejs.org/ 下载并安装最新 LTS 版本。

第二步：安装 codex

打开命令提示符（CMD）或 PowerShell，运行：

npm install -g @openai/codex

第三步：验证安装

打开命令提示符（CMD）或 PowerShell，运行：

codex --version

配置 API

第一步：获取 Auth Token

访问网站：https://letaicode.cn/ 站点页面进行以下操作：

点击 接口密钥 页面
点击 创建新密钥
密钥类型选择：codex（务必选择此分组，否则无法使用）
令牌名称随意

第二步：配置文件

⚠️ 重要提示：请将下方的 sk-xxx 替换为您在 LetAiCode 生成的实际 API 密钥！请将下方的 sk-xxx 替换为您在 LetAiCode 生成的实际 API 密钥！请将下方的 sk-xxx 替换为您在 LetAiCode 生成的实际 API 密钥！

1️⃣ 进入当前用户的用户目录下的 .codex 文件夹中，例如：C:\Users\testuser\.codex。

（注意：如果看不到该目录，说明您没有打开 Windows 的"显示隐藏的项目"，请先在文件资源管理器中开启。）

2️⃣ 如果没有 .codex 文件夹，请手动创建该文件夹，然后在其中创建 config.toml 以及 auth.json 两个文件。

3️⃣ 填写配置（需要将 sk-xxx 替换成您自己创建的真实 SK）：

auth.json 中的配置（注意，如果文件里有其他内容，直接覆盖原有的）：

{"OPENAI_API_KEY":"sk-xxx"}

config.toml 中的配置（直接复制下面的内容，如果文件里有其他内容，直接覆盖原有的）：

model_reasoning_effort 可选值为 high、medium、low，分别代表模型思考的努力程度（高、中、低）。

model_provider = "api111"model = "gpt-5.3-codex"model_reasoning_effort = "high"disable_response_storage = truepreferred_auth_method = "apikey"[model_providers.api111]name = "api111"base_url = "https://quiz.playoffer.cn/codex"wire_api = "responses"

💡 其中 model = "gpt-5.3-codex" 这一行，你可以指定具体的模型，如果想用最新的 gpt-5.4，也可以改成 model = "gpt-5.4"

启动 codex

🔄 重启终端！重启终端！重启终端！ 然后进入到您的工程目录：

cd your-project-folder

运行以下命令启动：

codex

🍎 Mac 版本教程

系统要求

macOS 12 或更高版本
Node.js 22+
npm 10+
网络连接

安装步骤

第一步：安装 Node.js

方式一：直接访问Node.js官网： https://nodejs.org/ 下载并安装最新 LTS 版本。
方式二：使用 Homebrew（推荐）

# 如果尚未安装 Homebrew，请先运行此命令/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 安装 Node.jsbrew install node

第二步：安装 codex

打开终端（Terminal），运行（可能需要加 sudo）：

npm install -g @openai/codex

第三步：验证安装

打开终端（Terminal），运行：

codex --version

配置 API

第一步：获取 Auth Token

访问网站：https://letaicode.cn/站点页面进行以下操作：

点击 接口密钥 页面
点击 创建新密钥
密钥类型选择：codex（务必选择此分组，否则无法使用）
令牌名称随意

第二步：配置文件

⚠️ 重要提示：请将下方的 sk-xxx 替换为您在 LetAiCode 生成的实际 API 密钥！请将下方的 sk-xxx 替换为您在 LetAiCode 生成的实际 API 密钥！请将下方的 sk-xxx 替换为您在 LetAiCode 生成的实际 API 密钥！

1️⃣ 创建目录和文件：

mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml

2️⃣ 编辑 auth.json 文件：

vi ~/.codex/auth.json

按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的密钥），然后按 ESC 键，输入 :wq 并回车保存退出。

{"OPENAI_API_KEY": "sk-xxx"}

注意：如果文件里有其他内容，直接覆盖原有的

3️⃣ 编辑 config.toml 文件：

vi ~/.codex/config.toml

按 i 进入插入模式，粘贴以下内容，然后按 ESC 键，输入 :wq 并回车保存退出。

model_provider = "api111"model = "gpt-5.4"model_reasoning_effort = "high"disable_response_storage = truepreferred_auth_method = "apikey"[model_providers.api111]name = "api111"base_url = "https://quiz.playoffer.cn/codex"wire_api = "responses"

注意：如果文件里有其他内容，直接覆盖原有的

💡 其中 model 这一行，你可以指定具体的模型，默认 gpt-5.3-codex，如果想用最新的 gpt-5.4，也可以改成 model = "gpt-5.4"

启动 codex

🔄 重启终端！重启终端！重启终端！ 然后进入到您的工程目录：

cd your-project-folder

运行以下命令启动：

codex

🐧 Linux 版本教程

系统要求

主流 Linux 发行版（Ubuntu 20.04+、Debian 10+、CentOS 7+ 等）
Node.js 22+
npm 10+
网络连接

安装步骤

第一步：安装 Node.js

Ubuntu/Debian：

sudo apt updatecurl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -sudo apt-get install -y nodejs

CentOS/RHEL/Fedora：

# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)sudo dnf install nodejs npm# 或sudo yum install nodejs npm

Arch Linux：

sudo pacman -S nodejs npm

第二步：安装 codex

打开终端（Terminal），运行：

sudo npm install -g @openai/codex

第三步：验证安装

打开终端（Terminal），运行：

codex --version

配置 API

第一步：获取 Auth Token

访问网站：https://letaicode.cn/站点页面进行以下操作：

点击 接口密钥 页面
点击 创建新密钥
密钥类型选择：codex（务必选择此分组，否则无法使用）
令牌名称随意

第二步：配置文件

⚠️ 重要提示：请将下方的 sk-xxx 替换为您在 LetAiCode 生成的实际 API 密钥！请将下方的 sk-xxx 替换为您在 LetAiCode 生成的实际 API 密钥！请将下方的 sk-xxx 替换为您在 LetAiCode 生成的实际 API 密钥！

1️⃣ 创建目录和文件：

mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml

2️⃣ 编辑 auth.json 文件：

vi ~/.codex/auth.json

按 i 进入插入模式，粘贴以下内容（将 sk-xxx 替换为您的密钥），然后按 ESC 键，输入 :wq 并回车保存退出。

{"OPENAI_API_KEY": "sk-xxx"}

3️⃣ 编辑 config.toml 文件：

vi ~/.codex/config.toml

按 i 进入插入模式，粘贴以下内容，然后按 ESC 键，输入 :wq 并回车保存退出。

model_provider = "api111"model = "gpt-5.3-codex"model_reasoning_effort = "high"disable_response_storage = truepreferred_auth_method = "apikey"[model_providers.api111]name = "api111"base_url = "https://quiz.playoffer.cn/codex"wire_api = "responses"

💡 其中 model = "gpt-5.3-codex" 这一行，你可以指定具体的模型，如果想用最新的 gpt-5.4，也可以改成 model = "gpt-5.4"

启动 codex

🔄 重启终端！重启终端！重启终端！ 然后进入到您的工程目录：

cd your-project-folder

运行以下命令启动：

codex

🧩 VSCode 插件 codex

以上配置完成后，在 VSCode 扩展商店中搜索并安装 codex 即可。

安装完成后会出现在侧边栏。

找到并点击 Settings，以打开 VSCode 系 IDE 的 settings.json 文件。

在 settings.json 文件末尾，添加以下配置：

⚠️ 注意：这里的 apikey 字段 无需更改！即，将以下内容原封不动粘贴即可！

"chatgpt.apiBase": "https://letaicode.cn/codex","chatgpt.config": {"preferred_auth_method": "apikey"}

🖥️ codex 桌面客户端

配置方法和上面的 codex CLI 一样，没生效可能需要手动更改一下配置文件。

设置 → 配置 → Custom config.toml settings 下面的 user config 换成你配置的路径。

❓ 常见问题

出现错误请按照如下步骤排查：

确认 API Key 创建是否正确：额度选择 无限额度，不要限制模型，分组选择 codex 渠道。

更多 codex 配置及使用详情请参考 codex 官方教程。