用 CC Switch 让 Claude Code 接入第三方模型：完整教程与真实体验

Claude Code 官方 CLI 默认只能使用 Claude 系列模型，但通过 CC Switch 这个第三方代理工具，可以让它接入其他模型提供商的 API。这篇文章记录了我从配置到日常使用的全过程，包括踩坑点和真实感受。

---

一、为什么想折腾这个？

Claude Code 的体验确实不错——直接在终端里和代码库对话、自动读取文件、执行命令、修改代码，这套工作流一旦习惯了就回不去。但它有两个门槛：

• 模型限制 — 只能使用 Anthropic 自家的 Claude 模型
• API 额度 — 用 Sonnet 和 Opus 跑复杂的代码任务，消耗速度不慢

CC Switch 的作用就是在这之间搭一座桥，让 Claude Code 的底层请求转发到第三方模型提供商，从而实现：

• 接入其他兼容 Anthropic API 格式的模型
• 通过第三方渠道获得更便宜的调用价格
• 多模型切换而不需要改动 Claude Code 本身

---

二、环境准备

2.1 安装 Claude Code

如果你还没有安装 Claude Code：

npm install -g @anthropic-ai/claude-code

安装完成后验证：

claude --version

注意：确保你的 Claude Code 版本在支持自定义 API 端点的版本之上。早期版本可能不兼容。

2.2 获取第三方 API 凭证

你需要从第三方模型提供商获取 API 端点（Base URL）和 API Key。具体注册流程因提供商而异，大致步骤是：

1. 注册账号并完成实名认证
2. 在控制台创建 API Key
3. 复制 Base URL 和 API Key，后续配置会用到

2.3 安装 CC Switch

npm install -g cc-switch

安装完成后可以通过 cc-switch --help 确认是否成功。

---

三、配置 CC Switch

3.1 基础配置

CC Switch 本质上是一个本地代理服务，它会监听一个本地端口，把 Claude Code 发出的请求转发到你指定的第三方端点。

启动 CC Switch 服务：

cc-switch start \
  --base-url "https://第三方提供商的API地址" \
  --api-key "sk-****************" \
  --port 8080

启动成功后，你会在终端看到类似输出：

CC Switch proxy started on http://localhost:8080
Target endpoint: https://第三方提供商的API地址
Model: 当前配置的模型名称

安全提示：API Key 建议通过环境变量传递，避免在终端历史中明文保存：

export CC_API_KEY="sk-****************"
cc-switch start --base-url "https://第三方提供商的API地址" --port 8080

3.2 配置 Claude Code 使用本地代理

接下来需要让 Claude Code 把请求发到本地代理而不是 Anthropic 官方端点。有两种方式：

方式一：通过环境变量

export ANTHROPIC_BASE_URL="http://localhost:8080"
export ANTHROPIC_API_KEY="任意占位值"

说明：ANTHROPIC_API_KEY 这里只需要填一个非空字符串即可，因为实际的认证会在 CC Switch 层处理。

方式二：通过 Claude Code 配置文件

在项目根目录或全局的 .claude/settings.json 中添加配置。

3.3 验证连接

在任意项目中启动 Claude Code：

claude

随便问一个问题，比如 hello，如果能正常得到回复，说明代理链路通了。

---

四、日常使用工作流

4.1 启动流程

每次使用 Claude Code 前，需要先启动 CC Switch 代理：

# 终端 1：启动代理
cc-switch start --base-url "https://第三方提供商的API地址" --port 8080

# 终端 2：使用 Claude Code（确保环境变量已设置）
export ANTHROPIC_BASE_URL="http://localhost:8080"
claude

如果你觉得每次都要设环境变量太麻烦，可以写一个启动脚本：

#!/bin/bash
# 文件名：claude-proxy.sh
export ANTHROPIC_BASE_URL="http://localhost:8080"
claude "$@"

chmod +x claude-proxy.sh
./claude-proxy.sh

4.2 切换模型

在 CC Switch 配置中更换 --base-url 或传入不同的模型参数，就可以切换到不同的模型。Claude Code 本身不需要做任何改动。

4.3 停止代理

使用完毕后，Ctrl+C 停止 CC Switch 进程即可。如果需要恢复到官方端点，取消环境变量：

unset ANTHROPIC_BASE_URL

---

五、真实使用感受

优点

• 接入成本低 — 整个配置过程不到十分钟，核心就一个代理服务加两个环境变量
• 透明切换 — Claude Code 的交互界面和功能完全不受影响，文件读取、代码修改、命令执行这些核心能力照常用
• 多模型可选 — 可以根据任务复杂度切换不同模型，简单任务用便宜的，复杂重构用更强的
• 成本可控 — 通过第三方渠道，调用单价可以比官方低不少，对于日常高频使用的人来说很实在

需要适应的地方

• 多开一个终端 — 每次都要先启动 CC Switch 再开 Claude Code，比直接用官方版本多了一步。用脚本或后台进程可以缓解
• 网络延迟 — 如果第三方提供商的服务器不在国内，延迟会比较高，输入响应能感觉到慢半拍。选择节点近的提供商很重要
• 模型能力差异 — 不是所有模型在代码理解上的表现都一样。有些模型能处理简单问答，但在多文件分析、代码重构等复杂任务上表现会打折扣。我的建议是复杂任务还是用 Claude 官方模型
• 代理稳定性 — CC Switch 本身是第三方工具，偶尔会遇到连接断开或者请求超时的情况，需要重新启动。遇到 API request failed 时，先看代理是否还在跑
• 配置持久化 — 环境变量在终端关闭后失效，每次新开会话需要重新设置。可以通过 .bashrc 或 .zshrc 配置 alias 来自动化

适合的场景

场景	推荐程度	说明
简单代码问答 / 解释	✅ 推荐	第三方模型完全够用，成本低
单文件 bug 修复	✅ 推荐	多数兼容模型能处理单文件级别的任务
多文件重构	⚠️ 视模型而定	需要模型有较强的代码库理解能力
大型项目架构分析	⚠️ 建议用官方	Claude 的上下文理解和代码推理能力在这类任务上优势明显
日常高频对话	✅ 推荐	成本低，适合大量日常交互

---

六、常见问题排查

问题 1：Claude Code 报 API request failed: 401

原因：API Key 不正确或者 CC Switch 没有正确传递认证信息。

排查：

# 检查 CC Switch 日志，看是否收到请求
# 确认 --api-key 参数是否正确
# 用 curl 直接测试第三方端点
curl -X POST "https://第三方提供商的API地址/v1/messages" \
  -H "Authorization: Bearer sk-****************" \
  -H "Content-Type: application/json" \
  -d '{"model":"模型名称","max_tokens":100,"messages":[{"role":"user","content":"hello"}]}'

问题 2：Claude Code 报 connection refused

原因：CC Switch 代理没有启动，或者端口不匹配。

排查：

# 确认代理进程在运行
curl http://localhost:8080/

# 检查环境变量
echo $ANTHROPIC_BASE_URL
# 应该输出 http://localhost:8080

问题 3：响应很慢

原因：第三方提供商服务器距离远，或者模型推理本身较慢。

解决：

• 换用节点更近的提供商
• 在 CC Switch 中切换更快的模型
• 如果提供商有专属加速线路，优先使用

问题 4：某些功能不工作（如工具调用）

原因：不是所有模型都完全兼容 Anthropic 的 tool use 格式，Claude Code 的很多核心功能（文件操作、命令执行）依赖 tool use。

排查：确认你使用的模型支持 Anthropic 格式的 tool calling。如果不支持，Claude Code 只能当纯聊天用，无法修改文件或执行命令。

---

七、总结

用 CC Switch 接入第三方模型来跑 Claude Code，整个过程的核心就三步：

1. 启动 CC Switch 代理 — 指向第三方端点
2. 设置环境变量 — 让 Claude Code 走本地代理
3. 正常使用 Claude Code — 所有功能照常使用

对于日常高频使用 Claude Code 的人来说，这条链路能显著降低调用成本，而且接入过程本身不复杂。但它不能替代官方 Claude 模型在复杂代码任务上的表现。我的实际做法是：简单任务走第三方模型，复杂重构和架构分析走官方 API，两者互补。

最后，CC Switch 作为社区工具，稳定性和长期维护情况需要持续关注。如果遇到代理不可用，及时切换回官方端点，避免影响工作。