在 Codex 中使用 Corion AI

Codex CLI 通过 OpenAI Responses API 与 Corion 通信，该 API 由 Corion 在 https://api.corion.ai 上提供。只需一条 config.toml 配置即可接入，无需任何适配器或兼容层。

前提条件

• 已安装 Codex CLI
• 从 控制台 → API 密钥 获取的 Corion API 密钥

配置

Codex 的自定义 provider 路径使用 Responses API（wire_api = "responses" 是唯一支持的传输协议），因此请将 base_url 指向 Corion 的 v1 根路径并设置 provider。

在 ~/.codex/config.toml 中添加：

model_provider = "corion"
model = "kimi-k3"

[model_providers.corion]
name = "Corion AI"
base_url = "https://api.corion.ai/v1"
env_key = "CORION_API_KEY"

然后用环境变量导出 Codex 读取的密钥：

# macOS / Linux
export CORION_API_KEY="your-corion-api-key"

# Windows PowerShell (persistent)
setx CORION_API_KEY "your-corion-api-key"   # restart your terminal after this

env_key 指定 Codex 读取的环境变量名称；密钥本身永远不会写入配置文件。

在运行任何任务之前，先确认你的密钥可以看到这些模型：

curl https://api.corion.ai/v1/models -H "Authorization: Bearer $CORION_API_KEY"

你应该会看到返回 kimi-k3、deepseek-v4-pro-0813 和 deepseek-v4-flash-0731。

随时切换模型：

codex -m kimi-k3
codex -m deepseek-v4-flash-0731

可用模型：kimi-k3（100 万上下文，最大输出 12.8 万 token）、deepseek-v4-pro-0813（100 万上下文，最大输出 37.5 万 token）、deepseek-v4-flash-0731（100 万上下文，最大输出 6.4 万 token）。

验证

一次最简单的非交互运行——看到一连串的推理过程加上最终答案，就说明认证、路由和计费都已正常工作：

codex exec "Reply with exactly: pong"

预期输出中头部应显示 model: kimi-k3、provider: corion，结尾有 token 计数，答案为 pong。如果返回 401，说明密钥错误或残缺——Corion 只在创建时完整显示一次密钥，请到控制台重新生成一个。

在让 Codex 执行修改操作之前，先运行一个只读任务——例如 codex exec "summarize this directory"——确认回复和工具调用都正常后，再开启写入权限。

说明与限制

• 协议正确，无需适配器。 Codex 与自定义 provider 通信时只使用 Responses API，而大多数兼容 OpenAI 的路由器并不提供该 API。Corion 原生支持，因此这是直连，不是 chat-completions 兼容层。

• Model metadata ... not found 警告——无害。 启动时 Codex 会查询 /v1/models 并期望一种 Corion 未返回的数据结构，因此会记录 missing field 'models'，然后对未知模型 ID 回退到默认元数据。生成不受影响。你可以通过固定真实限制来消除这种猜测行为：

  model_context_window = 1048576        # kimi-k3 / deepseek-v4-flash-0731
  model_auto_compact_token_limit = 900000
  

• 流式输出正常可用；Codex 从 Corion 流式接收 Responses 事件的方式与从 OpenAI 完全一致。

如遇其他请求错误，请参阅错误与重试。

资料来源：Codex CLI 配置参考、Codex CLI 概览。