接入 Claude Code

​

准备工作

1. 已安装 CC Switch：还没装的话，请先阅读 安装 CC Switch。
2. 已安装 Claude Code：用下面任意一种方式安装（前两种为官方推荐）。安装完成后重新打开终端，运行 claude --version 能看到版本号即可。
3. 已获取 ZeroCat 的 API Key：登录 ZeroCat 控制台 创建 API Key 并复制备用。

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

# 需要 Node.js 22 及以上
npm install -g @anthropic-ai/claude-code

​

选择接入端点

​

关于模型

1

添加供应商

打开 CC Switch，在左侧栏选择 Claude Code，然后点击右上角的 「添加供应商」。

2

选择「自定义配置」

在供应商预设列表中，点击最上方的 「自定义配置」。

3

填写 ZeroCat 信息

按下表填写各项：

字段	填写内容
名称	ZeroCat（只用于在列表中区分，可以自定义）
备注	可留空
官网链接	https://zero.cat（可选）
API Key	粘贴你的 ZeroCat API Key
请求地址	https://zero.cat，或三网优化直连端点 https://api.zero.cat

4

同时添加两个端点并自动测速（可选）

如果拿不准哪个端点更快，可以点击「请求地址」右上角的 「管理与测速」：

1. 在输入框中填入另一个端点（例如 https://api.zero.cat），点击右侧的 「+」 添加。
2. 保持勾选 「自动选择」，点击 「测速」。CC Switch 会测量每个地址的延迟，并自动把延迟最低的那个设为请求地址。
3. 点击 「保存」 返回。

测速只是向各个地址发一次普通请求来测量延迟，不会消耗额度。以后网络环境变了（比如换了宽带或公司网络），可以回到这里重新测速。

5

检查高级选项（保持默认即可）

点开 「高级选项」，确认以下几项都是默认值，不需要修改：

• 上游格式：Anthropic Messages (原生)
• 认证字段：ANTHROPIC_AUTH_TOKEN（默认）
• 模型映射：使用 Claude 模型时全部留空即可。Claude Code 会直接使用官方模型名，ZeroCat 可以正常识别。

6

确认配置并保存

页面最下方的 「配置 JSON」 会根据前面填写的内容自动生成，确认其中的 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 正确后，点击右下角的 「添加」。

7

启用 ZeroCat

回到供应商列表，可以看到刚添加的 ZeroCat。点击它右侧的 启用按钮（三角形图标），就会切换到 ZeroCat。

如果你之前没有在用的供应商，添加完成后 ZeroCat 会自动变为「使用中」，这一步可以跳过。

8

确认已生效

ZeroCat 卡片显示 「使用中」，顶部也显示 「直连 · ZeroCat」，说明切换成功。

卡片上的终端图标（「用 ZeroCat 打开终端」）可以直接打开一个使用该供应商的终端窗口，方便快速开始。

​

验证

claude

​

使用国产模型

1. 按第 1～3 步再添加一个供应商，名称可以填 ZeroCat 国产模型，API Key 和请求地址与前面相同。
2. 展开 「高级选项 → 模型映射」，把 Sonnet、Opus、Fable、Haiku 四行的 「实际请求模型」 都填成你要用的国产模型 ID，例如 deepseek-v4-pro。「显示名称」会自动跟着填好，也可以自己修改。
3. 「默认兜底模型」 也填上同一个模型 ID。它对应 Claude Code 启动时使用的主模型。
4. 点击「添加」，然后在列表中启用这个供应商。

​

附：CC Switch 写入的配置

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的ZeroCat API Key",
    "ANTHROPIC_BASE_URL": "https://zero.cat",
    "CLAUDE_CODE_AUTO_MODE_SERVER": "0"
  }
}

​

常见问题