客户端接入总览
本栏目汇总各类客户端、CLI、IDE 插件接入 187API 的完整配置教程。
先选你的场景
| 你在用什么 | 读这里 | 需要 Node.js |
|---|---|---|
| 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 配置 | 是 |
| 用 CCSwitch 统一管理多家 | CCSwitch 配置 | 否 |
| 直接写代码调 API | OpenAI SDK 接入 | 视语言 |
需要先装 Node.js 的，看 Node.js 环境准备。
统一的三个参数
不管用哪个客户端，你只需要填三样东西：
| 参数 | 值 |
|---|---|
| Base URL（[OI] 协议） | https://187api.com/v1 |
| Base URL（Anthropic 协议） | https://187api.com（末尾不要加 /v1） |
| API Key | 控制台「令牌管理」里创建，形如 sk-... |
:::danger 最常见的错误就是 Base URL 写错
- Anthropic 协议（Claude Code 等）：填
https://187api.com，不要加/v1 - [OI] 协议（Codex、SDK 等）：填
https://187api.com/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 |
更多见 常见问题。