Codex 配置

通过 OpenAI Responses API 将 Codex CLI 接入 Chimney。

可选阅读

已使用 CC-Switch 一键导入 的用户无需手动配置，可跳过本页。

前置条件：

• 已注册并登录 Chimney
• 已安装 Codex CLI

第一步：创建密钥

1. 打开 密钥管理 页面，点击 新建密钥。
2. 填写名称（如 codex），分组选择 GPT Plus 或 GPT PRO。
3. 创建后复制密钥（sk- 开头）。

📷 截图占位

cx-01-create-key.png — 创建密钥：分组选择 GPT Plus

分组选择

• GPT Plus：倍率 0.15x，性价比高，日常推荐。
• GPT PRO：倍率 0.25x，稳定可靠高速；Plus 用不了时可以切换到这个。

第二步：配置 config.toml

打开 Codex 配置目录：

• Windows：Win + R，输入 %userprofile%\.codex 回车
• macOS / Linux：打开终端，进入 ~/.codex

编辑（不存在则新建）config.toml，写入：

model = "gpt-5.5"
model_provider = "chimney"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.chimney]
name = "chimney"
base_url = "https://www.chimney.asia/v1"
wire_api = "responses"
requires_openai_auth = true

说明：

• wire_api = "responses"：Chimney 的 GPT 分组使用 Responses API（Codex 系模型的原生协议）。
• model 可换成密钥分组下的任意模型，如 gpt-5.6、gpt-5.4-mini，见 模型列表。
• model_reasoning_effort 可按需调整（low / medium / high / xhigh）。

第三步：配置 auth.json

在同一目录编辑（不存在则新建）auth.json，写入密钥：

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}

第四步：验证

打开终端运行：

codex

进入对话界面后发送一条消息，能正常收到回复即配置成功。

配置后仍报错？

• 401 鉴权失败：检查 auth.json 中密钥是否完整、是否为合法 JSON。
• 403 not assigned to any group：密钥没绑分组，回 密钥管理 绑定。
• 模型不存在：确认 config.toml 的 model 在密钥分组可用范围内，且与 base_url 拼写无误。
• 更多问题见 常见问题 与 错误码说明。