主题
创建令牌并导入 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 密钥
- 在“API 密钥”页面点击 “创建密钥”。
- 填写便于识别的名称,例如“个人电脑-CCSwitch”。
- 选择需要使用的分组。
- 按需设置配额、有效期和 IP 限制。
- 确认创建,并立即妥善保存密钥。
创建完成后,密钥会出现在列表中。每一行会显示:
- 密钥名称和脱敏后的 Key;
- 所属分组及倍率;
- 当前并发、用量和有效期;
- 启用状态;
- “使用密钥”“导入到 CCS”“禁用”“编辑”和“删除”等操作。
第三步:一键导入 CC-Switch
确保电脑已经安装并启动 CC-Switch,然后:
- 找到刚创建的密钥。
- 在最右侧“操作”区域点击 “导入到 CCS”。
- 浏览器询问是否打开 CC-Switch 时,选择“允许”或“打开”。
- 在 CC-Switch 中核对供应商名称、Base URL 和密钥。
- 确认导入并切换到新供应商。
- 完全退出并重新启动 Claude Code 或 VSCode。
导入成功后,Base URL 和密钥会由网站自动传递给 CC-Switch,通常不需要再次手工填写。
导入前确认软件来源
只允许浏览器打开你自己安装的可信 CC-Switch。不要把导入链接复制到群聊,也不要允许来源不明的软件接管密钥。
一键导入没有反应怎么办
按以下顺序检查:
- 确认 CC-Switch 已安装并至少启动过一次。
- 检查浏览器地址栏是否拦截了“打开外部应用”。
- 换用 Chrome 或 Edge 重试。
- 退出 CC-Switch 后,以正常用户身份重新启动。
- 仍无法导入时,使用下面的手动配置方式。
手动配置 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。