Codex CLI 配置
特别说明： AI 工具迭代速度极快。遇到报错时，建议先将 Claude Code、Codex CLI、CC-Switch 等工具更新到最新版本，新版通常已修复已知问题，也能避免旧版本特有的奇怪报错。
前置要求
- Node.js 18+ — nodejs.cn 下载 LTS 版本
- Git — git-scm.com
安装
npm install -g @openai/codex
验证：codex --version
配置 API
配置文件位置
| 系统 | config.toml | auth.json |
|------|-------------|-----------|
| Windows | C:\Users\用户名\.codex\config.toml | C:\Users\用户名\.codex\auth.json |
| Mac/Linux | ~/.codex/config.toml | ~/.codex/auth.json |
config.toml
model_provider = "rovoapi"
model = "gpt-5.5"
plan_mode_reasoning_effort = "xhigh"
model_reasoning_effort = "high"
disable_response_storage = true
supports_websockets = false
[model_providers.rovoapi]
name = "rovoapi"
base_url = "https://api.rovoapi.com"
wire_api = "responses"
requires_openai_auth = true
Codex 的 Base URL 不需要 /v1 后缀。
auth.json
{
"OPENAI_API_KEY": "sk-rovo-你的Key"
}
配置参数参考
| 参数 | 说明 | 可选值 |
|------|------|--------|
| model_provider | 供应商标识 | 自定义名称 |
| model | 使用的模型 | gpt-5.5、gpt-5.4 等 |
| plan_mode_reasoning_effort | Plan 模式推理深度 | low/medium/high/xhigh |
| model_reasoning_effort | 推理深度 | low/medium/high |
| disable_response_storage | 关闭服务端存储 | 建议 true |
| supports_websockets | 是否启用 WebSocket | 建议 false |
| wire_api | API 协议 | responses |
| model_context_window | 上下文窗口 | 整数（1M 填 1000000） |
| model_auto_compact_token_limit | 自动压缩阈值 | 整数（通常 900000） |
1M 上下文配置
model_context_window = 1000000
model_auto_compact_token_limit = 900000
常见问题
报错 Reconnecting（启动卡住一分多钟后恢复）
原因： Codex 启动时先用 WebSocket 协议连接，中转站只有 HTTP，连撞 5 次后才切换到 HTTP。
修复： 在 config.toml 中添加 supports_websockets = false。
报错 401 Unauthorized: Invalid token
原因： 之前登录过账号，auth.json 被覆盖。
修复： 手动打开 ~/.codex/auth.json，改为：
{
"OPENAI_API_KEY": "sk-rovo-你的Key"
}
报错 Selected model is at capacity
原因： 服务端模型容量限流，非 Key/余额/网络问题。
应对： 直接发送"继续"重试，或换个模型。
报错 Image generation is not enabled for this group
修复： 在 config.toml 中添加：
[features]
image_generation = false
GPT 偶发自称是特定版本号
原因： 中转挂号系统的系统提示词注入，不影响模型能力。
启动
cd 你的项目目录
codex