【CC-Switch】:让 Claude Code 兼容 OpenAI 格式 API

前言

在使用 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 安装(推荐)

bash 复制代码
# 添加 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、硅基流动等国内优质模型服务。

参考资料


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

相关推荐
技术钱3 小时前
OutputParser输出解析器
linux·服务器·前端·python
Dontla3 小时前
aio-pika介绍(基于asyncio的Python异步消息队列客户端,用于操作RabbitMQ,并实现对AMQP协议支持)
python·rabbitmq·ruby
2401_833033623 小时前
C#怎么使用协变和逆变 C#泛型中的in和out关键字协变逆变是什么意思怎么用【语法】
jvm·数据库·python
码界筑梦坊4 小时前
111-基于Python的中国旅游用户数据可视化分析系统
python·信息可视化·django·毕业设计·旅游
码界筑梦坊4 小时前
114-基于Python的1688电脑硬件数据可视化分析系统
开发语言·python·信息可视化·数据分析·毕业设计·echarts·数据可视化
DXM05214 小时前
第2期:0配置!10分钟搭建ArcGIS Python开发环境(无需装VS)
开发语言·人工智能·python·arcgis·arcgis自动化
一直会游泳的小猫4 小时前
uv - 极速 Python 包管理器
python·工具·uv·包管理
Zhencode4 小时前
Python创建MCP服务
python·mcp
m0_624578594 小时前
JavaScript 中高精度小数(20位以上)的正确处理方法
jvm·数据库·python