手动配置 Codex

当 C+ 安装或 ccswitch 导入不可用时，再手动配置 Codex。手动配置需要改两个文件：config.toml 写 Base URL，auth.json 写 API Key。

不要把 API Key 写进公开项目

API Key 只写在你自己用户目录下的 auth.json 里，不要写进项目仓库、README、截图或聊天记录。

适合谁看

• ccswitch 配置 Codex 后仍然走默认线路。
• 想自己检查 Codex 的 config.toml 和 auth.json。
• 需要手动切换模型提供商或 Base URL。

你需要准备

信息	从哪里拿	示例
API Key	中转站后台	sk-xxxxxxxxxxxxxxxx
Base URL	中转站后台或线路表	https://max.c-api.cc
模型名	中转站模型列表	gpt-5.4

找到 Codex 配置目录

Windows常见路径

%USERPROFILE%\.codex\config.toml

%USERPROFILE%\.codex\auth.json

如果目录不存在，可以先启动一次 Codex，或者手动创建。

macOS / Linux常见路径

~/.codex/config.toml

~/.codex/auth.json

可以在终端里用编辑器打开，也可以从 Finder 前往文件夹。

修改 config.toml

打开 config.toml，写入或合并下面内容：

model_provider = "custom"
model = "gpt-5.4"

[model_providers.custom]
name = "custom"
base_url = "https://max.c-api.cc"
wire_api = "responses"
requires_openai_auth = true

如果你已经有其他 Codex 配置，不要整文件清空；只确认 model_provider、model 和 [model_providers.custom] 这几项符合你的目标线路。

修改 auth.json

打开同目录下的 auth.json，写入你的 API Key：

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}

这里的 OPENAI_API_KEY 是 auth.json 里的字段名，不是让你去配置系统环境变量。

保存并验证

完全关闭 Codex 和终端后重新打开，执行：

codex login status

如果看到已经使用 API Key 登录，再执行：

codex

进入 Codex 后发送：

请回复“配置已生效”。

能正常回复，就说明 Codex 已经接入 c-api。

排错清单

现象	可能原因	处理方式
仍然走默认配置	config.toml 路径写错或 model_provider 没指向自定义 provider	确认文件在用户目录的 .codex 下，并检查 model_provider = "custom"
鉴权失败 / 401	auth.json 路径写错或 Key 错	重新从后台复制 API Key，写入用户目录下的 auth.json
连接失败	Base URL 错或线路不可用	换线路，确认 Base URL 是否写完整
TOML 报错	config.toml 格式不合法	检查引号、空行和表头
JSON 报错	auth.json 格式不合法	检查双引号、逗号和花括号
改完没反应	旧终端或旧 Codex 进程仍在	完全关闭 Codex 和终端后重新打开

仍然无法解决时，继续看 常见问题 FAQ。