Claude Code

通过原生 Messages 网关设置连接 Claude Code。

安装与准备

  1. 使用下方原生安装器安装 Claude Code；Windows 请使用下方 PowerShell 命令。重新打开终端，运行 claude --version。
  2. 在 routerra.ai 控制台创建 API 密钥，并复制获准使用的 Claude 模型 ID。Claude 订阅登录不能代替网关密钥。 所选模型需支持 Messages 流式输出与工具调用。
curl -fsSL https://claude.ai/install.sh | bash
claude --version

适用于 Windows PowerShell：

irm https://claude.ai/install.ps1 | iex
claude --version

配置 Claude 设置

  1. 将下方 env 合并到 ~/.claude/settings.json（Windows：%USERPROFILE%\.claude\settings.json），保留其他设置，替换两个占位符。ANTHROPIC_BASE_URL 使用不带 /v1 的根地址，Claude Code 自动添加 Messages 路径；ANTHROPIC_AUTH_TOKEN 提供 Bearer 认证。
  2. 退出运行中的 Claude Code，重新启动 claude，执行 /status 查看认证。用 /model YOUR_CLAUDE_MODEL_ID 明确切换模型，避免别名选中无权访问的模型。
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://routerra.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL_ID"
  }
}

检查连接

先发送简短提示，再要求 Claude Code 列出项目文件，检查工具调用。401 通常表示旧密钥或继承的 ANTHROPIC_API_KEY 冲突；清除冲突凭据并重启。路径 404 时检查是否重复 /v1。网关不提供 /v1/messages/count_tokens，因此 /context 的计数可能为估算值或不可用；这与流式输出和工具支持是不同问题。