Claude Code 接入 CC Switch 教程

ModelGate 专属教程：Claude Code 接入 CC Switch

本教程适用于通过 ModelGate 中转站为 Claude Code 配置 CC Switch 供应商。请按截图完成 Claude Code 安装、专用 API Key 创建、Anthropic 环境变量核对和运行验证。

操作说明

Claude Code 依赖 ANTHROPIC_* 环境变量读取供应商配置。请重点核对 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 和模型字段，避免 Key 填错或端点遗漏。

适用场景

需要让 Claude Code 通过 ModelGate 调用 Claude 模型，并由 CC Switch 管理配置。

配置目标

创建 Claude 专用 Key，导入 Claude 供应商，确认 Anthropic Messages 格式与认证变量。

完成标准 终端运行 claude 后可以正常进入 Claude Code，并显示当前使用的模型。 接口端点 统一填写 https://modelgate.app，保存前请逐字核对。API 格式选择 Anthropic Messages（原生），不要切换到 OpenAI 格式。认证字段使用 ANTHROPIC_AUTH_TOKEN，基础地址使用 ANTHROPIC_BASE_URL。

安装 Claude Code

先按官方方式安装 Claude Code。Windows 可使用 PowerShell 安装脚本，也可以通过 npm 全局安装；二选一即可。

# PowerShell 安装
irm https://claude.ai/install.ps1 | iex

# 或 npm 全局安装
npm install -g @anthropic-ai/claude-code
claude

安装命令执行完成后，可先确认 claude 命令可被终端识别。正式运行前先完成 ModelGate Key 和 CC Switch 供应商配置，避免首次启动时走默认配置。

创建 Claude Key

进入 ModelGate 后台创建 Claude Code 专用 API Key。专用 Key 方便后续单独统计 Claude Code 用量，也便于排查连接问题。

本图重点：确认已完成 ModelGate 账号注册，Claude Code 后续使用的 Key 从该账号创建。

注册账号后进入 令牌管理 页面。创建密钥时名称可填写 Claude，分组选择 Claude（即 Claude Max 分组）。创建成功后确认 Key、名称和分组无误。在操作区点击 导入 CCS，将该 Key 写入 CC Switch。

本图重点：进入 令牌管理页面后创建 Claude 专用 Key，便于单独统计和排查。

本图重点：密钥名称和分组按截图选择 Claude，确保匹配 Claude Code 使用场景。

本图重点：密钥创建成功后使用导入 CCS 入口，把 Claude 供应商信息写入 CC Switch。

本图重点：核对 Key 名称、Key 内容和 Claude 分组，确认无误后继续导入。

导入 CC Switch

浏览器提示打开 CC Switch 时选择允许。导入完成后进入 Claude 应用配置页，逐项核对供应商基础信息。 应用类型 选择 Claude。供应商名称保持 ModelGate。端点保持 **https://modelgate.app**。API 格式保持 Anthropic Messages（原生）。

本图重点：确认导入的是 Claude 供应商配置，并检查应用类型是否正确。

本图重点：重点核对 API 格式为 Anthropic Messages（原生），端点为 https://modelgate.app。

本图重点：启用 ModelGate 供应商后，Claude Code 才会读取该配置。

运行验证

确认供应商启用后，打开终端运行 claude。能正常进入 Claude Code 并显示当前模型，说明 ModelGate 接入成功。

![本图重点：终端运行 claude 后能进入 Claude Code 并显示模型，即说明接入完成。](data:image/svg+xml,%3Csvg xmlns=‘http://www.w3.org/2000/svg’ width=‘800’ height=‘450’ viewBox=‘0 0 800 450’%3E%3Crect fill=‘%23101828’ width=‘800’ height=‘450’/%3E%3Ctext x=‘400’ y=‘200’ text-anchor=‘middle’ fill=‘%23dbeafe’ font-size=‘16’ font-family=‘monospace’%3E$ claude%3C/text%3E%3Ctext x=‘400’ y=‘230’ text-anchor=‘middle’ fill=‘%2364778b’ font-size=‘14’ font-family=‘monospace’%3EOpus 4.8 · API Usage Billing%3C/text%3E%3C/svg%3E)

本图重点：终端运行 claude 后能进入 Claude Code 并显示模型，即说明接入完成。

截图中显示 Opus 4.8 与 API Usage Billing，实际展示会随当前模型和账号状态变化。如果无法启动，优先回到 CC Switch 检查 ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_BASE_URL。

最终核对清单

全部勾对后再交付或上传，能减少 Key、端点、协议和启用状态造成的返工。

• 已安装 Claude Code，并确认终端可以识别 claude 命令。
• 已创建 Claude 专用 ModelGate Key，并确认分组为 Claude。
• CC Switch 中 API 格式为 Anthropic Messages（原生），端点为 https://modelgate.app。
• ANTHROPIC_AUTH_TOKEN 已写入 ModelGate Key，ANTHROPIC_BASE_URL 已指向 ModelGate。
• ModelGate 供应商已启用。
• 终端运行 claude 后能进入 Claude Code，并显示当前模型。

常见问题排查

如果按截图完成后仍无法使用，优先按下面顺序检查，通常能快速定位问题。

claude 命令无法运行怎么办？

先确认 Claude Code 已安装完成；如果终端找不到命令，重新打开终端后再执行 claude。

Claude Code 还是走默认配置怎么办？

回到 CC Switch 检查 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 和供应商启用状态。

模型列表和截图不一致怎么办？

模型列表会随当前接口返回变化，只要格式、端点、Key 正确并能启动验证即可。

认证失败怎么办？

重新复制 ModelGate 后台的 Claude 专用 Key，确认没有多余空格，并重新保存供应商配置。