配置 Codex

本页说明如何让 Codex CLI、Codex Desktop 或 Codex IDE 扩展通过 LLMAPI 调用 Responses API。请使用所属分组支持 Responses API 的 API Key。

配置前准备

1. 在网页 API Key 页面创建或选择一个普通 API Key。通常应绑定 OpenAI 分组。
2. 使用这个 Key 调用 GET /v1/models，确认准备使用的模型对当前 Key 可见。
3. 完全退出正在使用的 Codex CLI、Codex Desktop 或编辑器扩展，避免配置被运行中的客户端覆盖。
4. 如果本机已有 Codex 配置，先备份并合并需要的字段，不要直接丢弃已有设置。

config.toml 和 auth.json 包含用户级配置与凭据，不要把它们提交到 Git、发送到聊天或放进截图。

从网页 API Key 页面复制配置

网页 API Key 页面会使用当前 Key 的实际分组和公开服务地址生成配置，这比手写固定模型与地址更可靠：

1. 登录网站，进入 API Key 页面。
2. 找到要使用的普通 API Key，点击 使用密钥。
3. 选择 Codex CLI。
4. 选择 Codex 认证模式和操作系统。
5. 将窗口生成的 config.toml 与 auth.json 保存到对应用户目录。
6. 重新启动你使用的 Codex 客户端，并按下文对应方式验证。

网页 API Key 页面默认提供兼容认证模式，也可能提供 API Key 模式。两种模式生成的 provider 认证字段不同，请成套复制同一模式下的 config.toml 和 auth.json，不要混用。

如果已经安装 CC Switch，也可以通过网页 API Key 页面的 导入到 CCS 打开导入流程；确认导入后，还需在 CC Switch 中点击 启用。参见 配置 CC Switch。

配置文件位置

系统	config.toml	auth.json
macOS / Linux	~/.codex/config.toml	~/.codex/auth.json
Windows	%USERPROFILE%\.codex\config.toml	%USERPROFILE%\.codex\auth.json

如果已经使用或配置过 Codex，~/.codex 通常已经存在，不需要重复创建。只有目录不存在、无法保存配置文件时，才运行 mkdir -p ~/.codex。

Windows 可以按 Win + R，输入 %USERPROFILE%\.codex 打开目录；目录不存在时先创建它。

这些是用户级 provider 设置。不要把 model_provider、model_providers 或认证配置放进项目内的 .codex/config.toml。

手动配置示例

以下示例对应网页 API Key 页面生成的兼容认证模式。服务地址和模型可随部署或 Key 分组变化；如果网页生成的内容与示例不同，以网页内容和 GET /v1/models 的结果为准。

~/.codex/config.toml：

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.llmapi.site"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

~/.codex/auth.json：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

将 YOUR_API_KEY 替换为普通 API Key。如果 gpt-5.5 不在当前 Key 的模型列表中，请同时把 model 和 review_model 改成实际可用的 Responses 模型。

验证配置

可以先确认 Key 能看到目标模型：

curl https://api.llmapi.site/v1/models \
  -H 'Authorization: Bearer YOUR_API_KEY'

然后按你实际使用的客户端验证，不需要为了验证桌面端或 IDE 扩展而另外安装 Codex CLI。

Codex CLI

确认命令可执行：

codex --version

再进入一个项目目录运行：

codex

Codex Desktop

完全退出并重新打开 Codex Desktop，新建一个任务并确认可以正常获得响应。

Codex IDE 扩展

重新加载窗口或重启编辑器，新建一个任务并确认可以正常获得响应。

常见问题

现象	处理
启动后进入官方登录流程	检查用户目录中的 config.toml 和 auth.json 是否存在、JSON/TOML 是否有效，以及 provider 配置是否来自同一种认证模式。
返回 401	检查 auth.json 中的 Key 是否完整、有效且未停用。
提示模型不存在	使用同一个 Key 查询 GET /v1/models，将 model 与 review_model 改为返回列表中的模型，或从网页 API Key 页面重新复制配置。
修改后没有生效	完全退出 Codex CLI、桌面端和 IDE 扩展，再重新启动；同时确认修改的是用户目录而不是项目目录。

Codex 配置文件的当前字段含义可参考 OpenAI 官方配置参考。