Skip to content

创建令牌并导入 CC-Switch

本站将 API Key 称为“API 密钥”或“令牌”。创建后可以在密钥右侧直接点击 “导入到 CCS”,无需手动复制多项配置。

最快使用方式

创建密钥 → 确认分组 → 点击右侧“导入到 CCS” → 在 CC-Switch 中确认并启用。

第一步:确认 API 端点

登录本站并进入左侧 “API 密钥” 页面。

页面顶部会显示当前可用的 API 端点,旁边带有复制按钮。请以密钥管理页面实际显示的地址为准,不要根据其他教程自行猜测。

text
API 端点:请从 API 密钥管理页面顶部复制

这个地址会在手动配置 CC-Switch 或其他客户端时用作 Base URL。

地址不要多写路径

CC-Switch 的 Claude 供应商通常填写页面显示的根地址,不要自行追加 /v1/v1/messages/chat/completions

第二步:创建 API 密钥

  1. 在“API 密钥”页面点击 “创建密钥”
  2. 填写便于识别的名称,例如“个人电脑-CCSwitch”。
  3. 选择需要使用的分组。
  4. 按需设置配额、有效期和 IP 限制。
  5. 确认创建,并立即妥善保存密钥。

创建完成后,密钥会出现在列表中。每一行会显示:

  • 密钥名称和脱敏后的 Key;
  • 所属分组及倍率;
  • 当前并发、用量和有效期;
  • 启用状态;
  • “使用密钥”“导入到 CCS”“禁用”“编辑”和“删除”等操作。

第三步:一键导入 CC-Switch

确保电脑已经安装并启动 CC-Switch,然后:

  1. 找到刚创建的密钥。
  2. 在最右侧“操作”区域点击 “导入到 CCS”
  3. 浏览器询问是否打开 CC-Switch 时,选择“允许”或“打开”。
  4. 在 CC-Switch 中核对供应商名称、Base URL 和密钥。
  5. 确认导入并切换到新供应商。
  6. 完全退出并重新启动 Claude Code 或 VSCode。

导入成功后,Base URL 和密钥会由网站自动传递给 CC-Switch,通常不需要再次手工填写。

导入前确认软件来源

只允许浏览器打开你自己安装的可信 CC-Switch。不要把导入链接复制到群聊,也不要允许来源不明的软件接管密钥。

一键导入没有反应怎么办

按以下顺序检查:

  1. 确认 CC-Switch 已安装并至少启动过一次。
  2. 检查浏览器地址栏是否拦截了“打开外部应用”。
  3. 换用 Chrome 或 Edge 重试。
  4. 退出 CC-Switch 后,以正常用户身份重新启动。
  5. 仍无法导入时,使用下面的手动配置方式。

手动配置 CC-Switch

在 CC-Switch 中新增 Claude/Anthropic 自定义供应商:

配置项填写内容
名称自定义,例如“本站 API”
Base URL从 API 密钥管理页面顶部复制“API 端点”
API Key / Auth Token刚创建的 API 密钥
启用状态开启

如果 CC-Switch 提供环境变量编辑,可使用:

text
ANTHROPIC_BASE_URL=密钥管理页面显示的 API 端点
ANTHROPIC_AUTH_TOKEN=你的 API 密钥
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
CLAUDE_CODE_ATTRIBUTION_HEADER=0

保存后切换到该供应商,并重新启动 Claude Code。

分组决定什么

每个密钥都会绑定一个分组,分组通常决定:

  • 可以使用的平台和模型;
  • 是否支持 Chat Completions、Responses、Messages 或 Gemini 接口;
  • 线路、并发或速率限制;
  • 计费倍率。

出现“模型不存在”或“无可用渠道”时,应先核对密钥分组和模型广场。

配额、有效期与 IP 限制

  • 密钥配额:达到配额后,即使账户仍有余额,该密钥也不能继续调用。
  • 有效期:过期后需要修改有效期或创建新密钥。
  • IP 白名单:仅允许指定公网出口 IP,家庭宽带和移动网络 IP 可能变化。
  • IP 黑名单:阻止指定 IP 使用该密钥。

首次测试建议暂不设置 IP 限制,确认调用成功后再开启。

安全提醒

API 密钥相当于密码

不要把完整密钥、导入链接或带有密钥的配置截图发送到 QQ 群、GitHub、网页前端或公开工单。反馈问题时只保留前 3 位和后 4 位,例如 sk-...abcd

API 密钥属于敏感信息,请勿在群聊、截图或前端代码中公开。