CC Switch

CC Switch 是什么

CC Switch 是一个 AI 编程工具配置管理器，面向需要同时使用多种 AI 编程 Agent 的开发者。它的核心功能是：把你不同项目、不同场景下的 AI 编程工具配置集中管理，一键切换，而不需要手动修改配置文件、更换环境变量、调整权限设置。

名字里的"CC"来自 Claude Code（Claude Code 的缩写），可以看出它最初的设计重心在 Claude Code 的配置管理上，但现在已经扩展到支持其他主流 AI 编程工具。

解决了什么问题

要理解 CC Switch 的价值，先理解它解决的问题是什么。

以 Claude Code 为例：你可能有几个不同的使用场景——自己的个人项目用个人 Anthropic API Key，公司项目用公司的 API Key，某些项目需要更严格的文件访问限制，某些项目需要更宽松的权限来让 AI 更自由地操作……每次切换场景，你需要手动改 ~/.claude.json 或者对应的配置文件，或者修改环境变量，容易出错，也很烦。

多个工具叠加，情况更复杂：你用 Claude Code 处理大多数任务，但某些场景切换到 Gemini CLI（因为它有免费额度），某些任务用 Codex CLI……每个工具的配置文件格式不同，管理起来混乱。

CC Switch 把这些配置集中管理，你只需要提前设置好不同的配置 profile，切换时选择对应的 profile，工具自动处理后面的配置更新。

核心功能

配置 Profile 管理

你可以在 CC Switch 里创建多个配置 Profile，每个 Profile 包含：

• 工具选择（Claude Code / Gemini CLI / Codex CLI 等）
• API Key（不同 Profile 用不同的 Key）
• 模型选择（比如同样用 Claude Code 但一个 Profile 用 Sonnet 一个用 Haiku）
• 权限设置（文件访问范围、命令执行权限等）
• 其他工具特定的配置参数

Profile 可以按项目命名（"工作项目 A"、"个人开源项目"），也可以按场景命名（"快速任务-低成本"、"复杂重构-高质量"）。

一键切换

设置好 Profile 之后，切换只需要一个命令或者在 CC Switch 的界面里选择，背后的配置文件修改、环境变量设置都自动完成。从"自己的个人项目配置"切换到"公司项目配置"，一秒钟完成，而不是手动翻配置文件。

支持多种 AI 编程工具

CC Switch 支持管理多种工具的配置，包括：

• Claude Code（Anthropic）
• OpenAI Codex CLI
• Gemini CLI（Google）
• 以及其他兼容 OpenAI API 格式的工具

对于需要根据不同任务在工具之间切换的开发者，CC Switch 统一了管理入口。

API Key 安全管理

CC Switch 提供了对 API Key 的安全存储，不同 Profile 的 Key 加密保存，切换 Profile 时自动应用对应的 Key，而不需要把 Key 明文写在多个配置文件里。

谁适合用 CC Switch

同时使用多种 AI 编程工具的开发者：如果你只用一个工具，配置管理问题不突出。一旦你开始用两三个工具，CC Switch 的价值就出来了。

在多个项目间切换的开发者：工作项目和个人项目用不同的 API Key 和配置，CC Switch 让切换无缝。

团队工具标准化：技术 Lead 用 CC Switch 设定好团队使用 AI 工具的标准配置，分发给团队成员使用，保证大家使用同样的设置，减少"为什么你的 Claude Code 行为和我的不一样"的问题。

经常调整 AI 工具参数的用户：对不同任务用不同的模型和参数，CC Switch 让这种细粒度的控制变得方便而不是麻烦。

实际使用场景举例

场景一：个人vs工作项目

• Profile A："个人项目" — 个人 Anthropic API Key，Claude Sonnet，宽松权限
• Profile B："工作项目" — 公司 API Key，Claude Haiku（控制成本），严格文件访问限制

开始工作时切换到 Profile B，下班做个人开源项目时切换回 Profile A，一个命令搞定。

场景二：成本控制

• Profile A："高质量任务" — Claude Sonnet，用于复杂重构和架构分析
• Profile B："快速任务" — Gemini CLI 免费额度 或 Claude Haiku，用于简单的代码解释和格式化

根据任务重要程度选择 Profile，既保证质量又控制成本。

场景三：工具切换

• Profile A：Claude Code 配置
• Profile B：Gemini CLI 配置（某些需要长上下文分析的任务）
• Profile C：Codex CLI 配置（团队用 OpenAI 的场景）

不需要记住每个工具的配置命令，从 CC Switch 选就够了。

和其他工具的比较

CC Switch 的定位比较特殊，它不是 AI 编程工具本身，而是 AI 编程工具的管理层。直接的竞品很少，更多的是类比：

类比 direnv：direnv 是一个根据目录自动加载环境变量的工具，CC Switch 的配置 Profile 机制和这个思路类似，但专注于 AI 编程工具的配置。

类比 pyenv/nvm：这些工具管理不同版本的编程语言运行时，CC Switch 管理不同的 AI 工具配置，都是"环境切换"的概念。

局限

工具本身是辅助性的：CC Switch 不提供 AI 编程能力本身，只管理其他工具的配置。如果你只用一个 AI 编程工具，它的价值很有限。

相对小众：CC Switch 针对的是已经深度使用多种 AI 编程工具的开发者，这个群体目前还不大，社区和文档资源有限。

依赖支持的工具：如果你用的 AI 编程工具不在 CC Switch 支持的列表里，就帮不上忙。

学习成本：初次设置需要理解 Profile 的概念、把各个工具的配置整理进来，有一定的初始投入。

实际建议

先整理清楚自己的使用场景：在使用 CC Switch 之前，把自己用 AI 编程工具的不同场景列出来，搞清楚哪些方面需要区分（API Key、模型、权限），再设计对应的 Profile 结构。

从两三个 Profile 开始：不需要一开始就设置很多 Profile，从最核心的两三个差异化场景开始，用起来了再扩展。

定期整理：随着 AI 工具在快速迭代，Profile 设置可能需要更新，定期检查配置是否还准确。

CC Switch 是 AI 编程工具生态扩大之后的一个顺应需求的工具，对于真正在多工具、多场景之间切换的开发者，它解决的问题是真实存在的。随着 AI 编程工具的生态继续成熟，这类管理工具的价值也会随之增加。