環境変数

CLAUDE_CODE_USE_POWERSHELL_TOOL

PowerShell ツールを制御する。Git Bash がない Windows ではツールは自動的に有効になり、0 を設定すると無効化できる。Git Bash がインストールされている Windows では、claude.ai アカウントと Console アカウントでは既定でツールが有効であり、Amazon Bedrock・Google Cloud の Agent Platform・Microsoft Foundry のセッションで有効にするには 1 を、無効にするには 0 を設定する。Linux・macOS・WSL では有効にする場合に 1 を設定し、pwsh が PATH 上に必要である。Windows で有効にすると、Claude は Git Bash を経由せず PowerShell コマンドをネイティブに実行できる。

使い方・用途

  • Git Bash がインストールされていない Windows 環境で、Bash ツールの拒否ルールを設定したまま PowerShell ツールを使えるようにしたいときに設定する。
  • Linux や macOS で PATH 上に pwsh を用意したうえで、Claude に PowerShell コマンドを実行させるツールを追加したいときに 1 を設定する。
  • Amazon Bedrock や Google Cloud の Agent Platform、Microsoft Foundry のセッションで PowerShell ツールを有効化または無効化したいときに設定する。
英語原文(公式ドキュメントより)

Controls the PowerShell tool. On Windows without Git Bash, the tool is enabled automatically; set to 0 to disable it. On Windows with Git Bash installed, the tool is on by default for claude.ai and Console accounts; set to 1 to enable it in Amazon Bedrock, Google Cloud's Agent Platform, and Microsoft Foundry sessions, or 0 to turn it off. On Linux, macOS, and WSL, set to 1 to enable it, which requires pwsh on your PATH. When enabled on Windows, Claude can run PowerShell commands natively instead of routing through Git Bash. See PowerShell tool

関連ドキュメント

関連する変更履歴

v2.1.143(1件)

Changed
Bedrock、Vertex、FoundryユーザーのWindows環境において、PowerShellツールをデフォルトで有効化しました
英語原文を表示
The PowerShell tool is now enabled by default on Windows for Bedrock, Vertex, and Foundry users. Opt out with CLAUDE_CODE_USE_POWERSHELL_TOOL=0.

変更後

どのプロバイダーを使用していても、Windows上での標準的なコマンド実行環境がすぐに整います。

関連ドキュメント

v2.1.111(1件)

Changed
WindowsにおいてPowerShellツールの段階的なロールアウトを開始しました。CLAUDE_CODE_USE_POWERSHELL_TOOL=1を設定することで、macOS/Linuxでもpwsh経由で利用可能です。
英語原文を表示
Windows: PowerShell tool is progressively rolling out. Opt in or out with CLAUDE_CODE_USE_POWERSHELL_TOOL. On Linux and macOS, enable with CLAUDE_CODE_USE_POWERSHELL_TOOL=1 (requires pwsh on PATH)

変更後

Windows環境での開発において、OSの機能をフルに活用した高度な自動化やトラブルシューティングが可能になります。

関連ドキュメント