本文专门整理 Codex CLI 使用卡特 Token 站 API Key 时的常见问题。

​
Codex 的 Base URL 必须带 /v1

Codex 使用 OpenAI 兼容接口，Base URL 必须写成： 
https://api.cutaihub.com/v1
不要写成： 
https://api.cutaihub.com
Claude Code 和 Codex 的区别：
客户端Base URL
Claude Codehttps://api.cutaihub.com
Codex CLIhttps://api.cutaihub.com/v1

​
Codex 配置文件在哪

Codex 主要读取两个文件：
系统config.tomlauth.json
WindowsC:\Users\用户名\.codex\config.tomlC:\Users\用户名\.codex\auth.json
macOS / Linux~/.codex/config.toml~/.codex/auth.json
如果 .codex 目录不存在，可以手动创建。

​
推荐 config.toml

推荐使用自定义 provider： 
model_provider = "cutai_codex"
model = "你的模型名称"
model_reasoning_effort = "medium"
disable_response_storage = true
supports_websockets = false

[model_providers.cutai_codex]
name = "cutai_codex"
base_url = "https://api.cutaihub.com/v1"
wire_api = "responses"
requires_openai_auth = true
关键点：
  • base_url 必须以 /v1 结尾。
  • supports_websockets = false 可以避免启动时反复 Reconnecting。
  • model 必须是当前 API Key 分组支持的模型。
  • 修改后需要完全退出并重启 Codex，Codex 通常不会热重载配置。

​
auth.json 应该怎么写

auth.json 内容应为： 
{
  "OPENAI_API_KEY": "你的完整API Key"
}
不要把完整 Key 发到聊天、截图或公开仓库。

​
401 Unauthorized / Invalid token

常见现象： 
401 Unauthorized
Invalid token
Invalid API key
排查：
  • auth.json 是否在正确的 .codex 目录。
  • OPENAI_API_KEY 是否复制完整。
  • 文件是否是合法 JSON。
  • 是否曾经登录过官方账号，导致 auth.json 被覆盖。
  • 是否仍使用旧 Key。
修复方式：
  1. 打开 ~/.codex/auth.json。
  2. 把内容改回 OPENAI_API_KEY。
  3. 保存后完全退出并重启 Codex。

​
503 model_not_found / 当前分组没有该模型

在卡特 Token 站中，Codex 返回 503 通常表示当前 API Key 所在分组没有你配置的模型。 处理方式：
  • 检查 config.toml 里的 model。
  • 回到 API Keys 页面确认该 Key 的分组。
  • 不要用「GPT生图专用」分组跑 Codex 对话或编程请求。
  • 新建一个支持目标模型的 Key 后重新配置。
503 优先按“当前分组没有该模型”排查，不要先当成网络故障。

​
Image generation is not enabled for this group

常见现象： 
Image generation is not enabled for this group
说明当前分组没有图像生成能力，但 Codex 或配置尝试启用图像生成相关特性。 可以在 ~/.codex/config.toml 中添加： 
[features]
image_generation = false
保存后完全退出并重启 Codex。

​
启动卡在 Reconnecting

常见现象： 
Reconnecting
Codex 默认可能先尝试 WebSocket，而普通 OpenAI 兼容代理走标准 HTTP。建议在 config.toml 中加入： 
supports_websockets = false
并确认你使用的是自定义 provider： 
model_provider = "cutai_codex"

[model_providers.cutai_codex]
base_url = "https://api.cutaihub.com/v1"
requires_openai_auth = true
保存后完全退出并重启 Codex。

​
Selected model is at capacity

常见现象： 
Selected model is at capacity. Please try a different model.
这通常表示目标模型当前容量不足或临时繁忙。 处理方式：
  • 等待一段时间后重试。
  • 切换到同分组下其他可用模型。
  • 如果持续发生，联系客服确认当前分组推荐模型。
如果错误变成 503，则按“当前分组没有该模型”处理。

​
如何启用大上下文

如果你使用的模型和分组支持大上下文，可以在 config.toml 中设置： 
model_context_window = 1000000
model_auto_compact_token_limit = 900000
说明：
  • model_context_window 是期望上下文窗口。
  • model_auto_compact_token_limit 是接近上限前自动压缩的阈值。
如果当前分组或模型不支持大上下文，配置写得再大也不会生效。

​
推理速度慢

如果 Codex 响应慢，可以降低推理强度： 
model_reasoning_effort = "medium"
常见取值：
值适合场景
low简单修改、快速问答
medium日常开发，推荐默认
high复杂分析、架构设计
推理强度越高，可能越慢、消耗越高。

​
GPT 生图专用分组不能用于 Codex

「GPT生图专用」只用于 GPT 图片生成，不适合 Codex 对话、编程、普通 GPT 聊天或 Claude 请求。 如果你把 Codex Key 建在这个分组，可能出现：
  • 503 当前分组没有该模型。
  • 模型不可用。
  • 请求参数或能力不支持。
请新建一个支持 Codex 的分组 Key。

​
排障时提供什么

联系客服时请提供：
  • 操作系统。
  • Codex 版本：codex --version。
  • config.toml 中的 base_url、model_provider、model，不要提供完整 Key。
  • API Key 分组。
  • 完整错误文本。
  • 是否修改配置后已完全重启 Codex。
不要发送完整 API Key。