> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 在 Codex 自定义 API 模式中临时启用 GPT-5.5 的本地模型目录配置。

截至 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 的内置方案。

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

## 配置步骤

<Steps>
  <Step title="准备自定义模型配置文件">
    自定义模型配置文件路径为 `~/.codex/custom-models.json`。

    <Tabs>
      <Tab title="下载 JSON 文件">
        下载完整模型目录文件：

        <a href="/images/downloads/custom-models-gpt-5.5.png" download="custom-models.json">下载 custom-models.json</a>

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

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

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

      <Tab title="手动修改 JSON 文件">
        如果你已经有 `~/.codex/custom-models.json`，请在现有文件基础上修改。不要只保留一个 `gpt-5.5` 条目。

        手动修改时，请确认 `models` 数组中包含 `gpt-5.5` 条目，并保留其他已有模型配置。如果你不熟悉 JSON，建议使用下载方式。

        `gpt-5.5` 条目应包含类似下面的关键字段：

        ```json theme={null}
        {
          "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
        }
        ```

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

  <Step title="在 Codex 配置中引用 JSON 文件">
    打开 Codex 主配置文件 `~/.codex/config.toml`，添加或合并以下配置。

    macOS / Linux 示例：

    ```toml theme={null}
    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 示例：

    ```toml theme={null}
    model_catalog_json = "C:\\Users\\YOUR_USER\\.codex\\custom-models.json"
    ```

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

  <Step title="重启 Codex">
    修改配置文件后，结束当前 Codex 进程，并在新终端会话中启动：

    ```bash theme={null}
    codex
    ```
  </Step>
</Steps>

## 排查建议

如果仍然无法使用 `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 接入文档](/zh/ai-tools/codex) 中的配置方式。