命令行编程工具

Claude Code 接入 6星中转:地址填根域名,不要加 /v1

Claude Code 使用 Anthropic Messages 协议。最关键的规则是:Base URL 填 https://www.6xin.cc,不要填 https://www.6xin.cc/v1。

预计阅读 5 分钟 适合手动配置 Claude Code、重点确认根地址的用户
核心规则:不带 /v1 Claude 分组 环境变量 404 排障

等不及了,先照这张表填

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。
如果你还没安装 CC Switch,建议先看 CC Switch 一键导入。手动配置适合已经熟悉环境变量和配置文件的用户。

确认本机 Claude Code 能打开

6星中转 只负责模型接口。手动配置前,先确认本机的 Claude Code 命令本身可用。

检查命令应该看到什么
命令是否存在which claude能输出可执行文件路径。
版本或帮助claude --version 或 claude --help能正常输出,不是 command not found。
当前认证状态进入 Claude Code 后执行 /status能看到当前认证或环境变量来源。
如果命令本身打不开,先解决安装问题;如果命令能打开但请求失败,再按本页排查 Base URL、令牌和模型分组。

方式一:用环境变量配置

在当前终端会话里设置以下变量,令牌使用你自己的 6星中转 API 令牌:

export ANTHROPIC_BASE_URL="https://www.6xin.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"

然后在同一个终端窗口启动 Claude Code。不同 shell 的持久化文件不同:

Shell常见配置文件说明
zsh~/.zshrcmacOS 新版本常见默认 shell。
bash~/.bashrc 或 ~/.bash_profileLinux 和旧 macOS 常见。
fish~/.config/fish/config.fish语法不同,不要直接复制 export。

手动配置步骤

1

准备 Claude 专用令牌

在 6星中转 令牌管理里创建或复制 Claude 分组令牌,名称建议写成 local-claude-code。

2

在同一个终端设置变量

设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN,先临时设置,确认能用后再写入 shell 配置文件。

3

先跑接口直测

用本页的 /v1/messages curl 请求验证 6星中转 令牌、模型和分组。

4

重新打开 Claude Code

关闭旧的 Claude Code 终端,新开终端或重新 source 配置后再启动。

5

用短任务验收

先问“回复 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 相关分组。

403 通常不是 Claude Code 安装错了,而是“当前令牌所在分组不能访问请求里的模型”。先换成同分组可用模型做测试。

配置来源排查

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-你的令牌"
恢复配置前,先确认你没有把同一个令牌写在多个地方。泄露或不再使用的令牌应直接在 6星中转 控制台禁用。

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。