通用步骤

CC-Switch 是用于管理 Claude Code、Codex、Gemini CLI 配置的辅助工具。它适合不想手动编辑配置文件、需要经常切换供应商或多套 API Key 的用户。

适合谁使用

• 第一次配置 Claude Code、Codex 或 Gemini CLI。
• 想用图形界面管理 API Key。
• 希望按工具分别保存风云 API、官方接口或其他供应商配置。
• 不想频繁打开隐藏目录编辑 JSON / TOML 文件。

安装建议

1. 前往 CC-Switch 项目发布页下载适合系统的安装包。
2. Windows 用户选择常规安装包。
3. macOS 用户可用 Homebrew 或安装包。
4. Linux 用户根据架构选择 deb、rpm 或压缩包。

风云 API 模板

如果工具中没有内置“风云 API”模板，可以选择“自定义供应商”，手动填写名称、Base URL 和 API Key。

配置前检查

先确认以下命令可用：

node -v
npm -v
claude --version
codex --version
gemini --version

如果某个 CLI 命令不存在，请先阅读 环境检查（通用步骤）。

通用配置流程

1. 打开 CC-Switch。
2. 选择目标工具：Claude、Codex 或 Gemini。
3. 添加供应商配置。
4. 填写供应商名称：风云 API。
5. 填写 Base URL 和 API Key。
6. 保存并启用该供应商。
7. 回到终端启动对应 CLI 测试。