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

3. 將下方 env 合併至 ~/.claude/settings.json（Windows：%USERPROFILE%\.claude\settings.json），保留其他設定並替換兩個預留值。ANTHROPIC_BASE_URL 使用不含 /v1 的根位址，Claude Code 會加入 Messages 路徑；ANTHROPIC_AUTH_TOKEN 提供 Bearer 驗證。
4. 結束執行中的 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 計數可能為估算值或無法使用；這與串流及工具支援是不同問題。