CC Switch配置Claude Code：供应商、认证字段与切换验证

本篇以 Claude Code CLI 为操作对象。CC Switch 管理供应商配置，本身不向你发放第三方服务额度。已经使用官方账号且不需要切换供应商时，可以继续现有登录方式；不必为了使用 Claude Code 先注册某个中转服务。

开始前拿到这四项信息

确认终端能运行 claude --version，并从你选定的供应商当前文档得到：

信息	要核对的内容
接入方式	原生兼容Claude消息协议，还是需要CC Switch路由转换
Base URL	专门给Claude Code使用的地址，不是控制台登录页
认证	Bearer token、x-api-key，或供应商提供的明确配置
模型	该账号可用的实际模型ID或预设映射

只看到“OpenAI兼容”或“有API Key”不足以确定能直连。若供应商没有说明 Claude 接入方式，先向它核实，不要不断猜测路径后缀。

添加供应商：先选对应用，再填字段

在 CC Switch 侧栏选 Claude Code，进入添加供应商。当前界面先选择预设，再填写；找不到相应厂商时使用自定义配置。预设已有协议与模型映射时，先按其要求填写个人凭证，避免把其他客户端的配置整段粘过来。添加说明

自定义供应商的结构示例：

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gateway.example.invalid",
    "ANTHROPIC_AUTH_TOKEN": "REPLACE_WITH_YOUR_OWN_TOKEN"
  }
}

这个地址是不可用的占位值，必须替换为已核对地址。示例采用 Bearer 认证；若供应商要求 x-api-key，使用 ANTHROPIC_API_KEY 字段而非同时塞入两套凭证。认证变量对应的请求头由 Claude官方网关说明明确区分。

在自己电脑上的配置界面输入凭证；给他人排错截图时保留字段名、地址和错误码即可，遮住值。添加时也留意编辑框中的其他设置，别把已有权限、MCP 或插件配置当成可以随供应商任意覆盖的内容。

直连、路由和聚合分别意味着什么

当前手册中，直连由客户端访问供应商；路由先经过本机 CC Switch，可承担格式转换与故障转移；聚合按所选模型分配供应商。点击顶部标签只是查看页面，实际生效模式要看“生效中”状态及切换按钮。切换说明

首次配置可从供应商明确支持的模式开始。卡片显示需要路由时，就按该提示启动路由，保持 CC Switch 运行；不能保存卡片后仍按直连理解请求路径。聚合并非首次连通所必需，先验证一个明确目标能工作更容易定位问题。

保存切换后，怎样知道真正用了新配置

当前 CC Switch 文档写明 Claude Code 切换可即时生效；Claude Code 也支持多数设置热重载。因此没有必要把“完全退出重启”写成每次必做步骤。不过 model 等部分键只在会话启动时读取，当前会话改变模型应使用 /model，或在保存任务状态后按实际需要新开会话。热重载及例外

保存后切换到目标供应商，确认当前模式和卡片状态。再在 Claude Code 里用 /status 查看实际网关和认证来源，用 /model 确认模型。Setting sources 只是设置来源列表，不能单独证明每个键最终来自哪个文件。

最后在新的测试目录创建 README.md，内容写 cc-switch-readonly-demo，从该目录打开 Claude Code，输入：

text

请只读当前目录，列出实际存在的文件。
读取其中的README.md并用两句话概括；如果不存在就报告不存在。
不要创建或编辑文件，不执行安装命令。

能获得与真实文件一致的回答，说明本轮请求和一次读取基本可用。它没有验证大型任务、所有模型、长上下文或每一种工具调用。若只是随意问候得到回复，也不足以证明文件工具链正常。

出错时先区分哪一层失败

现象	优先检查
401	凭证是否有效、对应Bearer还是x-api-key、实际认证来源是否仍为旧值
404或协议错误	Base URL和最终接口路径、供应商是否需路由转换
模型不存在	账号可用模型、预设映射及当前/model选择
切换后仍像旧配置	当前生效模式、项目设置与用户设置、启动环境及实际/status信息
简单对话成功，文件工具失败	网关工具调用兼容性及具体工具错误，不继续重复更换Key

不要打印全部环境变量或把完整配置公开求助。每次只修一个已找到的差异，重复同一个测试任务，才能知道变化是否有效。

Claude Desktop 是另一种配置入口，官方说明其第三方推理配置不能简单等同于 CLI 的环境变量。本文不把 CLI 步骤推广到所有桌面界面。本次核对了项目手册和官方文档，未登录任何供应商账户，也未运行付费连通性测试。

如果你选择小贺 API，可从服务入口查看当期 Claude Code 接入说明，再判断是否符合上面的条件；它是供应商选项之一，不是本教程的前置账户要求。

资料来源

CC Switch添加供应商
添加入口、自定义env格式与供应商字段。
CC Switch切换供应商
直连、路由、聚合及Claude Code生效方式。
Claude Code连接网关
认证字段、状态检查与不同客户端形态的区别。
Claude Code设置热重载
热重载范围及model等例外。

下一步

继续阅读与你当前问题相关的教程：