CC Switch 使用
HRET API 已经把 API 密钥、接口地址和模型配置接到 CC Switch 里。小白用户不需要手动复制 base URL，也不需要自己写环境变量，按页面点几下就能把 Claude Code、Codex 或 Gemini 配好。
开始前先确认
已经安装 CC Switch App
CC Switch 是电脑上的桌面应用。没有安装时，点击「打开 CC Switch」通常不会有反应，或者浏览器不知道要打开哪个应用。
已经有 API 密钥
进入 HRET API 左侧边栏的「API 密钥」。如果列表里还没有密钥，先点击「创建 API 密钥」。
密钥状态是已启用
列表里看到绿色「已启用」才可以正常使用。如果密钥被禁用，需要先启用或重新创建。
密钥有可用模型
创建或编辑 API 密钥时，确认这个密钥能看到你要使用的可用模型。模型列表会动态调整，以页面实际展示为准。
推荐方式：页面里直接使用 CC Switch
打开 API 密钥列表
在 HRET API 左侧边栏点击「API 密钥」，找到你要给工具使用的那一行密钥。
点击右侧三个点
在密钥这一行最右侧点击「...」，菜单里会看到「复制密钥」「复制连接信息」「编辑」「CC 切换」「聊天」「删除」。
选择 CC 切换
点击「CC 切换」后，会弹出「填入 CC Switch」窗口。这里就是 HRET API 自带的一键配置入口。
选择你要配置的应用
弹窗顶部有 Claude、Codex、Gemini 三个选项。用 Claude Code 就选 Claude；用 Codex CLI 就选 Codex；用 Gemini 相关工具就选 Gemini。
填写名称
名称只是你本机 CC Switch 里的配置名称，方便以后识别。可以直接用默认的 My Claude、My Codex，也可以改成 work-claude、relay-codex 这种容易记的名字。
选择主模型
「主模型」是必填项。点击下拉框，选择当前可用模型即可；模型列表会随平台配置动态变化。
Claude 可选填 Haiku / Sonnet / Opus
如果你选择的是 Claude，弹窗里还会出现 Haiku 模型、Sonnet 模型、Opus 模型。新手可以先不填，只填主模型即可；熟悉以后再按需要补上。
点击打开 CC Switch
确认应用、名称、主模型都填好后，点击右下角「打开 CC Switch」。接下来按浏览器或系统提示打开 CC Switch，配置会自动带过去。
怎么判断选 Claude 还是 Codex？
| 你要用的工具 | 弹窗里选 | 模型 |
|---|---|---|
| Claude Code | Claude | 选择当前可用模型。新手只填主模型。 |
| Codex CLI | Codex | 选择当前可用模型。 |
| Gemini 相关工具 | Gemini | 选择当前可用模型。 |
常见卡住点
找不到「CC 切换」
先确认你在「API 密钥」列表页，不是在创建弹窗里。CC 切换入口在某一行密钥最右侧的「...」菜单中。
主模型下拉框是空的
通常是这个 API 密钥的分组没有包含对应模型。返回编辑密钥，换成正确分组，或联系管理员确认该分组是否有模型。
不知道模型选哪个
直接选择下拉框里的可用模型即可。如果不确定，选择管理员推荐的模型。
点了「打开 CC Switch」没反应
先确认本机已经安装 CC Switch App。然后检查浏览器是否拦截了弹窗或外部应用打开请求。如果系统提示是否打开外部应用，选择允许。
备用方式：手动复制连接信息
如果你的浏览器打不开 CC Switch，才需要用备用方式。回到 API 密钥这一行的「...」菜单，点击「复制连接信息」，再把复制出来的 API 地址和密钥填到工具里。
# Claude Code 常见手动配置
# Common manual config for Claude Code
export ANTHROPIC_BASE_URL="https://your-relay-domain.com/v1"
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxx"
# Codex CLI 常见手动配置
# Common manual config for Codex CLI
export OPENAI_BASE_URL="https://your-relay-domain.com/v1"
export OPENAI_API_KEY="sk-xxxxxxxxxxxxxxxx"