Codex CLI 配置

使用独立的 ACode 服务商配置，将 Codex CLI 连接到支持 Responses API 的分组。

开始之前

准备一枚有效的 ACode 密钥，并确认其分组支持目标模型与 Responses API。也可以先查看密钥行上的「使用密钥」说明，或使用 CC Switch导入配置。

尚未安装 Codex CLI 时，请先完成 OpenAI 官方安装指引。安装后在终端运行 codex --version，确认命令可以使用。

1. 设置密钥

在你准备启动 Codex 的同一个终端设置环境变量：

macOS / Linux

export ACODE_API_KEY="sk-your-api-key"

Windows PowerShell

$env:ACODE_API_KEY="sk-your-api-key"

2. 配置服务商

打开用户配置文件 ~/.codex/config.toml。Windows 通常位于 %USERPROFILE%\.codex\config.toml；设置了 CODEX_HOME 时，以对应目录为准。

将以下字段合并到现有配置中。顶层的 model 和 model_provider 应放在 TOML 表定义之前；已存在的同名字段需要更新，不能重复追加。

model = "gpt-6.1-sol"
model_provider = "acode"

[model_providers.acode]
name = "ACode"
base_url = "https://acode.ink/v1"
env_key = "ACODE_API_KEY"
wire_api = "responses"

模型名称以分组为准

gpt-6.1-sol 是当前文档采用的示例名称。确认该模型对你的密钥分组开放；如果使用其他名称，也需确保与 Codex 和 Responses API 兼容。

3. 启动与验证

在同一个终端进入你的项目目录，运行：

codex

发送一句简单请求，确认返回正常。随后在 ACode 使用记录核对模型与请求时间。测试请求会按实际规则计费。

常见问题

提示环境变量不存在。 确认变量是在启动 Codex 的同一个终端中设置。另一个终端、桌面快捷方式或 IDE 启动的进程可能没有继承该变量。

仍然使用旧服务商。 检查当前启用的配置 profile、项目配置或启动参数是否覆盖了用户配置。重启 Codex 后再核对。

模型不存在或返回 404。 核对模型名、密钥分组、Base URL 和 Responses 支持情况。仅支持 Chat Completions 的分组不能直接用于这份配置。

参考资料

配置字段依据 OpenAI 自定义服务商文档。ACode 的具体模型权限与服务可用性以控制台为准。