CC-Switch 使用指南

CC-Switch 是一个跨平台桌面配置管理器，主要解决“我同时在用 Claude Code、Codex、Gemini CLI，配置文件又散又杂”的问题。它不是模型本身，也不是代理服务，而是统一管理这些客户端配置的控制台。

如果你的主目标是“把一批工具都切到 Flash API”，CC-Switch 会非常顺手。

适合谁

• 同时使用多个 AI CLI
• 不想频繁手改 ~/.claude、~/.codex、~/.gemini 之类目录
• 需要配置切换、备份、冲突检查和统一管理

官方定位

根据官方 GitHub README，CC-Switch 主要提供：

• Claude Code / Codex / Gemini CLI 一体化配置管理
• Provider 切换
• 配置导入导出
• 环境变量冲突检测
• MCP 管理
• 系统托盘快速切换

系统要求

官方 README 中给出的系统范围：

• Windows 10+
• macOS 10.15+
• Linux：Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 等主流发行版

安装

Windows

方案 A：MSI 安装包

从 GitHub Releases 下载 Windows.msi 安装。

方案 B：便携版

下载便携版压缩包后解压运行。

macOS

方案 A：Homebrew

brew tap farion1231/ccswitch
brew install --cask cc-switch

方案 B：手动下载

从 Releases 下载 macOS 压缩包。

首次打开若遇到未签名提示，按系统安全设置放行即可。

Linux

根据发行版选择对应包型，官方常见分发方式包括：

• .deb
• AppImage
• AUR 包

Arch Linux 用户可直接走 AUR。

它解决什么问题

统一管理不同工具的 provider

如果你今天要让 Claude Code 走 A 服务，Codex 走 B 服务，Gemini CLI 再走 C 服务，手动切换会很碎；CC-Switch 的核心价值就是把这些配置统一起来。

降低误改配置文件的风险

很多 CLI 工具的配置目录、变量名和文件格式并不一样。CC-Switch 提供可视化编辑和备份，减少“改坏一个就全坏”的情况。

统一管理 MCP

官方 README 里也把 MCP 管理列为核心能力，这对多工具并行使用的人很实用。

推荐用法

第一步：先让每个工具至少能独立启动

不要一上来就把“首次安装 + 首次认证 + 配置切换”全交给 CC-Switch。更稳妥的做法是：

1. 先确认 Claude Code、Codex、Gemini CLI 至少各自能启动
2. 再把配置收敛到 CC-Switch 管理

第二步：用它管理 provider，而不是替你理解 provider

CC-Switch 负责的是管理和切换，不是替你判断某个 API 地址或模型名一定正确。上游地址、Key、模型是否可用，仍然要以服务商文档为准。

用 CC-Switch 管理 Flash API

下面是最常见的填写方式。

Claude Code

• API Base URL：https://ai.flashapi.top
• API Key：你的 Flash API Key
• 模型：选择 Claude 系列模型

Codex

• Base URL：https://ai.flashapi.top/v1
• API Key：你的 Flash API Key
• Model：如 gpt-5.2-codex

Gemini CLI

• Base URL：https://ai.flashapi.top
• API Key：你的 Flash API Key
• Model：如 gemini-2.5-pro

OpenCode

• 接口格式：按模型选 Anthropic、OpenAI 或 Google (Gemini)
• API Key：你的 Flash API Key
• 额外选项：如需要缓存键，可填 {"setCacheKey":true}

第三步：把导出和备份用起来

如果你维护多台机器，或者要在团队里复制配置，导出 / 导入会比手工同步省很多时间。

使用建议

每种工具单独建一套 Flash API 配置

不要偷懒把所有工具都指向同一套字段模板。Claude、Codex、Gemini 的配置格式本来就不同，分开维护更稳。

macOS / Windows / Linux 的差异建议

macOS

• Homebrew 安装最方便。
• 适合个人多工具工作流。

Windows

• GUI 体验友好，适合不想碰配置文件的人。
• 如果 CLI 实际跑在 WSL，记得额外确认路径和同步策略。

Linux

• 更适合已经在桌面 Linux 环境里管理多个 CLI 的用户。
• 如果你纯服务器使用，CC-Switch 的价值会低很多。

官方链接

• 官方仓库：https://github.com/farion1231/cc-switch
• Releases：https://github.com/farion1231/cc-switch/releases