跳转到主要内容
截至 2026-04-24,部分 Codex 版本在自定义 API 模式下可能无法直接选择 gpt-5.5。这是 Codex 本地模型目录尚未包含该模型导致的显示和选择限制,不代表 LLMEasy 的 https://www.llmeasy.ru/v1 端点不可用。 你可以先添加一个本地 custom-models.json,让 Codex 识别 gpt-5.5,再在 ~/.codex/config.toml 中引用它。官方后续版本若已经内置支持 gpt-5.5,优先使用 Codex 的内置方案。
请使用页面提供的完整 custom-models.json。如果你要手动调整文件,请保留里面已有的模型条目和字段,只修改需要调整的模型配置。

配置步骤

1

准备自定义模型配置文件

自定义模型配置文件路径为 ~/.codex/custom-models.json
下载完整模型目录文件:下载 custom-models.json下载后,将文件放到 Codex 配置目录,并命名为 custom-models.json
系统目标路径
macOS / Linux~/.codex/custom-models.json
WindowsC:\Users\YOUR_USER\.codex\custom-models.json
下载得到的是完整模型目录文件,后续步骤会在 Codex 配置里引用它。
2

在 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 = "LLM Easy"
base_url = "https://www.llmeasy.ru/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 双引号字符串里时,建议把 \ 写成 \\
3

重启 Codex

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

排查建议

如果仍然无法使用 gpt-5.5,按顺序检查:
  1. model_catalog_json 是否是本机绝对路径
  2. custom-models.json 是否保留了完整模型目录
  3. base_url 是否为 https://www.llmeasy.ru/v1
  4. wire_api 是否为 responses
  5. model_provider 是否与 [model_providers.custom] 中的 provider id 保持一致
如果你的 Codex 已经内置支持 gpt-5.5,可以删除 model_catalog_json,改回常规 Codex 接入文档 中的配置方式。