環境変数

CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY

PowerShell実行時に-ExecutionPolicy Bypassを付与せず、マシンの実行ポリシーに従うようにするには1を設定します。

使い方・用途

  • Windows環境でシステムの実行ポリシー制限によりスクリプトやモジュールの読み込みが失敗するのを防ぎます。
  • 組織のセキュリティポリシー等で実行ポリシーのバイパスを禁止し、設定に従わせたい場合に使用します。
  • デフォルトでは利便性のためにプロセススコープでのバイパスが有効になっています。
英語原文(公式ドキュメントより)

Set to 1 to stop Claude Code from passing -ExecutionPolicy Bypass when spawning PowerShell for tool calls, hooks, and status line commands, and respect the machine's effective execution policy instead. By default Claude Code bypasses execution policy at process scope so .ps1 scripts and module imports work on default-Restricted Windows installs. Process-scope bypass never overrides Group Policy MachinePolicy or UserPolicy regardless of this setting

関連する変更履歴

v2.1.143(1件)

Changed
Settings
PowerShellツールの実行ポリシーに -ExecutionPolicy Bypass をデフォルトで適用するように変更しました
英語原文を表示
PowerShell tool now passes -ExecutionPolicy Bypass. Opt out with CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1

変更前

Windows環境において、システム側のスクリプト実行ポリシー制限によって、Claudeが提案したPowerShellコマンドが失敗することがありました。

変更後

ツール実行時にポリシーを一時的にバイパスするフラグが自動付与されます（CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1で以前の挙動に戻せます）。

ユーザーへの恩恵

Windows上でのスクリプト実行がよりスムーズになり、権限エラーによる作業の中断が減少します。

関連ドキュメント