Codex CLI 专项问题

Codex CLI 的 Base URL 格式是什么？

Codex 的 Base URL 需要 /v1 后缀，与 Claude Code 不同：

Claude Code：https://你的请求地址      （不带 /v1）
Codex CLI ：https://你的请求地址/v1   （带 /v1）

Codex CLI 配置文件在哪？怎么手动配置？

两个配置文件：

• ~/.codex/config.toml（Windows 为 C:\Users\用户名\.codex\config.toml）
• ~/.codex/auth.json（Windows 为 C:\Users\用户名\.codex\auth.json）

config.toml 参考：

model_provider = "custom"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://你的请求地址/v1"
wire_api = "responses"
requires_openai_auth = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

auth.json 参考：

{
  "OPENAI_API_KEY": "sk-***"
}

Codex CLI 如何启用 1M 上下文？

在 ~/.codex/config.toml 中确认以下两项：

model_context_window = 1000000
model_auto_compact_token_limit = 900000

• model_context_window：可用上下文窗口设为 1,000,000
• model_auto_compact_token_limit：接近上限前提前触发压缩，避免撞满

Codex CLI 推理速度慢怎么办？

将 config.toml 中的 model_reasoning_effort 从 high 改为 medium 或 low：

• low：快，适合简单代码生成、快速问答
• medium：中，日常开发任务（推荐）
• high：慢，适合复杂算法、架构设计

Codex CLI API Key 无效？

1. 检查 ~/.codex/auth.json 中的 Key 是否正确
2. 确认中转站余额充足、Token 未过期

Codex 报错 401 Unauthorized: Invalid token

现象：Codex CLI 运行时报错 unexpected status 401 Unauthorized: Invalid token。

原因：之前登录过账号，导致 ~/.codex/auth.json 被覆盖，里面的 Key 不再是中转 API 的 Key。

修复：手动打开 ~/.codex/auth.json（Windows 为 C:\Users\用户名\.codex\auth.json），将内容改为你的中转 API Key：

{
  "OPENAI_API_KEY": "sk-***"
}

保存后重新启动 Codex 即可。

同时使用 Claude Code 和 Codex CLI 会冲突吗？

不会。两者配置文件独立，互不冲突。使用 CC Switch 可统一管理：

• Claude Code → ~/.claude/settings.json
• Codex CLI → ~/.codex/config.toml + ~/.codex/auth.json

Codex 报错 Image generation is not enabled for this group

现象：Codex CLI 运行时报错 Image generation is not enabled for this group。

原因：当前分组未开通图像生成能力，Codex 默认尝试携带图像生成特性导致请求被拒。

修复：打开 ~/.codex/config.toml（Windows 为 C:\Users\用户名\.codex\config.toml），在 [features] 段中添加：

[features]
image_generation = false

如果文件中没有 [features] 段，则新增该段后再写入上述配置。注意 Codex 没有热重载，修改保存后需要完全退出并重启 Codex 才会生效。