YosHub YosHubDocs API 接入指南
✦ YosHub 新手接入指南

Yos Hub API 使用教程

Codex / Claude Code / Cherry Studio / VS Code 全流程接入 · OpenAI 与 Anthropic 双协议支持

  • 🪟 Win / macOS / Linux 三端
  • ⚡ 直链下载
  • 💡 报错速查
YosHub QQ 交流群 配置或使用遇到问题,加入官方 QQ 群:

登录、充值、API Key、客户端配置和报错排查都可以在群内咨询。

1039602843 点击加群

购买后使用流程

准备余额和 API Key,按教程完成客户端配置

  1. 1
    注册或登录

    进入 YosHub 创建个人账号

  2. 2
    钱包充值

    在钱包页面补充可用余额

  3. 3
    创建 API Key api.yoshub.com/keys

    为当前客户端创建独立令牌

  4. 4
    确认模型与分组

    在模型广场查看可用模型、分组和实时价格。

  5. 5
    复制接口地址

    OpenAI 工具带 /v1,Claude Code 使用根域名。

  6. 6
    一键配置

    按教程完成设置

配置完成后,即可开始使用

API Key 只显示给自己;如有泄露,请立即停用并重新创建。

📖 文档说明

本教程收录 Yos Hub API 的完整使用方法,覆盖充值、API Key、CC Switch、Codex、Claude Code 与 VS Code 的接入和排错。

💡
推荐阅读顺序

先看 Node.js 下载线路与接口地址CC Switch 配置 → 按需看 ChatGPT / Claude Code / VS Code 教程。

主站注册地址
api.yoshub.com
OpenAI 兼容地址
api.yoshub.com/v1
Claude Code 地址
api.yoshub.com
钱包与充值
api.yoshub.com/wallet
系统支持
Windows · macOS · Linux
维护方
YosHub 团队
QQ 群
更新日期
2026.07.19

快速开始

已有余额后,最短 5 分钟完成 API Key 与客户端配置。

  1. 安装 Node.js —— 点此跳转,按系统下载安装包。
  2. 创建 API Key —— 登录 YosHub → API Keys → 创建令牌,复制完整的 sk-xxx
  3. 下载 CC Switch —— 点此跳转,用它一键导入配置。
  4. 选择客户端 —— 按需配置 OpenAI 兼容客户端 / Claude Code
  5. 发送测试消息 —— 看到 AI 回复就说明接通了~

📦 Node.js 下载区

Claude Code、VS Code 里的插件和命令行工具,很多都会用到 Node.js。已经装过可以直接跳过;没装过就按你的系统点下面的安装包。

验证安装

终端执行 node -v && npm -v,能看到版本号就 OK~

🌐 线路与接口地址怎么填

YosHub 使用统一全球入口。客户端采用哪种协议,决定 Base URL 末尾是否需要 /v1

🚀
统一入口,无需挑选线路

先确认客户端使用 OpenAI 兼容协议还是 Anthropic 协议,再复制对应地址。模型名称和分组以 模型广场实时显示为准。

🌏
OpenAI 兼容接口 https://api.yoshub.com/v1 Codex、Cherry Studio、Chatbox、OpenAI SDK
🌏
Claude Code / Anthropic https://api.yoshub.com Claude Code 与 Anthropic 兼容客户端,不带 /v1
🔑
API Keys https://api.yoshub.com/keys 创建、停用和管理客户端令牌
打开
🧭
模型广场 https://api.yoshub.com/pricing 查看可用模型、分组和实时价格
打开
💡
路径填写规则

OpenAI 兼容接口地址末尾要带 /v1,例 https://api.yoshub.com/v1
Claude Code 填根域名即可,不要/v1,例 https://api.yoshub.com

⚙️ CC Switch 安装与一键导入配置

CC Switch 是个超好用的多模型管理工具,能在不重启的情况下切换不同提供商的配置。

CC Switch 下载

从 YosHub 一键导入配置

YosHub 支持把供应商配置一键导入到 CC Switch。导入后可直接应用到 Codex、Claude Code、OpenClaw、Hermes 等工具,不用手动编辑多个配置文件。

  1. 先在 Yos Hub API Keys 创建或复制 API Key。
    在 YosHub 控制台创建或复制 API Key 的界面
    YosHub 控制台 API Key 管理界面
  2. 打开 YosHub 提供的「CC Switch」一键导入入口。
    YosHub 提供的 CC Switch 一键导入入口
    CC Switch 一键导入入口
  3. 系统会唤起 CC Switch,进入供应商导入流程。按需勾选要写入的工具:Claude Code、Codex、Gemini。
    CC Switch 供应商导入流程,勾选要写入的工具
    CC Switch 供应商导入流程
  4. 点击保存并切换为当前供应商。

手动创建配置(可选)

如果不用一键导入,也可以手动创建:

  1. 打开 CC Switch,点击右上角「创建新配置」。
  2. 按工具类型选择 Codex、Claude Code、OpenClaw 或 Hermes。
  3. 填入 Yos Hub API Key 和请求地址:
    • Codex / OpenAI 兼容工具:https://api.yoshub.com/v1
    • Claude Code:https://api.yoshub.com不带 /v1
  4. 点击「高级选项」打开模型选择页面。
  5. 点击「获取模型列表」,把获取到的模型名称填入待配置的模型项。
  6. 点击「保存」生成配置并使用。

生效规则

💡
切换后要不要重启?

大多数工具切换配置后需要重启终端或 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 Key 不能直接填入 ChatGPT 官方客户端

需要使用 Yos Hub API 时,请选择 CC Switch、Cherry Studio、Chatbox、Codex 或支持自定义 Base URL 的 VS Code 工具。下面的下载入口仅适用于 OpenAI 官方 ChatGPT 账户。

官方入口

桌面版安装

  1. 打开 官方下载页,点「Download for macOS」获取 .dmg 安装包(需 macOS 14 及以上,建议 M 系列芯片)。
  2. 打开 .dmg,把 ChatGPT 拖入「应用程序」。
  3. 任意界面按 Option + Space 即可唤起。
  1. 打开 官方下载页,会自动跳转 Microsoft Store。
  2. 在 Microsoft Store 页面点「获取」安装。
  3. 任意界面按 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 | bash

Windows PowerShell 使用:

irm https://claude.ai/install.ps1 | iex

macOS 也可以通过 Homebrew 安装:

brew install --cask claude-code
💡
仍需 npm 时

原生安装失败时,可以先完成上面的 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"
)
🔐
不要把 API Key 发到聊天、截图或公开仓库

每个客户端建议单独创建一个 Key。写入用户环境变量后,需要重新打开终端才能读取新值。

第三步:测试

claude --version

看到版本号后运行 claude。能正常读取模型并回复,就说明配置完成。

附录:Claude Code 请求地址说明

⚠️
Claude Code 填根域名,不带 /v1

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_*.debsudo rpm -i code-*.rpm

第二步:把 VS Code 切换成中文

  1. 打开 VS Code → 左侧点击「扩展」图标(Ctrl + Shift + X)。
  2. 搜索 Chinese → 找到 Chinese (Simplified) Language Pack(发布者 Microsoft)→ 点击 Install
  3. 安装后右下角弹出提示 → 点击 Change Language and Restart 重启生效。

第三步:安装官方 AI 插件

🟢 ChatGPT(OpenAI 官方)

用于跑 GPT 系列模型

插件市场
🟣 Anthropic Claude Code

用于跑 Claude 系列模型

插件市场

第四步:确认接入

插件装好后,先确认 CC Switch 已启动并选中 YosHub 线路,再回到 VS Code。

第五步:测试一次

  1. 左侧活动栏找到 ChatGPT / Claude Code 图标,打开面板。
  2. 输入测试消息:请用中文回复:你好,帮我确认 VS Code 插件已经可以正常连接使用。
  3. 能正常收到回复就说明配置成功 ✨

Linux 特别说明

🐧
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.chatgptext 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 群 咨询。

已复制