Guia de campo do Claude Code em português

“claude” não é reconhecido: o que é e como corrigir no Windows

Quase todo “não funcionou” depois de instalar o Claude Code no Windows é o último degrau: a pasta do executável fora do PATH, a lista de pastas onde o Windows procura programas (p. 8). Não é falta do Git nem de Node.js. Abaixo, a conferência em duas linhas, a correção e os outros cinco erros de instalação do capítulo 1 do guia.

Primeiro: você abriu um terminal novo?

O instalador nativo (irm https://claude.ai/install.ps1 | iex, no PowerShell, sem ser administrador) deixa o executável em %USERPROFILE%\.local\bin\claude.exe. A janela onde você rodou o instalador guarda o PATH antigo: teste sempre numa janela aberta depois (p. 8). Num terminal de editor (VS Code, Cursor), feche e reabra o editor inteiro, não só o terminal, porque ele herda o PATH do editor (p. 9).

O instalador avisa em "Setup notes:" quando a pasta não está no PATH, mas não muda o PATH por você.

Confira em duas linhas

PowerShell

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
$env:PATH -split ';' | Select-String '\.local\\bin'

A primeira deve responder True: o executável está lá. A segunda deve imprimir C:\Users\<você>\.local\bin. Se a primeira der False, a instalação não terminou: rode o instalador de novo. Se a primeira der True e a segunda não imprimir nada, é o PATH.

Corrija o PATH do seu usuário

O comando abaixo acrescenta a pasta ao PATH do seu usuário, o que vale para todas as janelas futuras. Depois, abra um terminal novo e rode claude --version: a resposta é o número da versão seguido de "(Claude Code)".

PowerShell

$atual = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH',
  "$atual;$env:USERPROFILE\.local\bin", 'User')

As duas linhas de conferência foram testadas em 15/10/2026 no PowerShell 5.1 e respondem como descrito (p. 9). No Mac e no Linux a correção é acrescentar export PATH="$HOME/.local/bin:$PATH" ao ~/.zshrc ou ao ~/.bashrc.

Os outros cinco erros de instalação no Windows

Mensagem	O que aconteceu
`'irm' is not recognized`	Você está no CMD. Abra o PowerShell (o prompt começa com `PS C:\`) ou use o comando do CMD: `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd`.
`The token '&&' is not a valid statement separator`	O comando do CMD foi colado no PowerShell.
`A parameter cannot be found that matches parameter name 'fsSL'`	O comando do Mac foi colado no PowerShell, onde `curl` é apelido de outro comando.
"does not support 32-bit Windows" num PC de 64 bits	Você abriu o "Windows PowerShell (x86)". Abra o que não tem x86 no nome.
`claude` abre o app Desktop	Uma versão antiga do Desktop registrou um Claude.exe que passa na frente da CLI. Atualize o Desktop.

Duas instalações brigando

Instalação nativa e pelo npm ao mesmo tempo: roda a que vem primeiro no PATH. where.exe claude lista todas (p. 14). E o WinGet e o Homebrew, por padrão, não se atualizam sozinhos; o nativo se atualiza em segundo plano (p. 9).

Diagnóstico em um comando

Fora da sessão, claude doctor mostra qual executável respondeu, o método de instalação e se as atualizações automáticas estão ligadas, e mostra a linha "No installation issues found." quando está tudo em ordem. Ele só lê. Dentro da sessão, /status mostra versão, modelo e conta, e /doctor propõe correções e só aplica depois do seu sim (p. 14). Se a sessão nem abre, claude --safe-mode inicia sem CLAUDE.md, skills, plugins, hooks e MCP: se abrir assim, o defeito está numa personalização.

Git for Windows: opcional, e não é a causa

Sem o Git for Windows, o Claude Code roda os comandos pela ferramenta PowerShell; com ele, ganha também a ferramenta Bash e o Monitor (p. 8). Instalar o Git não conserta "não é reconhecido": quem conserta é o PATH.