在 Codex 中使用 Command Code — Provider API 模型 | Codex Router
在 Codex 中使用 Command Code,指的是用 Codex Router 把 Command Code 的 Provider API 接入 Codex 模型选择器。官方 Provider API 是一个 OpenAI 兼容的 Chat Completions 接口加一个 Anthropic Messages 接口,且仅支持 API Key——路由器不再通过 Command Code CLI 登录。
Provider API 是什么
端点是 https://api.commandcode.ai/provider/v1。它提供两种协议,路由器把它们暴露为一个可选族:
| 供应商 ID | 协议 | 典型模型 |
|---|---|---|
commandcode | Chat Completions | DeepSeek、GLM、Kimi、Qwen、MiniMax、GPT、Gemini |
commandcode-messages | Anthropic Messages | Claude Sonnet、Opus、Fable 与 Haiku |
两个 ID 共享同一份存储密钥,启用或停用其中任何一个都会整体切换整个族。
保存密钥
在 Command Code Studio 创建一个 API Key,然后通过隐藏提示保存并启用该供应商:
./bin/model-router codex provider-key commandcode set
./bin/model-router codex providers enable commandcode
存在多个密钥来源时,优先使用环境变量,其次是存储的密钥,最后是 macOS 钥匙串。可接受的变量是 COMMAND_CODE_API_KEY 与 COMMANDCODE_API_KEY。Windows 上用 ./model-router.ps1 codex 加相同命令。
模型目录
以下路线随注册表发布:
| Picker label | Model ID |
|---|---|
| DeepSeek V4 Flash | commandcode/deepseek-v4-flash |
| DeepSeek V4 Pro | commandcode/deepseek-v4-pro |
| DeepSeek V4.1 Flash | commandcode/deepseek-v4.1-flash |
| GLM-5.2 | commandcode/glm-5.2 |
| GLM-5.3-Flash | commandcode/glm-5.3-flash |
| Kimi K3 | commandcode/kimi-k3 |
| Kimi K2.7 Code | commandcode/kimi-k2.7-code |
| Qwen3.8 Max | commandcode/qwen3.8-max |
| Qwen3.7 Max | commandcode/qwen3.7-max |
| Qwen3.7 Plus | commandcode/qwen3.7-plus |
| MiniMax M3 | commandcode/minimax-m3 |
| MiniMax M2.7 | commandcode/minimax-m2.7 |
| MiMo-V2.5-Pro | commandcode/mimo-v2.5-pro |
| Grok 4.5 | commandcode/grok-4.5 |
| GPT 5.6 Luna | commandcode/gpt-5.6-luna |
| GPT 5.5 | commandcode/gpt-5.5 |
| Gemini 3.5 Flash | commandcode/gemini-3.5-flash |
| Hy3 | commandcode/hy3-paid |
| Hy4 Preview | commandcode/hy4-preview |
| Step 3.7 Flash | commandcode/step-3.7-flash |
| Claude Sonnet 5 | commandcode-messages/claude-sonnet-5 |
| Claude Opus 4.8 | commandcode-messages/claude-opus-4.8 |
| Claude Fable 5 | commandcode-messages/claude-fable-5 |
| Claude Haiku 4.5 | commandcode-messages/claude-haiku-4.5 |
实时目录无需认证即可在 https://api.commandcode.ai/provider/v1/models 获取。用 ./bin/curate-models commandcode 按机器添加更多模型。用 COMMANDCODE_BASE_URL 覆盖端点;两条路线都会遵循它,因此被重定向的供应商仍保持一致。
commandcode/deepseek-v4.1-flash 现已声明文本与图片输入,与其它 V4.1 Flash 路线一致:Command Code 为该模型记录了图片输入能力,其 Provider FAQ 也说明消息内容是文本与图片、没有逐模型的前置门槛,因此粘贴的截图会直接交给模型,而不是走视觉桥。commandcode/glm-5.3-flash 使用模型的 low · high · max 档位并带上 ox-alpha 收敛,使没有 max 的 Codex 版本不会发出模型按名拒绝的 xhigh,同时与其它 GLM-5.3-Flash 路线一样在 400K 处压缩。两个条目都提升了 compHash;请重建目录并完全退出、重新打开 Codex 后再粘贴图片。
Go 套餐回退
尽管 Go 套餐账户的 Key 有效,/provider/v1 仍会以 403 upgrade_required 拒绝它。当这个精确的权益响应在任何响应字节被转发之前到达时,路由器会通过 Command Code 的 /alpha/generate 传输重试该转轮,并为该凭据记住结果。其它 403、超时、限流与服务端故障不会触发回退。该路线会被定期复查,因此升级后的账户会回到文档所述的 Provider API。两条路径使用同一份存储密钥。
CLI 不能替代 harness
Command Code 的无头 CLI 是一个完整的自主编码代理,拥有自己的工作区、工具、权限决策、会话与压缩。把它放在单个 Codex Responses 请求背后启动,会制造第二个隐藏的工具循环,并绕过 Codex 的工具事件与审批。因此它无法透明地替代 Codex harness,Codex 仍然是 harness。路由器只适配模型传输,并保留 Command Code 报告的缓存 token 用量。
验证集成
./bin/model-router codex doctor
./bin/model-router codex providers
./bin/test-model 'commandcode/glm-5.2' --live --yes
供应商必须报告 SHOW 与 ready。完全退出 Codex、重新打开、新建任务并检查选择器。条目缺失见模型缺失。
供应商策略
Command Code 可能限制或封禁代理流量。通过 Codex Router 路由其模型风险自负;依赖之前请查阅 Command Code 条款。
常见问题
Codex 中的 Command Code Provider API 是什么? 它是 Command Code 在 https://api.commandcode.ai/provider/v1 上的 OpenAI 兼容 Chat Completions 接口,外加一个 Anthropic Messages 接口。Codex Router 把它们适配进 commandcode 供应商族下的 Codex 选择器。
Codex Router 会通过 Command Code CLI 登录吗? 不会。该路线仅支持 API Key。在 Command Code Studio 创建一个 Key,然后用 ./bin/model-router codex provider-key commandcode set 保存。
使用 Command Code Go 套餐时会怎样? 当 /provider/v1 返回精确的、响应字节发出前的 403 upgrade_required 时,路由器会通过 /alpha/generate 重试,并为该凭据记住这一结果。其它 403、超时与限流不会触发回退。