Claude Code 通过 CC Switch 连接

1.准备工作

安装 Node.js、Claude Code 和 CC Switch，并保证 CC Switch 在后台运行。准备一个 New API 令牌；网页登录密码不能当 API Key 使用。

2.添加中转渠道

1. 打开 CC Switch，进入 Claude 渠道管理，点击“添加渠道”。
2. 选择“自定义渠道”或 Anthropic Messages 格式。
3. Base URL 填：https://xiaomaiapi.cn。如果软件要求完整地址，再填 https://xiaomaiapi.cn/v1，不要重复添加。
4. API Key 填 New API 里生成的令牌。
5. 模型名必须填写中转站里实际存在的名称，然后保存并应用。

{
  "base_url": "https://xiaomaiapi.cn",
  "api_key": "sk-替换为你的令牌",
  "api_format": "anthropic",
  "model": "替换为实际模型名"
}

3.两种使用方式

直接配置：在 CC Switch 点击“应用到 Claude Code”，重新打开终端运行：

claude

代理 / 接管模式：开启 CC Switch 的 Proxy 或 Takeover，使用它显示的本地地址。常见地址是：

$env:ANTHROPIC_BASE_URL="http://127.0.0.1:15721"
claude

本地代理模式要求 CC Switch 一直运行；端口以 CC Switch 当前显示为准。

4.失败时检查

• 401 / 403：令牌无效、渠道未启用，或把网页登录密码当成了 API Key。
• 404 / model not found：模型名称不正确，或 Base URL 重复加了 /v1。
• 连接失败：检查 CC Switch 是否运行，以及本地端口是否被其他代理占用。
• VPN 打不开：将 cc-install.cn、xiaomaiapi.cn 和 127.0.0.1 加入直连 / bypass 规则。

5.安全提醒

不要把 API Key 发到群里、截图、网页或公开仓库。Key 泄露后立即在 New API 中禁用并重新生成。

Claude Code 官方文档 · CC Switch 渠道配置