当前位置:首页 > 文章 > 正文内容

Claude Code + CC-Switch 多节点配置实战:一键切换Claude/DeepSeek/GPT(Mac 2026详细教程)

廖万里5小时前文章0

Claude Code + CC-Switch 多节点配置实战:一键切换Claude/DeepSeek/GPT(Mac 2026详细教程)

上篇讲了Claude Code直连DeepSeek,但真实开发场景中我们经常需要在Claude、DeepSeek、GPT、Gemini之间来回切换——有的模型擅长写代码,有的便宜适合日常对话,有的推理能力强适合复杂架构设计。每次切换都去改环境变量?太麻烦了。今天用CC-Switch,一个桌面端API代理管理工具,让你在多个模型之间一键切换,连Claude Code都不用重启。

一、CC-Switch 是什么?为什么要用?

CC-Switch是一款运行在本地的API代理管理工具,核心功能就一个:拦截你的AI工具发出的API请求,根据配置转发到不同的模型服务商

它解决的问题非常实际:

  • 多模型切换:不用改代码、不用改配置、不用重启Claude Code,点一下按钮就切模型
  • API Key统一管理:所有Key存在CC-Switch里,不用在各个工具里到处配置
  • 中转节点支持:国内开发者可以配置API中转站,解决跨境网络问题
  • 可视化操作:图形界面操作,不用记命令行
  • 实时生效:切换节点后下一个API请求立即走新模型

它的工作原理本质上是一个本地反向代理

Claude Code ──▶ CC-Switch (127.0.0.1:7890) ──▶ 根据当前选中节点转发
                                                ├── DeepSeek API
                                                ├── Anthropic API  
                                                ├── 自定义中转站
                                                └── 其他兼容端点

二、安装 CC-Switch(Mac 版)

2.1 下载安装包

CC-Switch 提供 macOS、Windows、Linux 三平台客户端。访问其 GitHub Releases 页面下载最新版:

# 浏览器访问
open https://github.com/cc-switch/cc-switch/releases/latest

# 下载 macOS 的 .dmg 文件(通常命名为 CC-Switch-x.x.x.dmg)

2.2 安装

# 双击 .dmg 文件挂载
# 将 CC-Switch.app 拖入 Applications 文件夹
open /Applications/CC-Switch.app

2.3 首次启动(处理安全提示)

macOS 会对非 App Store 下载的应用提示"无法验证开发者"。解决方法:

# 方法一:系统设置操作
# 系统设置 → 隐私与安全性 → 在底部找到被拦截的 CC-Switch → 点击「仍要打开」

# 方法二:命令行解除(需要管理员密码)
sudo spctl --master-disable
# 然后重新打开 CC-Switch

# 方法三:右键打开(推荐,最简单)
# 在 Finder 中找到 CC-Switch.app
# 右键 → 打开 → 在弹出的对话框中点「打开」

首次启动后,CC-Switch 会在菜单栏显示一个图标,默认监听 127.0.0.1:7890 端口。

2.4 验证安装

# 检查端口是否在监听
lsof -i :7890
# 应该看到类似输出:
# CC-Switch  12345  user  10u  IPv4  ...  TCP *:7890 (LISTEN)

# 测试连通性
curl -s http://127.0.0.1:7890/v1/models
# 如果返回JSON数据(即使是空数组),说明代理服务正常运行
✅ CC-Switch安装完成!现在它的菜单栏图标应该显示为"已连接"状态。

三、配置多个API节点

打开CC-Switch主界面(点击菜单栏图标→Open Dashboard),开始添加节点:

3.1 添加 DeepSeek 节点

点击「Add Node」或「+」按钮,填写以下信息:

字段填写内容说明
名称DeepSeek V4 Pro便于识别的名称
API地址https://api.deepseek.com/anthropicAnthropic兼容端点
API Keysk-你的DeepSeek Key在platform.deepseek.com获取
协议类型Anthropic⚠️ 重要!必须选这个
⚠️ 关键提醒:DeepSeek官方提供的是Anthropic兼容端点(/anthropic),不要用OpenAI的端点(/v1)。协议类型必须选Anthropic,否则Claude Code无法识别。

3.2 添加 Claude 官方节点

名称Claude Opus 4
API地址https://api.anthropic.com
API Keysk-ant-你的Anthropic Key
协议类型Anthropic

3.3 添加 API 中转站节点

如果你有第三方API中转站(如ofox.ai、Canopy Wave、自定义搭建的one-api等),也添加进来:

名称自定义中转
API地址https://your-proxy.com/anthropic
API Key中转站提供的Key
协议类型Anthropic

配置完成后,CC-Switch主界面应该显示三个节点:

  ● DeepSeek V4 Pro    [默认]  ─ 当前使用
  ○ Claude Opus 4
  ○ 自定义中转

四、配置 Claude Code 连接 CC-Switch

现在让Claude Code把所有API请求发给CC-Switch,而不是直接发给Anthropic或DeepSeek:

# 设置环境变量,指向CC-Switch本地端口
export ANTHROPIC_BASE_URL="http://127.0.0.1:7890"
export ANTHROPIC_API_KEY="cc-switch"
# ↑ Key可以填任意值,CC-Switch不会校验它,而是用自己配置的Key

# 持久化配置(写入Shell配置文件)
cat >> ~/.zshrc << 'EOF'

# === Claude Code 通过 CC-Switch ===
export ANTHROPIC_BASE_URL="http://127.0.0.1:7890"
export ANTHROPIC_API_KEY="cc-switch"
EOF

# 重新加载配置
source ~/.zshrc

验证配置是否生效:

# 检查环境变量
echo $ANTHROPIC_BASE_URL
# 输出:http://127.0.0.1:7890

echo $ANTHROPIC_API_KEY
# 输出:cc-switch

五、测试多节点切换

5.1 切换到DeepSeek节点

# 1. 在CC-Switch界面点击"DeepSeek V4 Pro"节点
# 2. 看到该节点标记为"当前使用"

# 3. 启动Claude Code
cd ~/my-project
claude

# 4. 在对话中测试
# 输入:"你好,你是哪个模型?"
# 如果回复中体现DeepSeek的特征,说明切换成功

5.2 切回Claude官方

# 1. 在CC-Switch界面点击"Claude Opus 4"节点
# 2. Claude Code不需要重启
# 3. 直接输入下一个问题,就会用Claude回答

5.3 实时切换验证

你可以做一个有趣的测试:

# 在同一个Claude Code会话中:
# 1. 选DeepSeek节点 → 问"1+1=?" → 得到回答
# 2. 切到Claude节点 → 问"再算一次1+1=?" → 回答风格马上不同
# 切换完全无感!

六、进阶配置

6.1 设置默认节点

右键点击某个节点→「设为默认」。以后每次启动CC-Switch,这个节点自动选中。

建议把DeepSeek V4 Pro作为默认——日常聊天和一般编程任务用它最划算。遇到复杂架构设计再临时切到Claude。

6.2 开机自启

# CC-Switch设置中勾选「开机自启」
# 或者在 macOS 系统设置中添加:
# 系统设置 → 通用 → 登录项与扩展 → 添加 CC-Switch

6.3 多个Agent共享同一CC-Switch

CC-Switch可以同时服务多个工具:

Claude Code ─┐
Codex ──────── CC-Switch(:7890) ──▶ DeepSeek / Claude / GPT
Cursor ──────┘

所有工具都配置 base_url = http://127.0.0.1:7890,在CC-Switch中一键切换,所有工具同时切换模型。

七、常见问题

Q1: CC-Switch启动后Claude Code报Connection Refused?

A: 检查CC-Switch是否真的在监听:lsof -i :7890。如果没有输出,说明CC-Switch没启动成功。尝试重启应用。

Q2: 切换节点后Claude Code报401 Unauthorized?

A: 检查该节点的API Key是否正确。在CC-Switch中编辑节点,确认Key有效(可以去对应的API平台验证)。

Q3: DeepSeek节点选Anthropic协议还是OpenAI协议?

A: 必须选Anthropic。Claude Code只认Anthropic协议。如果你用的是其他兼容OpenAI协议的工具(如Cursor),才选OpenAI协议。

Q4: CC-Switch和系统代理(ClashX)冲突吗?

A: 不冲突。CC-Switch只代理AI API请求,ClashX代理其他网络流量。两个端口不同(默认7890和7891),互不干扰。

Q5: 如何确认当前使用的是哪个模型?

A: 查看CC-Switch界面,当前有"●"标记的节点就是正在使用的。你也可以在CC-Switch的请求日志中查看实际转发的API地址。

八、总结

回顾整个配置流程:

  1. 下载并安装CC-Switch(GitHub Releases→dmg→拖入Applications)
  2. 在CC-Switch中添加DeepSeek节点(地址:https://api.deepseek.com/anthropic,协议:Anthropic
  3. 添加Claude官方节点和自定义中转节点
  4. 设置Claude Code环境变量:ANTHROPIC_BASE_URL=http://127.0.0.1:7890
  5. 在CC-Switch界面一键切换节点,Claude Code实时生效

从此告别手动改环境变量的繁琐操作。一个CC-Switch,搞定所有模型的切换。

下一篇:Claude Code 接入第三方API中转站全攻略——ofox.ai、Canopy Wave、自建one-api,哪种方案最适合你?

本文链接:https://www.kkkliao.cn/?id=3896 转载需授权!

分享到:

版权声明:本文由廖万里的博客发布,如需转载请注明出处。


发表评论

访客

看不清,换一张

◎欢迎参与讨论,请在这里发表您的看法和观点。