ClawSocket API 指南

CC Switch 如何配置第三方模型：Claude Code、Codex 与 ClawSocket 接入教程 ​

很多人搜 cc switch 如何配置第三方模型，实际想解决的是：Claude Code、Codex CLI、Gemini CLI 这些开发工具能不能统一切到自己的 API 入口，而不是每个工具都手动改一遍配置。

CC Switch 配置第三方模型流程

先讲边界：CC Switch 本身不是模型服务，它更像一个配置管理器和切换器。第三方模型能不能跑起来，取决于你填入的 API 入口是否兼容对应工具需要的协议。涉及当前支持的模型、路径、配额、价格和限制，一律以 api.clawsocket.com 控制台当前显示为准。

如果你的目标是统一管理 Claude Code、Codex、Gemini CLI、OpenCode 或 OpenClaw，可以先从 api.clawsocket.com 获取当前可用的 Base URL、API Key 和模型名，再用 CC Switch 写入各工具配置。

先区分：你说的是哪一个 CC Switch ​

搜索结果里至少有两类常见工具：

名称形态更适合做什么
CC Switch 桌面版跨平台桌面应用统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 的 provider、MCP、模型映射
@adithya-13/cc-switchnpm CLI 工具在 Claude Code 不同 provider 之间快速切换

本文主线讲桌面版 CC Switch，因为它更接近“配置第三方模型”的完整需求；最后会补充 CLI 版的思路。

配置前先确认协议兼容 ​

不要一上来就填 Key。对 Claude Code 来说，官方 LLM gateway 文档写得很明确：网关至少要暴露它能识别的 API 格式，例如 Anthropic Messages、Bedrock InvokeModel 或 Vertex rawPredict。

如果走 Anthropic Messages 格式，重点检查：

  • 是否有 /v1/messages
  • 是否有 /v1/messages/count_tokens
  • 是否正确转发 anthropic-beta
  • 是否正确转发 anthropic-version
  • 是否支持你要映射的模型 ID

如果你手里的第三方服务只提供 OpenAI 兼容接口，那么 Claude Code 不一定能直接使用。CC Switch 官方介绍里提到本地代理可以做格式转换，但具体能转换到什么程度、是否支持当前模型能力，仍要以你实际安装版本和服务控制台说明为准。

对 Codex、Gemini CLI、OpenCode、OpenClaw 也是同样逻辑：先确认工具需要的协议，再决定怎么填 provider。

第一步：安装并打开 CC Switch ​

桌面版 CC Switch 官方页面说明，它支持 Windows、macOS 和 Linux，安装包通常从 GitHub Releases 下载。安装后打开应用，先看顶部或侧边栏里是否能切换到目标工具，例如：

  • Claude Code
  • Codex
  • Gemini CLI
  • OpenCode
  • OpenClaw

如果你只想配置 Claude Code，就先停留在 Claude Code 面板。不要同时改多个工具，第一次配置越小越容易排错。

第二步：新增 ClawSocket Provider ​

在 CC Switch 里点击新增 provider，按下面思路填写：

text
Provider Name: clawsocket
API URL / Request URL: https://api.clawsocket.com
API Key: 从 api.clawsocket.com 控制台获取
Protocol / Format: 以控制台当前文档为准

这里有两个常见坑：

  1. 不要凭别人的截图决定是否追加 /v1、/anthropic 或其他路径。
  2. 不要把模型名写成“听说可用”的名字，必须从控制台当前模型列表复制。

如果控制台当前要求专用路径，就按控制台写；如果控制台说明使用根地址，就不要自己拼路径。Base URL 配错时，最常见结果是 404、405 或一直无法完成握手。

第三步：配置 Claude Code 的模型映射 ​

CC Switch 文档里提到 model mapping 的作用：把 Claude Code 的模型别名映射到你希望使用的目标模型。常见字段包括：

映射项含义建议
Primary ModelClaude Code 默认模型先选一个稳定、成本可控的模型
Reasoning Model深度推理或 thinking 场景只给复杂任务使用
Haiku Default Model/model haiku 对应模型可映射到轻量模型
Sonnet Default Model/model sonnet 对应模型适合作为日常 coding 主力
Opus Default Model/model opus 对应模型适合复杂规划和架构任务

如果你用 ClawSocket，模型 ID、别名和权限都以 api.clawsocket.com 控制台当前显示为准。文章里的字段只是结构示例，不代表当前控制台一定开放同名模型。

更稳的配置方式是：

  1. Primary 先映射到一个你已验证可用的模型。
  2. Sonnet / Opus / Haiku 先不要全部填满。
  3. 只在最小任务跑通后，再补 reasoning 或长上下文模型。
  4. 给旧 provider 保留一个可一键切回的配置。

第四步：应用到 Claude Code 并验证 ​

保存 provider 后，在 CC Switch 主界面选择 clawsocket，点击启用或应用到 Claude Code。桌面版 CC Switch 官方页面说 Claude Code 支持热切换，但如果你的网络环境或本地代理状态复杂，重启终端仍然是最可靠的兜底动作。

进入一个测试仓库后运行：

bash
claude

在 Claude Code 里先检查：

text
/status

再做一个最小任务：

text
请只回复 ok，并说明当前模型名称。

如果 Claude Code 支持当前网关模型发现，也可以按官方文档启用：

bash
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

注意：官方文档说明模型发现只适用于 Anthropic Messages 格式，且会从 /v1/models 读取可用模型。网关没有实现该接口，或者模型 ID 不符合发现规则时，需要手动配置模型选项或模型映射。

Codex 和 Gemini CLI 怎么处理 ​

CC Switch 的价值不只在 Claude Code。它把多个开发工具的 provider 配置集中管理，适合下面这种团队环境：

工具配置重点风险点
Claude CodeAnthropic Messages 兼容、模型映射、认证优先级OpenAI 兼容接口不能直接硬塞
Codex CLIOpenAI 兼容 Base URL、API Key、模型名coding 模型 ID 要以控制台为准
Gemini CLIGemini API 兼容或工具当前支持的认证方式官方认证和第三方中转不是一回事
OpenCode / OpenClawprovider 协议、模型名、工具权限能聊天不代表能稳定跑工具调用

如果你用 ClawSocket 做统一入口，建议先配置一个工具，验证成功后再同步到其他工具。不要第一次就把所有工具都切过去，否则排错时很难判断是 provider、协议、模型还是工具本身的问题。

CLI 版 cc-switch 怎么用 ​

如果你说的是 npm 包 @adithya-13/cc-switch，它的定位更轻：用命令在 Claude Code provider 之间切换。

安装方式通常是：

bash
npm install -g @adithya-13/cc-switch

新增自定义 provider：

bash
cc-switch add clawsocket

交互式向导一般会要求你填写：

  • Base URL
  • API Key
  • 模型名
  • provider 名称

然后切换：

bash
cc-switch use clawsocket
cc-switch status
cc-switch doctor

CLI 版适合只管 Claude Code 的个人工作流；如果你还要管理 Codex、Gemini CLI、MCP、Skills 和多工具同步，桌面版 CC Switch 更合适。

常见问题 ​

1. 切换后 Claude Code 还是走旧模型 ​

先查三处：

  • CC Switch 是否真的对 Claude Code 写入配置
  • 终端里是否还有旧的 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN
  • Claude Code 是否被 managed settings、项目设置或命令行参数覆盖

官方设置文档说明，Claude Code 有 managed、命令行、local、project、user 多级优先级。排错时不能只看 ~/.claude/settings.json。

2. 报 401 或 403 ​

优先检查 API Key 是否有效、是否放错认证字段、控制台是否允许当前模型。Bearer Token 和 x-api-key 不是一回事，具体用哪种要看网关文档。

3. 报 404 或 405 ​

多数是 Base URL 或路径规则不匹配。不要自己把 /v1/messages 拼到 Base URL 后面，除非控制台明确要求这样写。

4. 模型能返回，但工具调用不稳定 ​

这通常不是“能不能聊天”的问题，而是协议兼容深度的问题。Claude Code 这类 coding agent 还会用到 token 统计、beta header、工具调用、长上下文和多轮状态。先用小仓库和只读任务验证，再开放写文件和执行命令权限。

5. 要不要开启自动 failover ​

可以开，但不要在没有日志的情况下开。失败回退会让长任务更不容易中断，也会让排查变复杂。至少记录当前 provider、模型 ID、状态码、请求 ID 和耗时。

推荐配置顺序 ​

更稳的落地顺序是：

  1. 在 api.clawsocket.com 控制台确认当前支持的模型、路径和认证方式。
  2. 在 CC Switch 里只新增一个 clawsocket provider。
  3. 只先配置 Claude Code 或 Codex 其中一个工具。
  4. 做 /status、最小问题、读文件、改小文件四类验证。
  5. 把旧 provider 保留为回滚目标。
  6. 再逐步同步到 Gemini CLI、OpenCode、OpenClaw 等工具。

CC Switch 能减少手动改配置的成本，但真正决定稳定性的，仍然是协议兼容、模型映射、日志和回滚。把这四件事先做好，再谈多模型热切换，才不会把问题藏进一个漂亮的按钮里。

参考资料 ​