CC-Switch macOS 安装

1. 安装（Homebrew 推荐）

CC-Switch 的维护者提供了 Homebrew tap，一行命令搞定：

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

装完后在"启动台"或 /Applications 里能找到 CC-Switch 图标，点开启动。

如果你不用 Homebrew，也可以去 CC-Switch 的 GitHub Releases 页下载 macOS .dmg，双击后把 App 拖到 Applications 目录。

2. 添加 AI通道作为 Provider

在 CC-Switch 主界面新增一个 Provider，填：

• Provider 名称：起个能认出来的名字，例如 aitongdao
• API Key：在 aitongdao.com → 令牌 创建一个 sk- 密钥。分组建议按用途选（Claude Code 选 ccmax，OpenAI 系列选 codex，Gemini 系列选 gemini）
• Base URL：
  • Claude Code：https://aitongdao.com
  • Codex CLI / OpenCode：https://ai.aitongdao.com/v1
  • Gemini CLI：https://aitongdao.com

3. 启用并验证

在 Provider 列表里把刚才创建的条目设为当前激活项。CC-Switch 会把配置写到对应工具的位置（例如 Claude Code 的环境变量或 ~/.claude.json）。

关闭原先的终端窗口，打开一个新的，然后用对应工具的自检命令验证：

claude doctor

如果想在多服务商之间切换，回 CC-Switch 选另一条 Provider，再重开终端就能看到新的服务商生效。

常见问题

• 双击打不开，提示"已损坏"：macOS 对未公证应用默认拦截，可以 Ctrl + 点击图标选"打开"，或者在"系统设置 → 隐私与安全性"里点"仍要打开"。
• 切换后终端里还是旧 Key：macOS 的 Terminal/iTerm 窗口必须整个关掉再开新窗口，读取到的才是更新后的环境变量。
• brew tap 报错：确认网络能访问 GitHub；如果访问慢，可以改用 .dmg 直装。