选择客户端

按你用的软件，选哪一个。

快米兔API配置助手

建议先用 快米兔API配置助手。勾选已经装好的软件和模型，登录后点「确认」。国内版和海外版 WorkBuddy 都能勾选。Claude Code 换模型用 CC Switch。

决策树

你主要在哪写代码？
│
├─ 终端 / SSH 上
│   ├─ 想让 AI 在终端里改项目  → Claude Code    
│   ├─ 习惯 OpenAI 生态、想用 GPT-5 → Codex CLI
│   ├─ 想自由切换任意模型、开源可改 → OpenCode
│   ├─ 主用 Gemini                  → Gemini CLI
│   └─ 终端智能体 Hermes             → Hermes
│
├─ IDE 里
│   ├─ 愿意换编辑器、要最顺滑的补全 → Cursor
│   ├─ 想留在 VS Code、要 Agent 能力 → Cline
│   └─ 已在用 Windsurf              → Windsurf
│
├─ 就想聊天 / 处理文档，不写代码
│   ├─ 桌面客户端                   → ChatBox / Cherry Studio
│   ├─ 自己部署的 Web 端            → NextChat / LobeChat
│   ├─ 图形化 Agent                 → AionUI
│   ├─ WorkBuddy / 海外版 WorkBuddy AI → WorkBuddy
│   └─ 要调节思考档位               → DSH
│
└─ 我自己写程序调接口               → 原生 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	配置
WorkBuddy	GUI	OpenAI 兼容，国内版和海外版都填 /v1	default	配置
Hermes Agent	CLI	OpenAI 兼容，地址填到 /v1	default	配置
DeepSeek Harness	桌面 / 网页	OpenAI 对话接口	default	配置
Toonflow（短剧视频生成工作台）	桌面	短剧视频生成工作台，文件在本机。分组选自动选组	auto	配置
Claude Desktop	GUI	官方不支持自定义端点	—	替代方案
ChatBox / Cherry / NextChat / LobeChat	GUI	OpenAI 兼容	default	配置
快米兔API配置助手	管理工具	勾选已经装好的软件	—	配置
CC Switch	管理工具	—（改配置文件）	—	配置

三个地址

同一把令牌，不同软件填的地址不一样：

客户端填什么字段	填的值	谁在用
ANTHROPIC_BASE_URL	https://api.52pay.com	Claude Code、Anthropic SDK
OpenAI 兼容 Base URL	https://api.52pay.com/v1	Cursor、Cline、ChatBox、OpenAI SDK
WorkBuddy 接口地址	https://api.52pay.com/v1	WorkBuddy 国内版和海外版
Gemini base url	https://api.52pay.com	Gemini CLI、Gemini SDK

地址怎么填

1. Claude Code 不要加 /v1。地址只填域名，不要出现 /v1/messages 或 /v1/v1/messages。
2. Cursor、Cline、ChatBox 必须加 /v1。
3. WorkBuddy 国内版和海外版都填 https://api.52pay.com/v1。详见 WorkBuddy。

看到 <!DOCTYPE html> ，回来对一下地址。

请求头怎么写

按协议选下面这一行：

协议	请求头
OpenAI 兼容	Authorization: Bearer <令牌>
Anthropic	x-api-key: <令牌> 或 Authorization: Bearer <令牌>
Gemini	x-goog-api-key: <令牌> 或 URL 参数 ?key=<令牌>

还是不确定？

先看你正在用的软件。 用得最多的是 WorkBuddy、Hermes 和 Codex，照着对应文档填地址就行。

→ WorkBuddy · Hermes · Codex