为什么在 Codex 的 API 模式无法使用 GPT-5.5？

截至 2026-04-24，部分 Codex 版本在自定义 API 模式下可能无法直接选择 gpt-5.5。这是 Codex 本地模型目录尚未包含该模型导致的显示和选择限制，不代表 BetterToken 的 https://www.bettertoken.ai/v1 端点不可用。你可以先添加一个本地 custom-models.json，让 Codex 识别 gpt-5.5，再在 ~/.codex/config.toml 中引用它。官方后续版本若已经内置支持 gpt-5.5，优先使用 Codex 的内置方案。

请使用页面提供的完整 custom-models.json。如果你要手动调整文件，请保留里面已有的模型条目和字段，只修改需要调整的模型配置。

配置步骤

准备自定义模型配置文件

自定义模型配置文件路径为 ~/.codex/custom-models.json。

下载 JSON 文件
手动修改 JSON 文件

下载完整模型目录文件：下载 custom-models.json下载后，将文件放到 Codex 配置目录，并命名为 custom-models.json。

系统	目标路径
macOS / Linux	`~/.codex/custom-models.json`
Windows	`C:\Users\YOUR_USER\.codex\custom-models.json`

下载得到的是完整模型目录文件，后续步骤会在 Codex 配置里引用它。

如果你已经有 ~/.codex/custom-models.json，请在现有文件基础上修改。不要只保留一个 gpt-5.5 条目。手动修改时，请确认 models 数组中包含 gpt-5.5 条目，并保留其他已有模型配置。如果你不熟悉 JSON，建议使用下载方式。gpt-5.5 条目应包含类似下面的关键字段：

{
  "slug": "gpt-5.5",
  "display_name": "gpt-5.5",
  "description": "Custom local catalog entry for GPT-5.5 based on gpt-5.4 metadata.",
  "base_instructions": "...",
  "model_messages": {
    "instructions_template": "...",
    "instructions_variables": {
      "personality_default": "",
      "personality_friendly": "...",
      "personality_pragmatic": "..."
    }
  },
  "supports_reasoning_summaries": true,
  "support_verbosity": true,
  "context_window": 272000
}

上面的代码块只展示单个模型条目的关键结构。完整文件请以下载文件或你现有的完整模型目录为准。

在 Codex 配置中引用 JSON 文件

打开 Codex 主配置文件 ~/.codex/config.toml，添加或合并以下配置。macOS / Linux 示例：

model_catalog_json = "/Users/YOUR_USER/.codex/custom-models.json"
model_provider = "custom"
model = "gpt-5.5"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
windows_wsl_setup_acknowledged = true

[model_providers]
[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

Windows 示例：

model_catalog_json = "C:\\Users\\YOUR_USER\\.codex\\custom-models.json"

model_catalog_json 使用本机绝对路径。Windows 路径写在 TOML 双引号字符串里时，建议把 \ 写成 \\。

重启 Codex

修改配置文件后，结束当前 Codex 进程，并在新终端会话中启动：

codex

排查建议

如果仍然无法使用 gpt-5.5，按顺序检查：

model_catalog_json 是否是本机绝对路径
custom-models.json 是否保留了完整模型目录
base_url 是否为 https://www.bettertoken.ai/v1
wire_api 是否为 responses
model_provider 是否与 [model_providers.custom] 中的 provider id 保持一致

如果你的 Codex 已经内置支持 gpt-5.5，可以删除 model_catalog_json，改回常规 Codex 接入文档中的配置方式。

Claude Code

Claude Desktop

Codex

Cursor

Cline

模型调用

服务保障

成本与 Token

概念说明

为什么在 Codex 的 API 模式无法使用 GPT-5.5？

配置步骤

排查建议

​配置步骤

​排查建议

配置步骤

排查建议