前言
Claude Code、Hermes Agent 和 OpenClaw 都可以使用外部模型服务，但每个应用对 API 协议和配置项的叫法不完全相同。CC Switch 的本地路由可以在应用和上游供应商之间增加一层适配：应用只需要请求本机的统一地址，真正的 OpenAI 订阅认证和供应商选择由 CC Switch 负责。
本文介绍一种本地使用方式：先在 CC Switch 中完成 OpenAI 订阅账号认证，再开启路由，把本机 API 接入其他应用。典型请求链路如下：
1 | Claude Code / Hermes / OpenClaw |
这里的 127.0.0.1 只代表当前电脑。它不是公网 API 地址，也不应该被直接暴露到互联网。
一、准备工作
开始前准备下面几项：
- 安装可以正常运行的 CC Switch，并在其中完成 OpenAI 订阅账号或 Codex OAuth 认证。
- 在 CC Switch 中确认对应供应商已经启用，并且能够正常完成一次模型请求。
- 安装 Claude Code、Hermes Agent 或 OpenClaw。本文中的方法适用于能够自定义 API 地址、API 格式和模型名的版本。
- 确认账号当前可以使用目标模型。本文使用
gpt-5.6-luna作为示例，也可以换成 CC Switch 或上游实际提供的其他 OpenAI 模型。
模型名称不是固定不变的。若请求返回 model_not_found 或“没有可用通道”，应优先使用 CC Switch 中显示的模型 ID，而不是机械照抄示例。
二、在 CC Switch 中开启本地路由
打开 CC Switch 的设置，找到“路由”或“路由服务”页面，按下面顺序操作：
- 开启“路由总开关”或“本地路由服务”，等待服务状态变为运行中。
- 在“应用路由”区域开启需要接管的应用，例如 Claude、Codex、Hermes、OpenClaw 等。不同版本的 CC Switch 可能会把这些开关放在不同的分组中。
- 确认监听地址为
127.0.0.1:15721。这是 CC Switch 本地路由的默认地址。 - 回到供应商列表，启用已经完成 OpenAI 认证的供应商。
开启应用路由后，CC Switch 会把已接管应用的 API 地址改成本地路由，并根据当前启用的供应商转发请求。路由模式下切换供应商通常可以立即生效，但如果应用在启动时读取配置，切换后重新打开一次终端或应用会更稳妥。
三、通用 API 配置
在 Claude Code、Hermes 或 OpenClaw 中新增一个自定义 API、Provider 或模型供应商，填写以下内容：
| 配置项 | 填写内容 |
|---|---|
| API 名称 | 任意名称，例如 CC Switch OpenAI |
| API URL / Base URL | http://127.0.0.1:15721 |
| API Key | 留空 |
| 模型 | gpt-5.6-luna，或 CC Switch 中可用的其他 OpenAI 模型 |
API URL 填本地路由的服务根地址，不要把 Markdown 链接标记、逗号或说明文字一起复制进去。除非应用明确要求完整端点，否则不要手动填写 /messages、/chat/completions 或 /responses；这些路径应由应用和 API 格式决定。
有些 OpenAI SDK 的配置项名称叫 base_url，并且会自动在地址后拼接 /v1。这种情况下按照该应用的提示填写：如果它把输入值当作 OpenAI API 根地址，使用 http://127.0.0.1:15721/v1；如果它会自动拼接 /v1，则仍然填写本文表格中的 http://127.0.0.1:15721。关键是避免最终请求地址重复出现 /v1/v1。
四、三种 API 格式如何选择
CC Switch 路由可以根据上游和应用之间的协议差异做转换。常见格式如下：
| API 格式 | 常见请求路径 | 适合场景 |
|---|---|---|
| Anthropic Messages | /v1/messages |
Claude Code 或明确使用 Anthropic 协议的客户端 |
| OpenAI Chat Completions | /v1/chat/completions |
传统 OpenAI 兼容客户端 |
| OpenAI Responses | /v1/responses |
支持 Responses API、工具调用和新式响应事件的客户端 |
三种格式都指向同一个本地路由地址，区别在于应用发出的请求结构。配置时，应选择应用实际使用的格式，而不是根据模型名称选择格式：模型是 OpenAI 模型，不代表所有客户端都必须使用 Responses API。
1. Claude Code：选择 Anthropic Messages
如果通过 Claude Code 使用本地路由，Provider 的 API 格式选择 Anthropic Messages。Claude Code 会请求类似下面的地址：
1 | http://127.0.0.1:15721/v1/messages |
在 CC Switch 的应用路由中启用 Claude 后，通常不需要再手动修改 Claude Code 的配置文件。若采用手动配置，思路等价于把 ANTHROPIC_BASE_URL 指向：
1 | http://127.0.0.1:15721 |
然后把模型设置为 gpt-5.6-luna 或当前供应商支持的模型名。客户端侧的 API Key 按本文配置留空；真实认证由 CC Switch 保存在本地的供应商配置中，并由路由转发时处理。
2. Hermes Agent：按 Provider 的 API 类型选择
Hermes Agent 支持多种 API 执行模式。新增自定义 Provider 时，可以按界面中的字段填写：
1 | Base URL: http://127.0.0.1:15721 |
如果 Hermes 的配置项提供 anthropic_messages、chat_completions 和 responses 三个选项，可以这样选择：
- 使用 Anthropic Messages 客户端模式时，选择
anthropic_messages。 - 使用传统 OpenAI 兼容模式时，选择
chat_completions。 - 使用 OpenAI Responses 客户端模式时，选择
responses。
优先选择与当前 Hermes 运行模式一致的类型。选错格式时，常见表现是请求路径正确但返回 400，或者流式输出无法解析。
3. OpenClaw：配置自定义 OpenAI 兼容 Provider
在 OpenClaw 中新增自定义 Provider 或模型，将服务地址指向本地路由，模型填写：
1 | Base URL: http://127.0.0.1:15721 |
OpenClaw 的不同版本可能把协议名称显示为 openai-completions、openai-responses 或 Anthropic Messages。按照实际选项选择对应格式即可：
openai-completions对应 OpenAI Chat Completions。openai-responses对应 OpenAI Responses。anthropic-messages对应 Anthropic Messages。
如果 OpenClaw 的模型配置会自动为 Base URL 添加 /v1，就不要在地址中重复添加；如果它要求完整的 OpenAI Base URL，再填写 http://127.0.0.1:15721/v1。
五、如何确认请求确实走了订阅认证
不要只看应用能否返回文字，还可以按下面顺序检查：
- 在 CC Switch 的路由页面确认服务正在运行，端口仍为
15721。 - 在路由页面或请求日志中观察是否出现新的请求记录。
- 检查当前请求使用的供应商是否是已经完成 OpenAI 订阅认证的供应商。
- 在应用中发送一个简短请求，先验证普通文本，再验证工具调用或流式输出。
- 如果 CC Switch 提供用量或配额面板，再核对请求是否计入正确的账号。
可以用下面的方式快速理解故障位置：
1 | 应用无法连接 → 检查 CC Switch 是否启动、地址和端口是否正确 |
六、常见问题
API Key 为什么可以留空？
这里的 API Key 是应用连接本地路由时使用的字段，不是 OpenAI 订阅账号本身的认证凭据。真实认证由 CC Switch 的供应商配置和本地路由负责。如果某个应用强制要求非空值，应先查看它是否支持“本地 Provider”或占位凭据；不要把 OpenAI 的登录 Token、Cookie 或 Refresh Token 粘贴到应用配置中。
为什么地址不能写成公网地址？
127.0.0.1 能保证请求只在本机回环接口上流转。把路由服务绑定到公网网卡或通过端口转发暴露出去，可能让任何能访问该端口的人借用你的账号额度，也会增加凭据和请求内容泄露风险。
开启路由后请求还是直连？
检查三处：本地路由服务是否运行、目标应用的路由开关是否开启、应用当前启用的 Provider 是否是需要路由的供应商。部分应用已经打开的终端不会重新读取配置，关闭并重新启动应用后再测试。
为什么 Claude Code 能用，Hermes 或 OpenClaw 却报格式错误？
这通常不是模型问题，而是客户端协议没有对应上。Claude Code 一般发送 Anthropic Messages；Hermes 和 OpenClaw 可能发送 Chat Completions 或 Responses。确保 Provider 的 API 类型和应用实际发送的请求类型一致，并检查 Base URL 是否重复拼接了 /v1。
七、安全与使用边界
这种配置的本质是把已经认证的账号请求交给本地路由，再由其他应用发起调用。因此应注意：
- 只在自己有权使用的账号和设备上配置，不要共享账号、Token、Cookie 或 CC Switch 数据目录。
- 不要把
127.0.0.1:15721绑定到公网，也不要把它作为团队公共 API 使用。 - 不要将包含真实认证信息的配置文件提交到 Git 仓库、截图或日志中。
- 订阅额度、自动化调用和第三方客户端的使用须符合 OpenAI 账号协议及 CC Switch 当前版本的说明。相关功能可能受账号策略、认证机制或服务端更新影响，不能保证长期可用。
- 对长时间运行的 Hermes、OpenClaw 任务设置合理的并发、循环和预算，避免在无人看管时快速消耗账号额度。
总结
通过 CC Switch 的本地路由，可以把 Claude Code、Hermes Agent、OpenClaw 等应用统一接入已经在 CC Switch 中完成 OpenAI 订阅认证的供应商。核心配置只有四项：
1 | API URL: http://127.0.0.1:15721 |
先开启 CC Switch 路由，再根据应用实际使用的协议选择 API 格式，就可以让不同客户端通过同一个本地入口工作。遇到问题时，优先检查路由状态、Provider 认证、模型 ID、协议类型和 /v1 路径是否重复。
参考资料：
