AZZ API

Claude Code 中継接続ガイド：ターミナルエージェントと Base URL 設定

Anthropic 公式ターミナルコーディングエージェント「Claude Code」の接続ガイド：インストール、ANTHROPIC_BASE_URL と API キーの設定、モデル切り替え、およびトラブルシューティング方法。

一、Claude Code とは

Claude Code は、Anthropic が提供する公式のターミナルコーディングエージェント（CLI）です。ターミナル上で直接コードの読み書き、コマンドの実行、タスクの処理が可能です。ANTHROPIC_BASE_URL や ANTHROPIC_API_KEY などの環境変数をネイティブで読み込むため、中継ゲートウェイへ簡単に接続し、自身の API キーとクレジットを使用して動作させることができます。

二、Claude Code のインストール

Node.js（公式推奨：18以上）が必要です。以下のコマンドでグローバルインストールしてください：

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

インストール後、ターミナルで claude と入力すれば起動します。モデルの切り替えは /model または claude --model … を使用します。

三、環境変数の設定

Windows（PowerShell）

$env:ANTHROPIC_BASE_URL="https://www.relay-api.com"
$env:ANTHROPIC_API_KEY="sk-あなたのキー"
$env:ANTHROPIC_MODEL="claude-sonnet-5"
claude

macOS / Linux（bash / zsh）

export ANTHROPIC_BASE_URL="https://www.relay-api.com"
export ANTHROPIC_API_KEY="sk-あなたのキー"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude

補足：ANTHROPIC_API_KEY はリクエストヘッダーに含まれ、ANTHROPIC_BASE_URL はデフォルトの API エンドポイントを上書きして本サイトの Anthropic エントリポイントを指すために使用されます。

四、インターフェースアドレス対照表

モデルグループ本サイトのエントリポイント（Base URL）プロトコル
Claude / Anthropichttps://www.relay-api.comAnthropic Messages
GPT / OpenAIhttps://www.relay-api.com/v1OpenAI Chat Completions
Geminihttps://www.relay-api.com/v1betaGoogle generateContent

五、トラブルシューティング

現象対処法
401 / 403キーが無効、未有効化、または残高不足です。sk- で始まるキーが正しいか、クレジットがチャージされているかを確認してください。
404 / モデル利用不可モデル名とプラットフォームの slug が一致していないか、そのモデルが有効化されていません。モデル ID を確認してください。
Unknown model指定するモデル ID は正確である必要があります（大文字・小文字含む）。モデル一覧で確認してください。
リクエストタイムアウト長時間かかるタスクではタイムアウト時間を調整するか、ネットワークの問題がある場合は再試行してください。

セキュリティのアドバイス：API キーを公開リポジトリに書き込まないでください。.env ファイルまたは環境変数を使用してください。コード生成タスクはトークン消費量が多いため、残高に注意し、「使用量ログ」で各呼び出しを確認することをお勧めします。