Grok 4.5 接入 Codex CLI 配置方法

背景

Codex CLI 是一款面向开发者的 AI 编码助手，支持通过自定义 provider 接入多种大语言模型。Grok 4.5 是 xAI 推出的最新模型，在推理、代码生成等任务上表现出色。然而 Codex 原生并不直接支持 Grok API，需要通过一个中间网关（CPA，Codex Proxy Agent）将 OpenAI 兼容的接口请求转发到 xAI 的 OAuth 认证池，再由 CPA 调用 xAI Grok API。本文分享的配置方法解决了直接接入时常见的报错、文件选择、网络搜索、自动审查不可用等问题，提供了一套完整、经过实测的接入方案。

核心内容

整套配置的架构为：Codex → 本地 CPA 网关（127.0.0.1:8317） → CPA xAI OAuth 账号池 → xAI Grok API。关键配置分为三部分：

1. Codex 主配置

文件路径为 /root/.codex/config.toml。主要参数：

• model_provider = "grok"（自定义 provider 名称）
• model = "grok-4.5"（默认使用模型）
• model_catalog_json = "/root/.codex/model_catalog.json"（指定模型元数据文件路径）
• model_reasoning_effort = "medium"（推理努力程度）
• disable_response_storage = true（禁用响应存储）
• personality = "pragmatic"（人格设定为务实）
• approvals_reviewer = "auto_review"（自动审查模式）

在 [model_providers.grok] 段中设置 provider 细节：

• name = "grok"
• base_url = "http://127.0.0.1:8317/v1"（本地 CPA 网关地址）
• wire_api = "responses"（使用 /v1/responses 协议）
• requires_openai_auth = true（需要使用 auth.json 中的 OpenAI 风格 key）

2. API Key 配置

文件路径：/root/.codex/auth.json，内容格式为：

{
  "OPENAI_API_KEY": "sk-xxxxxxx"
}

说明：此处的 sk-xxx 并非 xAI 官方 API key，而是对应 CPA 网关 config.yaml 中定义的 api-keys 值。CPA 网关收到这个 key 后会验证身份，再通过其 OAuth 账号池转发到 xAI。

3. 模型元数据配置

文件路径：/root/.codex/model_catalog.json。文中仅列出了需要增加的 grok-4.5 模型条目，并指出可以让 Codex 自行搜索并补充其他信息。关键字段包括：

• slug: "grok-4.5"
• display_name: "Grok 4.5"
• description: "Grok 4.5 via custom OpenAI-compatible provider"
• default_reasoning_level: "medium"
• supported_reasoning_levels: 低、中、高、极高四种努力程度
• context_window: 256000
• max_context_window: 256000
• use_responses_lite: false
• supports_reasoning_summaries: true
• input_modalities: ["text", "image"]
• base_instructions: （一个很长的 Codex system prompt）
• model_messages 中的 instructions_template 及对应不同 personality 的变量

关于自动审查（approvals_reviewer = "auto_review"），文中特别说明需要在 CPA 中将 codex-auto-review 映射到 grok-4.5，实现模型自我审查（grok-4.5 审查自己的输出）。

原文还提到这是经过实测的完美方法：Codex 不会报错，可以选择文件、执行网络搜索、自动审查均正常使用。

关键要点

• 架构核心：通过本地 CPA 网关（127.0.0.1:8317）做协议转换，将 Codex 的 OpenAI 兼容请求转发到 xAI Grok API，绕过直接接入的限制。
• 认证方式：Codex 使用 OpenAI 风格的 API key（auth.json），该 key 由 CPA 网关验证，而非直接使用 xAI 的 key。
• 通信协议：必须设置 wire_api = "responses"，即使用 /v1/responses 端点，而非传统的 /v1/chat/completions。
• 模型元数据独立文件：model_catalog.json 中需手动定义 Grok 4.5 的上下文窗口、推理等级、输入模态等参数，否则 Codex 无法识别该模型。
• 自动审查特殊配置：approvals_reviewer = "auto_review" 生效的前提是在 CPA 中将 codex-auto-review 映射回 grok-4.5，形成自我审查闭环。
• 文件路径固定：所有配置文件均位于 /root/.codex/ 目录下，需确保权限正确。
• 实测效果：该配置下 Codex 的文件选择、网络搜索、自动审查功能均可正常使用，无报错。

意义与影响

1. 扩展 Codex 模型生态：Codex CLI 原本主要面向 OpenAI 系列模型，通过此方案可以将 xAI 的最新模型（如 Grok 4.5）无缝集成，让开发者获得更多模型选择，尤其在推理和代码生成上获得 Grok 的独特能力。
2. 降低接入门槛：不需要修改 Codex 源码，仅通过配置文件和一个本地网关即可完成接入，普通开发者也能快速尝试。网关的 OAuth 账号池机制解决了 xAI 官方 API 的认证差异问题。
3. 功能完整性保持：该方案不仅实现了基础对话，还保留了文件操作、网络搜索、自动审查等高级功能，使 Grok 在 Codex 环境下的体验与原生 OpenAI 模型一致。
4. 为其他模型接入提供模板：文中的架构和配置模式（本地网关 + OpenAI 兼容接口 + 模型元数据文件）可推广到其他非 OpenAI 模型（如 Llama、Claude 等），只需修改对应的 provider、base_url 和模型 catalog 即可。
5. 潜在关注点：自动审查采用模型自我审查（grok-4.5 审查自己），可能在安全性和客观性上存在争议；CPA 网关的安全性和稳定性需要运维保障；该方案依赖于 CPA 项目自身的维护和更新。