環境変数

CLAUDE_CODE_PROCESS_WRAPPER

Claude Code が自身のバイナリから起動するプロセス(エージェントビューセッションをホストするバックグラウンドサービスなど)を、/opt/corp/launcher のような argv プレフィックスとして指定された企業ランチャー経由で起動する。シェルのエクスポートとしてではなく、ユーザー設定または管理設定の env ブロックに設定する。そうすることで、デタッチされたバックグラウンドサービスがこの値を継承できる。プロジェクト設定とローカル設定では設定できない。processWrapper 設定(Claude Code v2.1.210 以降が必要)と等価であり、両方設定した場合はこの変数が優先される。VS Code 拡張は claudeProcessWrapper 設定で独自のランチャーを別途構成する。Windows では無視される。値の形式、ランチャーの対象範囲、ランチャーが満たすべき契約については Run Claude Code behind a corporate launcher を参照。Claude Code v2.1.208 以降が必要

使い方・用途

  • 企業のセキュリティポリシーで、Claude Code が自身のバイナリから起動するプロセスを必ずランチャー経由で実行させる必要がある場合に使う。
  • エージェントビューのバックグラウンドセッションやバックグラウンドサービスが、コーポレートランチャーを経由せずに起動してしまう問題を防ぎたい場合に使う。
  • 管理対象設定の env ブロックでランチャーを配布し、複数マシンの Claude Code で一貫したプロセス起動経路を強制したい場合に使う。
英語原文(公式ドキュメントより)

Launch the processes Claude Code starts from its own binary, such as the background service that hosts agent view sessions, through a corporate launcher given as an argv prefix like /opt/corp/launcher. Set it in the env block of user or managed settings, not as a shell export, so the detached background service inherits it; project and local settings can't set it. Equivalent to the processWrapper setting, which requires Claude Code v2.1.210 or later; this variable takes precedence when both are set. The VS Code extension configures its own launcher separately through its claudeProcessWrapper setting. Ignored on Windows. See Run Claude Code behind a corporate launcher for the value format, what the launcher covers, and the contract the launcher must satisfy. Requires Claude Code v2.1.208 or later

関連ドキュメント

関連する変更履歴

v2.1.208(1件)

Added
環境変数 CLAUDE_CODE_PROCESS_WRAPPER を追加した。エージェントビューやバックグラウンドサービスにおいて、Claude Code が自身を起動する際に指定したラッパー実行ファイルを介して実行するようになり、企業向けのランチャーに対応した。
英語原文を表示
Added CLAUDE_CODE_PROCESS_WRAPPER: agent view and the background service now honor a corporate launcher by running every Claude Code self-spawn through a required wrapper executable

変更後

企業独自のセキュリティランチャー配下でも、バックグラウンドエージェントを正常に動作させられるようになります。

関連ドキュメント