OpenAI Codex CLI 配置教程

“
目前已经支持最新 gpt-5.4。如果你希望直接使用新模型，只需要在配置文件里修改 model 字段即可。本文示例默认使用 gpt-5.3-codex。

把 Codex CLI 配好，其实没有你想的那么难

很多人第一次接触 OpenAI Codex CLI，会下意识觉得这类终端工具门槛很高：要装环境、要配密钥、还要改配置文件。
但实际上，只要步骤理顺，整个过程并不复杂，甚至可以说非常直接。

这篇文章把 Windows、macOS、Linux 三个平台的安装与配置思路统一整理了一遍。
你不需要反复翻资料，也不用担心漏掉关键项。照着做，基本就能完成从安装到启动的全流程。

以这个不需要特殊上网的代理站为例：https://letaicode.cn/?aff=HQgMiS

先看准备条件

在开始之前，先确认你的环境满足下面几个条件：

Windows 10 / Windows 11，或 macOS 12+，或主流 Linux 发行版
Node.js 22 及以上
npm 10 及以上
网络连接正常

如果这些条件都满足，那么就可以正式开始。

第一步：安装 Codex CLI

无论你使用哪个系统，安装命令都很统一：

npm install -g @openai/codex

安装完成后，执行下面这条命令检查是否安装成功：

codex --version

只要能看到版本号输出，就说明这一部分已经没有问题。

Windows 用户额外注意

Windows 环境下，建议先安装 Git Bash。
安装方式很简单，去 Git 官方下载页面选择对应版本，一路下一步即可。

这一步虽然不是 Codex 本体安装，但在后续终端使用过程中会更方便，也更稳定。

第二步：去 LetAiCode 创建可用密钥

CLI 能跑起来，核心不只是安装成功，更关键是要把鉴权配置好。

进入 LetAiCode 后，按下面步骤操作：

打开“接口密钥”页面
点击“创建新密钥”
密钥类型选择 codex
令牌名称可自定义

这里最容易出错的一点，就是分组没选对。
如果不是 codex 分组，后续即使写了配置，也无法正常使用。

第三步：创建 `.codex` 配置目录

不同系统下，目录位置略有不同：

Windows：C:\Users\你的用户名\.codex
macOS / Linux：~/.codex

如果这个目录不存在，请手动创建。
然后在目录中准备两个文件：

auth.json
config.toml

这两个文件，一个负责存放密钥，一个负责定义模型和接口地址。

第四步：填写 `auth.json`

把下面这段内容写进去，并把 sk-xxx 换成你自己创建的真实密钥：

{"OPENAI_API_KEY":"sk-xxx"}

如果文件里原本有别的内容，建议直接覆盖，避免旧配置影响结果。

第五步：填写 `config.toml`

默认推荐使用以下配置：

model_provider = "api111"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://letaicode.cn/codex"
wire_api = "responses"

这里有两个点值得特别说明。

第一，model_reasoning_effort 用于控制模型思考强度，可选：

high
medium
low

第二，如果你想切换到更新版本，只需要把：

model = "gpt-5.3-codex"

改成：

model = "gpt-5.4"

也就是说，升级模型这件事，并不需要重装，只需要改配置。

不同平台怎么操作

Windows

Windows 用户一般会在 CMD 或 PowerShell 中完成安装。
配置文件写好后，记得重启终端，再进入项目目录启动：

cd your-project-folder
codex

macOS

macOS 用户可以从 Node.js 官网直接安装，也可以用 Homebrew：

brew install node

然后创建：

mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml

写好配置后，同样记得重启终端，再启动 Codex。

Linux

Linux 的流程与 macOS 接近。
先安装 Node.js 与 npm，再创建 ~/.codex 目录和两个配置文件，最后启动：

cd your-project-folder
codex

如果你还在用 VSCode

很多人并不只是在终端里使用 Codex，也会搭配编辑器一起工作。
这种情况下，可以继续安装 VSCode 的 codex 插件。

安装完成后，打开 settings.json，在末尾添加：

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

这里不需要改动 apikey 字段，按原样粘贴即可。

桌面客户端也能复用同一套配置

如果你使用的是 Codex 桌面客户端，配置思路和 CLI 本质上是一样的。
遇到不生效的情况，通常不是配置错了，而是程序没有读到正确的配置路径。

这时可以进入：

设置 -> 配置 -> Custom config.toml settings

把 user config 指向你真正使用的配置文件位置。

最后说说几个高频问题

如果你配置后仍然报错，建议优先排查这几项：

API Key 是否来自正确页面
密钥分组是否选择了 codex
额度是否足够，最好不要做模型限制
auth.json 是否写入了真实密钥
config.toml 是否被历史内容污染
改完配置后是否已经重启终端

写在最后

Codex CLI 真正难的，从来不是安装，而是第一次配置时信息分散、容易漏步骤。
只要把安装、密钥、配置文件这三件事梳理清楚，整个过程其实非常顺。

如果你准备开始用 Codex CLI，最直接的方法就是先照着这篇教程完成一遍。
先跑通，再优化；先用起来，再深入。这才是效率最高的上手方式。