01
CC Switch 主路径
Codex / Claude Code 接入
通过 CC Switch 选择 Codex 或 Claude Code 和主模型，直接导入云筑Hub 配置。
CC Switch 自动配置接口
按所选应用自动生成Codex 使用 /v1；Claude Code 使用官网根地址。无需手动填写。安装准备：ChatGPT（原 Codex 桌面应用）
先安装 ChatGPT 桌面应用，再按下方 10 步接入云筑Hub。已经安装的用户可以直接从第 1 步开始；下载和安装耗时另计。
Windows：从微软商店安装 ChatGPT
- 打开微软商店（Microsoft Store），搜索 ChatGPT。
- 确认应用名称为 ChatGPT、发布者为 OpenAI，点击「获取」或「安装」。也可直接使用下方官方商店入口。
- 安装完成后打开 ChatGPT，再继续下方账号准备和 CC Switch 接入流程。
系统要求以商店详情页为准；若被组织策略拦截，请联系管理员，不要关闭系统安全保护。
macOS：下载 ChatGPT 桌面应用
- 点击下方「Mac 官方下载」，从官方页面下载 ChatGPT 的 Mac 安装文件。
- 下载完成后打开安装文件，按提示完成安装。
- 打开安装好的 ChatGPT，再继续下方 CC Switch 接入流程。
当前官方 Mac 下载入口标注为 Apple Silicon（M 系列）；Intel Mac 用户请先确认兼容性，不预设所有机型均支持。
02
验证邮箱并完成注册
按页面提示完成人机验证；点击「发送验证码」，填写邮箱收到的验证码，勾选用户协议及隐私政策，再点击「创建账户」。注册成功后使用用户名或邮箱登录。人机验证的形式和显示位置以当前页面为准。
进入控制台03
04
兑换或充值额度
打开钱包，向下找到「有兑换码吗？」区域，输入兑换码并点击「兑换额度」。如需在线充值，按页面当前提供的金额、付款方式和提示操作。
05
进入 API 密钥管理
在控制台侧边栏进入「常规 → API 密钥」。新版支持「卡片视图」和「表格视图」，右上角可切换显示方式；两种视图管理的是同一组密钥。
打开 API 密钥06
创建并设置 API 密钥
点击「创建 API 密钥」，在右侧抽屉只填写便于识别的用途/令牌名称，例如 Workbuddy、Codex、Claude Code 或具体项目名，然后点击「保存更改」。
07
08
从密钥菜单打开 CC Switch 导入弹层
找到刚创建的 API 密钥，点击卡片右下角的「⋯」菜单，选择「CC Switch」。表格视图则打开目标密钥行的更多菜单。随后会出现「填入 CC Switch」弹层。
09
选择接入软件和主模型
在官网的「填入 CC Switch」弹层中先选择「应用」，再从下拉列表选择与该软件适配的「主模型」。名称可以保持默认；切换应用后需要重新选择主模型。
接入 Codex：应用选择 Codex，选择主模型即可。
接入 Claude Code：应用选择 Claude，只选择主模型；Haiku、Sonnet、Opus 等可选模型字段不要填写。
10
导入 CC Switch，重启对应软件并测试
点击「打开 CC Switch」。浏览器询问是否打开应用时，确认打开你已安装的 CC Switch；在软件中核对应用与主模型并确认导入、启用该供应商。
完全退出并重新启动所选的 Codex 或 Claude Code，再新建任务发送 hi。收到正常回复后，才表示该软件接入完成。
故障排查
没有成功时按顺序检查
1CC Switch 中是否已导入并启用对应应用的云筑Hub 供应商。
2应用和主模型是否选对；不要把 Codex 和 Claude Code 的配置混用。
3是否完全退出并重新启动对应软件。
4API 密钥是否有效、所选主模型是否可用、账户余额是否充足。
