Codex 是什么
Codex 是 OpenAI 面向软件开发的编程智能体。你可以配置自定义模型提供商,让 Codex 把请求发送到 Capriole AI 的 Responses 兼容 API。前置条件
开始前请确保你已经拥有以下内容。- Capriole AI 账户,可在此处注册
- Premium 方案(每月 USD 9,还包含无限网页聊天)或 Team 方案,获取 API Key 需要其中之一,可在此处订阅
- Capriole AI API Key,可在此处获取
安装
Codex CLI
使用官方安装程序安装 Codex CLI。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-astragpt-6.2-solgpt-6-astragpt-6.1-solgpt-6-solgpt-6-lunagpt-5.6-terragpt-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。
说明
- 此配置使用
env_key,API Key 会保留在 Shell 环境中,不会写入配置文件。 - 想在其他编程智能体中使用同一个 API Key,请参阅使用一个 API Key 配置编程智能体。
- 官方参考资料包括 Codex CLI、Codex 配置基础、Codex 配置参考和配置示例。

