跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt

Use this file to discover all available pages before exploring further.

CC Switch 是一款免费的桌面应用，专门用于管理和切换不同 AI 编程工具的接入配置。配合 AIHubMix 使用后，你可以在 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等主流 AI 编程工具之间快速切换，无需反复手动修改配置文件、环境变量或接口设置。对于同时使用多个模型、多个 CLI 工作流的开发者来说，CC Switch 可以明显降低配置成本，让不同工具的接入、切换和日常使用更加统一、高效。
Image

​
一、CC Switch 是什么？

CC Switch（项目地址：github.com/farion1231/cc-switch）是由开发者 Jason Young（farion1231） 开发的一款开源跨平台桌面应用，专为 AI 编程 CLI 工具设计的统一管理器。 对于同时使用多个 AI 编程工具的用户特别是开发者而言，以下问题或许并不陌生：
  • 每次切换 Provider，都需要手动编辑 ~/.claude/settings.json 或重新设置环境变量
  • 多台设备之间配置无法同步，换一台机器就要从头配置
  • WSL 与 Windows 环境各自维护一套配置，管理成本持续叠加
CC Switch 正是为解决上述问题而设计。它是一款轻量的桌面应用，安装后常驻在系统托盘，无论你是开发者还是普通用户，只需点击几下，就能完成 AI 工具和服务商的切换，全程不需要接触任何代码或配置文件。基于 Tauri 2 + Rust 构建，安装包体积轻巧，支持 Windows、macOS 与 Linux 全平台，并提供系统托盘常驻入口，让多 Provider 的切换与管理变得高效、直观。 支持的 5 大 CLI 工具：
CLI（Command Line Interface，命令行界面）工具是一类通过文字命令操作的程序，不需要图形界面，常用于开发环境。下表中的工具都属于此类，CC Switch 可以统一管理它们的配置。
工具名称开发方简介
Claude CodeAnthropic由 Claude 模型驱动的 AI 编程助手，可在终端中直接对话、写代码、改 Bug
CodexOpenAIOpenAI 推出的代码生成工具，支持多种编程语言的自动补全与生成
Gemini CLIGoogleGoogle Gemini 模型的命令行版本，适合与 Google 生态集成的开发者
OpenCode开源社区开源的 AI 编程命令行工具，支持接入多种 AI 模型
OpenClaw开源社区开源的 AI 命令行工具，可灵活切换不同的 AI 服务商（Provider）

​
二、核心功能

​
2.1 Provider 管理

CC Switch 内置 50+ 预设配置，覆盖主流 AI API 服务商，包括 Anthropic、OpenRouter、AIHubMix、AWS Bedrock 等。你可以：
  • 为每个 CLI 工具创建多个 Provider 配置
  • 拖拽排序，把最常用的置顶
  • 一键切换当前激活的 Provider，无需重启 CLI
  • 通过 Shared Config Snippet （共享配置）功能，切换服务商时自动保留插件数据与自定义设置——换了 API 不等于一切归零

​
2.2 MCP 服务器统一管理

如果你在多个 CLI 工具中都用到了 MCP（Model Context Protocol）服务器，CC Switch 提供统一的 MCP 管理面板，支持跨应用配置同步，不用在每个工具的配置文件里重复填写。

​
2.3 技能（Skills）安装

CC Switch 支持从 GitHub 仓库或 ZIP 文件安装技能包（Skills），通过 symlink 方式挂载，方便团队共享和版本管理。

​
2.4 用量统计 Dashboard

内置使用量看板，可追踪：
  • 每日/每周 API 消费金额
  • 请求次数与 Token 用量
  • 趋势图可视化
对于同时接入多个 Provider 的用户，这个功能能帮你清楚掌握每个渠道的实际消耗。

​
2.5 云同步

配置数据支持同步到以下云存储：
  • Dropbox
  • OneDrive
  • iCloud（macOS）
  • WebDAV 自建服务器
多设备开发者再也不用手动导出导入配置了。

​
三、安装教程

​
3.1 Windows

方式一：Winget（推荐） 
winget install --id=farion1231.CC-Switch -e
方式二：手动安装 前往 GitHub Releases 页面 下载最新版 .msi 安装包或便携版 .zip，解压后直接运行。 系统要求： Windows 10 及以上

​
3.2 macOS

方式一：Homebrew（推荐） 
brew tap farion1231/ccswitch
brew install --cask cc-switch
方式二：手动安装 从 Releases 页面下载已公证的 .dmg 文件，挂载后拖入 Applications 文件夹即可。 系统要求： macOS 12（Monterey）及以上

​
3.3 Linux

根据你的发行版选择对应包格式： 
# Debian / Ubuntu
sudo dpkg -i cc-switch_x.x.x_amd64.deb

# Fedora / RHEL
sudo rpm -i cc-switch-x.x.x.x86_64.rpm

# 通用（AppImage）
chmod +x cc-switch_x.x.x_amd64.AppImage
./cc-switch_x.x.x_amd64.AppImage

# Arch Linux（AUR）
paru -S cc-switch-bin
系统要求： Ubuntu 22.04+ / Debian 11+ / Fedora 34+

​
3.4 WSL 集成（（Windows 用户）

CC Switch 对 WSL（Windows Subsystem for Linux）有专项支持。在 Windows 主机上安装 CC Switch 后，可以直接管理 WSL 内的 Claude Code 等 CLI 工具的配置，无需在 WSL 环境内单独安装。 配置完成后，CC Switch 会通过本地代理桥接 WSL 与 Windows 之间的网络请求，实现统一管理。

​
四、配置 Claude Code 接入 AIHubMix

​
为什么选择 AIHubMix？

AIHubMix 由美国 AIHubMix, LLC 主体运营，是获得微软 Azure、AWS、GCP 、阿里云、百度云等各大模型推理云厂商官方授权的合规模型聚合平台。我们所有服务全部集群化部署云美国谷歌云上，长期为众多知名应用提供高并发、稳定、可信赖的 AI 模型 API 服务，深受开发者和企业信任。 对于 Claude Code 用户来说，通过 AIHubMix 接入可以有效降低使用成本，同时保持与 OpenRouter 类似的灵活性。

​
4.1 在 CC Switch 中添加 AIHubMix Provider

打开 CC Switch，进入 Claude Code 的 Provider 供应商管理页面：
  1. 点击右上角「+ 添加供应商」
    Image
  2. 在预设列表中选择「AiHubMix」，点击获取API key 跳转链接
    Image
  3. 在「API Key」栏中填写你的密钥
    Image
  4. 配置完成后，复制想要选择的模型ID（以claude-opus-4-7 为例），点击「添加」保存设置。
    Image
  5. 返回首页，在供应商列表中选择「AiHubMix」，点击「启动」即可使用。
    Image

​
4.2 验证连接

在终端中运行 Claude Code，发起一次简单的对话请求，如果响应正常，说明已成功接入 AIHubMix。
Image
终端打开 Claude Code后，输入 /status 可查询模型ID，输入/models 可选择配置的其他模型

​
五、在 VSCode 中使用

Claude Code 有官方 VSCode 扩展，CC Switch 与其完全兼容。配置步骤如下：

​
5.1 安装 Claude Code VSCode 扩展

在 VSCode 扩展市场搜索「Claude Code」并安装。

​
5.2 配合 CC Switch 使用

Image

​
5.3 多工作区场景

如果你同时打开了多个 VSCode 工作区，所有窗口共享同一个 CC Switch 配置，切换一次全局生效。

​
六、其他 CLI 工具➕AIHubMix 教程

CC Switch 不只是 Claude Code 的管理器，它对另外四个主流 AI 编程 CLI 工具同样有完整支持。

​
6.1 Codex➕AIHubMix

OpenAI Codex CLI 用户可以在 CC Switch 中单独管理 Codex 的 Provider 配置，接入AIHubMix。Codex的完整教程见 https://docs.aihubmix.com/cn/api/Codex-CLI
Image
以接入 deepseek-v4-flash 为例🌰，通过在 CC Switch 中简单配置AIHubMix API key，即可在codex中使用 deepseek-v4-flash 以及其他模型
Image

​
6.2 Gemini➕ AiHubMix

Google Gemini CLI 配置较为分散，CC Switch 将其整合进统一界面，支持多 Google 账号或多个 Gemini API Key 的快速切换，适合需要频繁在不同项目间切换的团队。

​
安装 Gemini CLI

确保 Node.js 版本 ≥ 18，没有则先安装： 
brew install node
然后全局安装 Gemini CLI： 
npm install -g @google/gemini-cli

​
配置步骤

  1. 打开 CCSwitch，点击 添加供应商
  2. 手动添加 AiHubMix
  3. 填入 API 密钥：你的 sk- 开头密钥（在 aihubmix.com/token 获取）
  4. 填入请求地址：https://aihubmix.com/gemini
14f4f33c 7805 45e5 Be0e 79e233ea887e
Image

​
6.3 OpenCode➕AiHubMix

OpenCode 是一个开源的 AI 编程 CLI，兼容多种 Provider。CC Switch 内置对 OpenCode 的支持，可以直接管理其配置文件，免去手动编辑 TOML/JSON 配置的麻烦。 完整安装教程见 https://docs.aihubmix.com/cn/api/Opencode

​
配置步骤

  1. 打开 CCSwitch，点击 添加供应商
  2. 选择 AiHubMix
  3. 填入 API 密钥：你的 sk- 开头密钥（在 aihubmix.com/token 获取）
Image
Image
在终端运行： 
opencode
Image

​
6.4 OpenClaw➕AiHubMix

OpenClaw 是兼容 OpenAI 接口的开源 CLI 工具，适合需要自定义模型路由的高级用户。具体安装教程见 https://docs.aihubmix.com/cn/api/OpenClaw

​
CC Switch 与 OpenClaw 的搭配使用方式：

  1. 在 CC Switch 中为 OpenClaw 创建独立的 Provider 组
  2. 将 AIHubMix、OpenRouter 等聚合平台配置为 OpenClaw 的上游
  3. 通过 CC Switch 的热切换功能，在不同的 OpenClaw 上游之间快速跳转
特别适合需要对比不同 API 服务商响应质量的开发者——在 CC Switch 中切换 Provider，OpenClaw 侧无需做任何修改。

​
七、CC Switch vs Claude Code Router 对比

市面上另一个常被提到的工具是 Claude Code Router，不少用户会问：我该用哪个？
对比维度CC SwitchClaude Code Router
形态桌面 GUI 应用CLI / 配置工具
支持的 CLI 工具5 个（Claude Code、Codex、Gemini、OpenCode、OpenClaw）主要针对 Claude Code
Provider 预设50+依赖手动配置
本地代理内置，支持热切换 + 故障转移需手动配置
MCP 管理统一管理界面不支持
WSL 支持专项支持有限支持
云同步支持（Dropbox / iCloud / WebDAV）不支持
用量统计内置 Dashboard无
上手难度低（GUI 操作）中（需熟悉配置文件）
适合人群多工具用户 / 追求效率者轻量配置需求 / 纯 CLI 爱好者
结论： 如果你只用 Claude Code 且习惯命令行操作，Claude Code Router 足够用；如果你同时使用多个 AI 编程工具，或者希望有一个可视化的统一管理入口，CC Switch 是更好的选择。

​
八、常见问题 FAQ

Q：CC Switch 本身免费吗？ A：完全免费，MIT 开源协议，代码托管在 GitHub。使用过程中产生的 API 费用由你选择的 Provider 决定。 Q：在 WSL 中如何让 CC Switch 生效？ A：CC Switch 安装在 Windows 侧，通过本地代理桥接 WSL 内的请求。确保 WSL 的代理设置指向 CC Switch 的本地监听端口即可。具体端口号可在 CC Switch 的代理设置页面查看。 Q：切换 Provider 后 Claude Code 需要重启吗？ A：不需要。CC Switch 的热切换功能在激活新 Provider 后立即生效，当前终端会话无需重启。 Q：配置数据存储在哪里？ A：本地数据库存储在 ~/.cc-switch/cc-switch.db，设置文件为 ~/.cc-switch/settings.json，CC Switch 会自动保留最近 10 个备份版本。 Q：我可以通过 URL 导入别人的 Provider 配置吗？ A：可以。CC Switch 支持 Deep Link（ccswitch:// 协议），团队成员可以通过分享一个链接快速导入统一的 Provider 配置，适合团队统一管理 API 接入。 Q：CC Switch 支持 AWS Bedrock 吗？ A：支持，内置 AWS Bedrock 预设，并支持跨区域推断（Cross-Region Inference），适合企业用户通过 Bedrock 接入 Claude 模型。

​
结语

CC Switch 把原本分散在各个配置文件里的 AI 编程工具管理工作，整合进了一个轻量的桌面应用。无论你是 Claude Code 的重度用户，还是同时使用 Codex、Gemini CLI 的多工具开发者，它都能让你的工作流更顺畅。 最新版本 v3.12.0 已稳定发布，欢迎前往 github.com/farion1231/cc-switch 查看完整文档和 Release Notes。
Image
更新时间：2026年4月28日