環境変数

CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST

Claude Code を組み込み、モデルプロバイダーのルーティングを代わりに管理するホストプラットフォームによって設定される。設定すると、Claude Code は設定ファイル内の CLAUDE_CODE_USE_BEDROCK、ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY などのプロバイダー選択・エンドポイント・認証の変数を無視するため、ユーザー設定がホストのルーティングを上書きできない。また、どの管理ソースから提供された場合でも、管理設定内の model、fallbackModel、modelOverrides などのモデル選択キーを無視するため、ホストのモデル設定が古い管理設定によるモデル固定より優先される。さらに、管理設定の env ブロック内の ANTHROPIC_MODEL や ANTHROPIC_DEFAULT_*_MODEL 系のモデル選択変数も無視する。ただし、管理設定の availableModels 許可リストは、ホストが独自のものを提供しない限り引き続き適用される。さらに、Claude Code は Amazon Bedrock、AWS 上の Claude Platform、Google Cloud の Agent Platform、Microsoft Foundry などのサードパーティプロバイダーに対して通常適用する自動的なテレメトリーオプトアウトをスキップするため、テレメトリーは標準の DISABLE_TELEMETRY オプトアウトに従う。Default behaviors by API provider を参照

使い方・用途

  • Claude Code をアプリ内に組み込んで提供するホストプラットフォーム側で、プロバイダの選択やエンドポイント・認証設定をユーザーの settings ファイルによる上書きから守りたいときに使う。
  • ホストが指定するモデル構成を、マネージド設定に残った古い model・fallbackModel・modelOverrides の指定よりも優先させたいときに使う。
  • ホストが管理する環境で、Bedrock などサードパーティプロバイダ利用時に自動適用されるテレメトリ無効化をスキップし、標準の DISABLE_TELEMETRY によるオプトアウトに任せたいときに使う。
英語原文(公式ドキュメントより)

Set by host platforms that embed Claude Code and manage model provider routing on its behalf. When set, Claude Code ignores provider-selection, endpoint, and authentication variables such as CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL, and ANTHROPIC_API_KEY in settings files, so user settings can't override the host's routing. Claude Code also ignores model-selection keys such as model, fallbackModel, and modelOverrides in managed settings, whichever managed source delivers them, so the host's model configuration takes precedence over an out-of-date managed model pin. Claude Code also ignores model-selection variables such as ANTHROPIC_MODEL and the ANTHROPIC_DEFAULT_*_MODEL family in a managed env block; an availableModels allowlist in managed settings still applies unless the host supplies its own. Claude Code also skips the automatic telemetry opt-out it otherwise applies on third-party providers such as Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, and Microsoft Foundry, so telemetry follows the standard DISABLE_TELEMETRY opt-out. See Default behaviors by API provider

関連ドキュメント

関連する変更履歴

v2.1.300(1件)

Changed
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST セッションにおいて、設定内の CA バンドル、ツールプロキシ、git TLS、SSL_CERT_FILE などの git 設定変数を無視するように変更した。Claude Desktop の下ではプロジェクト設定のみに適用される
英語原文を表示
Changed CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST sessions to ignore CA-bundle, tool-proxy, git TLS and git config variables like SSL_CERT_FILE in settings; under Claude Desktop, only in project settings

変更後

ホスト管理下のセッションで、設定ファイル内の CA バンドルや SSL_CERT_FILE などの TLS・Git 関連変数が原因で接続エラーや証明書検証の失敗が起きても、それらの設定が無視されるようになり、Claude Desktop のプロジェクト設定に限っては引き続き個別に調整できるようになる。

v2.1.251(1件)

Improved
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST 環境変数の下(例: Claude Desktop)での Amazon Bedrock セッションの開始を改善した。Bedrock のモデル ID または ARN を指定されたセッションが、推論プロファイルの検出を待たなくなった
英語原文を表示
Improved Amazon Bedrock session start under CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST (e.g. Claude Desktop): a session given a Bedrock model ID or ARN no longer waits for inference-profile discovery

変更後

Claude Desktop などホスト環境で Bedrock のモデル ID や ARN を指定してセッションを開始した際、推論プロファイルの検索を待たずにすぐ使い始められる。

v2.1.222(1件)

Fixed
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST が設定されている場合に、ホストが指定したモデル選択キーが、ディスク上の古い managed-settings.json よりも優先されない問題を修正しました。
英語原文を表示
Fixed host model-selection keys not taking precedence over a stale on-disk managed-settings.json when CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST is set

変更後

ホストアプリケーションで選んだモデルが、ローカル設定ファイルに干渉されることなく正しく反映されます。

関連ドキュメント

v2.1.126(1件)

Changed
ホスト管理デプロイメントにおいて、Bedrock/Vertex/Foundry利用時にアナリティクスが自動無効化されないようになりました
英語原文を表示
Host-managed deployments (CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST) no longer auto-disable analytics on Bedrock/Vertex/Foundry

変更後

管理されたエンタープライズ環境において、利用状況の統計などの重要なデータをプロバイダーの種類に関係なく一貫して収集・管理できるようになります。

関連ドキュメント