云筑Hub 标志 云筑HubAPI 接入指南 模型广场
CC Switch 主路径

Codex 接入

使用 CC Switch 导入云筑Hub 供应商配置，重启 Codex 后完成首次测试。

预计 8–12 分钟含完整公共前置流程截图可点击放大
固定接口地址https://www.yunzhuhub.com/v1注意末尾必须包含 /v1
01

填写新版注册信息

打开标题为「创建一个账户」的新版注册页，依次填写用户名、密码、确认密码和电子邮件。已有账号可直接登录，无需重复注册。

打开新版注册页
依次填写用户名、密码、确认密码和邮箱（截图已做隐私处理）
02

验证邮箱并完成注册

点击「发送验证码」，填写收到的验证码，勾选用户协议及隐私政策，再点击「创建账户」。注册成功后使用用户名或邮箱登录。

进入控制台
发送验证码、填写验证码并勾选协议（截图已做隐私处理）
03

从控制台进入钱包

登录后点击左上角菜单按钮，在侧边栏依次进入「个人 → 钱包」。手机端同样需要先展开侧边菜单，再选择「钱包」。

打开钱包
从「个人」分组进入「钱包」（截图已做隐私处理）
04

兑换或充值额度

在钱包页找到「添加资金」中的「有兑换码吗？」区域，输入兑换码并点击「兑换额度」；也可以按页面当前提供的方式充值。

在「添加资金」区域使用兑换码或选择充值方式（截图已做隐私处理）
05

进入 API 密钥管理

在控制台侧边栏依次进入「常规 → API 密钥」，查看和管理当前账号的密钥。

打开 API 密钥
从「常规」分组进入「API 密钥」（截图已做隐私处理）
06

创建并设置 API 密钥

点击「创建 API 密钥」，在右侧抽屉只填写便于识别的用途/令牌名称，例如 Workbuddy、Codex 或具体项目名，然后点击「保存更改」。

点击「创建 API 密钥」（截图已做隐私处理）
只填写用途/令牌名称，其他选项不要填写（截图已做隐私处理）
07

复制并妥善保存 API Key

保存后，从 API Key 列复制密钥；点击 sk-*** 文本也可以打开「完整 API 密钥」弹层。手机端首次点击复制可能只触发加载，等待加载提示完成后再点击一次复制，不要重复创建。

API Key 示例
<YOUR_API_KEY>
从 API Key 列复制新建的密钥（截图已做隐私处理）
08

在模型广场取得准确模型 ID

打开模型广场并搜索需要的模型，通过模型卡片名称或复制按钮取得完整模型 ID。模型列表与价格会更新，以官网实时页面为准。

查看模型广场
搜索并确认需要使用的模型（截图已做隐私处理）
通过模型卡片名称或复制按钮取得准确模型 ID（截图已做隐私处理）
09

安装并打开 CC Switch

从 CC Switch 官网获取与你系统匹配的版本，安装后打开应用。本指南全程使用 CC Switch 完成配置。

打开 CC Switch 官网
10

从 API 密钥行打开 CC Switch

回到云筑Hub 的「常规 → API 密钥」，在目标 API 密钥行打开「更多」菜单，然后选择「CC Switch」。

从目标 API 密钥行的「更多」菜单选择「CC Switch」（截图已做隐私处理）
11

选择 Codex 和主模型

在「应用」中选择 Codex，再选择需要使用的主模型。导入配置会自动使用 https://www.yunzhuhub.com/v1 作为 Endpoint。

在「应用」中选择 Codex，再选择主模型（截图已做隐私处理）
12

导入 CC Switch，重启 Codex 并测试

点击「打开 CC Switch」并完成导入，确认 CC Switch 中出现云筑Hub 供应商配置。完全退出并重新启动 Codex，再打开新任务发送 hi。

打开 CC Switch、完成导入并确认供应商配置（截图已做隐私处理）

故障排查

没有成功时按顺序检查

1CC Switch 中是否已出现云筑Hub 的 Codex 配置。
2Endpoint 是否为 https://www.yunzhuhub.com/v1。
3导入后是否完全退出并重新启动 Codex。
4模型 ID 是否可用、账户余额是否充足。

完成配置

发送 hi 做首次测试

能收到正常回复就表示接入完成。若失败，先检查地址、Key、模型 ID 与余额，再把报错截图发给客服。

返回首页模型广场