CC-Switch Linux 安装

1. 下载并安装

去 CC-Switch 的 GitHub Releases 页（仓库 farion1231/cc-switch），根据发行版选择：

• Debian/Ubuntu：下载 .deb，然后 sudo dpkg -i cc-switch_*.deb（缺依赖用 sudo apt-get -f install 补）
• 其他发行版：下载 .AppImage，赋可执行权限后直接运行：

chmod +x cc-switch-*.AppImage
./cc-switch-*.AppImage

装完后从应用菜单或命令行启动 CC-Switch。

2. 添加 AI通道作为 Provider

在 CC-Switch 主界面新增 Provider：

• Provider 名称：随便起，例如 aitongdao-cc
• API Key：在 aitongdao.com 后台"令牌"页创建的 sk- 密钥（按用途选分组：ccmax / codex / 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 doctor

通过就说明 AI通道接入成功。之后想换服务商，回 CC-Switch 切一下，再重开终端即可。

常见问题

• AppImage 双击没反应：先确认文件有可执行权限（chmod +x），部分发行版还需要装 libfuse2（Ubuntu 22.04+）：sudo apt-get install libfuse2。
• dpkg 报依赖不满足：跑 sudo apt-get -f install 自动补齐，然后再试一次 dpkg -i。
• 切换后命令行读不到新 Key：Linux 下打开的终端会保留自己启动时的环境变量副本，关掉窗口重新开才会读新值。如果你在 tmux/screen 会话里，记得新建一个 window 或者重新登录 shell。
• 发行版没有对应安装包：可以忽略 CC-Switch，直接按 Claude Code 手动教程配环境变量，效果完全一样。