客户端与编程工具配置
本页汇总猫咖啡 API 支持的常用客户端、AI 编程 CLI 和 IDE 插件。开始前，请先在令牌管理创建独立 API 令牌，并从控制台模型广场复制准确模型 ID。
先确认接口地址
| 协议 | Base URL | 常见工具 |
|---|---|---|
| OpenAI 兼容 | https://coffeecatbox.cc/v1 | Cherry Studio、OpenCode、Cline、Roo Code、Continue、Aider |
| OpenAI Responses | https://coffeecatbox.cc/v1 | Codex、Grok Build |
| Anthropic Messages | https://coffeecatbox.cc | Claude Code |
| Gemini 原生 | https://coffeecatbox.cc | Gemini CLI |
模型必须匹配协议
工具能连接接口不代表任意模型都适合它。Codex 优先选择支持 Responses 和工具调用的编程模型；Claude Code 选择支持 Anthropic Messages 与工具调用的 Claude 类模型；Gemini CLI 选择支持 Gemini 原生格式的模型。以控制台当前模型与渠道能力为准。
图形化配置工具
- CC Switch：统一管理 Claude Code、Codex、Gemini CLI、OpenCode 等工具，适合频繁切换配置。
- Cherry Studio：通用桌面聊天客户端。
- Chatbox：轻量桌面聊天客户端。
- NextChat：可自托管的 Web 聊天界面。
AI 编程 CLI
- Claude Code：Anthropic Messages 协议的终端编程代理。
- Codex：OpenAI Responses 协议的终端与 IDE 编程代理。
- Gemini CLI：Gemini 原生协议的终端编程代理。
- Grok Build：Responses 协议的终端编程工具。
- OpenCode：支持自定义 OpenAI 兼容提供商的开源编程代理。
- Aider：面向 Git 仓库的终端结对编程工具。
- Hermes Agent：可扩展的终端与消息平台智能代理。
IDE 插件
- Cline 与 Roo Code：VS Code 中的编程代理插件。
- Continue：支持 Agent、Chat、Edit 等角色的 IDE 插件。
- 通用 OpenAI 客户端：适用于其他支持自定义 Base URL 的工具。
Windows 用户
Codex、Claude Code、OpenCode 等工具均可在 Windows 原生或 WSL 中运行。需要 Linux 工具链、沙箱或大型仓库时，建议先阅读 Windows 与 WSL。
通用排查顺序
- 用控制台中实际存在的模型 ID，不要照抄其他站点的模型名。
- 用 curl 验证令牌和接口，再排查客户端。
- 检查最终 URL 是否重复
/v1/v1。 - 确认工具使用的协议与模型渠道匹配。
- 修改配置后退出工具并重新启动。
- 仍失败时记录状态码、错误消息和请求 ID，查看故障排查。