企业官网建设流程全解析

CC Switch 完全指南：一个免费桌面应用管住 Claude Code、Codex 等 AI 工具的供应商切换

【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch

在 Claude Code、Codex、Gemini CLI 之间轮换 API 供应商，意味着手改 JSON、TOML 或 .env 文件，还要担心碰坏自己加的配置。CC Switch 是免费的开源桌面应用，把这件事收进一个界面：内置 90 多个供应商预设，一处填好 Key，切换时只改地址、Key、模型这几项关键字段，其余设置原样保留。本文带你从安装到常用场景完整过一遍。

🚀 快速上手：分平台安装 CC Switch

先把应用装起来，再谈它能做什么。支持 Windows、macOS、Linux 三个平台，从仓库 Releases 页面下载对应安装包即可。

• Windows：下载.msi安装包（ARM 设备选 arm64 版本），或绿色免安装的 Portable 压缩包。要求 Windows 10 及以上。
• macOS：推荐用 Homebrew，一条命令完成安装与后续升级；也可从 Releases 下载.dmg，Apple Silicon 和 Intel 芯片都能原生运行。

brew install --cask cc-switch

• Linux：Debian/Ubuntu 选.deb，Fedora 等选.rpm，通用环境用 AppImage（需chmod +x后运行）。Arch 用户可用paru -S cc-switch-bin一行装好。要求 x86_64 或 ARM64，glibc 2.35+ 与 WebKitGTK 4.1，例如 Ubuntu 22.04+、Debian 12+。

首次启动时，它会自动把 Claude Code、Codex、Gemini CLI、Grok Build 的现有配置导入为名为default的供应商，并补上各工具的官方供应商。你原来的配置不会丢。

🎯 它替你把哪件烦事办了

场景一：你手上同时有 Claude 官方订阅和两家中转服务，想按价格切换供应商。以前的动作是打开工具、找它的配置文件、改地址和 Key、祈祷没改错格式。现在这个动作变成了：打开 CC Switch，点一家供应商，点"启用"。

场景二：你在 Claude Code 里加过插件、Hook、MCP 和注释。直接改配置文件的工具很容易把它们冲掉。CC Switch 切换时只替换请求地址、Key、模型名、接口协议这几项连接信息，其余内容原样保留；第一次改写每个配置文件之前，还会把原文件备份到~/.cc-switch/backups/live-first-write/。

另外它管理的不只是供应商：MCP 服务器、Markdown 提示词、Skills 技能都有集中面板，添加一次，勾选同步到哪些工具即可。

🗂️ 日常：供应商切换与配置管理

主界面按工具分页（Claude、Codex、Gemini…），每页是一列供应商卡片：

• 卡片显示名称、接入地址和当前使用标记，支持拖拽排序，把最常用的放上面
• 预设库内置90 多家供应商（AWS Bedrock、NVIDIA NIM、各类社区中转），可搜索；也可以"自定义配置"从零填
• 同一份配置可以写成通用供应商，一次同步到 Claude Code、Codex、Gemini CLI 三个工具
• 支持项目整套切换：把当前工具的供应商、MCP、Skills、提示词保存为一个项目，之后一键切换（入口默认隐藏，在「设置 → 通用」打开"显示项目切换"）

添加面板上方就是预设列表，选中后只需填 API Key，请求地址已预置。首次启动导入了官方供应商，所以想回到官方登录时，切到它再按工具自身流程（如 Claude Code 的/login）操作即可。

📊 盯盘：用量、成本与额度

• 不用开路由也能统计：默认自动扫描各工具的本地会话记录，按供应商和模型统计请求数、Token、缓存命中率、输出速度和花费
• 仪表板：总成本、总请求数、真实消耗 Token、缓存命中率，外加全年热力图和逐条请求日志
• 额度倒计时：供应商卡片和系统托盘上直接显示剩余量，例如"5 小时剩余 94%"，覆盖 Claude/ChatGPT/Gemini 官方订阅和 Kimi、智谱 GLM、MiniMax 等 Coding Plan 额度
• 自定义定价：按模型设置单价，也可以从 models.dev 导入，让成本数字更准

🛡️ 稳定运行：本地路由、故障转移与云同步

想让 Claude Code 用 GPT 格式的供应商、或让 Codex 用 Claude？开本地路由：请求经本机转发，在 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses、Gemini Native 四种格式之间自动转换。具体玩法见仓库里的攻略文档 在 Claude Code 中使用 GPT 和 在 Codex 中使用 Claude。

• 自动故障转移：为每个工具配置供应商队列，请求失败时按顺序自动改道，配合熔断器和健康监控
• 聚合模式：多家供应商的模型同时出现在 Claude Code 或 Codex 的模型选择器里，选哪个模型请求就发给哪家，不用回 CC Switch 切换
• 云同步：通过 WebDAV（坚果云、Nextcloud、NAS）或 S3 兼容存储（Cloudflare R2、阿里云 OSS 等）在多台设备间保持配置一致

🧩 三套可以叠加的工作流

1. 多设备一致：云同步 + 开机自启。家里电脑和公司笔记本同步同一份供应商库，开机就在托盘就绪，换机器不用重新填 Key。
2. 高频切换：系统托盘直切 + 用量盯盘。托盘里每个工具一行，显示"名称 · 供应商 · 额度"，不打开主窗口就能换供应商；额度见底时卡片上的倒计时提醒你该切哪家。
3. 格式混搭：本地路由 + 故障转移。给路由配一条供应商队列，主线路挂了自动切备用，整条链路比单点直连稳。

❓ 避坑速查

🔍 幕后一瞥

技术栈一句话：Tauri 2 + Rust 写后端，React 18 + TypeScript + Vite + TailwindCSS 写前端，数据落在本地 SQLite（~/.cc-switch/cc-switch.db），写入采用原子操作防止配置损坏。

进阶小功能合起来记：深色/浅色/跟随系统三种主题；自动更新；简体中文、繁体中文、英文、日文四语界面；OpenClaw 工作区编辑器可直接编辑 AGENTS.md、SOUL.md；Hermes 记忆管理可改 MEMORY.md、USER.md；ccswitch://深度链接可一键导入供应商、MCP 和提示词。

📚 资料与下一步

• 完整用户手册（安装、供应商、MCP、路由、FAQ）：docs/user-manual/zh/
• 功能支持矩阵与更新历史：README_ZH.md 与 CHANGELOG.md
• 贡献与问题反馈：CONTRIBUTING.md

装好 CC Switch，把最常用的三四个供应商卡片排到最上面，剩下的交给托盘。

【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch