主题
选择客户端
快米兔 API 同时提供三套协议，所以几乎所有主流 AI 客户端都能接。问题只是——你该用哪个。
决策树
你主要在哪写代码？
│
├─ 终端 / SSH 上
│ ├─ 想要最强的 agentic 编码体验 → Claude Code ⭐ 首选
│ ├─ 习惯 OpenAI 生态、想用 GPT-5 → Codex CLI
│ ├─ 想自由切换任意模型、开源可改 → OpenCode
│ └─ 主用 Gemini → Gemini CLI
│
├─ IDE 里
│ ├─ 愿意换编辑器、要最顺滑的补全 → Cursor
│ ├─ 想留在 VS Code、要 Agent 能力 → Cline
│ └─ 已在用 Windsurf → Windsurf
│
├─ 就想聊天 / 处理文档，不写代码
│ ├─ 桌面客户端 → ChatBox / Cherry Studio
│ ├─ 自己部署的 Web 端 → NextChat / LobeChat
│ └─ 图形化 Agent → AionUI
│
└─ 我自己写程序调接口 → 原生 API 调用一览表
| 客户端 | 类型 | 走的协议 | 推荐分组 | 文档 |
|---|---|---|---|---|
| Claude Code | CLI | Anthropic /v1/messages | default / Claude Code Max | 配置 |
| Codex CLI | CLI | Responses / Chat Completions | Openai | 配置 |
| OpenCode | CLI | OpenAI 兼容 / Anthropic | default | 配置 |
| Gemini CLI | CLI | Gemini /v1beta | Gemini | 配置 |
| Cursor | IDE | OpenAI 兼容 | Openai | 配置 |
| Cline | VS Code 插件 | OpenAI 兼容 / Anthropic | default | 配置 |
| Windsurf | IDE | OpenAI 兼容 | Openai | 配置 |
| AionUI | GUI | Gemini / OpenAI 兼容 | default | 配置 |
| Claude Desktop | GUI | 官方不支持自定义端点 | — | 替代方案 |
| ChatBox / Cherry / NextChat / LobeChat | GUI | OpenAI 兼容 | default | 配置 |
| CC Switch | 管理工具 | —（改配置文件） | — | 配置 |
三个 Base URL，别记混
这是新用户最常踩的坑。同一把令牌，不同客户端要填不同的地址：
| 客户端填什么字段 | 填的值 | 谁在用 |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.52pay.com | Claude Code、Anthropic SDK |
OpenAI 兼容 Base URL | https://api.52pay.com/v1 | Cursor、Cline、ChatBox、OpenAI SDK |
Gemini base url | https://api.52pay.com | Gemini CLI、Gemini SDK |
最高频的两个错误
- Anthropic 协议不要加
/v1。Claude Code 会自己拼/v1/messages，你再加一次就变成/v1/v1/messages→ 404。 - OpenAI 兼容协议必须加
/v1。少了它请求会打到网页路由上，返回一坨 HTML 而不是 JSON。
判断方法：填完之后如果报 404 或者返回内容以 <!DOCTYPE html> 开头，八成就是这里错了。
认证头对照
不同协议用的认证头不一样，快米兔 API 三种都认：
| 协议 | 请求头 |
|---|---|
| OpenAI 兼容 | Authorization: Bearer <令牌> |
| Anthropic | x-api-key: <令牌> 或 Authorization: Bearer <令牌> |
| Gemini | x-goog-api-key: <令牌> 或 URL 参数 ?key=<令牌> |
还是不确定？
先装 Claude Code。 它是目前编码能力最强、生态最完整的选择，本站也针对它做了专线优化（Claude Code Max 分组）。