CC Switch

CC Switch 是一个开源桌面应用，用来统一管理 Claude Code、Codex、Gemini CLI 等编程工具的服务商配置。它会自动改写这些工具的配置文件，不用手动设置环境变量；导入上上之钥的 Key 后，还能在 CC Switch 里直接看到余额。

最快的方式是在控制台 API 密钥页面点击 Key 右侧的导入到 CCS，一键写入接口地址、密钥和余额查询，不需要手动填写任何内容。

第一步：安装 CC Switch

安装包可以在 CC Switch 官网或 GitHub Releases 下载。

安装后请至少打开一次 CC Switch。首次打开时它会向系统注册 ccswitch:// 链接，之后网页上的一键导入才能唤起它。

第二步：一键导入 Key

登录控制台，进入 API 密钥页面。还没有 Key 的话先点创建密钥；在要使用的 Key 右侧点击导入到 CCS（也可以点使用密钥，在弹窗里点一键导入到 CC Switch）；在弹出的列表里选择要使用的工具：Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、Antigravity CLI。当前分组用不了的工具会置灰并写明原因；Claude Desktop 目前 CC Switch 还不支持一键导入，需要在 CC Switch 里手动添加；浏览器询问「是否打开 CC Switch」时选择允许 / 打开； CC Switch 弹出导入确认窗口，确认后就会新增一个名为上上之钥的供应商。

导入时会自动带上：

接口地址：Claude Code 为 https://upupkey.com，Codex 为 https://upupkey.com（CC Switch 会自己拼上 /v1）；你的 API Key；余额查询脚本：每 30 分钟刷新一次，在供应商卡片上显示剩余额度；接口协议：按工具自动选择（Claude Code 用 Anthropic，Codex / Grok Build 用 Responses，OpenCode / OpenClaw / Hermes / Pi 用 Chat Completions）；默认模型：Codex、Grok Build、OpenCode、OpenClaw、Hermes、Pi 会带上分组里的默认模型（Claude 分组默认 claude-sonnet-5-5，OpenAI 分组默认 gpt-5.5）。

一次只能导入一个工具。想在多个工具里使用，重复点「导入到 CCS」并分别选择即可。需要 CC Switch 4.0.10 或更新版本。

点击按钮后没有任何反应，或提示「CC Switch 未安装」，通常是因为还没有打开过 CC Switch。请先打开一次 CC Switch，再回到网页重试。

第三步：启用并开始使用

在 CC Switch 左侧选中对应工具（Claude Code / Codex / Gemini CLI）；找到刚导入的上上之钥供应商，点击启用。也可以在系统托盘菜单里直接点供应商名称切换；打开终端开始使用：

切换后的生效方式：

手动添加（不使用一键导入）

如果浏览器无法唤起 CC Switch，也可以手动添加：

在左侧选中要配置的工具，点击右上角的 +（添加供应商）；选择创建自定义配置；按下表填写，保存后点击启用。

地址末尾不要加 /v1，否则会变成 /v1/v1/... 导致请求失败。供应商卡片上的检测连通只检查地址能不能连上，不会验证 Key 和模型名，Key 是否正确请以实际对话为准。

常见问题

余额显示「查询失败」

一般是请求地址被手动改成了别的路径。把地址改回 https://upupkey.com，或删除供应商后重新一键导入即可。

Codex 报模型不存在

在 CC Switch 中编辑供应商，把模型改成你的分组里能用的模型。可用模型可以在本站模型页面或 API 密钥的使用密钥弹窗中查看。

提示余额不足或 401

确认 Key 没有被禁用、没有过期，并且账户余额充足。可以在控制台 API 密钥页面查看 Key 状态。