API 转发平台配置教程
覆盖 Claude Code / Codex / Roo Code / Cherry Studio / OpenClaw / Chatbox 配置指南
选哪个分组,决定你能用哪些模型、按什么单价:ds4.1 选 011(国产特惠-ds4.1-高缓)|GPT 选 020(gpt-稳定不降智)|Claude 选 claude-kiro-正价(价格在 0.25–0.27 之间浮动,随号池成本变动)。
一、进入官网然后注册账号
进入官网:https://api.yushou.xyz/ 然后 注册账号
进入官网后点击注册即可,若浏览器提示风险,换一个浏览器打开就好。
- 注册后1 元测试额度已自动到账(无需加群、无需找站长要兑换码);用完后使用兑换码兑换额度,续费也可以在这里在线充值
- 先挑分组:每个分组下面的模型清单不同,先确定你要用哪个模型、再决定选哪个分组
- 然后 Key 创建
- 必须手动选择要用的分组(不同分组下面模型不同;不选分组 = 一个模型都没有)
- 创建的令牌不要限制模型【注意】
- 复制创建的令牌 key
到这里就可以配置到自己想配置的地方了,例如 AI Studio、CC、Codex 等(配置的时候选择 OpenAI 协议,自定义模型配置)
二、claude code 配置方法
1. 首先下载最新版本 CC switch
CC switch 下载地址:github.com/farion1231/cc-switch/releases
2. 创建自定义配置
3. 配置模型(请求地址要换下)
【需要注意】如果获取不到模型检查如下几点:
- 检查令牌复制的是否正确
- 检查创建密钥时是否选了分组、且所选分组包含你要用的模型(不选分组 / 分组与模型不匹配 = 一律提示「无可用渠道」)
- 正常不需要开魔法,有个别网络无法访问域名解析,需要开下魔法
- 分辨不清模型名称大小写,直接获取模型选填!!!
4. 打开终端
5. vscode 上的 claude code 图形化插件也可以使用(记得重启下 vscode)
6. 配置问题
问题一
如果遇见这种问题,是 claude 插件的问题不支持 OpenAI 协议,可以看图二选择设置 OpenAI 协议并开启路由。
问题二
- 更新到最新版本
- 改为 Codex 原生协议(不需要开路由)
- Codex 都退出,结束进程的退出,然后重新打开
三、Codex 配置方法
1. 首先下载 CC switch
CC switch 下载地址:github.com/farion1231/cc-switch
Codex 下载地址:chatgpt.com/codex
2. 创建自定义配置
3. 配置模型
【需要注意】如果获取不到模型检查如下几点:
- 检查令牌复制的是否正确
- 检查创建密钥时是否选了分组、且所选分组包含你要用的模型(不选分组 / 分组与模型不匹配 = 一律提示「无可用渠道」)
- 正常不需要开魔法,有个别网络无法访问域名解析,需要开下魔法
- 有的开了魔法无法获取模型的情况,全局切换到规则即可解决
- 分辨不清模型名称大小写,直接获取模型选填!
5. 重启 codex 进行对话
- 如果配置的不是 Codex 系列,那么模型那里是空白的,但是可以使用
- 空白的他调用的是你选填模型的第一个
- CC 每次切换模型需要重启 Codex
四、在 Roo Code / Kilo Code 中使用
- API 供应商选择 Anthropic
- 填写 API 密钥
- 使用自定义基础 URL,填写:
https://api.yushou.xyz/
五、在 Cherry Studio 中使用
- 新增供应商平台
- 类型选择 Anthropic
- 填写 API 密钥,API 地址
https://api.yushou.xyz/ - 点击管理拉取模型加入
六、OpenClaw 模型配置
需要 3 个东西:Base URL、密钥(Key 创建步骤获取的 key)、Model ID(你创建令牌时所选分组下面的模型名字;令牌没选分组就没有模型可选)
方法一:编辑配置文件
# 编辑配置文件
~/.openclaw/openclaw.json
# 找到 baseUrl,apiKey,Model ID 替换然后保存
{
"models": {
"providers": {
"my-provider": {
"baseUrl": "https://api.yushou.xyz/v1",
"apiKey": "sk-你的API密钥",
"api": "openai-completions",
"models": [
{
"id": "你的模型名",
"name": "你的模型名",
"contextWindow": 1048576
}
]
}
}
}
}
# 重启网关使配置生效
openclaw gateway restart
# 查看模型是否添加成功
openclaw models list
七、Chatbox 配置
不行就用 https://api.yushou.xyz/v1。API 地址填 https://api.yushou.xyz/v1,密钥填令牌 key,模型选你在令牌分组里要用的模型名(令牌没选分组就没有模型可选)。
八、CC Switch 一键导入与常见坑
CC Switch 里手填配置比较绕:Claude Code、Codex、Gemini CLI 三个工具的字段形状都不一样,请求地址带不带 /v1 也不同。下面两种方式任选一种。
方式一:一键导入(推荐,最省事)
把下面链接里的 sk-你的令牌 换成你自己创建的令牌,整条复制到浏览器地址栏回车,CC Switch 会弹出导入确认:
ccswitch://v1/import?resource=provider&app=claude&name=寓守API&endpoint=https://api.yushou.xyz&apiKey=sk-你的令牌&homepage=https://yushou.xyz
Codex 用这条(注意结尾带 /v1):
ccswitch://v1/import?resource=provider&app=codex&name=寓守API-Codex&endpoint=https://api.yushou.xyz/v1&apiKey=sk-你的令牌&homepage=https://yushou.xyz
如果 CC Switch 里有「Universal Provider(跨工具共用)」这一项,勾上 Claude Code / Codex / Gemini,一次填写三个工具都能用。
方式二:手动填(导入失败时用)
Claude Code:请求地址不带 /v1
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
"ANTHROPIC_BASE_URL": "https://api.yushou.xyz"
}
}
Codex:两个文件都要写,请求地址带 /v1
# ~/.codex/auth.json
{ "OPENAI_API_KEY": "sk-你的令牌" }
# ~/.codex/config.toml
model_provider = "custom"
model = "你要用的模型名"
[model_providers.custom]
name = "custom"
base_url = "https://api.yushou.xyz/v1"
wire_api = "responses"
requires_openai_auth = true
Gemini CLI:请求地址不带 /v1
{
"env": {
"GEMINI_API_KEY": "sk-你的令牌",
"GOOGLE_GEMINI_BASE_URL": "https://api.yushou.xyz"
}
}
三个最常见的坑
- 没选分组 / 分组和模型对不上 → 调用一律提示「无可用渠道」。回去创建令牌时先确认已经选了分组、且所选分组包含你要用的模型(第一节已标红)。
- 系统环境变量冲突 → 电脑里若已经存在
ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL、OPENAI_API_KEY、GEMINI_API_KEY,会覆盖 CC Switch 写进去的配置,怎么改都不生效。CC Switch 顶部会弹黄条「环境变量冲突」→ 展开 → 勾选 → 移除所选(它会自动备份)。 - 请求地址填反 → Claude Code / Gemini 用
https://api.yushou.xyz(不带 /v1),Codex 用https://api.yushou.xyz/v1(带 /v1)。填反会 404 或空响应。
改完配置后多数工具需要重启终端 / 重启 Codex;Claude Code 支持热切换,不用重启。
九、WorkBuddy 自定义模型接入教程
想在 WorkBuddy 里使用本站模型,按下面三步添加自定义供应商即可。开始前,先在本站「令牌」页面创建并复制自己的密钥,记得选择包含目标模型的分组。
步骤 1:点击「自定义模型」
在 WorkBuddy 的模型设置中找到「自定义模型」,点击进入添加页面。入口位置可参考下图。
步骤 2:选择「其他供应商」
在供应商选择页面点击「其他供应商」。这里要接入的是本站提供的接口,不要误选成官方供应商。
步骤 3:填写接口地址、密钥和模型全名
本站接口主域名为 https://api.yushou.xyz,常用兼容接口地址为 https://api.yushou.xyz/v1;具体字段填写方式以截图中的地址格式为参考。
从本站「令牌」页面复制并粘贴到密钥输入框。密钥一定换成你自己的,不要照抄别人的密钥。复制时不要带入空格或换行。
请从本站模型广场直接复制完整模型名称,不要填简称、显示昵称,也不要省略版本号或后缀。大小写、数字、连字符等每一个字符都必须完全一致,前后不要多空格。
同时确认:你创建令牌时选择的分组,包含这个完整名称对应的模型。
高级配置随你心意:可以根据自己的使用习惯调整;不确定时先保持默认,保存后选择刚添加的自定义模型开始使用。先把基础连接跑通,再逐项调整,排查起来更方便。
若提示「无可用渠道」,先检查令牌分组和模型名称;若提示密钥无效,重新复制自己的令牌,注意不要带入空格或换行。其他问题可参考下面的常见提问。
十、常见问题(页面打不开 / 缓存命中)
缓存命中:同一件事做得越久越便宜
前提:令牌必须先选好分组——不选分组一个模型都调不到,下面这些省钱技巧也就无从谈起。
模型缓存的是和你上一次完全相同的前缀。命中之后,输入部分的大头(实测能覆盖 98%~99%)按缓存价计费,比正常输入便宜很多 —— 就算你用的是特惠分组也一样(前提还是:令牌已经选好分组):同一件事一直做下去,命中率会自己涨上来,能到 90% 上下。
越做越省钱的用法(缓存会越来越高):
- 反复问同一份资料 / 同一本合同、文档(把资料放前面,问题只在后面追加);
- 固定格式的批量整理、分类、抽取(同一个模板跑几百上千条);
- 同一套系统提示 + 同一批规则做长期客服问答;
- 长对话一直聊下去(历史都带着,前缀基本不变)。
命中注定很低的用法(别指望靠缓存省钱):
- 写小说 / 网文 / 剧本推演 / 角色扮演 —— 每轮都是新情节、新人设、新场景,前缀全变;
- 每次换一份新材料让它总结(新报告、新论文、新文件);
- 同一段内容反复改写、换风格、换语气多版本重写;
- “随便帮我写一段”这类每次要求都不同的活。
上面这类活,缓存帮不上忙,但也不用靠缓存省钱 —— 先确认令牌已经选了分组,然后直接走 国产特惠 分组最划算:特惠是把单价本身打了大折,不吃缓存也照样便宜,比绕去官方直连划算得多。反过来说,如果你的活是反复问同一份长资料、固定模板批量跑、长对话一直聊(缓存命中能到 85% 以上),那 国产经济 / 国产稳定 更合算 —— 这两档缓存是真打折的。一句话:命中率 60% 以下选特惠,85% 以上选经济 / 稳定。
小技巧:固定不变的内容(系统提示、大文档)放最前面,变化的内容只往后追加;同一个会话里别来回换材料,命中率会明显好很多。
十一、常见问题(进阶:开票 / 高价分组 / 缓存掉)
下面几条不常遇到,但一旦碰上很容易被误会成「站点坏了」,先看这里再找站长。
建议做法:大额批处理、长时间连续跑量尽量安排在白天或晚间; 凌晨到上午先用小额试跑,确认稳定了再放量。
- Claude Code 是这个分组的「专武」,自带缓存标记,正常用就有缓存,不用额外设置;
- 其他 agent、客户端(第三方插件、自己写的脚本等)需要自己在请求里补上缓存标记。
"cache_control": { "type": "ephemeral" }
比较完整的写法(Claude 原生格式 /v1/messages 请求里):
{
"model": "你后台里看到的完整模型名",
"messages": [
{
"role": "system",
"content": [
{
"type": "text",
"text": "这里是很长、并且每一轮都完全一样的系统提示 / 资料",
"cache_control": { "type": "ephemeral" }
}
]
},
{ "role": "user", "content": "每一轮变化的问题" }
]
}
没有这个标记,服务端就不会建立缓存,同一份资料反复问也会按全价算 ——
表现出来就是「别人有缓存,我怎么一直在掉缓」。
不想折腾客户端参数,最省事的办法就是直接用 Claude Code。
高峰期:整体负载高,这个分组确实可能变慢,属于正常现象;高峰期偶尔掉缓, 我们会尽力维护,不用太担心。
谷期首字还慢:先检查自己的网络 —— 换手机热点、关掉代理、换官方浏览器再试一次, 网络因素占大头。
谷期掉缓:这种情况是不应该出现的,请先检查自己的并发结构和工作属性,常见三类原因: ① 单账号开了很高的并发在抢;② 每一轮内容都在变、前缀不稳定(缓存本来就没法命中, 比如每轮换新材料、换人设);③ 同一账号多端或多工具同时在跑。 把并发放缓、把固定不变的内容放到最前面,通常就会明显好转。
十二、相关页面
价格与倍率:模型广场(各分组实时单价与倍率,先在这里挑好分组,再去创建令牌)
延伸阅读:大模型 API 调用成本怎么算 · ChatGPT 和 Claude 的 API 在国内怎么调用 · 多个大模型 API 统一接入
—— 使用中遇到问题欢迎咨询,提供全程远程协助 ——