用 cc-switch 路由为 Claude Code 配置 OpenAI 类模型

如果希望在 Claude Code 中使用 OpenAI 类模型，一个更省心的做法，是通过 cc-switch 的路由功能完成接入。关键不是单纯改接口地址，而是先让请求进入 cc-switch 的本地路由，再把供应商接口格式设为 OpenAI Responses API，最后用一个测试 prompt 验证链路是否真正打通。

先说结论 这篇配置的重点不是“换一个接口地址”，而是把三件事对齐：开启路由、选对 API 格式、完成一次实际验证。

本文只做三件事：

• 开启 cc-switch 路由，并确保 Claude 已纳入路由应用；
• 把供应商 API 格式 设为 OpenAI Responses API（需开启路由）；
• 用一个测试 prompt 验证链路是否真的已经打通。

为什么必须开启路由

在编辑供应商时，API 格式 可以选择 OpenAI Responses API（需开启路由）。这说明它不是普通的直连场景，而是依赖 cc-switch 的路由能力来转发请求。

这里的请求链路很简单：

1. Claude Code 的请求先进入 cc-switch 本地路由；
2. cc-switch 再按选定格式转发到上游兼容服务；
3. Claude Code 最终才能正常使用 OpenAI 类模型。

安装 cc-switch

如果本机还没有安装 cc-switch，可以先从最新发布页下载安装包：

• 发布页：https://github.com/farion1231/cc-switch/releases/latest
• macOS：推荐下载 CC-Switch-v3.14.1-macOS.dmg，也提供 .zip 和 .tar.gz；
• Windows：可下载 CC-Switch-v3.14.1-Windows.msi，也可以使用 Windows-Portable.zip 解压即用；
• Linux：按发行版选择 .deb、.rpm 或 .AppImage。

安装完成后，先启动 cc-switch，再继续下面的路由配置。

配置步骤

1. 打开 cc-switch 的路由功能

进入“设置”页面，切换到“路由”标签页。

先确认这两项：

• 路由总开关 已开启；
• 路由应用 里，Claude 已启用。

如果只开了总开关，但没有把 Claude 加到路由应用里，那么 Claude Code 的请求不一定会经过本地路由。

2. 确认本地路由地址

在路由页面可以看到一个本地服务地址，例如：

http://127.0.0.1:15721

这表示 cc-switch 已经在本地启动了路由服务。后续 Claude Code 的请求会先进入这里，再由它转发到你配置的上游接口。

3. 编辑供应商

进入“编辑供应商”页面后，先填写服务端地址。

这里重点看两件事：

• 请求地址要填写兼容 OpenAI Responses API 的服务端地址；
• 地址不要以 / 斜杠结尾。

注意 这里最容易出错的不是选项本身，而是地址细节。只要服务端地址不符合要求，后面即使保存成功，也可能无法按预期工作。

4. 设置 API 格式

在“高级选项”里，把 API 格式 设为：

OpenAI Responses API（需开启路由）

这里不要选错。既然目标是让 Claude Code 通过 cc-switch 使用 OpenAI 类模型，就应当让 cc-switch 以对应格式来处理请求。

5. 设置认证字段并保存

从截图来看，认证字段 这里选择的是：

ANTHROPIC_AUTH_TOKEN（默认）

重点不在字段名本身，而在于它要和当前在 cc-switch 中维护的认证配置保持一致。确认无误后，点击右下角的“保存”即可。

如何验证是否生效

验证这类配置时，与其反复检查参数，不如直接发起一次测试请求。

提示 刚完成配置时，优先验证链路是否打通，不必一开始就执行复杂任务。

成功标准

• Claude Code 能否正常发起请求；
• 请求是否能稳定返回结果；
• 返回结果是否符合目标模型的预期表现。

测试 prompt

下面这段 prompt 更适合用来确认链路是否正常，而不是评估模型能力上限：

请对当前会话中你能访问到的 Claude Code 工具做一次完整可用性检查，并输出结果表格。

要求：
1. 先自行探索当前会话里可见、可加载、可调用的工具，不要预设固定工具名单。
2. 以常用工具优先为原则，覆盖：
  - 本地命令执行
  - 文件读取/编辑/写入
  - 子代理/技能
  - 交互提问
  - 网页抓取/网页搜索
  - 任务与后台任务
  - 计划模式
  - worktree
  - 监控
  - notebook
  - 远程触发/登录相关能力
3. 用最小副作用方式测试，优先避免改业务代码。
4. 如果必须写测试文件，只能写到项目下 .claude/ 或隔离 worktree 中，并在结束时清理。
5. 对每个实际探测到的工具标记为：
  - 可放心使用
  - 有条件使用
  - 暂不可依赖
6. 对“有条件使用”说明限制条件；对“暂不可依赖”写清报错或现象。
7. 最终输出一张表，列为：
  - 工具
  - 作用
  - 现在状态
  - 备注
8. 额外给出一段总结：
  - 哪些是本次会话里最值得信赖的常用工具
  - 哪些工具不稳定或受环境限制
9. 如果发现网页搜索相关工具异常，继续做最小化复测，并整理成一段可发给后侧的问题描述。
10. 如果测试过程中创建了计划、worktree、定时任务、后台任务或临时文件，结束前要恢复现场。
11. 全程用中文，过程更新简短。

如果返回结果能够稳定生成表格、项目列表和总结，通常就说明请求已经走通，响应格式也基本正常。

实际测试结果

下面这张图展示的是一次真实的验证结果。重点看两点：是否稳定输出结构化表格，以及是否能对结果做分组和总结。

从这次测试结果来看，Claude Code 已经能够基于这条链路完成更复杂的任务：不仅能正常生成表格，还能对不同工具标注“可放心使用”“有条件使用”“暂不可依赖”，并补充限制条件和异常现象说明。这说明链路不只是“能通”，而且已经足够支撑较长指令和结构化输出。

关于 WebSearch 的补充说明

WebSearch 需要单独看待。它不是本地直接执行的工具，而是 Anthropic 服务端执行的 server tool，所以可用性会比本地工具更容易受外部条件影响。

常见影响因素包括：

• 组织开关：Web search 需要由管理员在 Claude Console 中启用；
• 平台差异：不同接入平台上的支持能力并不完全一致；
• 服务状态：可能受到限流、内部错误等影响，对应错误码包括 too_many_requests、max_uses_exceeded、unavailable 等；
• 续跑机制：长请求可能出现 pause_turn，需要继续续跑后才能拿到完整结果。

因此，在一次实际测试里看到 WebSearch 表现为“有条件使用”或“暂不可依赖”，更接近“云端能力受环境与服务状态影响”，不一定代表这个工具在本地完全不可用。

不开启路由时，通常会遇到什么问题

如果不走路由，这类配置通常会遇到下面几种问题：

• 请求格式对不上：OpenAI Responses API 风格与 Claude Code 原生请求格式并不等价，不经过转换层就可能出错；
• 请求没有真正经过兼容层：目标并不是单纯换地址，而是让请求先进入本地路由再转发；
• 缺少稳定性能力：cc-switch README 中明确提到本地代理支持 auto-failover、circuit breaker、provider health monitoring、format conversion；
• 容易误判“已经配好”：有时配置保存成功了，但实际请求链路并没有按预期生效。

常见注意点

• 不要漏掉 Claude 的路由启用；
• 服务端地址不要带尾部 /；
• 先验证通路，再判断模型效果。

小结

这套配置的核心，不是让 Claude Code 直接请求某个 OpenAI 风格接口，而是让请求先进入 cc-switch 的本地路由，再由路由按 OpenAI Responses API 的格式转发到上游服务。

发布前建议再确认这四件事：

• 路由已开启；
• Claude 已加入路由应用；
• 服务端地址填写正确，且不带尾部 /；
• API 格式 已设为 OpenAI Responses API（需开启路由）。

说明 本文内容由作者提供原始信息与测试结果，并由 AI 协助完成结构整理、文字润色与编辑。