RealRelay.ai
程式碼代理

Claude Code 設定指南

透過 Anthropic Messages 端點將 Claude Code 接上 RealRelay.ai:安裝、把 ANTHROPIC_BASE_URL 指向 RealRelay.ai、檢查連線並選擇模型。

建立 API 密鑰瀏覽模型目錄
協定
Anthropic Messages
基礎位址
https://www.realrelay.ai
官方文件
code.claude.com
已對照工具官方文件核對
2026-10

概覽

Claude Code 是 Anthropic 推出的終端機程式碼代理。它會讀取你的專案、編輯檔案,並在你核准後執行指令。它使用 Anthropic Messages 協定,因此是連到 RealRelay.ai 的 /v1/messages 端點。

  • 一組 API 金鑰,在主控台的 API 金鑰頁面取得。

  • 基礎位址是網站位址,不含 /v1。Claude Code 會自行加上 /v1/messages,如果你自己加上,會得到 404。

  • 一個模型 ID,完全依照 GET /v1/models 列出的寫法,例如 anthropic/claude-sonnet-4-6。

Anthropic 只支援 Claude Code 搭配 Claude 模型使用。目錄中的其他模型可透過協定轉換使用,但它們的工具使用與延伸思考僅屬盡力支援。

安裝

請使用 Anthropic 的安裝程式。它不需要 Node.js,並會在背景自動更新。在 Windows 上,Claude Code 還需要 Git for Windows;如果安裝程式要求安裝,請參閱 Anthropic 的設定指南。

macOS · Linux · WSL
curl -fsSL https://claude.ai/install.sh | bashclaude --version
Windows PowerShell
irm https://claude.ai/install.ps1 | iexclaude --version
npm (Node.js 18+)
npm install -g @anthropic-ai/claude-code

如果 claude --version 印出版本號,就代表安裝成功。如果找不到指令,請開啟新的終端機,讓它讀到更新後的 PATH。

設定

把設定寫在 ~/.claude/settings.json。不論是從哪個終端機或 IDE 啟動,Claude Code 每次啟動都會讀取這個檔案,而且其中的值會優先於你在 shell 中 export 的變數。請把 sk-*** 換成你的金鑰。

~/.claude/settings.json
1{2  "env": {3    "ANTHROPIC_BASE_URL": "https://www.realrelay.ai",4    "ANTHROPIC_AUTH_TOKEN": "sk-***",5    "ANTHROPIC_API_KEY": "",6    "ANTHROPIC_MODEL": "anthropic/claude-sonnet-4-6",7    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"8  }9}
~/.zshrc · ~/.bashrc
1export ANTHROPIC_BASE_URL="https://www.realrelay.ai"2export ANTHROPIC_AUTH_TOKEN="sk-***"3export ANTHROPIC_API_KEY=""4export ANTHROPIC_MODEL="anthropic/claude-sonnet-4-6"5export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

啟動 Claude Code 前,先執行 source ~/.zshrc,或開啟新的終端機。

Windows PowerShell
1[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://www.realrelay.ai", "User")2[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-***", "User")3[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "anthropic/claude-sonnet-4-6", "User")4[Environment]::SetEnvironmentVariable("CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY", "1", "User")

這些變數會儲存在你的使用者帳戶中。啟動 Claude Code 前,請關閉並重新開啟終端機。

  • ANTHROPIC_AUTH_TOKEN 會把金鑰當作 bearer token 送出。ANTHROPIC_API_KEY 刻意設為空字串,以免 Anthropic 帳戶殘留的金鑰取得優先權。

  • CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 會以 RealRelay.ai 的模型清單填入 /model 選單。

  • 不要把金鑰放進專案的 .claude/settings.json,這個檔案通常會被提交。若只想套用到單一專案,請使用 .claude/settings.local.json。

驗證

  1. 1

    直接呼叫端點

    開啟 Claude Code 前,先用你的金鑰執行這段指令。若收到 JSON 回覆,且其 id 以 msg_ 開頭,就代表位址、金鑰與模型都沒問題。

    Terminal
    1curl -sS "https://www.realrelay.ai/v1/messages" \2  -H "Authorization: Bearer sk-***" \3  -H "anthropic-version: 2023-06-01" \4  -H "content-type: application/json" \5  -d '{"model": "anthropic/claude-sonnet-4-6", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'
  2. 2

    在專案中啟動 Claude Code

    如果你先前以 Anthropic 帳戶登入,請先執行一次 /logout。接著啟動 claude,並執行 /status。

    Claude Code
    cd /path/to/your/projectclaude/status
  3. 3

    檢查狀態畫面

    Anthropic base URL 那一行應顯示 RealRelay.ai,而憑證應來自 ANTHROPIC_AUTH_TOKEN。送出一則簡短訊息;收到回覆即確認整條路徑暢通。之後請求會出現在主控台的用量日誌中。

模型

在工作階段中可用 /model 切換模型,或以 claude --model 加上模型 ID 啟動。Claude Code 在第一次請求前不會檢查名稱,所以拼錯時,會在你送出第一則訊息時才出現錯誤。

Claude Code 也會把背景工作(例如標題與摘要)交給它的 Haiku 槽位,而這個槽位的內建名稱並不是 RealRelay.ai 列出的 ID。請把每個別名都指向你的金鑰可以呼叫的模型:

~/.claude/settings.json → env
"ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-sonnet-4-6","ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4-6","ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-sonnet-4-6"

在 /v1/messages 上原生提供的 Claude 模型,列於選擇模型。

疑難排解

  • 401 或「Invalid token」。金鑰沒有送達 RealRelay.ai。請在 /status 中確認憑證來自何處。若 token 是以 "$OTHER_VAR" 的形式 export,而該變數在你的 profile 中較晚才定義,token 就會是空的。

  • 出現有兩個憑證來源的警告。你仍登入著 Anthropic 帳戶。請執行 /logout。

  • 404。基礎位址以 /v1 結尾。請把它移除。

  • 400 並指出未知欄位,例如 context_management:請關閉 Claude Code 的實驗性請求欄位。

    ~/.claude/settings.json → env
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"

  • 出現上下文錯誤,或沒有自動壓縮:發生在上下文視窗比 Claude Code 預設值小的模型上。請執行 /compact,然後把視窗設為該模型的上限(最小 100,000)。

    ~/.claude/settings.json → env
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "200000"

  • 設定似乎被忽略。settings.json 中的值會優先於 shell 變數,而以原生安裝程式安裝的 Claude Code 不會讀取專案的 .env 檔案。

  • 除錯輸出中出現 /v1/messages/count_tokens 的錯誤。RealRelay.ai 不提供該端點。訊息本身並不會經由它送出。