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 に `
英語原文を表示
Fixed a Claude apps gateway that serves allowedProviders with "gateway" locking out laptops that name that gateway in user settings

変更前

ゲートウェイが allowedProviders に `

変更後

ユーザー設定でそのゲートウェイを指定しているラップトップでも、ゲートウェイが提供する allowedProviders の値が正しく解釈され、ログインできるようになりました。

ユーザーへの恩恵

ユーザーは、managed settings とユーザー設定の組み合わせによってゲートウェイから締め出されることなく、ゲートウェイ経由で Claude Code を利用できるようになりました。

v2.1.285(1件)

Added
マシンが利用できる API プロバイダーを制限する 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 プロバイダーを使えるかは、環境変数などの個別設定に依存していました。

変更後

環境変数だけでなく allowedProviders マネージド設定でも、マシンが利用できる API プロバイダーを絞り込めるようになった。

ユーザーへの恩恵

管理者は 1 つのマネージド設定でマシンごとのプロバイダー利用を制限できる。