Documentation Index
Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
Use this file to discover all available pages before exploring further.
截至 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。下载完整模型目录文件：下载 custom-models.json下载后，将文件放到 Codex 配置目录，并命名为 custom-models.json。| 系统 | 目标路径 |
|---|
| macOS / Linux | ~/.codex/custom-models.json |
| Windows | C:\Users\YOUR_USER\.codex\custom-models.json |
如果你已经有 ~/.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_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
env_key = "BETTERTOKEN_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 300000
[profiles.bt-gpt-5-5]
model = "gpt-5.5"
model_provider = "bettertoken"
model_reasoning_effort = "high"
model_catalog_json = "C:\\Users\\YOUR_USER\\.codex\\custom-models.json"
model_catalog_json 使用本机绝对路径。Windows 路径写在 TOML 双引号字符串里时，建议把 \ 写成 \\。 设置 BetterToken API Key
在终端中设置环境变量：export BETTERTOKEN_API_KEY="YOUR_API_KEY"
~/.zshrc 或 ~/.bashrc 中。 重启并选择配置
修改配置文件或环境变量后，结束当前 Codex 进程，并在新终端会话中启动：codex --profile bt-gpt-5-5
排查建议
如果仍然无法使用 gpt-5.5，按顺序检查：
model_catalog_json 是否是本机绝对路径custom-models.json 是否保留了完整模型目录base_url 是否为 https://www.bettertoken.ai/v1wire_api 是否为 responsesBETTERTOKEN_API_KEY 是否已在启动 Codex 的同一个终端会话中生效
如果你的 Codex 已经内置支持 gpt-5.5，可以删除 model_catalog_json，改回常规 Codex 接入文档 中的配置方式。
