Claude Code 接入 6星中转:地址填根域名,不要加 /v1
Claude Code 使用 Anthropic Messages 协议。最关键的规则是:Base URL 填 https://www.6xin.cc,不要填 https://www.6xin.cc/v1。
等不及了,先照这张表填
Claude Code 和 OpenAI 兼容工具的地址规则不一样。这里只写 Claude Code 手动配置的最小口径。
| 要配置什么 | 填写值 | 最容易错的点 |
|---|---|---|
| Base URL | https://www.6xin.cc |
不要加 /v1,Claude Code 会自己拼 Messages 路径。 |
| Token | sk-你的6星中转令牌 |
建议使用 Claude 分组专用令牌,不和 Codex/图形客户端共用。 |
| 环境变量 | ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN |
变量要在启动 claude 的同一个终端里生效。 |
| 模型 ID | 模型广场复制的 Claude 模型 | 403 多数是令牌分组和模型不匹配,不是安装坏了。 |
准备工作
- 已安装 Claude Code,并确认终端里能执行对应命令。
- 已在 6星中转 创建 Claude 相关分组的令牌。
- 已从 6星中转 模型广场复制 Claude 模型 ID。
确认本机 Claude Code 能打开
6星中转 只负责模型接口。手动配置前,先确认本机的 Claude Code 命令本身可用。
| 检查 | 命令 | 应该看到什么 |
|---|---|---|
| 命令是否存在 | which claude | 能输出可执行文件路径。 |
| 版本或帮助 | claude --version 或 claude --help | 能正常输出,不是 command not found。 |
| 当前认证状态 | 进入 Claude Code 后执行 /status | 能看到当前认证或环境变量来源。 |
方式一:用环境变量配置
在当前终端会话里设置以下变量,令牌使用你自己的 6星中转 API 令牌:
export ANTHROPIC_BASE_URL="https://www.6xin.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
然后在同一个终端窗口启动 Claude Code。不同 shell 的持久化文件不同:
| Shell | 常见配置文件 | 说明 |
|---|---|---|
| zsh | ~/.zshrc | macOS 新版本常见默认 shell。 |
| bash | ~/.bashrc 或 ~/.bash_profile | Linux 和旧 macOS 常见。 |
| fish | ~/.config/fish/config.fish | 语法不同,不要直接复制 export。 |
手动配置步骤
准备 Claude 专用令牌
在 6星中转 令牌管理里创建或复制 Claude 分组令牌,名称建议写成 local-claude-code。
在同一个终端设置变量
设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN,先临时设置,确认能用后再写入 shell 配置文件。
先跑接口直测
用本页的 /v1/messages curl 请求验证 6星中转 令牌、模型和分组。
重新打开 Claude Code
关闭旧的 Claude Code 终端,新开终端或重新 source 配置后再启动。
用短任务验收
先问“回复 OK”,再让它读项目或改文件。避免一上来就给大任务,排障会很慢。
先用接口直测,再启动 Claude Code
如果你不确定是 Claude Code 配置问题,还是 6星中转 令牌问题,可以先用最小 Messages 请求验证:
curl "https://www.6xin.cc/v1/messages" \
-H "x-api-key: sk-你的令牌" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-示例模型",
"max_tokens": 128,
"messages": [
{"role": "user", "content": "回复 OK"}
]
}'
如果这条请求能成功,说明令牌、分组、模型和 6星中转 侧链路基本正常;后续再看 Claude Code 本地配置是否生效。
为什么不能加 /v1
Claude Code 会把 Messages 接口路径拼到 Base URL 后面。如果你写成 https://www.6xin.cc/v1,最终可能变成 /v1/v1/messages,从而返回 404。
| 写法 | 结果 | 判断 |
|---|---|---|
https://www.6xin.cc |
https://www.6xin.cc/v1/messages |
正确 |
https://www.6xin.cc/v1 |
.../v1/v1/messages |
错误,常见 404 来源 |
模型和分组
Claude Code 的令牌需要能访问 Claude 模型。建议在 6星中转 创建一个专用令牌,例如 claude-code-stable,并选择 Claude 相关分组。
配置来源排查
Claude Code 可能读取当前 shell 环境变量,也可能读取用户级或项目级设置。遇到“明明改了地址还是访问旧地址”时,按这个顺序查:
| 检查项 | 怎么看 | 处理方式 |
|---|---|---|
| 当前终端变量 | echo "$ANTHROPIC_BASE_URL" |
确认输出是 https://www.6xin.cc。 |
| 是否新开了终端 | 新窗口里变量为空或回到旧值。 | 重新 export,或写入 shell 配置文件。 |
| 用户级设置覆盖 | 工具 debug 日志里仍是旧地址。 | 检查 Claude Code 设置来源,移除旧 Base URL。 |
| 项目级设置覆盖 | 只有某个项目目录里失败。 | 检查项目内配置文件,避免和全局配置冲突。 |
这些情况先停下来,不要继续改更多配置
Claude Code 的问题很容易被误判成“工具坏了”。遇到下面这些现象时,先按单点排查,不要同时改地址、令牌、模型和 shell 配置。
| 现象 | 先停在哪里 | 下一步只做这一件事 |
|---|---|---|
| 接口直测失败 | 不要先启动 Claude Code。 | 先确认令牌、分组和模型能通过 6星中转 Messages 接口。 |
| 返回 404 | 不要重装 Claude Code。 | 把 Base URL 改回 https://www.6xin.cc,去掉 /v1。 |
| 返回 403 | 不要在未验证前换成更贵或不熟悉的模型。 | 检查令牌分组是否允许当前 Claude 模型。 |
| 新终端仍然走旧地址 | 不要继续换令牌。 | 只检查 shell 配置、用户级设置和项目级覆盖来源。 |
| 直测成功但 Claude Code 失败 | 不要怀疑 6星中转 接口本身。 | 确认 Claude Code 进程读取的是同一个终端环境。 |
| 6星中转 用量日志没有记录 | 不要只看本地终端报错。 | 说明请求没有打到 6星中转,回到地址和配置来源排查。 |
验证和排障
| 现象 | 优先检查 | 处理 |
|---|---|---|
| 401 | 令牌是否完整、是否有多余空格。 | 重新复制令牌并只在本机安全位置保存。 |
| 403 | 令牌分组和模型是否匹配。 | 换 Claude 分组令牌或换该分组开放的模型。 |
| 404 | Base URL 是否误写 /v1。 |
改成 https://www.6xin.cc 后重启终端或工具。 |
| 请求仍打到旧地址 | 用户级配置是否覆盖当前 shell。 | 检查 Claude Code 的设置来源,并重开终端。 |
| 提示认证方式冲突 | 本机登录态和环境变量令牌同时存在。 | 用 /status 确认当前使用哪种认证;测试 6星中转 时保持变量来源明确。 |
为什么直测成功,Claude Code 还是失败?
优先检查 Claude Code 是否读到了同一个终端里的环境变量,以及是否有用户级或项目级设置覆盖。直测成功只证明 6星中转 链路可用,不代表本地工具已经读取新配置。
我应该用 ANTHROPIC_API_KEY 还是 ANTHROPIC_AUTH_TOKEN?
本页按 6星中转 网关接入写法使用 ANTHROPIC_AUTH_TOKEN 配合 ANTHROPIC_BASE_URL。如果你同时保留官方 Anthropic API Key,要用 /status 确认当前实际认证来源。
新终端里变量没了怎么办?
临时 export 只对当前终端有效。确认能跑通后,再写入 ~/.zshrc、~/.bashrc 或你的 shell 配置文件,并重新打开终端。
完成标准
| 检查项 | 应该看到什么 | 不满足时先看 |
|---|---|---|
| 当前终端变量 | ANTHROPIC_BASE_URL 是 https://www.6xin.cc,令牌变量有值。 |
环境变量配置 |
| 接口直测 | /v1/messages 最小请求能返回文本。 |
接口直测 |
| Claude Code 新终端 | 新打开终端后启动 Claude Code,短问答能返回。 | 配置来源排查 |
| 6星中转 用量日志 | 能看到刚才那次 Claude 请求时间点。 | 验证和排障 |
恢复默认配置
如果你只是临时测试 6星中转,可以关闭当前终端窗口,临时 export 的变量就会失效。若写入了 shell 配置文件,删除对应两行后重新打开终端。
# 删除或注释掉类似配置
export ANTHROPIC_BASE_URL="https://www.6xin.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
Claude Code 仍然不通时,提交这些定位信息
Claude Code 手动配置失败时,先把“6星中转 接口直测”和“Claude Code 是否读取配置”分开。直测成功但工具失败,通常是终端变量、配置来源或旧进程问题。
| 信息 | 建议内容 | 不要提供什么 |
|---|---|---|
| 当前终端变量 | ANTHROPIC_BASE_URL 是否为 https://www.6xin.cc,令牌变量是否存在。 |
不要输出完整令牌。 |
| 接口直测结果 | /v1/messages 最小请求是否成功,错误码和错误摘要是什么。 |
不要提交含隐私内容的完整请求体。 |
| 工具读取情况 | 新终端启动 Claude Code 后是否仍失败,是否有用户级或项目级配置覆盖。 | 不要用旧终端结果判断新配置。 |
| 模型和分组 | 模型 ID、令牌分组、脱敏令牌片段,例如 sk-前6位...后4位。 |
不要贴完整 API Key。 |
| 6星中转 回证 | 用量日志是否出现对应时间点、模型和状态。 | 不要只说“没有反应”。 |
整理后可以套用 FAQ 工单模板;如果更适合图形化切换,回到 CC Switch 切换 Claude Code。