API Hop

ドキュメント

API Hop ドキュメント

Claude Code 連携

Claude Code で RequestBeam の Claude Messages 互換エンドポイントを使用します。

Claude Code は Anthropic Messages プロトコルでモデルを呼び出します。ANTHROPIC_BASE_URL に、このページに示す Anthropic 互換 Base URL を設定してください。

Claude Sonnet 4.6（claude-sonnet-4-6）は上流の供給元では対応していますが、現在 RequestBeam では公開されていません。現時点の連携における既定モデルではありません。モデルを呼び出す前に、自分の API キーによる GET https://api.apihop.ai/v1/models のレスポンスでアクセス権を確認してください。

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

前提条件

まず有効な RequestBeam API キーを用意してください。キーはローカルのシェル環境に書き込まれます。リポジトリにコミットしたり、ログやスクリーンショットに含めたりしないでください。

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 で Claude Code を使用する場合は、Git Bash または WSL を推奨します。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

bash を使用する Linux では、同じ変数を ~/.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 を作成または編集する方法もあります。ファイルがすでに存在する場合は、他の設定を置き換えず、既存の JSON に env と model を統合してください。

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

自分の API キーで現在利用できるモデルは GET https://api.apihop.ai/v1/models で確認してください。

起動とテスト

環境変数を設定した後で Claude Code を再起動し、通常のプロンプトを送信してください。

bash
claude "Reply exactly OK."

対話モードを開始することもできます。

bash
claude

初回起動時に、テーマ、安全性の確認、ターミナル設定、現在のディレクトリを信頼するかどうかを尋ねられる場合があります。ターミナルの案内に従ってください。

モデルの選択

環境変数で既定のモデルを設定するか、--model を使って 1 回のコマンドに使用するモデルを選択してください。

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 Base URL に /anthropic を追加した値にしてください。
  • ANTHROPIC_BASE_URL にエンドポイントのパスを含めないでください。必要なのは Anthropic 互換のベース URL のみです。
  • macOS で ~/.zshrc を編集した後は、Claude Code を起動する前に source ~/.zshrc を実行するか、新しいターミナルを開いてください。
  • 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 互換エンドポイントです。