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

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

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

1. Claude Codeとは

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

2. Claude Codeのインストール

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

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

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

3. 環境変数の設定

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入口へと転送します。

4. インターフェースアドレス対照表

モデルグループ	本サイト入口（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

5. トラブルシューティング

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

セキュリティのヒント：APIキーは公開リポジトリに書かず、.envファイルや環境変数を使用してください。生成系タスクはトークン消費が激しいため、残高に注意し、「利用ログ」で各リクエストを確認してください。

Base URLに関する補足：本サイトは /v1beta/models/... と /v1beta/v1beta/models/... （および /v1/... と /v1/v1/...）の両方を受け付けるため、クライアントが自動的に /v1 や /v1beta を補完するかどうかに関わらず利用可能です。Base URLにはドメインのルート、または /v1beta を含むアドレスのどちらでも設定できます。モデルIDはコントロールパネルの「トークン」ページ右上にある「モデルID」からコピーして使用してください。