星桥

Claude Code 中转配置：API 地址、密钥与排错

Claude Code 通过星桥接入时使用 Anthropic Messages 协议。基础地址是 https://newapi.xingqiaoapi.cn，不带 /v1；需要选择支持该协议以及任务所需工具调用的模型与分组。

资料核对：。以下步骤对照 Anthropic 官方网关文档，不代表所有 Claude Code 功能均已逐项实测。

1. 准备模型与密钥

先在价格页核对模型 ID、分组及 Anthropic 端点。这里的 YOUR_CLAUDE_MODEL_ID 必须替换成实际有权限的模型，不要直接把其他协议的模型名称套进配置。

2. 配置当前终端

macOS / Linux：

export ANTHROPIC_BASE_URL="https://newapi.xingqiaoapi.cn"
export ANTHROPIC_AUTH_TOKEN="替换为你的星桥密钥"
export ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL_ID"
claude

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://newapi.xingqiaoapi.cn"
$env:ANTHROPIC_AUTH_TOKEN = "替换为你的星桥密钥"
$env:ANTHROPIC_MODEL = "YOUR_CLAUDE_MODEL_ID"
claude

本例使用 Bearer token。检查其他服务商遗留的同名变量或密钥设置，避免同时保留互相冲突的认证来源。

3. 用 /status 核对实际连接

启动 Claude Code 后运行 /status，确认 Anthropic base URL 和认证来源。发送一句短消息，再到星桥控制台核对请求时间、模型与分组。某些后台任务会请求辅助模型；主模型可用不代表这些模型也有权限。

4. 需要跨终端使用时

可将变量合并到用户级 ~/.claude/settings.json 的 env 字段，Windows 通常为 %USERPROFILE%\.claude\settings.json。保留已有设置，不要把真实密钥写进团队共享的项目配置。设置文件中的同名环境变量可覆盖 shell 变量；地址未切换时以 /status 为准。

常见问题

ANTHROPIC_BASE_URL 要加 /v1 吗？

这份 Claude Code 配置不加 /v1。客户端会自行请求 /v1/messages；重复添加可能产生错误路径。不要把 OpenAI 风格客户端的 Base URL 直接复制到这里。

为什么 count_tokens 返回 404？

本站当前未启用 /v1/messages/count_tokens。依赖这一端点的客户端版本或功能可能不可用，需要记录版本和报错路径交给管理员，不能靠修改密钥或重复添加 /v1 解决。

哪些能力需要单独确认？

流式事件、工具调用、辅助模型、缓存和长上下文都需要相应模型与上游支持。不要仅用一次聊天成功推断完整兼容，也不要用长任务反复测试失败配置。

遇到限流和路由错误时，参照401、429、503 排错指南。多轮任务的费用可按缓存输入与输出的计算示例核对。

参考来源

Anthropic 官方：连接 Claude Code 到 LLM 网关。更多最小请求与配置说明见星桥接入文档；费用核对见Token 与分组计费。