Codex 接入 #

Codex 使用 OpenAI Responses API。通过自定义 model provider 接入 CoreRouter 时，需要在用户级 config.toml 中配置 Provider，并用环境变量提供 API Key。

Codex 需要当前 Model ID 支持 /v1/responses。如果只支持 /v1/chat/completions，普通聊天可能可用，但 Codex 无法完成 Agent 工作流。

准备工作 #

• 已安装 VS Code 和 Codex。
• 已在 CoreRouter 控制台创建 API Key。
• 已确认要使用的 Model ID 支持 Responses API。
• 已选择适合 Coding Agent 的模型，不要直接复用只支持普通聊天的模型。

配置文件位置 #

默认配置文件：

~/.codex/config.toml

Windows 通常位于：

%USERPROFILE%\.codex\config.toml

如果文件不存在，可以手动创建。

配置 CoreRouter Provider #

model = "responses-model-id"
model_provider = "corerouter"

[model_providers.corerouter]
name = "CoreRouter"
base_url = "https://api.corerouter.tech/v1"
env_key = "COREROUTER_API_KEY"
wire_api = "responses"

设置 API Key #

macOS / Linux：

export COREROUTER_API_KEY="sk-xxxxxxxxxxxxxxxx"

长期生效：

echo 'export COREROUTER_API_KEY="sk-xxxxxxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell：

$env:COREROUTER_API_KEY="sk-xxxxxxxxxxxxxxxx"

用户级永久配置：

[System.Environment]::SetEnvironmentVariable('COREROUTER_API_KEY', 'sk-xxxxxxxxxxxxxxxx', 'User')

验证 Responses API #

curl https://api.corerouter.tech/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COREROUTER_API_KEY" \
  -d '{
    "model": "responses-model-id",
    "input": "Hello"
  }'

如果返回成功 JSON，说明这个 Model ID 的 Responses API 基本可用。

更多原始 API 示例见 Responses API 接入。

测试 Codex #

配置完成后重启 VS Code，打开 Codex，依次测试：

请分析当前项目的目录结构，并告诉我这个项目使用了哪些主要技术。

请创建一个 hello.ts 文件，实现一个 hello 函数，然后运行相关测试并告诉我测试结果。

调用链路 #

VS Code
   -> Codex
   -> OpenAI Responses API
   -> CoreRouter
   -> New API 兼容层
   -> 模型渠道
   -> AI Model

常见问题 #

普通 API 可用，但 Codex 不可用 #

Codex 使用 /v1/responses，不是 /v1/chat/completions。请用同一个 Model ID 单独验证 Responses API。

Base URL 应该怎么填 #

Codex Provider 的 base_url 填 https://api.corerouter.tech/v1。如果填到 /v1/responses，Codex 会继续拼接路径并导致请求失败。

提示 API Key 无效 #

检查：

• 环境变量名是否是 COREROUTER_API_KEY。
• config.toml 中 env_key 是否同名。
• API Key 是否来自 CoreRouter 控制台。

提示找不到模型 #

把 model 改成控制台显示的 Model ID，不要使用展示名称。

Agent 能力不稳定 #

选择支持 Responses、Tool Calling、Streaming 和 Coding Agent 的模型。如果模型只支持普通对话，Codex 可能无法完成文件修改、命令执行或多步骤任务。

安全建议 #

• 不要把 API Key 写进 config.toml。
• 推荐通过 env_key 从环境变量读取 API Key。
• 不要把 ~/.codex/config.toml 提交到项目仓库。
• 为 Codex 创建独立 API Key，并设置额度上限。