集成

Claude Code

Anthropic 官方 CLI 接入 xAPI —— 通过环境变量切换 base URL,无需修改代码。

Claude Code 是 Anthropic 官方的命令行 coding agent,原生支持通过 ANTHROPIC_BASE_URL 环境变量覆盖默认 base URL。 接入 xAPI 时使用聚合路由 ai.xapi.to,运行于 Anthropic Messages 协议, 自动跨上游故障转移。

1

安装

$npm install -g @anthropic-ai/claude-code
2

创建 API Key

进入 xapi.to 控制台 → API Keys → 新建, 密钥形如 sk-xapi-...。

3

配置环境变量

写入 ~/.zshrc 或 ~/.bashrc:

$export ANTHROPIC_BASE_URL="https://ai.xapi.to"
$export ANTHROPIC_AUTH_TOKEN="sk-xapi-..."

加载新环境:

$source ~/.zshrc

必须使用 ANTHROPIC_AUTH_TOKEN,不要使用 ANTHROPIC_API_KEY。 后者会触发 Claude Code 的官方账号校验逻辑导致鉴权失败。 若此前已设置 ANTHROPIC_API_KEY,请先执行 unset ANTHROPIC_API_KEY 并重启终端。

4

启动与验证

$claude

发送任意请求,确认收到 Claude 模型的回复即接入成功。 在交互式 session 中输入 /status 可查看当前 base URL 是否为 ai.xapi.to。

路由策略

通过修改 base URL 切换路由策略:

优先级base URL
质量(默认)https://ai.xapi.to
速度https://ai.xapi.to/speed
成本https://ai.xapi.to/cost

模型切换

session 中执行:

/model claude-opus-4-7

或在启动前设置默认模型:

$export ANTHROPIC_MODEL=claude-opus-4-7

可用模型清单参见 模型与价格。

项目级隔离

如需仅在特定项目中使用 xAPI,可配合 direnv, 在项目根目录创建 .envrc:

$export ANTHROPIC_BASE_URL="https://ai.xapi.to"
$export ANTHROPIC_AUTH_TOKEN="sk-xapi-..."

执行 direnv allow 后,该目录下的 claude 命令将使用 xAPI, 其他位置仍走原配置。

常见问题

  • 通过 echo $ANTHROPIC_AUTH_TOKEN 确认密钥已正确加载
  • 执行 unset ANTHROPIC_API_KEY 并重启终端
  • 终端未加载新环境变量:重开 terminal 或 source ~/.zshrc
  • 在 session 中输入 /status 查看当前 base URL

当前模型不在所命中上游的支持列表中。执行 /model claude-opus-4-7 切换至 支持的模型,或使用 /cost 策略让网关进行跨上游模糊匹配。

该端点暂未实现。Claude Code 会自动降级为本地 tokenizer 估算,不影响主流程。