大约 2 分钟
CC-Switch 配置 Claude Code
本页给出使用 CC-Switch 接入 Claude Code 的完整流程。
一、准备信息
开始前先确认：
- 已完成通用步骤：/docs/ccswitch/1-common.html
- 已创建 Claude 对应分组令牌：/docs/register/4-token.html
- 本机可执行
claude --version
你会用到两项参数：
- API 地址：
https://www.yuzhixiaolongxia.com/v1 - API Key：Claude 分组令牌
二、在 CC-Switch 中新增 Claude 配置
- 打开 CC-Switch，进入
Providers（或供应商）页面 - 点击
Add新建配置 - 应用类型选择
Claude - 填写
Base URL为https://www.yuzhixiaolongxia.com/v1 - 填写
API Key为你的令牌 - 可选填写模型（如
claude-3-7-sonnet，以你分组可用模型为准） - 保存并点击
Enable
关键点：
- 必须启用到“使用中”状态，只有保存不代表生效
- 一台机器可同时保留多个 Claude 配置，用于测试/生产切换
三、终端验证
重开终端后执行：
claude进入会话后输入一句测试问题，例如“回复：连接成功”，能正常返回即说明接入成功。
四、常见错误与处理
| 现象 | 原因 | 处理方式 |
|---|---|---|
401 Unauthorized | API Key 错误、过期或复制不完整 | 重新创建令牌并完整替换 |
model not found | 模型名不在当前分组可用列表 | 换成分组内模型，或切换分组 |
| 仍走旧提供商 | 旧配置仍被启用 | 在 CC-Switch 中禁用旧项，启用新项 |
| 首次可用，随后失效 | 令牌额度不足或被删除 | 到控制台检查余额与令牌状态 |
五、日常维护建议
- 测试和生产使用不同令牌
- 每次大改后执行一次最小问答验证
- 令牌疑似泄露时立即删除并重建