Home / Claude Code / Claude Code Agora Fala PowerShell: O Windows Entrou no Jogo

Claude Code Agora Fala PowerShell: O Windows Entrou no Jogo

Vou te contar uma coisa que deveria ser óbvia mas que o mercado de ferramentas de IA ignorou por anos: quase 60% dos desenvolvedores do mundo usam Windows. Não Linux. Não macOS. Windows.

O Stack Overflow Developer Survey de 2024 mostrou que 59,2% dos devs usam Windows para desenvolvimento pessoal e 47,6% para trabalho profissional. Em ambientes enterprise — onde as software houses brasileiras mais faturam — a proporção é ainda maior.

E sabe o que todas as ferramentas de IA coding fizeram até agora? Trataram Windows como cidadão de segunda classe. O Claude Code não era diferente. Até agora.

Na versão v2.1.84, lançada em 26 de março de 2026, a Anthropic adicionou o PowerShell tool — o primeiro suporte nativo ao ecossistema Windows dentro do Claude Code. E na minha experiência com 300+ software houses, isso muda o jogo pra muita gente que estava de fora.

O problema: Claude Code falava Bash numa máquina Windows

Se você tentou usar Claude Code no Windows antes dessa atualização, provavelmente viveu isso: você pede pro Claude listar os arquivos de um diretório e ele responde com ls -la. Você pede pra ele criar um script e ele gera um .sh com sintaxe Bash. Você pede pra ele verificar um serviço e ele roda systemctl status.

Nada disso funciona no PowerShell.

O issue #28670 no GitHub documenta exatamente essa dor: o Claude Code gerava comandos Linux/Bash dentro do PowerShell, recebia um erro, e em vez de entender que estava num ambiente Windows, tentava o mesmo comando de novo. Loop infinito de frustração.

E não era só isso. O issue #5723 — um dos feature requests mais votados da comunidade Windows — pedia integração nativa com Windows Terminal e PowerShell há meses. O issue #2458 ia além: destacava que em ambientes enterprise com VDI (Virtual Desktop Infrastructure), onde WSL não é opção, o Claude Code era simplesmente inutilizável.

A mensagem da comunidade era clara: “Queremos usar o Claude Code. Não conseguimos. Nosso ambiente é Windows.”

O que é o PowerShell Tool

O PowerShell tool é uma nova ferramenta nativa do Claude Code que permite executar comandos PowerShell diretamente, sem passar pelo Git Bash. Quando ativado, o Claude entende que está num ambiente Windows e gera comandos compatíveis.

Na prática:

  • Em vez de ls -la, ele gera Get-ChildItem -Force
  • Em vez de grep, ele usa Select-String
  • Em vez de chmod +x, ele usa Set-ExecutionPolicy ou ajusta ACLs
  • Scripts são gerados como .ps1, não .sh

O Claude Code auto-detecta qual versão do PowerShell você tem: pwsh.exe (PowerShell 7+) com fallback pra powershell.exe (PowerShell 5.1, que vem built-in no Windows). Ou seja, funciona na sua máquina Windows sem instalar nada extra.

Como ativar

Uma variável de ambiente:

$env:CLAUDE_CODE_USE_POWERSHELL_TOOL = "1"

claude

Ou permanentemente no settings.json:

{

"env": {

"CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"

}

}

Importante: o Bash tool continua registrado ao lado do PowerShell tool. Eles coexistem. Isso significa que às vezes o Claude pode escolher usar Bash mesmo com o PowerShell disponível — especialmente se o prompt não deixar claro o contexto. Se isso acontecer, basta dizer “use PowerShell” na sua instrução.

Configurações extras

Três settings adicionais controlam onde o PowerShell é usado:

1. Shell padrão para comandos !:

{

"defaultShell": "powershell"

}

Faz os comandos rápidos com ! usarem PowerShell em vez de Git Bash.

2. Hooks individuais em PowerShell:

{

"hooks": {

"PreToolUse": [{

"shell": "powershell",

"command": "Write-Host 'Hook executado no PowerShell'"

}]

}

}

Cada hook pode rodar no shell que fizer sentido. Isso funciona independente do PowerShell tool estar ativado.

3. Skills com shell PowerShell:

---

shell: powershell

---

Blocos de comando dentro de skills executam no PowerShell.

O que funciona e o que ainda não funciona

Vou ser transparente: isso é um opt-in preview. A Anthropic foi honesta sobre as limitações atuais:

Funciona

  • Comandos PowerShell 5.1 e 7+
  • Coexistência com Bash tool
  • Hooks e skills com shell PowerShell
  • defaultShell para comandos !
  • Auto-detecção da versão do PowerShell

Ainda não funciona (preview)

  • Auto mode — o modo autônomo não suporta PowerShell tool ainda
  • PowerShell profiles — seus profiles .ps1 não são carregados
  • Sandboxing — sem isolamento de segurança (por isso é opt-in)
  • WSL — só funciona no Windows nativo, não dentro do WSL
  • Git Bash ainda necessário — você precisa do Git Bash instalado pra iniciar o Claude Code

Essa última limitação é a mais irônica: pra usar o PowerShell tool, você ainda precisa do Git Bash pra dar boot no Claude Code. Mas faz sentido — o runtime do Claude Code é Node.js e precisa do ambiente Unix do Git Bash pra inicializar. O PowerShell tool entra depois, na execução dos comandos.

Por que isso importa pra sua Software House

O elefante na sala: .NET e C\#

Se sua SH trabalha com .NET, C#, ou qualquer stack Microsoft, o Claude Code com PowerShell muda tudo. Antes, o Claude gerava comandos dotnet build que às vezes funcionavam (porque o .NET CLI é cross-platform), mas qualquer coisa que tocasse o sistema operacional — serviços do Windows, registro, IIS, Active Directory — virava um desastre de comandos Bash inválidos.

Agora, o Claude pode:

  • Gerenciar IIS com Get-IISAppPool, New-IISSite
  • Interagir com Windows Services via Get-Service, Restart-Service
  • Manipular o registro com Get-ItemProperty, Set-ItemProperty
  • Gerenciar Active Directory com os cmdlets do módulo AD
  • Executar scripts de deploy em PowerShell nativo

Pra SHs que atendem clientes enterprise rodando Windows Server, isso abre um mundo que estava fechado.

Ambientes corporativos e VDI

Muitas software houses brasileiras — especialmente as que atendem bancos, governo e grandes corporações — operam em ambientes onde WSL não é permitido por políticas de segurança. Virtual Desktop Infrastructure (VDI) com Citrix ou VMware, máquinas bloqueadas, Group Policy restritivo.

O issue #2458 no GitHub descrevia exatamente isso: “Claude Code CLI currently requires WSL2 or native Linux environments, creating significant performance barriers for Windows-based enterprise development workflows.”

Com o PowerShell tool, essas SHs ganham um caminho. Não é perfeito (a limitação do auto mode é significativa), mas é o primeiro passo real.

Os números falam

O Claude Code se tornou a ferramenta de IA coding mais usada do mercado, ultrapassando GitHub Copilot e Cursor em 8 meses. Em empresas pequenas, a taxa de adoção chega a 75%. Mas em enterprises com 10.000+ funcionários, o Copilot ainda lidera com 56% — e uma das razões é justamente o suporte a Windows.

A Anthropic serve mais de 300.000 clientes business. Muitos deles estão em Windows. O PowerShell tool é a resposta da Anthropic pra fechar essa lacuna de adoção enterprise.

O que eu penso

Eu vou ser direto: essa feature deveria ter chegado antes. O Claude Code nasceu como ferramenta de terminal Unix, e a Anthropic demorou pra reconhecer que metade do mundo dev roda Windows. Quando você tem 300 mil clientes business e ignora o OS mais usado no enterprise, tá deixando dinheiro — e impacto — na mesa.

Dito isso, a execução tá correta. Fazer como preview opt-in é a decisão certa: sem sandboxing, o risco de um comando PowerShell destrutivo rodando sem supervisão é real. E manter o Bash tool ao lado garante que nada quebra pra quem já usa.

O que eu quero ver nas próximas versões:

1. Auto mode com PowerShell — sem isso, metade da magia do Claude Code não funciona no Windows

2. Sandboxing — essencial pra enterprise

3. Sem dependência de Git Bash — pra ser realmente nativo

Se a Anthropic entregar esses três pontos nos próximos meses, o Copilot perde a última vantagem que tem no enterprise: a integração nativa com Windows.

Como preparar sua SH agora

Se você tem devs no Windows, faça isso hoje:

1. Ative o PowerShell tool no template de setup:

{

"env": {

"CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"

},

"defaultShell": "powershell"

}

2. Adicione uma regra no CLAUDE.md dos projetos Windows:

# Ambiente
  • Este projeto roda em Windows. Use PowerShell para todos os comandos.
  • Nunca use sintaxe Bash (ls, grep, chmod, etc).
  • Use cmdlets PowerShell nativos: Get-ChildItem, Select-String, etc.

3. Ensine seus devs sobre as limitações:

  • Auto mode não funciona ainda — usem modo interativo
  • Profiles não carregam — funções custom precisam ser chamadas explicitamente
  • Se precisar de algo do Linux, o Bash tool continua disponível

4. Monitore o changelog — a Anthropic tá iterando rápido. Auto mode com PowerShell provavelmente vem nas próximas versões.

Conclusão

O PowerShell tool não é uma feature completa. É um preview, com limitações reais. Mas é a primeira vez que a Anthropic olhou pro ecossistema Windows e disse: “vocês existem, e nós vamos suportar vocês nativamente.”

Pra software houses que operam em Windows — e são muitas no Brasil, especialmente as que trabalham com .NET, ERP, e clientes enterprise — isso é o sinal pra começar a investir em Claude Code. Não precisa esperar ficar perfeito. Configure o preview, teste com seus projetos Windows, e dê feedback no GitHub. A Anthropic tá ouvindo.

Sou Thulio, mentoro 300+ SHs desde 2016.

Marcado:

Deixe um Comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *