Skip to main content
OpenAI 的 Codex CLI 原生讲 Responses API。把它的 base URL 重定向到 ByteSpike 之后，CLI 直接能用 GPT-5 / o-系列目录，再加上网关翻译成 Responses 结构的所有其他模型（Claude 系列、Gemini 系列）。

​
前置条件

  • 一个 ByteSpike 账号 + 一把 key。GPT-5 / o-系列只要 key 落在任意 能服务它们的分组里（通常是 OpenAI / default 分组）。要经 Responses 翻译触达 Claude 或 Gemini，key 的分组必须包含这些模型。
  • 装好 Codex CLI：

​
配置

Codex CLI 读 OPENAI_API_KEY + OPENAI_BASE_URL。两个都设：
如果你这个版本的 Codex CLI 用了一个 Responses-only 的 base URL 覆盖 flag（部分预发布版用 --responses-base-url），显式把 https://llm.bytespike.ai/v1 传进去：

​
验证

Codex 会对网关跑一次小的 Responses-API 调用。你应该看到正常的工具 调用输出（文件列表）。出错的话基本都是配置问题：401 = key 错了、 402 = 钱包空了、400 model_not_allowed = 默认模型不在 key 的 分组里。

​
切换模型

大多数版本的 Codex 接受 --model：
上面三个都能跑 —— gpt-5-* 走 OpenAI 原生路径；Claude id 在 ByteSpike 背后会触发 Responses→Messages 翻译。CLI 完全感知不到这个差别。

​
常见配置

选一把分组包含你需要切换的全部模型的 key（如果你的账号开了 all-protocols 分组通常就用它）。然后 CLI 就能在单个 session 里用 --model 在 OpenAI 原生和 Claude/Gemini 翻译之间切。
透传 Codex 的推理控制项：
网关原样转发 reasoning.effort 字段。价格反映更高的推理 token 输出 —— 详见 价格。
Codex 的 --response-format json_schema=... flag 会作为 response_format 转发到网关，再按模型正确处理（GPT 原生直接 支持 JSON Schema 模式；Claude 路径退化为 text + 解析）。
Codex 的工具定义（--tools=...）作为 Responses-API 的 tools 数组转发。在 GPT 路径上它是原生的；Claude/Gemini 路径上网关 会翻译成目标模型的原生格式（Claude 用 input_schema，Gemini 用 functionDeclarations）。

​
Codex vs Claude Code —— 什么时候用哪个

不少团队 两个都装，按任务挑。用一个 ByteSpike 账号，每个 CLI 单独发一把 key 绑到对应的分组。

​
排错

​
下一步

Claude Code CLI

Anthropic 的编码 CLI，同样的配置思路。

/responses 参考

Codex 讲的协议。

Models

GPT-5 / o-系列目录。

Cursor IDE

编辑器层集成。