前言

在使用 Claude Code、Codex、Gemini CLI 等 AI 编程工具时,你是否遇到过这些痛点:

  • 每个工具都有不同的配置格式(JSON、TOML、.env
  • 切换 API 供应商需要手动编辑配置文件
  • Claude Code 只支持 Anthropic 格式,无法直接使用 DeepSeek、硅基流动等 OpenAI 兼容供应商
  • 多个工具之间缺乏统一的 MCP、Skills 管理方式
  • 配置文件容易损坏或丢失

CC-Switch 应运而生!它是一个桌面应用,可以统一管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 五个 CLI 工具。无需手动编辑配置文件,一键切换供应商,内置 50+ 供应商预设,让你的 AI 编程工作流更加顺畅。

重点推荐:CC-Switch 的路由模式可以让 Claude Code 直接使用 OpenAI兼容格式的 API,解锁 DeepSeek、硅基流动、Gemini 等更多模型选择!, 也可以兼容部署的vllm模型。

GitHub 地址https://github.com/farion1231/cc-switch

CC-Switch 核心功能

为什么选择 CC-Switch?

功能特性 说明
一个应用,五个 CLI 工具 在单一界面中管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw
告别手动编辑 50+ 供应商预设,包括 AWS Bedrock、NVIDIA NIM 和社区中转服务
一键切换 可视化界面,一键在不同供应商之间切换
统一 MCP/Skills 管理 一个面板管理四个应用的 MCP、Skills,支持双向同步
系统托盘快速切换 从托盘菜单即时切换供应商,无需打开完整应用
路由模式(核心亮点) 让 Claude Code 直接使用 OpenAI 兼容格式 API,解锁 DeepSeek、硅基流动等更多模型
跨平台支持 Windows、macOS、Linux 全平台覆盖

界面预览

打开默认界面如下,默认没有"路由"这一栏(开启路由模式后才会显示):

在这里插入图片描述


1. CC-Switch 下载安装

官方markdown: https://github.com/farion1231/cc-switch/blob/main/README_ZH.md

1.1 Windows 下载

Releases 页面下载最新版本的安装包:

  • CC-Switch-v{版本号}-Windows.msi — 安装包
  • CC-Switch-v{版本号}-Windows-Portable.zip — 绿色版

下载地址https://github.com/farion1231/cc-switch/releases
找到对应的版本下载即可:
在这里插入图片描述

1.2 macOS 下载

方式一:通过 Homebrew 安装(推荐)

# 添加 tap
brew tap farion1231/ccswitch

# 安装
brew install --cask cc-switch

# 更新
brew upgrade --cask cc-switch

方式二:手动下载

从 Releases 页面下载 CC-Switch-v{版本号}-macOS.dmg(推荐)或 .zip

注意:CC-Switch macOS 版本已通过 Apple 代码签名和公证,可直接安装打开。


2. Claude Code 配置

在这里插入图片描述

2.1 Anthropic 格式配置(官方 API)

2.1.1 添加配置

点击"添加供应商"按钮:

在这里插入图片描述

2.1.2 选择供应商

你可以直接选择"自定义",如果有对应的厂商预设也可以直接选择:

在这里插入图片描述

2.1.3 填写 base_url 和 API Key

根据你的供应商填写相应的配置:

在这里插入图片描述

2.1.4 高级选项

在高级选项中配置你想使用的模型:

在这里插入图片描述

2.1.5 保存配置

确认配置无误后点击保存:

在这里插入图片描述

2.1.6 启用供应商

针对你配置好的供应商,点击"启用"按钮即可切换:

在这里插入图片描述

2.1.7 测试是否配置成功

打开 Claude Code 进行测试,确认模型切换成功:

在这里插入图片描述


2.2 🔥 让 Claude Code 适配 OpenAI 格式供应商(核心功能)

这是 CC-Switch 最强大的功能! Claude Code 默认只支持 Anthropic 官方 API 格式,导致无法直接使用 DeepSeek、硅基流动、Gemini 等 OpenAI 兼容格式的供应商。通过 CC-Switch 的路由模式,可以实现格式自动转换,让 Claude Code 解锁更多模型选择。

适用场景

  • 使用国内模型服务(DeepSeek、硅基流动、阿里云等)
  • 接入 Gemini、GPT 等非 Anthropic 模型
  • 使用第三方 API 中转服务

参考博客https://www.xiaohongshu.com/explore/69d63551000000001a022b8c?xsec_token=ABKAGsezUhSFVN3ClXe9FarJ-A1SaN7A6SxEpLeQvg164=&xsec_source=pc_search&source=web_search_result_notes

2.2.1 添加供应商

点击界面中的"添加供应商",配置方式与 Anthropic 格式相同:

在这里插入图片描述

2.2.2 选择供应商

选择"自定义"或对应的厂商预设:
在这里插入图片描述

2.2.3 填写 base_url 和 API Key

填写 OpenAI 兼容供应商的配置:

在这里插入图片描述

2.2.4 高级选项

配置你想使用的模型:
在这里插入图片描述

2.2.5 保存配置

点击保存完成配置:

在这里插入图片描述

2.2.6 启用供应商

点击"启用"按钮,此时会弹出提示需要配置路由:
在这里插入图片描述

这是因为 Claude Code 默认只支持 Anthropic 格式,使用 OpenAI 格式需要开启路由功能:
在这里插入图片描述

2.2.7 配置路由

步骤 1:点击设置

在这里插入图片描述

步骤 2:打开路由开关

在这里插入图片描述

步骤 3:重新启用供应商

回到供应商列表,再次点击启用,成功后会显示"切换成功":

在这里插入图片描述

2.2.8 测试是否配置成功

打开 Claude Code 进行测试:

在这里插入图片描述

2.2.9 代理按钮说明

界面上的代理按钮功能说明:

在这里插入图片描述


3. 常见问题

Q1:切换供应商后需要重启终端吗?

大多数工具需要重启终端或 CLI 工具才能使更改生效。Claude Code 是例外,它支持供应商数据的热切换,无需重启。

Q2:启用后 Claude Code 报错怎么办?

检查以下几点:

  • API Key 是否正确
  • base_url 是否包含正确的路径(通常是 /v1
  • 模型名称是否与供应商支持的模型匹配

Q3:OpenAI 格式供应商为什么需要路由?

Claude Code 默认只支持 Anthropic 格式的 API 请求。路由功能会将 Anthropic 格式的请求转换为 OpenAI 格式,实现格式兼容。

Q4:如何确认当前使用的是哪个供应商?

点击系统托盘图标,当前启用的供应商会有明显标识。也可以打开 CC-Switch 主界面查看。

Q5:如何切换回官方登录?

在预设供应商里面添加一个"官方登录"预设。切换过去之后,执行一遍 Log out / Log in 流程,之后便可以在官方供应商和第三方供应商之间随意切换。

Q6:切换供应商后插件配置怎么不见了?

CC-Switch 使用"通用配置片段"功能,在不同的供应商之间传递 Key 和请求地址之外的通用数据。

可以在"编辑供应商"菜单的"通用配置面板"里,点击"从当前供应商提取",把所有通用数据提取到通用配置中。新建供应商时勾选"写入通用配置"(默认勾选),就会把插件等数据写入到新的供应商配置中。

Q7:数据存储在哪里?

数据类型 存储路径
数据库 ~/.cc-switch/cc-switch.db
本地设置 ~/.cc-switch/settings.json
备份 ~/.cc-switch/backups/
Skills ~/.cc-switch/skills/

总结

CC-Switch 解决了 Claude Code 多模型切换的核心痛点:

  1. 告别手动编辑配置文件 — 可视化界面一键切换
  2. 支持多种 API 格式 — Anthropic 格式和 OpenAI 兼容格式都能搞定
  3. 路由模式 — 自动格式转换,兼容更多供应商
  4. 统一管理 — MCP、Skills、Prompts 一站式管理

对于经常使用 Claude Code 的开发者,CC-Switch 是提升效率的必备工具。推荐使用路由模式获得更好的兼容性,可以接入 DeepSeek、硅基流动等国内优质模型服务。

参考资料


本文为个人学习笔记,如有错误,请指正修改。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐