用 CC Switch 切换 Claude Code 到 6星中转
这一页只讲 Claude Code 的 CC Switch 切换。最重要的一句话:Claude Code 的 API URL 填 https://www.6xin.cc,不要加 /v1。
先看结论:Claude Code 速填表
| 配置项 | 6星中转 应该怎么填 | 错了会怎样 |
|---|---|---|
| 应用页 | 在 CC Switch 顶部选择 Claude。 | 写入到别的工具配置里,Claude Code 不会生效。 |
| API URL | https://www.6xin.cc |
多写 /v1 时容易出现路径异常或 404。 |
| API Key | 使用能访问 Claude 模型的 6星中转 令牌。 | 401 或权限不足。 |
| 验证方式 | 重开终端,发短问答,再查 6星中转 用量日志。 | 只看 CC Switch 状态,无法证明请求真的走 6星中转。 |
看这篇前
如果你还没装好 CC Switch,或还不理解 Provider、Base URL、API Key、Model 分别是什么,先看 通用概念与配置。本页只补 Claude Code 专属步骤。
一、什么情况适合切 Claude Code
| 场景 | 是否适合 CC Switch | 建议 |
|---|---|---|
| 同时保留官方账号和 6星中转 令牌 | 适合 | 分别建 Claude-official 和 6星中转-Claude,需要时点启用。 |
| 不同项目使用不同 Claude 分组 | 适合 | 按项目或环境命名,例如 6星中转-Claude-prod、6星中转-Claude-test。 |
| 团队共用一台开发机 | 适合 | 每个人使用自己的 6星中转 令牌,不要共用一条 Key。 |
| 只长期使用一套 6星中转 Claude 配置 | 可选 | 配一次即可;后续不频繁切换时,手动配置也可以。 |
二、开始前准备
- 已经走完 通用概念与配置。
- 已经创建能访问 Claude 模型的 6星中转 令牌。
- 本机终端能运行 Claude Code。
claude --version
如果提示命令不存在,先安装 Claude Code,再回来继续配置。
| 你需要的值 | 填写内容 | 注意 |
|---|---|---|
| API URL | https://www.6xin.cc |
Claude Code 填根地址,不带 /v1。 |
| API Key | sk-你的 6星中转 令牌 |
令牌要能访问 Claude 模型。 |
| Model | 从 6星中转 模型广场复制 Claude 模型 ID | 不确定时先不锁定模型,能用后再细调。 |
三、在 CC Switch 里添加 Claude 配置
打开 CC Switch
顶部应用切换到 Claude。确认当前不是 Codex 或 Gemini 页面。
点击 Add Provider
新建一个 Provider,名称建议写成 6星中转-Claude 或带项目后缀。
填写字段
API URL 填 https://www.6xin.cc,API Key 填 6星中转 令牌,Model 可先留空或填 Claude 可用模型 ID。
保存并启用
保存后在列表里点击 Enable / 启用。状态显示使用中后,关闭所有旧 Claude Code 终端。
| 字段 | 示例 | 说明 |
|---|---|---|
| Name | 6星中转-Claude | 本地显示名。 |
| Provider / App | Claude | 写入 Claude Code 配置。 |
| API URL | https://www.6xin.cc | 不要加 /v1。 |
| API Key | sk-你的令牌 | 使用 Claude 分组可用令牌。 |
| Model | Claude 可用模型 ID | 以 6星中转 模型广场当前公开 ID 为准。 |
四、为什么 Claude 不能加 /v1
Claude Code 会自己拼接 Messages 路径。Base URL 写根地址时,请求会落到正确的 /v1/messages;如果你手动写成 https://www.6xin.cc/v1,就可能变成重复路径。
| Base URL | 最终路径倾向 | 结果 |
|---|---|---|
https://www.6xin.cc |
https://www.6xin.cc/v1/messages |
正确 |
https://www.6xin.cc/v1 |
.../v1/v1/messages |
常见 404 或路由错误 |
五、验证切到 6星中转
- 关闭之前所有 Claude Code 终端窗口。
- 打开新终端。
- 启动 Claude Code。
- 发送一句短指令。
claude
回复:连接成功,并告诉我当前模型名称
能正常返回,说明本机配置已经生效。更稳妥的验证方式是打开 6星中转 控制台用量日志,确认刚才那次请求的时间点出现了记录。
六、完成标准
| 检查项 | 应该看到什么 | 不满足时回到哪里 |
|---|---|---|
| CC Switch 启用项 | Claude 应用下 6星中转-Claude 处于使用中。 |
添加 Claude 配置 |
| Base URL | 是 https://www.6xin.cc,没有 /v1。 |
/v1 规则 |
| 新终端短问答 | Claude Code 能正常回复“连接成功”。 | 验证切到 6星中转 |
| 6星中转 用量日志 | 能看到刚才那次请求的时间点。 | 常见误区 |
七、启用后仍走旧配置时,先查覆盖来源
CC Switch 写入的是本机配置,但终端环境变量、启动脚本或项目脚本仍可能覆盖它。排查时只确认变量是否存在,不要把令牌值打印出来。
| 覆盖来源 | 怎么安全检查 | 处理方式 |
|---|---|---|
| Shell 环境变量 | printenv ANTHROPIC_BASE_URLtest -n "$ANTHROPIC_AUTH_TOKEN" && echo ANTHROPIC_AUTH_TOKEN=set |
如果还指向旧地址,先清理当前终端变量或打开新终端。 |
| 启动脚本或 alias | type claude |
如果 alias 里写死了旧环境变量,先改脚本或临时绕过 alias。 |
| 项目内文档或脚本 | 检查项目 README、启动脚本和 .env 示例。 |
不要把旧 Claude 地址复制进新项目脚本。 |
| 旧终端进程 | 关闭 Claude Code 窗口后重新打开。 | 切换后必须新开终端再验证。 |
八、失败时按这个顺序排查
Claude Code 切换失败时,先按顺序排查,不要一上来重装工具。大多数问题都能在地址、令牌、终端进程和用量日志里定位。
看启用项
确认 CC Switch 当前在 Claude 应用页,并且 6星中转-Claude 是使用中。不要只看 Codex 或 Gemini 页面的状态。
重开 Claude Code 终端
关闭所有旧的 Claude Code 窗口,再打开新终端。旧进程不会自动读取刚写入的配置。
核对根地址
API URL 必须是 https://www.6xin.cc,不能写成 https://www.6xin.cc/v1,也不要多带空格。
核对令牌和模型
401 优先看令牌是否完整;403 或 model not found 优先看令牌分组和模型 ID 是否匹配。
核对 6星中转 日志
短问答成功后,到 6星中转 用量日志按时间点找记录。没有记录时,通常说明 Claude Code 仍在走旧后端。
这些情况先停下来,不要继续改 Claude 配置
Claude Code 的关键规则是根地址、不带 /v1。如果你同时改令牌、模型和地址,很容易把简单路径问题变成多变量问题。
| 现象 | 先停止什么 | 下一步只做这一件事 |
|---|---|---|
| 404 或路径异常 | 不要重装 Claude Code。 | 只把 API URL 改回 https://www.6xin.cc。 |
| 启用后没生效 | 不要继续创建新 Provider。 | 关闭所有旧 Claude Code 终端,重新打开再测。 |
model not found |
不要凭官方模型名手写。 | 从 6星中转 模型广场复制当前 Claude 分组可用模型。 |
| 6星中转 日志没有记录 | 不要只看 CC Switch 当前状态。 | 说明 Claude Code 可能仍在走旧后端,检查覆盖来源。 |
九、切回原来的后端
切回官方账号或其他 Claude 后端时,逻辑完全一样:在 Claude 配置列表里启用原来的 Provider,然后关闭当前 Claude Code 终端,重新打开。
Claude-official、6星中转-Claude。如果生产和测试环境不同,再拆成 6星中转-Claude-prod 和 6星中转-Claude-test。
十、常见误区
| 现象 | 原因 | 处理 |
|---|---|---|
| 401 Unauthorized | 令牌复制不完整、过期、被禁用。 | 重新创建 Claude 可用令牌,整段复制到 CC Switch。 |
| 404 或路径异常 | API URL 多写了 /v1。 |
改回 https://www.6xin.cc。 |
model not found |
模型 ID 不在当前令牌分组里。 | 换成 6星中转 模型广场里 Claude 分组可用的模型。 |
| 启用了但没生效 | 旧终端还在用旧环境。 | 关闭所有 Claude Code 终端,重新打开。 |
| 几分钟后突然失败 | 余额不足、令牌被删除或上游临时不可用。 | 看 6星中转 控制台余额、令牌状态和状态页。 |
十一、日常使用建议
- 测试和生产用不同令牌,避免一次误操作影响所有项目。
- 配置名称带环境后缀,例如
6星中转-Claude-prod、6星中转-Claude-dev。 - 每次切换后都用短问答验证,不要一上来跑长上下文任务。
- 怀疑令牌泄露时,先到 6星中转 控制台禁用或删除,再回 CC Switch 替换新 Key。
Claude Code 仍然不通时,提交这些定位信息
Claude Code 的定位重点是根地址、Claude 分组、终端是否重开,以及是否还有环境变量覆盖 CC Switch。提交问题前先把这些信息整理好。
| 信息 | 建议内容 | 不要提供什么 |
|---|---|---|
| Provider 配置 | Provider 名称、API URL 是否为 https://www.6xin.cc、模型 ID。 |
不要把完整 API Key 截进图里。 |
| 覆盖来源 | 是否设置过 ANTHROPIC_BASE_URL、项目级配置或旧终端环境变量。 |
不要只说“CC Switch 已启用”。 |
| 错误表现 | 401、403、404、model not found、timeout 或完整错误摘要。 | 不要提交包含完整 prompt 或客户数据的日志。 |
| 6星中转 回证 | 新终端短问答是否成功,用量日志是否出现对应时间点。 | 不要用旧终端结果判断新配置。 |
如果错误码已经明确,可以继续按 FAQ 错误码速查 分流。