CC Switch 图形化接入
CC Switch 是一个免费的小软件,帮你把 Claude Code 的「请求发到哪、用哪个密钥」配好,全程在窗口里点,不用手敲命令。以后换密钥、换服务商也是点一下的事。整套大约 10 分钟。
先选你的电脑系统:
开始前要有一个 unipaxtools 的 API 密钥。还没有的话先做 新手路线第 1–3 步(注册、付款、建密钥),做完回到这里。
1下载并安装 CC Switch
约 3 分钟
打开官方下载页 github.com/farion1231/cc-switch/releases/latest,往下滚到 Assets 区。只显示几行的话,点底部的 Show all NN assets 展开全部。
Assets 区:按系统找对应的安装包
只从这个 GitHub 页面或 ccswitch.io 下载。别的网站给的安装包可能被改过,会偷你的密钥。
点名字以 -Windows.msi 结尾的那个下载(例如 CC-Switch-v3.19.2-Windows.msi)。
| 你的电脑 | 下载哪个 |
|---|---|
| 普通 Windows 笔记本 / 台式机(绝大多数) | …-Windows.msi |
| 骁龙处理器的 ARM 笔记本 | …-Windows-arm64.msi |
| 不想安装,解压就用 | …-Windows-Portable.zip |
名字带 .sig 的是校验文件,不是安装包,不要下。
双击下载好的 .msi,一路点 下一步 装完。如果弹出蓝色的「Windows 已保护你的电脑」,点 更多信息 → 仍要运行。
Microsoft Defender SmartScreen 阻止了无法识别的应用启动…
更多信息
点名字以 -macOS.dmg 结尾的那个下载(例如 CC-Switch-v3.19.2-macOS.dmg)。Intel 和 M 系列芯片都用这一个。
双击打开 .dmg,把 CC Switch 图标拖进旁边的 Applications 文件夹,然后到「启动台」里打开它。
第一次打开如果提示「无法验证开发者」或「已损坏」:打开 系统设置 → 隐私与安全性,往下翻到安全性一栏,点 CC Switch 旁边的 仍要打开,输入开机密码确认。
电脑上装了 Homebrew 的也可以在终端里一条命令装:brew install --cask cc-switch。
CC Switch 窗口打开,左上角蓝色的「CC Switch」字样,右上角一个橙色的 + 按钮,中间是空的服务商列表。
2安装 Claude Code
约 3–5 分钟 · 已经装过的跳过
CC Switch 只负责「配置」,干活的是 Claude Code,所以它也要装。不会打开终端的先看 终端怎么打开、怎么粘贴。
先装 Git(下载后一路 Next)。Windows 上的 Claude Code 没有它跑不起来。
打开 Windows PowerShell,粘贴下面这行,回车,等它跑完:
irm https://claude.ai/install.ps1 | iex打开 终端,粘贴下面这行,回车,等它跑完:
curl -fsSL https://claude.ai/install.sh | bash关掉终端重新打开,输入 claude --version 回车,出现 2.x.x (Claude Code) 这样的版本号就装好了。没出现看 报错对照表 · 安装阶段。
3把 unipaxtools 加进 CC Switch
约 1 分钟
办法一:一键导入(推荐)
先让 CC Switch 开着,然后在浏览器里登录 unipaxtools 控制台,左边菜单点 API 密钥。
在你要用的那个密钥这一行,最右边「操作」里点 导入到 CCS。
API 密钥列表:每行右边的「操作」里有「导入到 CCS」
浏览器顶部弹出「要打开 CC Switch 吗?」,点 打开 / 允许。CC Switch 会弹出来,地址和密钥已经填好,点确认导入。
点了没反应:确认 CC Switch 已经装好并且打开过一次;浏览器拦截了弹窗的话,地址栏右边会有个小图标,点它选允许。还是不行就用下面的办法二手动填。
办法二:手动填三个格子
点 CC Switch 右上角橙色的 +。在一大片预设图标里,unipaxtools 不在里面,点最左上角蓝色的 自定义配置。
添加新供应商页:点左上角「自定义配置」
往下滚到表单,只填这三项,其他都不用管:
自定义配置表单:供应商名称 / API Key / 请求地址
| 格子 | 填什么 |
|---|---|
| 供应商名称 | Unipaxtools(随便起,认得出就行) |
| API Key | 你的密钥,sk- 开头那串 |
| 请求地址 | https://us-proxy.unipaxtools.com |
https://us-proxy.unipaxtools.com
点右下角 添加 保存。
请求地址结尾不要加 /,也不要加 /v1。密钥前后别带空格。这两处错了会报 401。
4点亮 Unipaxtools 卡片
约 10 秒
窗口顶部那排是不同软件的图标,先点第一个(橙色星芒,Claude Code),确认它是选中状态。
再点一下下面列表里的 Unipaxtools 卡片。
点亮后:卡片变成蓝色边框,右边显示剩余额度
卡片边框变蓝、底色变浅蓝,右边出现「剩余:… USD」。这就切好了,不用重启。
5启动 Claude Code 验证
约 1 分钟
新开一个终端窗口,进到你要干活的文件夹,输入 claude 回车。第一次会让你选主题(直接回车)、问是否信任这个文件夹(选 Yes 回车)。
随便问一句,能正常回答就通了。再去控制台 使用记录 页看一眼,有这条记录就确认是走的 unipaxtools。
启动后要你登录 Anthropic 账号(Select login method):说明第 4 步卡片没点亮,或者没选中 Claude Code 图标,回去再点一次,然后关掉终端重开。
之前按 新手路线第 6 步做法 B 用命令设过地址和密钥的,那边的设置会和 CC Switch 打架,删掉命令那份:
在 PowerShell 里执行[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL",$null,"User"); [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN",$null,"User"),然后重开 PowerShell。
在终端里执行 sed -i '' '/ANTHROPIC_/d' ~/.zshrc,然后关掉终端重开。
日常用法
从托盘快速切换
CC Switch 会在 任务栏右下角屏幕右上角菜单栏 常驻一个小图标。点它,不用打开主窗口就能切换服务商,每个软件后面写着它当前用的是哪家。
托盘菜单:鼠标移到「Claude · Unipaxtools」上展开切换
换了新密钥
在卡片上点编辑(铅笔图标),把 API Key 换成新的保存;或者直接在控制台对新密钥点一次 导入到 CCS,再点亮新卡片。
Codex 也想走 unipaxtools
顶部图标先点 Codex(OpenAI 那个),再点 Unipaxtools 卡片。每个软件各自记住自己的服务商,互不影响。Codex 怎么装见 Codex(GPT)接入。
进阶设置(可以不看)
只用 unipaxtools 一家的话,下面这些都保持默认就行。点主窗口左上角的齿轮进设置。
「通用」页:显示哪些软件、界面语言
设置 →「通用」页
主页面显示:勾你要用的软件(Claude Code、Codex 等),不用的取消,主界面更清爽。
Codex 应用增强 → 非接管切换时保留官方登录:用 Codex 的建议打开,切到 unipaxtools 后官方插件、手机远程这些功能不受影响。
「路由」页:本地路由服务
本地路由:总开关 + 监听地址 127.0.0.1 / 端口 15721
CC Switch 可以在本机起一个转发服务。打开路由总开关后状态变成运行中;监听地址 127.0.0.1、端口 15721 没特殊需要别改,改了要点保存并重启路由服务。
「自动故障转移」:有多个服务商时自动切换
自动故障转移:要先启动路由服务
要先在「本地路由」里打开总开关,这里才能配。选好软件标签,把服务商按顺序加进队列,再打开「自动故障转移」。请求失败时会按顺序换下一家。
