cc-switch

cc-switch

多个 AI 编程工具共用一套配置 · 点一下换供应商和密钥

版本 v4.0.28作者 开源社区协议 开源分类 AI工具 Windows macOS Linux

软件介绍

Claude Code、Codex、Gemini CLI 各有各的配置文件,想换一家 API 供应商,就得手动改 JSON 或 TOML,密钥、模型、接口地址一项项对着填。CC Switch 把这些收进一个桌面窗口,选预设、填密钥、点一下就能切换。

除了换供应商,它还把 MCP 服务器、Skills 和提示词收在同一处,添加一次再勾选同步给哪几个工具,不必每换一个工具就重配一遍。愿意折腾的话,还能让请求先经本机转发,做到格式互转和自动换备用线路。

切换时只替换接口地址、密钥和模型,自己加的插件、hooks 和注释都留在原处;Windows、macOS、Linux 都有原生安装包。

核心功能

一键切换供应商

90 多个预设覆盖官方渠道、中转服务和 AWS Bedrock 等云厂商,挑一个粘贴密钥就行,不用记各家接口怎么写。

一个窗口管十二款工具

Claude Code、Codex、Gemini CLI、Kimi Code 等 12 款工具集中在一处管理,不用在多个配置文件夹之间来回翻。

集中管理 MCP 与 Skills

MCP 服务器和 Skills 只添加一次,再勾选要同步的工具;提示词按工具分开保存,各自的写法互不影响。

三种连接方式按需选

直连、本地路由、聚合随你挑。走路由时能在 Claude Code 里用上 GPT 模型,也能在 Codex 里用 Claude。

会话记录整理成阅读视图

把每个工具的原始日志排成能读的页面,哪一轮动了哪些文件、哪一步失败,扫一眼就知道问题出在哪。

用量与余额直接显示

供应商卡片和托盘上直接写 token 用量、花费,以及订阅剩余额度和账户余额,不必再开网页去查。

安装与使用

  1. 在下载页按系统挑文件:Windows 选 .msi 安装包或 Portable 便携版,macOS 选 .dmg,Linux 按发行版选 .deb、.rpm 或 AppImage。
  2. macOS 也可以直接用 Homebrew 装:brew install --cask cc-switch;Arch Linux 用 paru -S cc-switch-bin。
  3. 打开软件,从预设列表里挑一个供应商,填上自己的 API 密钥,点一下切换。
  4. 回到 Claude Code 或 Codex 正常使用即可,自己原有的插件、MCP 和注释不会被覆盖。
  5. 在 MCP 页面把常用服务器添加一次,勾选要同步的工具,以后新装的工具也不用重新配。
  6. 切换前先点 MCP 页面的「检查连通性」,一次把所有已启用的服务器试一遍,连不上的会当场标出来。

运行环境要求

操作系统Windows 10 / 11
其他Linux 需要 glibc 2.35 及以上和 WebKitGTK 4.1,RHEL / Rocky / Alma 8–9 暂时装不了
其他本地路由和聚合模式下,CC Switch 需要保持运行才能转发请求

常见问题

Q:切换供应商会不会把我原来的设置弄丢?
A:不会。切换只换接口地址、密钥和模型这三项,插件、hooks、MCP 配置和你自己写的注释都保持原样。
Q:本地路由必须开吗?
A:不是。直连模式就是把工具直接接到供应商,不开路由照样能用;只有需要格式互转或失败时自动换一家,才要打开路由。
Q:我的 Linux 发行版能装吗?
A:需要 glibc 2.35 及以上并带 WebKitGTK 4.1,例如 Ubuntu 22.04+、Debian 12+ 和较新的 Fedora;RHEL、Rocky、Alma 8–9 暂时不支持。
Q:官方额度快用完时能不能提前停下?
A:可以。Codex 走本地路由用官方账号时,打开「官方额度保护」,五小时或每周使用率达到阈值(默认 95% 和 98%)就暂停官方请求,第三方模型照常可用。

版本更新内容

当前版本 v4.0.28 更新内容(内容较多时可在框内滚动查看)

4.0.28 · 2026-11-08

以适配新版 Codex 的会话分组为主,新增暂停官方登录开关与应用安装进度显示

  • 新增:新版 Codex 官方与第三方会话分开,直连切换后旧会话只能查看,可在设置里开启统一 Codex 会话历史解决
  • 新增:路由或聚合模式下切到第三方,会话与官方订阅留在同一组,来回切换都能继续
  • 新增:路由或聚合设置里可打开暂停使用官方登录,官方额度用完也能继续用第三方模型,开关后需重启 Codex
  • 优化:官方额度保护改为默认开启,五小时额度到 95% 或每周到 98% 时暂停官方请求,第三方照常可用
  • 优化:应用页安装与升级会显示排队状态和实时进度,离开页面再回来进度仍在
  • 优化:Codex 不再写入新版已删除的配置项,避免每次启动提示无法识别的配置
  • 修复:Codex 故障转移到备用供应商时仍带上一家模型名,导致报模型不存在
  • 修复:Kimi、DeepSeek 上压缩上下文失败、续接工具调用后会话一直报 400 的问题

4.0.27 · 2026-11-07

新增会话正文搜索与界面密度缩放设置,并集中修复软链接配置、熔断恢复等问题

  • 新增「搜索消息正文」 开关,可在本地索引里搜到聊天内容,默认关闭
  • 新增界面密度和界面缩放设置,缩放有 90% 到 125% 四档,只保存在本机
  • 新增模型定价表搜索框,可按模型 ID 或名称筛选,按回车即可编辑或新增
  • 优化 Skills 已安装页排版,筛选和批量操作更顺手;供应商图标会跟随深浅色主题
  • 优化 Grok Build 正在使用的供应商可打开终端;右键不再弹出浏览器自带菜单
  • 修复配置文件是软链接时被替换成普通文件或写入失败的问题
  • 修复请求取消后供应商卡在熔断恢复中、Codex 自定义权限下 plan 模式报错、Skill 误报可更新等问题
  • 修复 Linux 快捷面板显示异常、对话框打开时窗口拖不动、模型价格同步超时等问题

4.0.26 · 2026-11-05

新增账号订阅计划显示与更多应用的一键导入,并做了一轮性能优化和多项修复。

  • 新增:授权中心和官方供应商卡片会显示每个账号的订阅计划,Max 和 Free 账号一眼就能区分。
  • 新增:GitHub Copilot 账号列出所有有上限的额度,Free 账号的代码补全和聊天次数也能看到。
  • 新增:一键导入链接支持 Claude Desktop、MiniMax Code、Kimi Code 等更多应用的供应商。
  • 新增:Codex 卡片可保留官方 Fast 档,转发官方 ChatGPT 账号的中转能用上更快的速度档。
  • 新增:DeepSeek Harness 可设置配置目录,装在 WSL 里也能在 CC Switch 中管理。
  • 注意:Clash 这类代理工具可能把本地路由请求转走,返回空 502,进入路由模式时会有提示和设置方法。
  • 优化:供应商列表、启动、会话读取和路由转发都更快,会话同步占用数据库时界面不再卡住。
  • 修复:IPv6 不通时经路由请求先卡两分多钟、Copilot 用 Grok 报 422 和回复显示两遍等问题。

4.0.25 · 2026-11-02

新增 MCP 连通性检查与 Codex 官方额度保护,修复本地路由相关问题

  • 新增 MCP 连通性检查,可一键检查所有已启用的服务器,也能单独测试某一台。
  • 新增 Codex 官方额度保护,可设置使用率阈值,快用完时自动暂停官方请求,第三方模型照常可用。
  • 新增用量页汇率自动获取,超过 12 小时自动更新,费用仍按美元记录。
  • 新增 Codex 子代理并发上限设置,会话管理里可直接删除 Kimi Code 会话。
  • 优化 Claude Code 和 Claude Desktop 的模型菜单,写明模型来自哪个供应商、实际是哪个模型。
  • 注意 本地路由不再接受网页发来的请求,避免额度被网页用掉,编程工具的请求不受影响。
  • 修复路由模式下打开终端混入其他设置、OpenCode Go 等供应商要求重新登录、纯文本模型收到文件后每轮报错。
  • 修复 Windows 上供应商表单内容闪烁、启动后托盘面板打不开、Codex 用量被重复计算等问题。

4.0.21 · 2026-10-26

新增多个 Claude 官方账号切换,并修复 Codex 路由错发、登录状态误报等问题

  • 新增:可在多个 Claude 官方订阅账号间切换,每张官方卡选一个号,换卡就换号,想多个号同时用可从卡片上「打开终端」
  • 新增:卡片和授权中心显示每个号的套餐与剩余额度,登录令牌只留在本机,不上传、不刷新、不登出
  • 新增:Codex 供应商的模型列表可以拖动排序,顺序就是 Codex 里 /model 菜单的顺序
  • 优化:「打开终端」 移到卡片上;轻量模式退出后重启仍保持轻量模式
  • 优化:MCP 选 SSE 时会提前提示哪些应用不支持;OpenCode 的 OMO 卡片不再显示无用的连通检测
  • 修复:托管的 ChatGPT 账号重启后误报「登录已过期」、不能切换,过一会儿又自己恢复的问题
  • 修复:Codex 经本地路由时请求可能发到别的地址;MCP 配置多出 timeout、autoApprove 导致 Codex 拒绝加载
  • 修复:npm 12 下 OpenCode 和 Grok Build 装不上、Kimi Code 用量时间不对、部分配置含特殊字符时无法编辑等问题

4.0.20 · 2026-10-24

新增对 Oh My Pi 的支持,改进应用管理与账号编辑,修复一批用量统计和显示问题

  • 新增:支持 Oh My Pi 应用,可管理供应商、MCP、Skills、提示词和会话,并在应用页安装升级卸载
  • 新增:托管 ChatGPT 账号可选择浏览器登录,适合关闭了设备代码登录的企业工作区
  • 优化:应用页按已安装和未安装分组,已安装的应用可拖动排序,侧栏跟着调整
  • 优化:Kimi 官方账号卡片可编辑模型、从 Kimi Code 移除;未订阅套餐的账号显示未订阅
  • 优化:余额为零或欠费时仍显示具体金额,卡片和托盘用颜色区分额度查询失败
  • 修复:DeepSeek 余额用完误显示套餐已过期、Kimi Code 子代理用量漏统计的问题
  • 修复:Skills 安装更新报 HTTP 429、Pi 用环境变量引用 Key 查询额度报 401 的问题
  • 修复:Claude Code 会话标题显示成命令输出、Linux 开启应用级窗口按钮后页头拖不动的问题

相关推荐

更多软件
返回软件中心