Claude Code: "claude" não encontrado no Windows

Em resumo: no Windows, o instalador do Claude Code coloca o claude.exe em %USERPROFILE%\.local\bin, mas nem sempre adiciona essa pasta ao teu PATH — por isso escrever claude dá “‘claude’ is not recognized…” e não consegues iniciar sessão nem ligá-lo. Resolve de uma de duas formas: executa-o uma vez a partir da respetiva pasta para iniciar sessão agora e depois adiciona essa pasta ao PATH para funcionar em todo o lado.

Nota

Isto tem a ver com o próprio comando claude não executar no Windows — o passo anterior a ligá-lo ao Thunderbird. Se, em vez disso, o claude funciona no teu terminal mas o atbridge não o encontra quando o ligas, consulta Quando o atbridge não encontra a tua IA CLI.

Porque é que isto acontece

Os programas do Windows só podem ser executados pelo nome se a respetiva pasta estiver no teu PATH. O instalador do Claude Code conclui com sucesso e coloca o claude.exe em %USERPROFILE%\.local\bin, mas nem sempre coloca essa pasta no PATH do teu utilizador — por isso um terminal acabado de abrir não sabe onde está o claude. É um passo comum e esperado, não uma instalação avariada. (A Anthropic documenta-o como o caso “command not found” após a instalação.)

Instalaste com o npm?

Se instalaste o Claude Code com npm install -g @anthropic-ai/claude-code, o comando fica na pasta do teu prefixo do npm em vez de .local\bin. Encontra-a com npm config get prefix e usa esse caminho em vez de %USERPROFILE%\.local\bin em todo o lado abaixo.

Como resolver

1. Executa-o uma vez a partir da respetiva pasta — para iniciar sessão agora mesmo. Abre o PowerShell e executa:

   cd $env:USERPROFILE\.local\bin
   .\claude

   Isto arranca o Claude Code apesar de ainda não estar no PATH, para que possas iniciar sessão com a tua conta. (Preferes corrigir primeiro o PATH? Faz o passo 2, abre um novo terminal e depois basta executares claude.)

2. Adiciona a pasta ao teu PATH — para o claude funcionar em todo o lado.

   PowerShell

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

   Isto atualiza definitivamente o PATH do teu utilizador. Depois fecha e reabre o terminal para que ele reconheça a alteração.

   Definições (GUI)

   Carrega em Iniciar, escreve “variáveis de ambiente” e abre Editar as variáveis de ambiente do sistema → Variáveis de Ambiente…. Em Variáveis de utilizador, seleciona Path → Editar → Novo e adiciona:

   %USERPROFILE%\.local\bin

   Clica em OK em cada caixa de diálogo e depois fecha e reabre o terminal.

3. Verifica. Abre um terminal novo e executa:

   claude --version

   Uma cadeia de versão significa que o Windows já encontra o claude. O claude doctor imprime uma verificação de estado só de leitura se quiseres confirmar a instalação.

Cuidado

As alterações ao PATH só se aplicam a terminais abertos de novo — a janela onde o editaste não verá a alteração. Abre um novo PowerShell ou uma nova Linha de Comandos antes de testar.

Depois liga-o no Thunderbird

Assim que o claude executar num terminal e tiveres iniciado sessão uma vez, liga-o como a IA por trás do Chat de IA do atbridge — escolhe Claude Code CLI nas Definições → Fornecedores de IA do atbridge. Passos completos: Ligar uma subscrição CLI.

Se, depois disso, o atbridge continuar sem o ver, é a deteção do lado do atbridge — um único comando resolve: Quando o atbridge não encontra a tua IA CLI.

Para onde ir a seguir

• Ligar uma subscrição CLI
• Quando o atbridge não encontra a tua IA CLI
• O Windows bloqueia o atbridge (SmartScreen)

Mais rápido: pergunte à comunidade

Para perguntas do tipo «como é que eu…» costuma obter uma resposta mais rápida — e ajuda a próxima pessoa com a mesma dúvida — no Discord. Qualquer coisa ligada à sua conta, faturação ou a um bug é melhor como um pedido de suporte, onde respondemos por email.