Codex 是什么
Codex 是 OpenAI 面向软件开发的编程代理。你可以配置自定义模型提供商，让 Codex 通过 Capriole AI 的 Responses 兼容 API 使用 Capriole AI。前置条件
开始前请确保你已经拥有以下内容。安装
Codex CLI
Codex app
从 OpenAI Codex 下载应用。配置
创建或更新~/.codex/config.toml。
运行 Codex
设置 API Key，然后启动 Codex。支持的模型
Codex 通过 Responses API 使用 Capriole AI 提供的 OpenAI 模型。使用下面的原生模型 ID，即可沿用 Codex 内置的模型选择和推理设置，无需自定义model_catalog_json。只能调用 Capriole AI 已支持的模型。
gpt-6-astragpt-6.1-solgpt-6-solgpt-6-lunagpt-5.6-terragpt-5.6-lunagpt-5.5
gpt-6.1-sol 需要 Codex 0.159.2 或更高版本。更早的版本没有该模型的元数据，会退回通用设置。
API 也接受带 openai/ 前缀的模型 ID 和 openai-latest。openai-latest 会跟随 Capriole AI 推荐的 OpenAI 旗舰模型。
故障排除
为什么 Codex 返回身份验证错误
运行codex 前，确认已在同一个 Shell 中导出 CAPRIOLE_AI_API_KEY。
为什么 Codex 找不到模型
确认已经设置model_provider = "capriole_ai"，并确认 model 是 openai-latest 或 Capriole AI 支持的 OpenAI 模型 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 环境中，不会写入配置文件。 - 官方参考资料包括 Codex CLI、Codex 配置基础、Codex 配置参考和配置示例。