settings.json

allowedProviders

型string[]記述場所管理者設定のみ

マシンが Anthropic API、Amazon Bedrock、LLM ゲートウェイなど、どのサービス経由で Claude に到達できるかを列挙する設定で、リストにないプロバイダーでのセッションは起動時・ログイン時・次回 API 接続時に拒否されるため、セッション途中で未リストのプロバイダーへ切り替えることも拒否される。拒否メッセージはプロバイダーを選択した設定と続行手順を示し、Claude Code v2.1.285 以降が必要。

既定値: 未設定の場合、どのプロバイダーでも使用可能

記述例

{
  "allowedProviders": ["anthropic", "bedrock"]
}

使い方・用途

  • managed settings でマシンごとに利用できる API プロバイダー(Anthropic API、Amazon Bedrock、LLM ゲートウェイなど)を制限する。変更前は環境変数などの個別設定に依存していたが、この設定1つで絞り込めるようになった- LLM ゲートウェイ/プロキシを許可する場合は "customEndpoint" を列挙し、同一の管理対象ソースの env ブロックにゲートウェイの URL を設定する。全値と env ピンが必要なエンドポイント変数は設定リファレンスを参照- 管理対象マシンに展開する際は、他のポリシーを運ぶマネージドソースにリストを記載する。サーバー管理設定だけに設定した場合、その設定を取得するセッションにしか届かず、デバイス管理で届かないマシン向けの便宜であり強制ではない- 値が不正な場合はフェイルクローズで空の許可リストとして強制され、すべての API プロバイダーが拒否されマシン上で Claude Code が起動しなくなる。個別のエントリのみが未知のプロバイダー名の場合は、そのエントリを破棄して報告し残りを強制する- 既定値は未設定で、どのプロバイダーでも使用可能。Claude Code v2.1.285 以降が必要
英語原文(公式ドキュメントより)

List the services a machine may reach Claude through, such as the Anthropic API, Amazon Bedrock, or an LLM gateway. A session on a provider that isn't listed is refused at startup, at login, and when it next contacts the API, so switching to an unlisted provider mid-session is refused too. The [refusal message](/docs/en/errors#managed-settings-dont-allow-this-api-provider) names what selected the provider and the steps to continue. Requires Claude Code v2.1.285 or later.

関連ドキュメント

関連する変更履歴

v2.1.296(1件)

Fixed
allowedProviders を 'gateway' で提供する Claude アプリゲートウェイにおいて、ユーザー設定でそのゲートウェイ名を指定しているノート PC が締め出されてしまう問題を修正した
英語原文を表示
Fixed a Claude apps gateway that serves allowedProviders with "gateway" locking out laptops that name that gateway in user settings

v2.1.285(1件)

Added
マシンが利用できる API プロバイダー (Anthropic API、カスタムエンドポイント、Bedrock、Mantle、Vertex AI、Foundry、Claude Platform on AWS、Cloud gateway) を制限するマネージド設定 allowedProviders を追加した
英語原文を表示
Added allowedProviders managed setting to limit which API providers a machine may use (Anthropic API, a custom endpoint, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform on AWS, or a Cloud gateway)

変更後

組織の管理者がマシン単位で利用できる API プロバイダーを制限できるようになり、許可されていないプロバイダーへの切り替えはセッション開始時やログイン時、実行中も拒否される。これにより、企業のポリシーに沿った接続先だけを使うよう環境を確実に統制できる。