API 转发平台配置教程

覆盖 Claude Code / Codex / Roo Code / Cherry Studio / OpenClaw / Chatbox 配置指南

【不会用提供咨询和远程协助！！！】

【请耐心看文档，一步一步按着操作你会学会如何使用！！！】

【这是中转不要用官方的请求地址！！！】

📣 使用前先加群 / 频道（重要）

飞机频道t.me/yushou_api　公告、通知、波动、故障都在这里发

QQ 群点我加群　群号 1108680398

有问题先在群里问，比慢慢等邮件快得多；进群记得看置顶。

💰 邀请奖励（长期活动）

登录后在 「钱包」页面 →「推荐计划」 复制你的专属邀请链接，发给朋友；好友通过链接注册并完成首次充值，你就能拿奖励：首笔充值不足 10 元返 50%，10 元及以上返 5 元额度；好友充值满 6 小时后自动到账，每位好友只计一次，单个邀请人每月上限 15 元。奖励可在推荐计划里一键「转入余额」直接当钱用。

去「钱包 → 推荐计划」复制邀请链接 →

❗ 创建密钥时必须选择分组

不选分组会走默认的 「国产经济」分组，只能调用国产模型（DeepSeek / GLM / Kimi / Qwen / MiMo 等）；想用 GPT、Claude、Gemini、Grok 这些国外模型，必须手动选中对应分组，否则调用时会提示「无可用渠道」。

选择分组相关教程 ↓

❓ 页面打不开 / 缓存怎么用才省钱

别用国内套壳的“谷歌浏览器”（自带安全检测，会误拦本站请求），尽量在电脑端使用；缓存能不能命中直接决定你花多少钱，看你做的是哪一类活 —— 详见下方「九、常见问题」。

打不开页面 / 缓存命中 →

一、进入官网然后注册账号

进入官网：https://api.yushou.xyz/ 然后注册账号

进入官网后点击注册即可，若浏览器提示风险，换一个浏览器打开就好。

注册后使用兑换码兑换额度（续费也可以这里在线充值）

看分组下面有哪些模型

然后 Key 创建

选择要用分组（不同分组下面模型不同）

❗ 创建密钥时必须选择分组 ❗不选分组会默认走「国产经济」分组（只能调用国产模型）要用 GPT / Claude / Gemini / Grok 等国外模型，必须手动选择对应分组；分组与模型不匹配会提示「无可用渠道」

创建的令牌不要限制模型【注意】
复制创建的令牌 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 支持热切换，不用重启。

九、常见问题（页面打不开 / 缓存命中）

页面打不开、白屏、一直转圈？先换浏览器，再换设备，最后换网络。

❌ 不要用国内套壳的“谷歌浏览器”

各种“加速版 / 极速版 / 内置 AI 的 Chrome”基本都是套壳浏览器，自带安全拦截模块，会误拦本站请求，表现就是打不开、白屏、一直转圈、验证码过不去。请去官网装官方 Chrome 或 Edge（电脑端）再打开。

📱 尽量不要在手机端使用

手机浏览器对本站的令牌、上传、配置页面适配很差，容易出现点了没反应、复制不了 Key、改完不生效等怪问题。注册、充值、拿密钥、改配置请用电脑；手机只用来聊天提问一般没问题。

✅ 换了官方浏览器还是打不开，按顺序试这三步

① 换网络：切手机热点或换一个网络；② 关插件：广告拦截、脚本拦截类插件先停用；③ 强制刷新：Ctrl + F5，或直接用无痕窗口打开。三步做完还是不行，把打不开的页面地址截图发到群里，我们直接看。

缓存命中：同一件事做得越久越便宜

模型缓存的是和你上一次完全相同的前缀。命中之后，输入部分的大头（实测能覆盖 98%～99%）按缓存价计费，比正常输入便宜很多 —— 就算你用的是特惠分组也一样：同一件事一直做下去，命中率会自己涨上来，能到 90% 上下。

越做越省钱的用法（缓存会越来越高）：

反复问同一份资料 / 同一本合同、文档（把资料放前面，问题只在后面追加）；
固定格式的批量整理、分类、抽取（同一个模板跑几百上千条）；
同一套系统提示 + 同一批规则做长期客服问答；
长对话一直聊下去（历史都带着，前缀基本不变）。

命中注定很低的用法（别指望靠缓存省钱）：

写小说 / 网文 / 剧本推演 / 角色扮演 —— 每轮都是新情节、新人设、新场景，前缀全变；
每次换一份新材料让它总结（新报告、新论文、新文件）；
同一段内容反复改写、换风格、换语气多版本重写；
“随便帮我写一段”这类每次要求都不同的活。

上面这类活，缓存帮不上忙，但也不用靠缓存省钱 —— 直接走 国产特惠 分组最划算：特惠是把单价本身打了大折，不吃缓存也照样便宜，比绕去官方直连划算得多。反过来说，如果你的活是反复问同一份长资料、固定模板批量跑、长对话一直聊（缓存命中能到 85% 以上），那 国产经济 / 国产稳定 更合算 —— 这两档缓存是真打折的。一句话：命中率 60% 以下选特惠，85% 以上选经济 / 稳定。

小技巧：固定不变的内容（系统提示、大文档）放最前面，变化的内容只往后追加；同一个会话里别来回换材料，命中率会明显好很多。

十、相关页面

价格与倍率：模型广场（各分组实时单价与倍率）

模型热度：大模型调用排行榜（实时 Token 用量）

延伸阅读：大模型 API 调用成本怎么算 · ChatGPT 和 Claude 的 API 在国内怎么调用 · 多个大模型 API 统一接入

—— 使用中遇到问题欢迎咨询，提供全程远程协助 ——