unipaxtools 文档
官网 教程首页 免费注册
← 返回教程首页

CC Switch 图形化接入

CC Switch 是一个免费的小软件,帮你把 Claude Code 的「请求发到哪、用哪个密钥」配好,全程在窗口里点,不用手敲命令。以后换密钥、换服务商也是点一下的事。整套大约 10 分钟。

先选你的电脑系统:

开始前要有一个 unipaxtools 的 API 密钥。还没有的话先做 新手路线第 1–3 步(注册、付款、建密钥),做完回到这里。

1下载并安装 CC Switch

约 3 分钟

1

打开官方下载页 github.com/farion1231/cc-switch/releases/latest,往下滚到 Assets 区。只显示几行的话,点底部的 Show all NN assets 展开全部。

Assets 区:按系统找对应的安装包Assets 区:按系统找对应的安装包

只从这个 GitHub 页面或 ccswitch.io 下载。别的网站给的安装包可能被改过,会偷你的密钥。

2

点名字以 -Windows.msi 结尾的那个下载(例如 CC-Switch-v3.19.2-Windows.msi)。

你的电脑下载哪个
普通 Windows 笔记本 / 台式机(绝大多数)…-Windows.msi
骁龙处理器的 ARM 笔记本…-Windows-arm64.msi
不想安装,解压就用…-Windows-Portable.zip

名字带 .sig 的是校验文件,不是安装包,不要下。

3

双击下载好的 .msi,一路点 下一步 装完。如果弹出蓝色的「Windows 已保护你的电脑」,点 更多信息 → 仍要运行。

!
仍要运行点「更多信息」后才会出现这个按钮
点这个
Windows 拦截提示的样子
2

点名字以 -macOS.dmg 结尾的那个下载(例如 CC-Switch-v3.19.2-macOS.dmg)。Intel 和 M 系列芯片都用这一个。

3

双击打开 .dmg,把 CC Switch 图标拖进旁边的 Applications 文件夹,然后到「启动台」里打开它。

4

第一次打开如果提示「无法验证开发者」或「已损坏」:打开 系统设置 → 隐私与安全性,往下翻到安全性一栏,点 CC Switch 旁边的 仍要打开,输入开机密码确认。

电脑上装了 Homebrew 的也可以在终端里一条命令装:brew install --cask cc-switch。

做对了会看到

CC Switch 窗口打开,左上角蓝色的「CC Switch」字样,右上角一个橙色的 + 按钮,中间是空的服务商列表。

2安装 Claude Code

约 3–5 分钟 · 已经装过的跳过

CC Switch 只负责「配置」,干活的是 Claude Code,所以它也要装。不会打开终端的先看 终端怎么打开、怎么粘贴。

1

先装 Git(下载后一路 Next)。Windows 上的 Claude Code 没有它跑不起来。

2

打开 Windows PowerShell,粘贴下面这行,回车,等它跑完:

irm https://claude.ai/install.ps1 | iex
1

打开 终端,粘贴下面这行,回车,等它跑完:

curl -fsSL https://claude.ai/install.sh | bash
✓

关掉终端重新打开,输入 claude --version 回车,出现 2.x.x (Claude Code) 这样的版本号就装好了。没出现看 报错对照表 · 安装阶段。

3把 unipaxtools 加进 CC Switch

约 1 分钟

办法一:一键导入(推荐)

1

先让 CC Switch 开着,然后在浏览器里登录 unipaxtools 控制台,左边菜单点 API 密钥。

2

在你要用的那个密钥这一行,最右边「操作」里点 导入到 CCS。

API 密钥列表:每行右边的「操作」里有「导入到 CCS」API 密钥列表:每行右边的「操作」里有「导入到 CCS」
3

浏览器顶部弹出「要打开 CC Switch 吗?」,点 打开 / 允许。CC Switch 会弹出来,地址和密钥已经填好,点确认导入。

点了没反应:确认 CC Switch 已经装好并且打开过一次;浏览器拦截了弹窗的话,地址栏右边会有个小图标,点它选允许。还是不行就用下面的办法二手动填。

办法二:手动填三个格子

1

点 CC Switch 右上角橙色的 +。在一大片预设图标里,unipaxtools 不在里面,点最左上角蓝色的 自定义配置。

添加新供应商页:点左上角「自定义配置」添加新供应商页:点左上角「自定义配置」
2

往下滚到表单,只填这三项,其他都不用管:

自定义配置表单:供应商名称 / API Key / 请求地址自定义配置表单:供应商名称 / API Key / 请求地址
格子填什么
供应商名称Unipaxtools(随便起,认得出就行)
API Key你的密钥,sk- 开头那串
请求地址https://us-proxy.unipaxtools.com
https://us-proxy.unipaxtools.com
3

点右下角 添加 保存。

请求地址结尾不要加 /,也不要加 /v1。密钥前后别带空格。这两处错了会报 401。

4点亮 Unipaxtools 卡片

约 10 秒

1

窗口顶部那排是不同软件的图标,先点第一个(橙色星芒,Claude Code),确认它是选中状态。

2

再点一下下面列表里的 Unipaxtools 卡片。

点亮后:卡片变成蓝色边框,右边显示剩余额度点亮后:卡片变成蓝色边框,右边显示剩余额度
做对了会看到

卡片边框变蓝、底色变浅蓝,右边出现「剩余:… USD」。这就切好了,不用重启。

5启动 Claude Code 验证

约 1 分钟

1

新开一个终端窗口,进到你要干活的文件夹,输入 claude 回车。第一次会让你选主题(直接回车)、问是否信任这个文件夹(选 Yes 回车)。

claude
✻ Welcome to Claude Code! /help for help, /status for your current setup > 你好,介绍一下你自己
2

随便问一句,能正常回答就通了。再去控制台 使用记录 页看一眼,有这条记录就确认是走的 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」上展开切换托盘菜单:鼠标移到「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本地路由:总开关 + 监听地址 127.0.0.1 / 端口 15721

CC Switch 可以在本机起一个转发服务。打开路由总开关后状态变成运行中;监听地址 127.0.0.1、端口 15721 没特殊需要别改,改了要点保存并重启路由服务。

「自动故障转移」:有多个服务商时自动切换 自动故障转移:要先启动路由服务自动故障转移:要先启动路由服务

要先在「本地路由」里打开总开关,这里才能配。选好软件标签,把服务商按顺序加进队列,再打开「自动故障转移」。请求失败时会按顺序换下一家。

卡住了?先对照 报错对照表,还解决不了就加客服 QQ 495063912,把报错截图发过来。