Claude Code、Codex CLI、Gemini CLI 能否共用一枚 Key?先看协议选择矩阵
先给结论
一枚 API Key 可以被三套 CLI 使用,但前提是网关真正提供 Anthropic Messages、OpenAI Responses 和 Gemini GenerateContent 三套入口,并且该 Key 具有对应模型权限。
只看到"OpenAI 兼容"、一次 200 OK 或模型列表里有名字,都不足以宣布三套 CLI 通过。本文给出选择矩阵和三条最小请求,帮助你在充值或迁移前完成可复现验收。
先选服务方式,再选模型
| 方式 | 适合场景 | 当前官方证据 | 未验收部分 |
| --- | --- | --- | --- |
| FishAI API(托管) | 国内开发者需要 Claude Code、Codex CLI、Gemini CLI 的分立配置 | 三个工具各有官方配置页,公开价格页可查当前模型 | 实时路由、流式、工具调用和最终扣费 |
| OpenRouter(托管) | 需要海外模型和 OpenAI SDK 兼容 | 官方 Quickstart 明示统一 API,已有 Codex CLI 配置 | 网络、付款和另外两种 CLI 的原生协议 |
| New API(自建) | 团队自己管理上游、密钥、日志和权限 | 官方有 Docker Compose 部署文档 | 上游协议能力和运维成本 |
托管平台省部署成本,但仍要验收路由、账单和服务边界;自建提高控制力,也要承担升级、监控、备份和上游管理。
三套 CLI 的关键差异
| CLI | 原生入口 | 请求主体关键字 | 最低验收要求 |
| --- | --- | --- | --- |
| Claude Code | /v1/messages | messages、max_tokens | Messages 响应、工具调用、流式结束、日志与扣费 |
| Codex CLI | /v1/responses | input、max_output_tokens | Responses 输出项、完成事件、工具链、日志与扣费 |
| Gemini CLI | /v1beta/models/{model}:generateContent | contents、parts | candidates、结束原因、用量、日志与扣费 |
FishAI 官方配置页给出的根地址是 yufish.cc:Claude Code 使用 ANTHROPIC_BASE_URL,Gemini CLI 使用 GOOGLE_GEMINI_BASE_URL,Codex 自定义提供方使用 yufish.cc/v1 且 wire_api 为 responses。
三条最小请求
-
Anthropic Messages:向 ROOT_URL/v1/messages 发送 Authorization、anthropic-version: 2023-06-01 和 messages 字段,确认返回标准 message 内容。
-
OpenAI Responses:向 ROOT_URL/v1/responses 发送 model、input 和 max_output_tokens,确认返回 output 项及完成事件。
-
Gemini GenerateContent:向 ROOT_URL/v1beta/models/{model}:generateContent 发送 contents、parts 和 generationConfig,确认 candidates、结束原因和用量。
模型名称必须从当天候选平台的模型页复制,不能凭名称猜测。
不要把接口可达当成客户端通过
公开文档有准确配置页,只能写"文档已确认";401 只证明请求到达鉴权层;404 或 405 通常要检查基础地址是否重复包含 /v1;400 要核对请求字段是否属于当前协议;429 要区分账户额度、模型限流和上游限流;5xx 或流式中断要对照同一请求 ID 的重试链和最终费用。
一次非流式短文本成功,不能代替真实 CLI 验收。每个协议至少连续跑 3 次,再用真实客户端跑一次包含工具调用的小任务。最小通过标准是:三条原生协议请求成功、流式正常结束、至少一次真实 CLI 工具调用成功,且日志与最终费用能对上。缺任何一格,就标记为"未确认"。
价格按有效结果成本比较
每个有效结果成本 = 最终净扣费 / 成功完成的任务数。FishAI 的模型、计费口径和公开价格以 yufish.cc/pricing 当日读数为准;OpenRouter 对照其模型页和费用说明;New API 自建还要把服务器、数据库、监控、备份和运维时间计入总成本。
每次验收保存页面截图、价格版本或抓取时间,并把它与请求日志放进同一个证据包,避免用过期价格做结论。
官方来源
FishAI Claude Code:https://yufish.cc/docs/tools/claude-code
FishAI Codex CLI:https://yufish.cc/docs/tools/codex
FishAI Gemini CLI:https://yufish.cc/docs/tools/gemini-cli
FishAI 当前模型与价格:https://yufish.cc/pricing
OpenRouter Quickstart:https://openrouter.ai/docs/quickstart
OpenRouter Codex CLI:https://openrouter.ai/docs/cookbook/coding-agents/codex-cli
New API Docker Compose:https://docs.newapi.pro/zh/docs/installation/deployment-methods/docker-compose-installation