客户端接入总览
本栏目汇总各类客户端、CLI、IDE 插件接入 小关API 的完整配置教程。
先选你的场景
| 你在用什么 | 读这里 | 需要 Node.js |
|---|---|---|
| 完全新手 / 图形界面 | 小白教程（Cherry Studio / Chatbox） | 否 |
| Cherry Studio（国产桌面） | Cherry Studio 配置 | 否 |
| Chatbox（轻量聊天） | Chatbox 配置 | 否 |
| Trae（字节 AI IDE） | Trae 配置 | 否 |
| Cursor | Cursor 配置 | 否 |
| CodeBuddy（腾讯） | CodeBuddy 配置 | 否 |
| MiniMax Code | MiniMax Code 配置 | 否 |
| Zcode | Zcode 配置 | 否 |
| DeepSeek Harness | DeepSeek Harness 配置 | 否 |
| SillyTavern（酒馆） | SillyTavern 配置 | 否 |
| Claude Code（CLI / VS Code 插件） | Claude Code 配置 | 是（仅 CLI） |
| Codex CLI / VS Code 插件 | Codex 配置 | 是 |
| ChatGPT 桌面版 | ChatGPT 桌面版配置 | 否 |
| Claude 桌面版 | Claude 桌面版配置 | 否 |
| Gemini / Antigravity CLI | Gemini 配置 | 否（官方脚本） |
| Grok Build | Grok Build 配置 | 否（官方脚本） |
| Kimi Code CLI | Kimi Code 配置 | 否（官方脚本） |
| GLM（通过 Claude Code） | GLM 配置 | 是 |
| OpenClaw（AI 编程 / 命令行） | OpenClaw 配置 | 是（22+） |
| Hermes Agent（终端长期助手） | Hermes Agent 配置 | 否（Python 3.11+） |
| WorkBuddy（桌面 Agent 工作台） | WorkBuddy 配置 | 否 |
| 用 CC-Switch 统一管理多家 | CC-Switch 配置 | 否 |
| 直接写代码调 API | OpenAI SDK 接入 | 视语言 |
不想一个个试？
先看 Agent 客户端配置大全 —— 17 类客户端的配置在一页里，按需查。
需要先装 Node.js 的，看 Node.js 环境准备。
统一的三个参数
不管用哪个客户端，你只需要填三样东西：
| 参数 | 值 |
|---|---|
| Base URL（OpenAI 协议） | https://api.yzgz.cn/v1 |
| Base URL（Anthropic 协议） | https://api.yzgz.cn（末尾不要加 /v1） |
| API Key | 控制台「令牌管理」里创建，形如 sk-... |
最常见的错误就是 Base URL 写错
- Anthropic 协议（Claude Code 等）：填
https://api.yzgz.cn，不要加/v1 - OpenAI 协议（Codex、SDK 等）：填
https://api.yzgz.cn/v1，必须带/v1
加错或漏掉 /v1，表现是 404 或「找不到 chat/completions」。
分组怎么选
创建令牌时要选令牌分组，它决定这把 key 能调哪些模型。
| 分组 | 说明 |
|---|---|
default | 默认分组，不确定就选它 |
vip | 专属分组，倍率可能更低 |
分组名以控制台实际显示为准。用什么模型就选哪个分组，不要凭名字猜。
模型可用列表建议留空（不额外限制）。填了但写错，请求会返回 403。
配置完先做三件事
- 确认客户端读取了配置 —— 看启动时是否仍在连官方域名
- 发一句最短的话测试 —— 比如
hi - 回控制台看用量 —— 有记录就说明真通了
通用排错
| 现象 | 优先检查 |
|---|---|
仍在连接 api.anthropic.com | 配置文件路径/文件名是否正确、是否被读取 |
| 401 Unauthorized | key 是否完整、Bearer 后是否有空格、环境变量是否为空 |
| 404 找不到 chat/completions | Base URL 是否多了或少了 /v1 |
| 403 Forbidden | 令牌的「模型可用列表」是否限制了当前模型 |
| 400 报错 | 模型名拼写、令牌分组是否支持该模型 |
| 有响应但模型不可用 | 分组是否已启用；用 /v1/models 查实际可用模型 |
| 请求卡住/超时 | 先用最短文本测；检查是否有多余代理、流式设置、重复 /v1 |
更多见 [常见问题](../reference/faq/overview。