CC Switch：7个编程工具配置一站管

我的桌面上躺着六个不同的配置文件。Claude Code 用 JSON，Codex 也是 JSON 但字段名完全不一样，Gemini CLI 非要环境变量。每次换 API 供应商，打开这些文件挨个改——漏改一个，第二天开工就是 401。

本文是一篇实操指南。

核心操作

CC Switch 是什么

一个跨平台桌面应用（Win/Mac/Linux），集中管理 7 个 AI 编程工具的配置：Claude Code、Codex、Cursor、Gemini CLI、OpenCode、OpenClaw、Hermes Agent。你在一个界面里管理配置，它自动写到所有工具对应的文件里。

做得到：一键切换 API 供应商、多套 Profile 切换、自动备份、系统托盘热切换（Claude Code 免重启）、AES-256-GCM 加密存储 Key。

做不到：不支持非编程类 AI 工具、不支持配置自动合并、不支持云端同步。

安装

官网发布页：https://github.com/farion1231/cc-switch/releases

Windows：.msi 安装包或 .exe 便携版。macOS：.dmg（区分 Intel 和 Apple Silicon）。Linux：.AppImage / .deb / .rpm。

接入灿海星图

打开 CC Switch → 添加供应商：

• 供应商类型选「OpenAI 兼容」
• Base URL：https://www.lumaocean.com/v1
• API Key：sk-你的Key
• 默认模型：Claude Sonnet 4

点「测试连接」验证。然后勾选你用的工具（推荐起步只勾 Claude Code），点「应用配置」。

工具配置明细表

热切换

系统托盘右键 → 切换供应商 → 选中目标。Claude Code 配置立即生效（每次对话前重读配置）。其他工具需要重启。

多供应商策略

白天主力开发用灿海星图 → 晚上批量任务切 DeepSeek 直连 → 离线开发切本地 Ollama。三种供应商一键切换。

CLI 模式

cc-switch provider add --name "灿海星图" --type openai_compatible --base-url "https://www.lumaocean.com/v1" --api-key "sk-xxx" --model "Claude Sonnet 4"
cc-switch sync --tool claude-code

适合 CI/CD 集成。API Key 从 CI 平台的安全变量读取，不硬编码。

常见疑问

Q1：改了配置后 Claude Code 需要重启吗？

不需要。Claude Code 每次对话前重新读取配置文件。但 Codex、Gemini CLI 等仍需要重启终端才能识别新配置。

Q2：API Key 存在本地 SQLite 里安全吗？

AES-256-GCM 加密，密钥从机器硬件特征派生。Key 在数据库中只有密文，只在写入配置文件时临时解密到内存，明文从不落盘。但换了电脑后加密密钥不同，已存储的 Key 无法解密——导出不含 Key 的模板，在新电脑重新填入。

Q3：团队多人用怎么统一配置又不泄露 Key？

导出不含 Key 的模板 JSON 文件（包含供应商 URL、模型、工具勾选），分发后每人只填自己的 Key。不要共用同一个 Key。

我为什么不用手动改配置文件

手动维护 6 个不同格式的配置文件，每次换供应商要改 6 个地方。有两个致命问题：(1) 格式不一致容易改错——JSON 多一个逗号、YAML 缩进少一个空格，配置文件静默失效；(2) 不同工具的字段名叫法完全不同——这个叫 ANTHROPIC_AUTH_TOKEN，那个叫 apiKey，还有一个叫 GEMINI_API_KEY。CC Switch 维护了一份字段映射表，把这些差异封装在工具内部。

数据来源：CC Switch GitHub仓库 (github.com/farion1231/cc-switch)；各工具官方配置文档。