CC Switch 安装指南
CC Switch 是一个用于管理 Claude Code、Codex、Gemini CLI 等 AI 编程工具配置的桌面应用。它不是本项目的运行依赖,只是辅助开发者在不同 AI 服务提供商之间切换。
前置环境
CC Switch 管理的 CLI 工具通常需要 Node.js 环境。建议本机 Node.js 版本和本项目保持一致:
bash
node --version本项目要求:
json
{
"engines": {
"node": ">=20.19.0"
}
}安装 CLI 工具
按需安装你实际使用的 AI CLI。
Claude Code:
bash
npm install -g @anthropic-ai/claude-codeCodex:
bash
npm install -g @openai/codexGemini CLI:
bash
npm install -g @google/gemini-cli如果团队统一使用 Homebrew,也可以通过对应 tap 或 cask 安装,具体以各工具官方说明为准。
安装 CC Switch
访问 CC Switch 发布页下载对应平台安装包:
text
https://github.com/farion1231/cc-switch/releases常见平台:
- Windows:下载
.msi安装包或 portable 压缩包。 - macOS:下载
.zip后拖入 Applications,或使用 Homebrew cask。 - Linux:下载
.deb、AppImage,或使用 AUR 包。
验证
安装完成后打开 CC Switch,确认:
- 应用窗口可以正常打开。
- 系统托盘出现 CC Switch 图标。
- 能看到 Claude Code、Codex、Gemini CLI 等工具配置入口。
然后在终端分别验证 CLI 是否可用:
bash
claude --version
codex --version
gemini --version只需要验证你实际安装的工具。
注意事项
- API Key 不要写进项目代码、文档或提交记录。
- 如果需要配置密钥,请放在对应工具的用户目录配置中,或使用环境变量。
- CC Switch 只影响本机 AI 工具配置,不会改变本项目的构建、运行和依赖安装方式。