主题
客户端接入总览
先确认你的客户端说哪套协议，再点进对应页面。每个客户端的地址填法都不一样，填错就是 404。
地址里的域名：国内一律用 api.
下表和各页示例用的都是默认的三网优化直连 https://api.jichuanai.com。 人在海外的话，可以把域名换成 https://jc.jichuanai.com（海外线路），其余一个字都不用改； 国内别换，海外线路在国内部分宽带会被拦。两条线功能一样、key 通用。详见 接口地址与协议。
新手怎么选
先看你电脑上有没有梯子：
- 没有梯子：WorkBuddy（图形界面，填三格就行，不用装 CC Switch）→ 图片教程
- 有梯子：OpenCode 或 Claude Code（控制台「导入到 CCS」一键配好）→ OpenCode 图片教程
- 已经在用 DeepSeek Harness：→ 图片教程
一分钟对照表
| 你在用 | 协议 | 地址填什么 |
|---|---|---|
| Claude Code（CLI / 桌面端） | Anthropic Messages | https://api.jichuanai.com（不带 /v1） |
| CC Switch | Anthropic Messages | https://api.jichuanai.com/v1（「完整 URL」关闭） |
| Claude Code for VS Code | Anthropic Messages | https://api.jichuanai.com（不带 /v1） |
| Codex / Codex Desktop | OpenAI Responses | https://api.jichuanai.com/v1 |
| Zcode | OpenAI 兼容 | https://api.jichuanai.com/v1 |
| ChatBox | OpenAI 兼容 | https://api.jichuanai.com/v1 |
| Trae | OpenAI 兼容 | https://api.jichuanai.com/v1 |
| WorkBuddy | OpenAI 兼容 | https://api.jichuanai.com/v1/chat/completions（填完整） |
| OpenCode | OpenAI 兼容 | https://api.jichuanai.com/v1 |
| Hermes Agent | OpenAI 兼容 | https://api.jichuanai.com/v1 |
| DeepSeek Harness | OpenAI 兼容 | https://api.jichuanai.com/v1 |
| 酒馆 SillyTavern（电脑 / 手机） | OpenAI 兼容 | https://api.jichuanai.com/v1 |
| Python / Node 写代码 | OpenAI 兼容 | https://api.jichuanai.com/v1 |
| curl / 自己发 HTTP | 三套都行 | 带完整路径 |
| magpie（一处设置，Claude Code / Codex 等共用） | 自动检测 | https://api.jichuanai.com/v1 |
| 上面没有的 | 看它支持哪套 | 见下 |
带不带 /v1，一句话判断
记这一条就够
配置项叫 ANTHROPIC_BASE_URL / 「Anthropic Base URL」→ 不带 /v1。其余一律带 /v1。
为什么：Claude Code 系的客户端读到地址后会自己补 /v1/messages。 你填 https://api.jichuanai.com/v1，拼完就是 /v1/v1/messages → 404。
实测对照：/v1/messages → 401（说明端点在），/v1/v1/messages → 404。
还有一类例外：某些客户端有「完整 URL」「Use full URL」开关。 打开之后它原样使用你填的地址、不再拼路径，这时要填到底：
https://api.jichuanai.com/v1/chat/completions共通的三件事
无论哪个客户端，这三件事都一样：
- key 的分组要和你买的东西匹配 —— 见 先看这三步
- 模型名逐字复制 —— 见 模型清单
- 单模型时长卡必须先改客户端默认模型 —— Codex / Claude Code / Trae 连上就按自己的默认模型发请求。买的是 DeepSeek Flash 卡，默认还是
gpt-5.6-luna，一发就是 404。Flash 卡可填deepseek-v4-flash-0731，Pro 卡可填deepseek-v4-pro-0813。
各客户端具体改哪一格：
| 客户端 | 改哪里 |
|---|---|
| Codex / Codex Desktop | 默认模型 / 当前模型，不要用自带的 GPT 名 |
| Claude Code 系 | Sonnet / Opus / Haiku / Fable / Subagent 和「默认兜底模型」 六个框填同一个名字 |
| ChatBox / WorkBuddy / Trae / 酒馆 | 对话用的模型下拉框，不要留着软件预置的 GPT / Claude |
模型名[1M] 这种写法：只有 Anthropic 协议能用
有些教程的配置里会出现 glm-5.3[1M]、deepseek-v4-pro-0813[1M] 这种带方括号的写法。 那是 Claude Code 自己的长上下文标记。
- Anthropic 协议（Claude Code、CC Switch、VS Code 插件）： 我们会把结尾的
[1M]/[1m]去掉再转发，所以填不填都能用。 - OpenAI 协议（Codex、OpenCode、WorkBuddy、ChatBox、Trae、Zcode、SDK……）： 不处理，会原样发给上游 → 上游不认识这个模型名 → 404。
跨客户端抄配置最容易死在这里
从 Claude Code 的配置里把 glm-5.3[1M] 复制到 ChatBox / WorkBuddy，必 404， 而报错只说「模型不存在」，不会告诉你是那对方括号的事。 OpenAI 协议的客户端里，模型名不要带方括号。
没列出来的客户端怎么办
只要它支持「自定义 OpenAI 兼容接口」，就能接，见 其他客户端：
- 接口地址填
https://api.jichuanai.com/v1（若有「完整 URL」开关且打开了，则填https://api.jichuanai.com/v1/chat/completions） - API Key 填
sk-xxx - 模型名从 模型清单 复制，不带方括号
配完先发一条消息实测，别只看「保存成功」。