ACORG docs

主题

安装 CC Switch ​

CC Switch 用于统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI CLI 的供应商、MCP、Prompts、Skills、代理、用量和会话。

Windows 11 ​

从 Releases 下载 Windows 安装包:

https://github.com/farion1231/cc-switch/releases

常用文件:

  • CC-Switch-v{版本号}-Windows.msi
  • CC-Switch-v{版本号}-Windows-Portable.zip
  • Windows ARM64 设备选择文件名含 Windows-arm64 的安装包或便携包

不确定电脑架构时,在 Windows 设置的“系统 → 系统信息”中查看“系统类型”；普通 Intel/AMD 电脑选择不带 arm64 的 Windows 文件。文件名可能随 Release 改动,以发布页实际列出的文件为准。

安装后从开始菜单启动,或打开便携版目录中的可执行文件。

macOS ​

推荐使用 Homebrew:

bash
brew install --cask cc-switch

也可以从 Releases 下载 .dmg 或 .zip:

https://github.com/farion1231/cc-switch/releases

如果系统提示来源不明,优先确认下载来源和签名状态,不要随意跳过安全提示。

首次使用 ​

  1. 启动 CC Switch。
  2. 导入已有 Claude Code / Codex 配置。
  3. 新增或编辑供应商。
  4. 切换供应商后重新打开对应 CLI。
  5. 在终端中运行 codex 或 claude 做一次简单验证。

建议验证 ​

  • 能看到已导入的 CLI 配置。
  • 切换供应商后,对应 CLI 能正常启动。
  • MCP、Prompts、Skills 等配置没有被意外清空。
  • 需要代理时,CLI 请求能走到预期代理。

升级 ​

  • Windows:下载新版安装包覆盖安装,便携版直接替换目录。
  • macOS Homebrew:
bash
brew update
brew upgrade --cask cc-switch

升级前建议确认当前配置已被应用识别,不要手动删除配置目录。

常见问题 ​

切换后 CLI 仍使用旧配置 ​

关闭当前终端并重新打开。大多数 CLI 会在启动时读取配置,已运行的会话不一定热更新。

配置导入后看不到 MCP 或 Skills ​

先确认目标 CLI 原始配置目录中确实存在对应配置。部分工具会把会话、MCP、插件或 Skills 分散在不同文件中。

是否必须配合 Codex 和 Claude Code ​

不是。CC Switch 适合同时管理多个 AI CLI。如果只使用一个 CLI,手动配置也可以满足需求。

相关文档 ​

下一步 ​

继续开启 IDEA MCP。