跳转到主要内容
只需一个 Capriole AI API Key,就能在 Codex 中使用 GPT-6.2 Astra 和 GPT-6.2 Sol,价格比官方 API 最多低 92%。

Codex 是什么

Codex 是 OpenAI 面向软件开发的编程智能体。你可以配置自定义模型提供商,让 Codex 把请求发送到 Capriole AI 的 Responses 兼容 API。

前置条件

开始前请确保你已经拥有以下内容。
  • Capriole AI 账户,可在此处注册
  • Premium 方案(每月 USD 9,还包含无限网页聊天)或 Team 方案,获取 API Key 需要其中之一,可在此处订阅
  • Capriole AI API Key,可在此处获取

安装

Codex CLI

使用官方安装程序安装 Codex CLI。
也可以使用 npm 安装。
验证安装。

Codex 应用

从 OpenAI Codex 下载应用。

配置

模型验证

使用下方配置,Codex CLI 0.169.1 经 Capriole AI 通过了文件读取、文件写入和最终答案检查。 创建或更新 ~/.codex/config.toml。
各项设置的作用如下。
  • model 是默认模型。可以在会话中通过 /model 更改,也可以在命令行中通过 --model 更改。
  • model_provider 选择在它下方定义的 Capriole AI 提供商。
  • base_url 包含 /v1,因为 Codex 会自行添加 /responses。
  • wire_api = "responses" 使用 Responses API,这是 Codex 自定义提供商唯一支持的协议。
  • env_key 从环境变量读取你的 API Key,并以 Bearer Token 形式发送。

运行 Codex

设置 API Key,然后在项目目录中启动 Codex。
如需非交互式运行,请使用 codex exec。

支持的模型

Codex 通过 Responses API 使用 Capriole AI 提供的 OpenAI 模型。使用下面的原生模型 ID,即可沿用 Codex 内置的模型选择器和推理设置,无需自定义 model_catalog_json。
  • gpt-6.2-astra
  • gpt-6.2-sol
  • gpt-6-astra
  • gpt-6.1-sol
  • gpt-6-sol
  • gpt-6-luna
  • gpt-5.6-terra
  • gpt-5.6-luna
使用 gpt-6.2-astra 和 gpt-6.2-sol 需要 Codex 0.169.1 或更高版本,使用 gpt-6.1-sol 需要 0.159.2 或更高版本。更早的版本没有这些模型的元数据,会退回通用设置。 API 也接受带 openai/ 前缀的模型 ID 和 openai-latest。openai-latest 别名会跟随 Capriole AI 推荐的 OpenAI 旗舰模型。 由于 Capriole AI 在 Responses API 上提供 Grok,Codex 也可以通过同一个提供商运行 xai/grok-4.7。 Codex 只内置了 OpenAI 原生模型 ID 的元数据。对于 openai-latest 和 xai/grok-4.7,它会输出 Model metadata ... not found 并使用后备设置。会话仍可正常进行,但使用 gpt-6.2-astra 等原生 ID 效果最好。

故障排除

为什么 Codex 返回身份验证错误

运行 codex 前,确认已在同一个 Shell 中导出 CAPRIOLE_AI_API_KEY。

为什么 Codex 找不到模型

确认已经设置 model_provider = "capriole_ai",并确认 model 是“支持的模型”一节中列出的 ID 之一。

为什么请求出现端点或协议错误

确认 [model_providers.capriole_ai] 下设置了 base_url = "https://api.caprioletech.com/v1" 和 wire_api = "responses"。

为什么 Codex 忽略 Capriole AI 提供商

不要使用 openai 等保留的内置提供商 ID。自定义提供商 ID 请保持为 capriole_ai。

为什么配置修改没有生效

确认 ~/.codex/config.toml 是当前生效的用户配置文件。如需依赖项目级 .codex/config.toml,请先信任该项目,然后重新启动 Codex。

说明

最后修改于 2026年11月18日