Claude Code で API 中継サービスを使う

環境変数または settings.json で Claude Code をカスタム API アドレスに向ける方法。

3 分で読めます

Claude Code はリクエストをカスタム API アドレスに送信できます。対応する環境変数を設定するか、設定ファイルに書き込むだけです。本記事では、Anthropic のインターフェースと互換性のある API 中継サービスに Claude Code を向ける方法を説明します。

準備する情報

始める前に、お使いの API プラットフォームから以下の情報を取得します：

API アドレス（Base URL）：プラットフォームが提供するインターフェースのルートアドレス
API キー（Key）：認証に使用するトークン
モデル名：プラットフォームが対応していて、かつ利用する予定のモデル識別子

方法 1：環境変数

ターミナルで以下の環境変数を設定します（~/.zshrc または ~/.bashrc に書き込むと長期的に有効になります）：

export ANTHROPIC_BASE_URL="https://example.com"   # プラットフォームが提供する API アドレスに置き換え
export ANTHROPIC_AUTH_TOKEN="your-key"            # 自分の API キーに置き換え
export ANTHROPIC_MODEL="your-model-name"          # プラットフォームが対応するモデル名に置き換え

設定後にターミナルを開き直し、claude を実行すれば有効になります。

方法 2：settings.json

Claude Code の設定ファイル ~/.claude/settings.json（グローバル）、またはプロジェクト内の .claude/settings.json に書き込むこともできます：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://example.com",
    "ANTHROPIC_AUTH_TOKEN": "your-key",
    "ANTHROPIC_MODEL": "your-model-name"
  }
}

設定にキーが含まれる場合は、バージョン管理に含めない .claude/settings.local.json の使用をお勧めします。

よくある質問

404 が出る：末尾のスラッシュに敏感なサービスもあるため、API アドレスの末尾に / を付けるか外すかを試してみてください。
モデル名が一致しない：Claude Code はモデル名を自動的に変換しないため、プラットフォームが認識できる名前をモデル名に設定してください。
GUI アプリで有効にならない：Dock やショートカットから起動した GUI アプリは、ターミナルで設定した環境変数を読み込みません。
サブスクリプションとの競合：Claude のサブスクリプションアカウントに同時にログインしている場合、カスタムアドレスがサブスクリプションを上書きします。公式に戻すには、上記の設定を削除してください。

もっと詳しく