環境変数

CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY

1 を設定すると、ANTHROPIC_BASE_URL が LiteLLM、Kong、社内プロキシなどの Anthropic 互換ゲートウェイを指しているときに、ゲートウェイの /v1/models エンドポイントから /model ピッカーを構成できる。デフォルトではオフである。共有 API キーで稼働するゲートウェイでは、そのキーがアクセスできるすべてのモデルがすべてのユーザーに表示されてしまうためである。検出されたモデルは、セッションが受け取る availableModels の許可リストによって引き続きフィルタリングされる。サーバー管理による配信はゲートウェイ構成では利用できないため、リストは MDM または管理用設定ファイルで提供すること。

使い方・用途

  • LiteLLM や Kong、内部プロキシのような Anthropic 互換ゲートウェイの /v1/models エンドポイントに /model ピッカーのモデル一覧を反映させたいときに使う。
  • ゲートウェイが提供するモデル名を開発者ごとに手動設定させるのではなく、起動時に自動取得して /model ピッカーに表示させたいときに使う。
  • ゲートウェイが /v1/models を提供しており、そこからモデル一覧を配りたい場合に、モデル情報の配布先を MDM または managed settings ファイル経由に絞りたいときに使う。
英語原文(公式ドキュメントより)

Set to 1 to populate the /model picker from your gateway's /v1/models endpoint when ANTHROPIC_BASE_URL points at an Anthropic-compatible gateway such as LiteLLM, Kong, or an internal proxy. Off by default because gateways backed by a shared API key would otherwise show every user every model the key can access. Discovered models are still filtered by an availableModels allowlist the session receives; deliver the list through MDM or a managed settings file, since server-managed delivery is not available on gateway configurations

関連ドキュメント

関連する変更履歴

v2.1.257(2件)

Added
検出された /model ピッカーのエントリに、ゲートウェイが提供する description を表示できるようにした（CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY）。説明がないエントリは従来どおり 'From gateway' と表示される
英語原文を表示
Added support for a gateway-supplied description on discovered /model picker entries (CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY); entries without one still read "From gateway"

変更後

ゲートウェイが各モデルの説明文 (description) を提供している場合、/model ピッカーの項目にその説明が表示されるようになる。説明を持たないモデルは従来どおり「From gateway」と表示される。これにより、ピッカーからどのモデルを選ぶべきか判断しやすくなる。

関連ドキュメント

Changed
ゲートウェイモデル検出（CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1）の挙動を変更し、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC が設定されていても実行するようにした。ゲートウェイへのクエリのみが行われるためである
英語原文を表示
Changed gateway model discovery (CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1) to run even when CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC is set, since it only queries your gateway

変更後

非本質的な通信の無効化を設定していても、ゲートウェイ経由で利用可能なモデル一覧が /model ピッカーに自動的に反映されるようになる。

関連ドキュメント

v2.1.248(1件)

Fixed
apiKeyHelper が唯一の認証情報である場合に、ゲートウェイモデルディスカバリー(CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY)が一切実行されない問題を修正した
英語原文を表示
Fixed gateway model discovery (CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY) never running when apiKeyHelper is the only credential

関連ドキュメント

v2.1.129(1件)

Changed
モデルピッカーでのゲートウェイ/v1/modelsによるモデル自動検出が、CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1によるオプトイン方式に変更されました
英語原文を表示
Gateway /v1/models discovery for the /model picker is now opt-in via CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 (was automatic in 2.1.126–2.1.128)

変更後

意図しないエンドポイントへのリクエストを防ぎ、セキュリティやネットワーク要件に合わせた柔軟な設定が可能になります。

関連ドキュメント