CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

環境変数

1 などの空でない任意の値を設定すると、自動更新、テレメトリ、エラーレポート、/feedback コマンド、Claude が下書きするフィードバック、リリースノート、PR および MR ステータスバッジのチェック、fast mode チェックなどの可用性チェックといった、本質的でないネットワークトラフィックが無効になる。また、依存関係のインストールを引き起こしうるため、プラグインコマンドソースのバックグラウンド実行(ネットワークトラフィックではなくローカルコマンド)も停止する。ほとんどのオン/オフ変数と異なり、0 や false を設定してもトラフィックは無効のままになる。再有効化するには変数を削除すること。機能フラグの取得も無効化され、Remote Control および機能フラグ取得を必要とするその他の機能が利用できなくなる。公式プラグインマーケットプレイスの自動インストールは対象外で、無効化するには CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL を使う。ゲートウェイのモデル検出には影響せず、こちらには独自のオプトインがある。

使い方・用途

  • テレメトリ、エラーレポート、自動更新などを個別の環境変数を設定せず一括で無効化したい場合に使う。
  • ネットワーク越しの不要な通信を抑制したい企業環境や dev container で、組織のポリシーとしてまとめて適用したい場合に使う。
  • Remote Control など feature-flag 取得を必要とする機能を無効にしたまま Claude Code を運用したい場合に使う。
英語原文

Set to any non-empty value, such as 1, to disable nonessential network traffic: auto-updates, telemetry, error reporting, the /feedback command, Claude-drafted feedback, release notes, the PR and MR status badge checks, and availability checks such as the fast mode check. It also stops the background runs of plugin command sources, which are local commands rather than network traffic, because they can trigger dependency installs. **Setting it to 0 or false still disables this traffic**, unlike most on/off variables; unset the variable to allow it again. Also disables feature-flag fetching, which makes Remote Control and the other features that need feature-flag fetching unavailable. Official plugin marketplace auto-install isn't covered; disable it with CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL. Doesn't affect gateway model discovery, which has its own opt-in

関連ドキュメント

関連する変更履歴

v2.1.319(1件)

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC が設定されている場合に、TLS 検査プロキシの背後での証明書エラーが解消されない問題を修正した。この設定がある場合、証明書エラーの発生後、Claude Code は設定された API ホストと TLS ハンドシェイクを行うようになった（http:// プロキシが設定されていればそれを経由する。API リクエストは送信しない）
英語原文を表示
Fixed a case where certificate errors behind a TLS-inspecting proxy persisted when CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC was set. With it set, Claude Code now makes a TLS handshake with the configured API host after a certificate failure, through your http:// proxy if one is set; it sends no API request

関連ドキュメント

v2.1.295(1件)

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC が設定されると /usage とステータスラインに Claude アプリゲートウェイの支出上限が表示されなくなる問題を修正し、支出上限のリクエストはセッションがサインインしているゲートウェイに送られるようにした
英語原文を表示
Fixed CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC hiding the Claude apps gateway spend limit in /usage and the status line. The spend limit request goes to the gateway the session is signed in to

関連ドキュメント

v2.1.290(1件)

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC が、起動時の接続ウォームアップもスキップするように変更した。
英語原文を表示
Changed CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC to also skip the startup connection warm-up

v2.1.257(1件)

ゲートウェイモデル検出（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.120(1件)

テレメトリ無効化設定(DISABLE_TELEMETRY 等)が、API およびエンタープライズユーザーの利用統計送信を抑制していなかった問題を修正
英語原文を表示
Fixed DISABLE_TELEMETRY / CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC not suppressing usage metrics telemetry for API and enterprise users

変更後

機密性の高い開発環境において、セキュリティポリシーに基づいた厳格なデータ保護と通信制御が保証されます。

関連ドキュメント

v2.1.110(1件)

ヘッドレス/SDKセッションにおいて、特定の無効化設定時にセッションタイトルの自動生成が不要なAPIリクエスト(Haikuモデル)を発生させる問題を修正
英語原文を表示
Fixed headless/SDK session auto-title firing an extra Haiku request when CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC or CLAUDE_CODE_DISABLE_TERMINAL_TITLE is set

変更後

大規模な自動実行スクリプトなどでAPIトークンの消費を極限まで抑え、処理速度の向上にも寄与します。

関連ドキュメント

v2.1.105(1件)

特定のプロジェクトで非必須トラフィックを無効にすると、マシン上の全プロジェクトでメトリクスが無効化されてしまう問題を修正しました
英語原文を表示
Fixed CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC in one project's settings permanently disabling usage metrics for all projects on the machine

変更後

プロジェクトごとのプライバシー・セキュリティ要件に応じた柔軟な設定が可能になります。

関連ドキュメント

v2.0.17(1件)

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC now disables release notes fetching

関連ドキュメント