◆

cc-switch 安装使用:Claude Code 账号切换

2026-02-28 07:150

用 Claude Code 稍微久一点就会遇到切换供应商的需求:手上可能同时有官方订阅、几个中转服务的 API key,不同任务想走不同的通道。而配置的落点是配置文件里的那几个环境变量,切一次就得去编辑 JSON,改完还要重启终端。

更麻烦的是工具不止一个。Claude Code、Codex、Gemini CLI 各有自己的配置格式,有的用 JSON,有的用 TOML,有的读 .env。同一个中转服务要在三个工具里各配一遍,格式还都不一样。手改这些文件最实际的风险是写坏 JSON 语法,然后工具启动直接报错,还得回去找哪个逗号多了。

cc-switch 就是来解决这件事的,它是一个桌面应用,把这些工具的配置切换收拢到一个图形界面里。核心能力是供应商管理:内置了几十个供应商预设,粘贴 key 就能导入,之后一键切换。它还能从系统托盘直接切,不用打开主界面。

除了切换供应商,它把 MCP 服务器的配置也统一管了。MCP 配置在各个工具里同样是分开存的,这个面板可以一处配置、双向同步到支持的工具,省掉重复劳动。另外还有提示词文件(CLAUDE.md、AGENTS.md 这类)的跨工具同步、Skills 的一键安装、以及用量和花费的统计面板。

实现上它用 Tauri 构建,配置存在 SQLite 里,写文件走原子写入并带自动备份——这一点对我来说是选它的理由之一,毕竟手改配置最怕的就是写到一半坏掉。

下载

https://github.com/farion1231/cc-switch/releases

Windows、macOS、Linux 三个平台都有包。mac 上更推荐用 Homebrew 装,命令是 brew install --cask cc-switch,升级用 brew upgrade --cask cc-switch,省得每次去翻发布页。它的 mac 版本做了苹果的代码签名和公证,所以不会遇到「文件已损坏」那类需要手动移除隔离标记的问题,下载完直接打开就行。

Arch Linux 可以用 paru -S cc-switch-bin。其他 Linux 发行版从发布页选 deb、rpm 或者 AppImage。

基本用法

装完之后的流程比较直白。

第一次启动时可以把现有 CLI 工具里已有的配置导入进来,作为默认的供应商,这样原本的配置不会丢。

添加供应商是点「添加供应商」,然后从预设列表里挑一个,或者自建一个自定义配置。用预设的好处是各种环境变量的名字和地址都已经填好了,只需要贴 key。

切换有两个入口:主界面里选中某个供应商点启用,或者直接在系统托盘菜单里点它的名字,后者更快。

有一点需要注意:切换之后是否需要重启。Claude Code 不用重启就能生效,但其他 CLI 工具需要重启终端或者重启工具本身,改动才会被读到。这个差异容易让人以为切换没成功。

如果想从中转服务切回官方账号登录,做法是添加一个「官方登录」的预设,切过去之后重启 CLI 工具,然后按它自己的登录流程走一遍 OAuth 认证。

最后提一句安全上的事:这个工具管理的是各家服务的 API key,这些凭据会存在本地的配置库里。它支持通过 Dropbox、iCloud、WebDAV 这些方式在多设备间同步供应商数据,用这个功能就意味着凭据会离开本机,开之前想清楚是否可接受。

💬留言板0

还没有留言,来发表第一条吧~

PAGE LOAD / LIVEcc-switch 安装使用:Claude Code 账号切换加载中