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

发布时间2026年8月30日 09:08
语言ja

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 / Anthropic	`https://www.relay-api.com`	Anthropic Messages
GPT / OpenAI	`https://www.relay-api.com/v1`	OpenAI Chat Completions
Gemini	`https://www.relay-api.com/v1beta`	Google generateContent

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

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

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