CC Switch 使用教程

📖 项目简介

CC Switch 是一款跨平台桌面端的「AI 编程工具配置管理器」，用一个 App 同时管住 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 共 7 款 主流 AI 编程工具。它内置 50+ 服务商预设，让你不用再手动编辑 JSON、TOML、.env 配置文件，可视化界面里点一下就能一键导入供应商、瞬间切换模型，特别适合想给 Codex、Claude Code 一键接入国产大模型（DeepSeek、智谱、Kimi、通义千问等）来省钱、提速的开发者。

它基于 Tauri 2 + Rust 构建，所有数据存在本地 SQLite，采用原子写入防止配置损坏；还支持系统托盘秒切换、统一管理 MCP 与 Skills、通过 Dropbox/OneDrive/iCloud/WebDAV 云端同步多设备。

📎 相关链接与下载地址（点击展开）

GitHub 项目： github.com/farion1231/cc-switch
安装包下载： GitHub Releases 页面
官方网站： ccswitch.io
更多教程：关注公众号 / 抖音 / 视频号「IT小圈」

✨ 核心亮点

🧩

一个App管7款工具

Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等统一管理

🗂️

50+ 服务商预设

国产大模型、AWS Bedrock、NVIDIA NIM 等，选好直接切换

⚡

托盘秒切换

系统托盘点一下即可切换供应商，无需打开主界面

☁️

云端同步 + 原子写入

多设备同步配置，SQLite 原子写入防止配置损坏

🚀 如何使用

下载安装 CC Switch

在 GitHub 搜索「cc-switch」进入项目主页，打开 Releases 页面，按系统选择安装包：Windows 选 .msi 或免安装的 Portable.zip；macOS 推荐 .dmg（已签名公证，可直接打开），或用 Homebrew 安装 brew install --cask cc-switch；Linux 提供 deb / rpm / AppImage。

选择工具 + 添加供应商

打开 App，左侧选中你要配置的工具（如 Codex 或 Claude Code）。点击「添加供应商」，从 50+ 预设里选择国产大模型（DeepSeek、智谱 GLM、Kimi、通义千问等），或选「自定义供应商」填入 API 端点。

粘贴 API Key 一键导入

在配置表单里粘贴服务商给你的 API Key（如需还可填 Endpoint 地址），点「一键导入」。数据仅保存到本地，不上传任何数据。

启用并切换

选中刚导入的供应商点「启用」，或直接在系统托盘菜单里点供应商名称即可瞬间切换。除 Claude Code 支持热切换外，其它工具切换后重启终端 / CLI 即可生效。回到终端运行 Codex，就已经用上了国产大模型。

切回官方登录（可选）

从预设列表添加一个「官方登录」供应商，切换后执行对应工具的登录 / OAuth 流程，之后即可在官方与第三方供应商之间自由切换。

❓ 常见问题

Q: 切换供应商后需要重启终端吗？

大多数工具需要重启终端或对应 CLI 才能生效。例外是 Claude Code，它目前支持供应商数据热切换，无需重启。

Q: 它支持哪些 AI 编程工具？

支持 7 款：Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes，每款都有专属的供应商预设与配置管理。

Q: 我的配置数据存在哪里？安全吗？

所有供应商、MCP、Prompts、Skills 数据存在本地 SQLite 数据库（~/.cc-switch/ 目录下），采用原子写入防止损坏，并自动保留最近若干份备份。即使卸载 App，你的 CLI 工具也能继续正常工作。

Q: 切换供应商后插件配置丢了怎么办？

用「共享配置片段」功能：在「编辑供应商 → 共享配置面板」点「从当前供应商提取」保存通用数据，新建供应商时勾选「写入共享配置」（默认开启）即可带上插件数据。