大约 1 分钟
Codex 手动配置
本页提供 Codex CLI 的完整手动配置方案，并标出与 Claude 配置的关键差异。
一、配置文件位置
| 系统 | 路径 |
|---|---|
| Windows | %USERPROFILE%\\.codex\\config.toml、%USERPROFILE%\\.codex\\auth.json |
| macOS | ~/.codex/config.toml、~/.codex/auth.json |
| Linux | ~/.codex/config.toml、~/.codex/auth.json |
二、写入 config.toml
disable_response_storage = true
model_provider = "yuzhi"
model = "gpt-5-codex"
model_reasoning_effort = "high"
model_verbosity = "high"
[features]
web_search_request = true
[model_providers.yuzhi]
name = "yuzhi"
base_url = "https://www.yuzhixiaolongxia.com/v1"
wire_api = "responses"
requires_openai_auth = true三、写入 auth.json
{
"OPENAI_API_KEY": "替换为你的Codex分组令牌"
}令牌获取：/docs/register/4-token.html
四、与 Claude 配置的差异
| 维度 | Claude | Codex |
|---|---|---|
| 认证变量 | ANTHROPIC_AUTH_TOKEN | OPENAI_API_KEY |
| 配置文件 | settings.json | config.toml + auth.json |
| 接口形态 | Anthropic 风格 | OpenAI 兼容风格 |
五、验证步骤
- 关闭旧终端并重开
- 执行：
codex- 发送测试任务，能正常返回即配置成功
六、常见错误
| 现象 | 原因 | 处理方式 |
|---|---|---|
invalid_api_key | Key 错误或分组错误 | 替换为 Codex 分组令牌 |
model_not_found | 模型名与分组不匹配 | 修改为分组支持模型 |
429 | 额度不足或并发过高 | 检查余额，降低并发 |
| 命令可运行但请求失败 | base_url 拼写错误 | 确认为 https://www.yuzhixiaolongxia.com/v1 |
七、进阶建议
- 用两个 Provider 分别管理测试/生产
- 使用固定验证任务做发版后自检
- 团队统一
config.toml模板，避免个人随意改动
下一步：Gemini 配置