BLOG

Codex 接入 GPT-5.5 配置指南

RootFlowAI 文档站迁移内容。

Codex 接入 GPT-5.5 配置指南

在使用 codex-cli 或 codex-app 时，许多开发者希望能够通过第三方 API 接入 GPT-5.5。然而，目前最新版本在只支持官方 ChatGPT 登录的条件下，直接使用 codex --model gpt-5.5 会发生回退（fallback）。这是因为最新的 Codex 源码中缺乏内置的 gpt-5.5 的 model info。

通过以下配置方法，你可以通过 RootFlow AI 中转服务使用 GPT-5.5。

前提条件

已注册 RootFlow AI 并获取 API Key（获取方式）
已安装 Codex CLI（安装教程）
确保网络环境正常

详细配置步骤

步骤 1：下载 Model Catalog 文件（最关键）

你需要一个 model_catalog.json 文件，其中定义了 gpt-5.5 及其他 GPT-5 系列模型的属性。该文件会告诉 Codex 如何与这些模型交互。

点击下载：model_catalog.json

该文件包含以下模型定义：

| 模型 | 说明 | |------|------| | gpt-5.5 | 最新前沿模型，支持复杂编码、研究和实际工作 | | gpt-5.4 | 前沿 agentic 编码模型 | | gpt-5.4-mini | 轻量版前沿编码模型 | | gpt-5.3-codex | Codex 优化的编码模型 | | gpt-5.2 | 专业工作和长时间运行 agent 优化 |

步骤 2：放置配置文件

将下载的 model_catalog.json 放到你的 .codex 目录下：

# macOS / Linux
mv ~/Downloads/model_catalog.json ~/.codex/model_catalog.json

步骤 3：更新核心配置

打开或创建你的 Codex 配置文件（~/.codex/config.toml），加入以下内容：

model_provider = "rootflowai"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_catalog_json = "/Users/xxx/.codex/model_catalog.json" # 替换为你实际的绝对路径

[model_providers.rootflowai]
name = "rootflowai"
base_url = "https://api.rootflowai.com/v1"
wire_api = "responses"
requires_openai_auth = true

model_catalog_json 必须填写绝对路径，不支持 ~ 等缩写。

步骤 4：设置 API Key

确保你的环境变量中已配置 RootFlow AI 的 API Key：

export OPENAI_API_KEY="sk-你的RootFlowAI密钥"

建议将此行添加到 ~/.zshrc 或 ~/.bashrc 中以持久化。

步骤 5：验证接入

启动 Codex，确认模型已正确加载：

codex --model gpt-5.5

如果一切配置正确，Codex 将通过 RootFlow AI 中转服务使用 GPT-5.5 进行交互。