Yos Hub API 使用教程
Codex / Claude Code / Cherry Studio / VS Code 全流程接入 · OpenAI 与 Anthropic 双协议支持
购买后使用流程
准备余额和 API Key,按教程完成客户端配置
-
1
注册或登录
进入 YosHub 创建个人账号
-
2
钱包充值
在钱包页面补充可用余额
-
3
创建 API Key api.yoshub.com/keys
为当前客户端创建独立令牌
-
4
确认模型与分组
在模型广场查看可用模型、分组和实时价格。
-
5
复制接口地址
OpenAI 工具带 /v1,Claude Code 使用根域名。
-
6
一键配置
按教程完成设置
API Key 只显示给自己;如有泄露,请立即停用并重新创建。
📖 文档说明
本教程收录 Yos Hub API 的完整使用方法,覆盖充值、API Key、CC Switch、Codex、Claude Code 与 VS Code 的接入和排错。
先看 Node.js 下载 → 线路与接口地址 → CC Switch 配置 → 按需看 ChatGPT / Claude Code / VS Code 教程。
⚡ 快速开始
已有余额后,最短 5 分钟完成 API Key 与客户端配置。
- 安装 Node.js —— 点此跳转,按系统下载安装包。
- 创建 API Key —— 登录 YosHub → API Keys → 创建令牌,复制完整的
sk-xxx。 - 下载 CC Switch —— 点此跳转,用它一键导入配置。
- 选择客户端 —— 按需配置 OpenAI 兼容客户端 / Claude Code。
- 发送测试消息 —— 看到 AI 回复就说明接通了~
📦 Node.js 下载区
Claude Code、VS Code 里的插件和命令行工具,很多都会用到 Node.js。已经装过可以直接跳过;没装过就按你的系统点下面的安装包。
Windows 下载(x64 / ARM64)
macOS 下载(Intel / Apple Silicon)
终端执行 node -v && npm -v,能看到版本号就 OK~
🌐 线路与接口地址怎么填
YosHub 使用统一全球入口。客户端采用哪种协议,决定 Base URL 末尾是否需要 /v1。
先确认客户端使用 OpenAI 兼容协议还是 Anthropic 协议,再复制对应地址。模型名称和分组以 模型广场实时显示为准。
https://api.yoshub.com/v1
Codex、Cherry Studio、Chatbox、OpenAI SDK
https://api.yoshub.com
Claude Code 与 Anthropic 兼容客户端,不带 /v1
OpenAI 兼容接口地址末尾要带 /v1,例 https://api.yoshub.com/v1。
Claude Code 填根域名即可,不要加 /v1,例 https://api.yoshub.com。
⚙️ CC Switch 安装与一键导入配置
CC Switch 是个超好用的多模型管理工具,能在不重启的情况下切换不同提供商的配置。
CC Switch 下载
Linux 下载(x64 / ARM64)
从 YosHub 一键导入配置
YosHub 支持把供应商配置一键导入到 CC Switch。导入后可直接应用到 Codex、Claude Code、OpenClaw、Hermes 等工具,不用手动编辑多个配置文件。
- 先在 Yos Hub API Keys 创建或复制 API Key。
YosHub 控制台 API Key 管理界面 - 打开 YosHub 提供的「CC Switch」一键导入入口。
CC Switch 一键导入入口 - 系统会唤起 CC Switch,进入供应商导入流程。按需勾选要写入的工具:Claude Code、Codex、Gemini。
CC Switch 供应商导入流程 - 点击保存并切换为当前供应商。
手动创建配置(可选)
如果不用一键导入,也可以手动创建:
- 打开 CC Switch,点击右上角「创建新配置」。
- 按工具类型选择 Codex、Claude Code、OpenClaw 或 Hermes。
- 填入 Yos Hub API Key 和请求地址:
- Codex / OpenAI 兼容工具:
https://api.yoshub.com/v1。 - Claude Code:
https://api.yoshub.com,不带/v1。
- Codex / OpenAI 兼容工具:
- 点击「高级选项」打开模型选择页面。
- 点击「获取模型列表」,把获取到的模型名称填入待配置的模型项。
- 点击「保存」生成配置并使用。
生效规则
大多数工具切换配置后需要重启终端或 CLI 才会生效;Claude Code 当前支持供应商数据热切换,通常不需要重启。
CC Switch 能管什么
- 统一管理 Codex、Claude Code、OpenClaw、Hermes 等工具的供应商配置。
- 一键导入供应商配置,减少手动改 JSON、TOML 或环境变量。
- 通过 Deep Link 导入供应商、MCP 服务器、提示词和技能。
- 支持系统托盘快速切换供应商。
- 支持 MCP 和 Skills 管理,适合多工具、多模型用户长期使用。
💬 ChatGPT(原Codex)官方客户端说明
ChatGPT 官方网页、桌面端和手机端使用 OpenAI 官方账户,不提供第三方 Base URL 配置入口。
需要使用 Yos Hub API 时,请选择 CC Switch、Cherry Studio、Chatbox、Codex 或支持自定义 Base URL 的 VS Code 工具。下面的下载入口仅适用于 OpenAI 官方 ChatGPT 账户。
官方入口
桌面版安装
- 打开 官方下载页,点「Download for macOS」获取 .dmg 安装包(需 macOS 14 及以上,建议 M 系列芯片)。
- 打开 .dmg,把 ChatGPT 拖入「应用程序」。
- 任意界面按 Option + Space 即可唤起。
- 打开 官方下载页,会自动跳转 Microsoft Store。
- 在 Microsoft Store 页面点「获取」安装。
- 任意界面按 Alt + Space 即可唤起。
手机版
App Store / Google Play 搜索「ChatGPT」,认准开发者 OpenAI。
只从 openai.com / chatgpt.com 官方域名下载和登录,谨防第三方仿冒客户端。
✨ Claude Code 安装教程
安装 Anthropic 官方 Claude Code,并使用 YosHub 的 Anthropic 兼容入口完成认证。
第一步:安装 Claude Code
macOS / Linux 优先使用官方原生安装脚本:
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell 使用:
irm https://claude.ai/install.ps1 | iexmacOS 也可以通过 Homebrew 安装:
brew install --cask claude-code原生安装失败时,可以先完成上面的 Node.js 安装,再使用 npm 方式。
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com第二步:设置 YosHub 凭证
macOS / Linux 当前终端执行:
export ANTHROPIC_AUTH_TOKEN="sk-你的YosHub密钥"
export ANTHROPIC_BASE_URL="https://api.yoshub.com"Windows PowerShell 永久写入当前用户环境变量:
[Environment]::SetEnvironmentVariable(
"ANTHROPIC_AUTH_TOKEN", "sk-你的YosHub密钥", "User"
)
[Environment]::SetEnvironmentVariable(
"ANTHROPIC_BASE_URL", "https://api.yoshub.com", "User"
)每个客户端建议单独创建一个 Key。写入用户环境变量后,需要重新打开终端才能读取新值。
第三步:测试
claude --version看到版本号后运行 claude。能正常读取模型并回复,就说明配置完成。
附录:Claude Code 请求地址说明
Claude Code 会自动拼接 Anthropic 路径,因此 ANTHROPIC_BASE_URL 使用 https://api.yoshub.com。只有 Codex、Cherry Studio、Chatbox 等 OpenAI 兼容工具使用 https://api.yoshub.com/v1。
🪟 VS Code 使用教程
按顺序完成 VS Code 安装、中文界面、官方 AI 插件安装和连接测试。适合想在代码编辑器里直接用 GPT / Claude 系列模型的用户。
先完成 快速接入 的环境配置,再回来继续本页。保持 CC Switch 处于运行中。
第一步:下载 Visual Studio Code
Windows 安装时建议勾选「添加到 PATH」和「通过 Code 打开」;macOS 下载后把 VS Code 拖到「应用程序」;Linux 用 sudo apt install ./code_*.deb 或 sudo rpm -i code-*.rpm。
第二步:把 VS Code 切换成中文
- 打开 VS Code → 左侧点击「扩展」图标(Ctrl + Shift + X)。
- 搜索
Chinese→ 找到 Chinese (Simplified) Language Pack(发布者 Microsoft)→ 点击 Install。 - 安装后右下角弹出提示 → 点击 Change Language and Restart 重启生效。
第三步:安装官方 AI 插件
第四步:确认接入
插件装好后,先确认 CC Switch 已启动并选中 YosHub 线路,再回到 VS Code。
第五步:测试一次
- 左侧活动栏找到 ChatGPT / Claude Code 图标,打开面板。
- 输入测试消息:
请用中文回复:你好,帮我确认 VS Code 插件已经可以正常连接使用。 - 能正常收到回复就说明配置成功 ✨
Linux 特别说明
装完后打开终端运行:
code --version
node -v && npm -v
code --install-extension OpenAI.chatgpt
code --install-extension Anthropic.claude-code🚑 常见报错排查
90% 的问题都能在这一节找到答案。Ctrl + F 搜错误码。
❌ 401 Unauthorized · 密钥错误
检查 CC Switch 里的 API Key 是否和 YosHub 后台一致,注意前后不要带空格。
❌ 404 Not Found · 路径错
Base URL 必须以 /v1 结尾,例 https://api.yoshub.com/v1(Claude Code 除外,填根域名即可)。
❌ ChatGPT 桌面版打不开或无法登录
ChatGPT 官方客户端使用 OpenAI 官方账户,不能填写 Yos Hub API Key 或 Base URL。使用 Yos Hub API 时请改用 CC Switch、Cherry Studio、Chatbox 或其他支持自定义接口的客户端。
❌ VS Code 找不到插件
按 Ctrl + P → 粘贴 ext install OpenAI.chatgpt 或 ext install Anthropic.claude-code。
❌ Node.js 命令找不到
Win 安装时没勾「Add to PATH」→ 重新跑安装包 → 勾上。macOS/Linux 装到 nvm 里更省事。
❌ 413 错误:请求包太大
原因:请求包太大被拒收。
解决方法:缩短对话历史、减少上传内容或降低客户端的上下文/输出上限,然后重新发送。
❌ 余额或令牌额度不足
钱包余额和 API Key 自身额度是两层限制。请同时检查 钱包余额与 API Key 的额度、状态和过期时间。
❌ 当前分组没有可用渠道 / 模型不可用
打开 模型广场,确认模型名称、API Key 分组和可用模型一致。不要凭记忆手写模型名。
❌ 连接超时 / Failed to fetch
先在浏览器打开 https://api.yoshub.com,再检查客户端 Base URL、防火墙和本机代理。仍无法解决时,复制完整报错并到 QQ 群 咨询。