Enable the PowerShell tool on Linux/macOS/WSL

Set CLAUDE_CODE_USE_POWERSHELL_TOOL=1 to opt into the PowerShell tool. Requires PowerShell 7+ (pwsh) on PATH. When enabled, PowerShell becomes the primary shell and the shell:powershell field works in skill frontmatter, command hooks, and defaultShell.

bash

# Per-session opt-in
CLAUDE_CODE_USE_POWERSHELL_TOOL=1 claude

# Or persist it in ~/.claude/settings.json — add the keys below by hand.
# Don't overwrite the whole file with `cat >`; it would wipe any other
# global config (model, env vars, allowed tools, etc.) you already have.
#
# {
#   "env": {
#     "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"
#   },
#   "defaultShell": "powershell"
# }

# On Windows, set the variable to 0 to opt OUT of the progressive rollout
CLAUDE_CODE_USE_POWERSHELL_TOOL=0 claude