cc-switch

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• 一台可运行桌面应用的电脑（cc-switch 为跨平台桌面应用）
• 已安装或计划安装至少一个受支持的 AI 编程工具，如 Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、Open
• 从唯一官网 ccswitch.io 或 GitHub 仓库 https://github.com/farion1231/cc-switch 获取安装包
• 如需切换供应商，请准备好对应服务商的 API 配置或账号信息

安装与启动步骤

1. 1下载安装客户端

   README 的下载安装章节未给出具体命令，请前往唯一官网 ccswitch.io 或 GitHub 仓库 Releases 页面，下载对应系统的桌面安装包后按提示安装。

2. 2添加 Provider

   打开应用，在侧边栏选择要管理的工具，点击页面右上角的“+”（Add Provider），选择预设或自行创建自定义配置。

3. 3启用或切换 Provider

   在主界面选中某个 provider 后点击“Enable”生效；OpenCode、OpenClaw、Hermes、MiniMax Code 的按钮是“Add”，Pi 是“Enable/Remove”，这五类为共存模式，可同时添加多个。也可在

4. 4重启对应工具生效

   Claude Code 无需重启；Codex、Gemini CLI、Grok Build 需要重启终端或该 CLI 工具；Claude Desktop 需要重启应用本身。

5. 5回到官方登录

   如需恢复官方账号，在列表中切换到内置官方 provider（例如“Claude Official”），重启该工具后按其登录/OAuth 流程操作即可。

6. 6管理工具版本

   侧边栏“Apps”页面集中显示各 AI 编程工具的版本、安装位置与来源，可单个或一键全部安装、升级，并选择哪些工具显示在侧边栏。

7. 7查看用量与配额

   用量面板默认扫描各工具本地会话日志，统计请求、Token、缓存命中率、输出速度与花费；部分供应商配额需先在供应商卡片上开启“Configure usage query”。

如何确认成功

桌面应用能正常打开并显示主界面，侧边栏可见各 AI 编程工具条目，切换 provider 后对应工具的配置文件被更新。

常见问题

注意事项

• 唯一官方网站是 ccswitch.io，请勿从其他来源下载安装包。
• 页面顶部的“Direct”/“Routing”/“Aggregation”标签只是切换查看视图，不会修改配置；要真正切换需点击“Start routing”“Switch to Aggregation”或“Back to direct”。
• 部分供应商的余额/配额需先在供应商卡片上开启“Configure usage query”，其他供应商可自行编写用量脚本。
• README 的下载安装章节未给出具体命令，安装步骤以官网或 GitHub Releases 页面说明为准。