CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS

リクエストとレスポンス

リクエストは GET /v1/models?limit=1000 で、既定のタイムアウトは 3 秒です。リダイレクトはすべて失敗として扱われ、認証情報がリダイレクト先に漏れることを防ぎます。ゲートウェイの応答がタイムアウトより遅い場合や、/v1/models をリダイレクトする場合（http から https へのリダイレクトも含む）、検出は何も表示されずに失敗するため、エンドポイントは設定したベース URL で直接提供してください。

低速なゲートウェイに長めの猶予を与えるには、CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS を設定します。この変数には Claude Code v2.1.269 以降が必要です。

Claude Code は、以下の両方の認証情報ヘッダーを付けて検出リクエストを送信し、値が解決しないヘッダーは省略します。両方のヘッダーを送信するには Claude Code v2.1.248 以降が必要です。それより前のバージョンでは、ANTHROPIC_AUTH_TOKEN が設定されている場合は Authorization のみ、それ以外では x-api-key のみを送信します。

• Authorization：ベアラートークンとしての ANTHROPIC_AUTH_TOKEN。設定されていない場合は、ベアラートークンとしての apiKeyHelper の値。その場合、Claude Code はヘルパーが値を返すのを待ってからリクエストを送信します。
• x-api-key：ANTHROPIC_API_KEY など、Claude Code が解決した API キー。ヘルパーの値しか認証情報がない場合、このヘッダーにもその値が入るため、値は両方のヘッダーに渡って送られます。

Claude Code は、ANTHROPIC_CUSTOM_HEADERS にあるヘッダーも送信します。カスタムヘッダーの値が空でない場合、Claude Code は、大文字小文字を区別せずに名前を照合し、同名の組み込みヘッダーの代わりにそのヘッダーを送信します。

どちらの認証情報ヘッダーの値も解決しない場合、Claude Code は検出をスキップし、claude --debug セッションのデバッグログに [gatewayDiscovery] skipped という行を書き込みます。ANTHROPIC_CUSTOM_HEADERS だけを通じて認証情報を指定した場合も、Claude Code は検出をスキップします。

Claude Code は、レスポンスの data 配列内の各エントリから id、任意項目の display_name、任意項目の description を読み取ります。

{
  "data": [
    {
      "id": "claude-sonnet-4-6",
      "display_name": "Claude Sonnet 4.6",
      "description": "Default model for everyday coding tasks"
    },
    { "id": "claude-opus-4-8" }
  ]
}

Claude Code は、id に claude または anthropic という文字列がどこかに含まれる（大文字小文字は区別しない）エントリを残し、それ以外は無視します。vertex_ai/claude-sonnet-4-6 や bedrock/anthropic.claude-sonnet-4-5 のようなプロバイダー接頭辞付きの ID はこのフィルターを通過しますが、どちらの文字列も含まない ID は通過しません。v2.1.223 より前では、Claude Code は id が claude または anthropic で始まるエントリのみを残していたため、プロバイダー接頭辞付きの ID は隠されていました。