PowerShell tool

Windows では、コマンドが Git Bash を経由せず PowerShell で実行されます。ツールを有効にすると、Claude は PowerShell を主要なシェルとして扱います。Windows 環境で PowerShell スクリプトやモジュールを使う開発作業に関わる機能です。

PowerShell tool は、Claude が PowerShell コマンドをネイティブに実行するためのツールです。Windows では、Claude Code が PowerShell 7 以降の pwsh.exe を自動で検出し、見つからない場合は PowerShell 5.1 の powershell.exe を使います。

PowerShell コマンドは、作業ディレクトリのリセットについて Bash コマンドと同じ動作をとり、CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR 環境変数も同様に適用されます。また、grep、rg、egrep、fgrep、findstr、git grep、git diff の終了コード 1 を正常な結果として扱う場合があります。

Windows での文字コードと出力の扱いは次のとおりです。

• PowerShell 5.1 では、> と >> によるリダイレクトで UTF-8 のファイルを書き出します。
• ネイティブコマンドの標準入力にパイプで渡すテキストは UTF-8 でエンコードします。
• エラー出力は ANSI エスケープシーケンスを除いて取得します。
• 子プロセスが標準入力を待つコマンドには、待ち続ける代わりに end-of-file が渡されます。

PreToolUse フックは、PowerShell tool のコマンド文字列を tool_input.command で受け取り、フィールドは Bash ツールと同じです。シェルコマンドを検査するフックでは、Bash だけでなく Bash|PowerShell にマッチさせます。

シェルの選択は、次の設定で行えます。

• settings.json で "defaultShell": "powershell" を設定すると、対話的な ! コマンドが PowerShell を通ります。PowerShell tool の有効化が必要です。
• 個々のコマンドフックに "shell": "powershell" を設定すると、そのフックが PowerShell で実行されます。フックは PowerShell を直接起動するため、CLAUDE_CODE_USE_POWERSHELL_TOOL の設定に関係なく動作します。
• スキルの frontmatter に shell: powershell を設定すると、` !command ` ブロックが PowerShell で実行されます。PowerShell tool の有効化が必要です。

Windows では PowerShell tool が段階的に展開されており、CLAUDE_CODE_USE_POWERSHELL_TOOL でオプトイン・オプトアウトできます。Windows の Bedrock、Vertex、Foundry のユーザーには既定で有効になっており、CLAUDE_CODE_USE_POWERSHELL_TOOL=0 でオプトアウトできます。Linux と macOS では CLAUDE_CODE_USE_POWERSHELL_TOOL=1 で有効にでき、PATH 上に pwsh が必要です。

対象プランについては、公式のリリースノートには記載がありません。

実行ポリシー

Claude Code は PowerShell をプロセススコープに限って -ExecutionPolicy Bypass で起動します。この回避は Group Policy の MachinePolicy や UserPolicy を上書きしないため、組織のポリシーはそのまま適用されます。マシンの実効的な実行ポリシーに従わせたい場合は、CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1 を設定します。

Bash の拒否ルールとの関係

Git Bash がインストールされた Windows では、Bash を拒否すると、そのセッションでは PowerShell tool もオフになります。これは単独の Bash だけでなく Bash(git push *) のようなスコープ付きのルールにも、設定ファイルや --disallowedTools からのルールにも当てはまります。Bash の拒否ルールと併用して PowerShell tool を残すには、次のいずれかを行います。

• 環境変数、または設定ファイルの env ブロックで CLAUDE_CODE_USE_POWERSHELL_TOOL=1 を設定する。
• 設定ファイルに、PowerShell(git push *) の拒否ルールのようなスコープ付きの PowerShell 権限ルールを追加する。

どちらも無い場合、スコープ付きの Bash 拒否ルールでは Bash ツールは使えたまま、Claude Code は警告無しに PowerShell をオフにします。なお、Bash ツールの拒否によって PowerShell tool もオフになり、シェルツールが無くなる場合には、起動時に警告が表示されます。

権限ルールの適用範囲

PowerShell tool のコマンドは、Bash と同様に権限モードで自動承認できます。Windows では、許可ルールと読み取り専用の判定が 32 KB までのコマンドに適用されます。

Windows では PowerShell tool が段階的に展開されており、CLAUDE_CODE_USE_POWERSHELL_TOOL でオプトイン・オプトアウトできます。

1. 環境変数、または settings.json で CLAUDE_CODE_USE_POWERSHELL_TOOL=1 を設定し、PowerShell tool を有効にします。
2. Linux、macOS、WSL では PowerShell 7 以降が必要です。pwsh をインストールし、PATH に含まれていることを確認します。