API Hop

文件目錄

API Hop 文件

Claude Code 整合

在 Claude Code 中使用 RequestBeam 的 Claude Messages 相容端點。

Claude Code 透過 Anthropic Messages 協定呼叫模型。請將 ANTHROPIC_BASE_URL 設為本頁顯示的 Anthropic 相容基礎網址。

上游供應商支援 Claude Sonnet 4.6（claude-sonnet-4-6），但目前尚未在 RequestBeam 發布，因此不是已啟用的預設整合模型。呼叫任何模型前，請以您自己的 GET https://api.apihop.ai/v1/models 回應確認存取權限。

text
ANTHROPIC_BASE_URL=https://api.apihop.ai/anthropic

先決條件

請先準備有效的 RequestBeam API 金鑰。金鑰會寫入本機 Shell 環境，切勿將其提交至程式碼儲存庫、日誌或螢幕截圖。

安裝 Claude Code

在 macOS / Linux 上，請使用 Claude Code 原生安裝程式：

bash
curl -fsSL https://claude.ai/install.sh | bash

若安裝程式顯示 ~/.local/bin/claude，但找不到 claude，請開啟新的終端機，或將 ~/.local/bin 加入 PATH。

舊的工作流程仍可使用 npm 套件：

bash
npm install -g @anthropic-ai/claude-code

請勿使用 sudo npm install -g @anthropic-ai/claude-code，這可能導致之後升級時出現權限問題。

安裝後請驗證 CLI：

bash
claude --version
claude doctor

Windows 建議以 Git Bash 或 WSL 執行 Claude Code。PowerShell 也能設定環境變數，但持續儲存方式會因終端機而異。

設定環境變數

暫時設定僅影響目前的終端機工作階段：

bash
export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
export ANTHROPIC_MODEL="claude-sonnet-5-5"

macOS 預設使用 zsh。若要持續保留設定，請將變數寫入 ~/.zshrc，然後執行 source ~/.zshrc，讓目前終端機立即讀取：

bash
printf '%s\n' \
  'export ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"' \
  'export ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"' \
  'export ANTHROPIC_MODEL="claude-sonnet-5-5"' \
  >> ~/.zshrc

source ~/.zshrc

Linux 使用 bash 時，請將相同變數寫入 ~/.bashrc 並執行 source ~/.bashrc。

Windows PowerShell 暫時設定：

powershell
$env:ANTHROPIC_AUTH_TOKEN="YOUR_REQUESTBEAM_API_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apihop.ai/anthropic"
$env:ANTHROPIC_MODEL="claude-sonnet-5-5"

PowerShell 使用者層級的持續設定：

powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_REQUESTBEAM_API_KEY", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.apihop.ai/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5-5", "User")

執行 claude 前，請開啟新的 PowerShell 工作階段。

設定檔

您也可以建立或編輯 ~/.claude/settings.json 來取代 Shell 設定。若檔案已存在，請將 env 與 model 合併到現有 JSON，勿取代其他設定：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_REQUESTBEAM_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.apihop.ai/anthropic",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  },
  "model": "claude-sonnet-5-5"
}

可用模型：

  • claude-fable-5
  • claude-fable-5-1
  • claude-opus-4-6
  • claude-opus-4-7
  • claude-opus-4-8
  • claude-opus-5
  • claude-opus-5-5
  • claude-sonnet-5
  • claude-sonnet-5-5

請透過 GET https://api.apihop.ai/v1/models 查看您的 API 金鑰目前可用的模型。

啟動與測試

設定環境變數後，重新啟動 Claude Code，再傳送一般提示詞：

bash
claude "Reply exactly OK."

也可以啟動互動模式：

bash
claude

首次啟動時，Claude Code 可能要求選擇主題、確認安全事項、設定終端機，或詢問是否信任目前目錄。請依終端機提示操作。

選擇模型

使用環境變數設定預設模型，或以 --model 為單次指令選擇模型：

bash
claude --model claude-sonnet-5-5 "Review this PR"

端點行為

Claude Code 使用已設定的 RequestBeam API 金鑰驗證。服務接受以下任一驗證形式：

http
x-api-key: YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01
http
Authorization: Bearer YOUR_REQUESTBEAM_API_KEY
anthropic-version: 2023-06-01

回應會保留原生 Anthropic Messages JSON 或 SSE 事件格式，不會轉換為 OpenAI 格式。

疑難排解

  • ANTHROPIC_BASE_URL 必須是本頁顯示的公開 API 基礎網址加上 /anthropic。
  • ANTHROPIC_BASE_URL 不應包含端點路徑，只需 Anthropic 相容基礎網址。
  • 在 macOS 編輯 ~/.zshrc 後，請執行 source ~/.zshrc，或在啟動 Claude Code 前開啟新的終端機。
  • 若 claude 顯示找不到指令，請確認安裝位置已加入 PATH，常見位置為 ~/.local/bin/claude。
  • 若 claude doctor 回報缺少環境變數，請在同一終端機執行 echo $ANTHROPIC_BASE_URL 與 echo $ANTHROPIC_MODEL，確認已載入。
  • 若收到 401，請確認 API 金鑰有效。
  • 若模型不可用，請確認模型名稱來自上述可用模型清單。
  • 變更環境變數後，請重新啟動 Claude Code 程序。
  • POST https://api.apihop.ai/anthropic/v1/messages：Anthropic Messages 相容端點。