CLI 与 API 的差异

专用命令行工具（Claude Code、Codex、Gemini CLI、Grok）和通用 API 客户端（Cherry Studio、自己写调用）走的不是同一套请求格式。这篇文章说明区别，以及为什么要按客户端填对地址。

核心区别

CLI 和 API 是完全不同的接口

虽然都可能调用同一个模型（比如 Gemini），但 CLI 工具和标准 API 客户端走的通道不一样：

• CLI 工具（如 Gemini CLI）→ 该工具自己的 CLI 接口 → 模型
• API 调用（如 Cherry Studio）→ 标准 API 接口 → 模型

这两种接口的请求格式、响应格式、参数结构都不一样。

本站也不做「全部转成 OpenAI 格式」，所以地址按协议填，见 5 分钟接入：

• Claude：https://aicode.cat（不要 /v1）
• GPT：https://aicode.cat/v1（要 /v1）
• Gemini：https://aicode.cat/v1beta（要 /v1beta）

为什么不能混用？

如果在 CLI 工具里填了另一种协议的地址，或在 API 客户端里把三个服务填成同一个 URL，会导致：

• 同样的模型，表现出不同的能力
• 部分功能无法正常工作
• 出现难以排查的奇怪问题

正确的使用方式

CLI：用于编程工具

只在对应的命令行工具里，填该工具协议的地址：

客户端	Base URL
Claude Code	https://aicode.cat
Codex（终端 / 桌面）	https://aicode.cat/v1
Gemini CLI	https://aicode.cat/v1beta
Grok CLI	https://aicode.cat/v1

这些工具内部会使用正确的请求格式与对应接口通信。安装页见 Claude Code、Codex、Codex 桌面版、Gemini CLI、Grok。

API：用于通用客户端

标准 API 调用场景（Cherry Studio、自己写代码）同样按模型服务分别填，不要只填一个地址：

在客户端里选的服务	Base URL
Claude / Anthropic	https://aicode.cat
OpenAI / GPT	https://aicode.cat/v1
Gemini / Google	https://aicode.cat/v1beta

详见 Cherry Studio。

价格差异

CLI 工具和 API 客户端可能对应不同渠道成本：

• 渠道成本不同 — 厂商对 CLI 和 API 可能有不同定价
• 配额限制不同 — QPM（每分钟请求数）和 TPM（每分钟 Token 数）可能不同

具体价格以 套餐站 为准，可能随官方调整而变化。

关于价格变动

价格调整主要有以下原因：

1. 官方调价 — 当 Google、Anthropic、OpenAI 调整定价时，我们会相应更新
2. 渠道成本变化 — 上游成本上升时，价格也需要相应调整

价格调整反映的是上游成本变化。我们会尽量保持稳定，但成本确实上涨时会改价。

常见问题

Q: 我在 Gemini CLI 里用了 GPT 的 /v1 地址，为什么感觉模型变笨了？

因为标准 API 接口没有 CLI 接口预置的编程优化提示词，模型在代码场景下的表现会有差别。Gemini CLI 请用 https://aicode.cat/v1beta。

Q: 可以用 CLI 专用配置来做 API 开发吗？

不建议。CLI 的请求 / 响应格式是为命令行工具设计的，直接拿去写 API 会遇到兼容性问题。自己调用请按上面的 API 表填协议地址。

Q: 为什么不统一成一个地址？

参见 为什么不做 API 格式转换。强行转换会丢失功能、改变模型行为，无法保证与官方一致的体验。

Q: 我的使用量会合并计算吗？

用量和余额以 控制台 / 密钥页 为准，不要按第三方文档假设 CLI 和 API 分户头。

总结

• CLI → 只在对应工具里用对应协议地址（Claude Code、Gemini CLI、Codex、Grok）
• API → Cherry Studio、自定义开发等，按模型服务分别填
• 不要混用 → 混用会导致模型能力表现异常

相关阅读

• 为什么不做 API 格式转换 — 保持原生接口的设计理念
• 套餐与购买 — 套餐与价格以套餐站为准