这里写目录标题

还在手动改配置？这款神器让AI编程工具秒切API！

一个工具搞定 Claude Code、Codex、Gemini CLI… 多环境切换从未如此简单

在这里插入图片描述

😫 你是不是也遇到过这些痛点？

  • API被墙了，想切到国内镜像，却要翻文档、改JSON配置文件
  • 团队里每个人配置都不一样，排查问题像破案
  • 多个AI工具（Claude Code、Codex、Gemini CLI）配置分散，管理混乱
  • 不知道花了多少钱，API用量像黑盒
  • 想试试新的API提供商，又怕改错配置把环境搞崩

如果你中了任意一条，今天介绍的这款工具就是为你量身打造的！

🚀 CC Switch：AI编程工具的「万能遥控器」

CC Switch 是一款桌面端工具，专门解决多AI编程工具的API配置管理难题。

它支持 Claude Code、OpenAI Codex、Gemini CLI、OpenCode、OpenClaw 五款主流AI编程工具的统一管理，让你告别手动改配置的痛苦。

功能 说明
🔄 一键切换 Provider 保存多套 API 配置，点一下即可切换，无需手动编辑 JSON
🖥️ 多应用统一管理 同时管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五款工具
🛡️ 本地 API 代理 内置高性能 HTTP 代理，支持自动故障转移与请求监控
🔌 MCP 服务器管理 可视化添加、编辑和同步 MCP 服务器配置
📊 用量统计 实时查看 Token 消耗与 API 费用
💾 备份与恢复 自动备份配置，防止误操作导致数据丢失

✨ 核心功能一览

一键切换 Provider

保存多套API配置（官方API、国内镜像、第三方代理），点击即可切换，无需手动编辑任何配置文件！

五款工具统一管理

一个界面同时管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw，再也不用东奔西跑。

内置本地API代理

高性能HTTP代理，支持自动故障转移与请求监控，稳定性拉满。

MCP 服务器可视化配置

告别命令行，图形化添加、编辑和同步 MCP（Model Context Protocol）服务器。

用量统计与成本控制

实时查看 Token 消耗与 API 费用，支持按模型和 Provider 分类查看，花钱心里有数。

WebDAV 自动同步

支持坚果云等 WebDAV 服务，多设备配置共享，团队协作神器！

Claude Rectifier

修复第三方API网关可能不兼容的 Claude thinking block 格式，兼容性更强。

🎯 谁需要这款工具？

人群 使用场景
全栈开发者 在官方API、国内镜像、自建代理之间灵活切换
团队Leader 通过WebDAV同步，统一团队配置，减少沟通成本
成本控制党 监控API开销，避免超额使用导致账单爆炸
工具尝鲜者 快速试用不同AI编程工具，无需重复配置
运维人员 当某个API服务不可用时，秒切备用Provider，故障容灾

📥 安装与使用

支持平台

  • Windows：MSI安装包 / 便携版 ZIP
  • macOS：ZIP解压 / Homebrew安装
  • Linux：DEB、RPM、AppImage

macOS

方式一：直接下载（推荐）

  1. 下载 CC-Switch-vX.X.X-macOS.zip
  2. 解压后将 CC Switch.app 拖入「应用程序」文件夹
  3. 首次启动时右键点击 → 打开，或前往「系统设置 → 隐私与安全性 → 仍要打开」

⚠️ 由于作者没有 Apple 开发者账号，macOS 可能提示"未知开发者"。关闭提示后，前往「系统设置 → 隐私与安全性」点击「仍要打开」，之后每次均可正常启动。

方式二：Homebrew

# 添加 tap 并安装
brew tap farion1231/ccswitch
brew install --cask cc-switch
# 更新
brew upgrade --cask cc-switch

Linux

根据发行版选择对应格式：

发行版 推荐格式 安装命令
Ubuntu / Debian / Mint .deb sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / Rocky .rpm sudo dnf install ./CC-Switch-*.rpm
openSUSE .rpm sudo zypper install ./CC-Switch-*.rpm
Arch / Manjaro / 其他 .AppImage 见下方

AppImage 使用方式：

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

快速上手（3分钟搞定）

在这里插入图片描述

第三步：添加第一个 Provider

点击右上角的 + ，从内置预设中选择（如官方 Anthropic API、DeepSeek、阿里百炼等），或手动填写以下信息：
在这里插入图片描述

  • 名称：便于区分的备注名
  • API Key：服务商提供的密钥
  • Base URL（可选）：自定义代理地址
  • 模型：指定默认使用的模型名称
  • API 格式：Anthropic Messages 原生格式 或 OpenAI Chat Completions 兼容格式

在这里插入图片描述

第四步：切换 Provider

在列表中点击目标 Provider，再点击「启用」，CC Switch 会自动将配置写入对应 CLI 工具的配置文件:

在这里插入图片描述

在终端直接运行 claude 命令时，即会使用新配置。

第五步：验证配置（可选）

点击 Provider 旁的「健康检查」按钮，发送一个测试请求验证 API Key 和网络连通性。

在这里插入图片描述

💡 按 Cmd/Ctrl + , 快速打开设置；按 ESC 关闭当前面板。

进阶功能

在这里插入图片描述

MCP 服务器管理

在「MCP」面板中，可视化添加、编辑和删除 MCP（Model Context Protocol）服务器。配置自动同步到对应 CLI 工具，支持从已安装的应用一键导入现有 MCP 配置。

Skills 管理

Skills 是 Claude Code 的提示词增强功能。CC Switch 支持：

  • 从 GitHub 仓库安装 Skills（内置 baoyu-skills 等预设仓库）
  • 从本地 ZIP 文件安装
  • 管理 Claude Code 和 Codex 的 Skills

在这里插入图片描述

会话管理器（Session Manager）

在「会话」页面，可浏览全部五个应用的历史对话记录，支持目录导航和会话内搜索，并自动按当前应用过滤显示。

在这里插入图片描述

💡 为什么选择 CC Switch？

  • ✅ 图形化界面 - 告别命令行编辑，小白也能轻松上手
  • ✅ 自动备份 - 防止误操作，配置安全有保障
  • ✅ 健康检查 - 一键测试API连通性，确保配置生效
  • ✅ 会话管理 - 浏览历史对话记录，支持会话内搜索
  • ✅ Skills管理 - 支持安装Claude Code的提示词增强功能

🔗 获取方式

GitHub 开源项目：https://github.com/farion1231/cc-switch

🎁 写在最后

AI编程工具越来越丰富，但配置管理却成了新的负担。

CC Switch 的出现，让开发者可以专注于编码本身，而不是纠结于配置文件。

如果你也在用 Claude Code、Codex 或其他AI编程工具，强烈推荐试试这款神器！

📌 收藏本文，配置AI工具不迷路！

👇 转发给还在手动改配置的朋友，解救他们于水火！

如果遇到问题可以咨询我，加群一起交流

在这里插入图片描述

Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

cover

企业内网知识库对接DeepSeek：权限继承与增量索引的工程陷阱

avatar DeepSeek技术社区
cover

DeepSeek API 网关设计：多租户配额与熔断策略的工程实践

avatar DeepSeek技术社区
cover

DeepSeek RAG 查询缓存命中率：为何你的知识库响应忽快忽慢？

avatar DeepSeek技术社区