Resposta rápida: identifique onde o erro aparece antes de tentar corrigir. No terminal, confira se o comando claude é encontrado; se ele abre, use o diagnóstico do Code. Uma mensagem de reparo do aplicativo Claude ou de acesso a arquivos pelo Cowork exige outra investigação.
Este guia organiza problemas do Claude Code no Windows por sintoma. Anote a mensagem exata e o método de instalação para escolher o caminho adequado.
| Sintoma | Primeira checagem |
|---|---|
Terminal não encontra claude |
Instalação e PATH |
| Code abre, mas falha ao autenticar | Conta, credencial e mensagem de login |
| Aplicativo Claude pede reparo | Suporte do aplicativo; não presumir falha de npm |
| Cowork não executa comandos ou acessa o ambiente local | Avisos do serviço e versão do Windows |
Cowork no Windows — verificação em 18/09/2026: a Anthropic marcou como resolvido em 14/09 o incidente associado à atualização do Windows de 8/09. O aviso orienta para uma correção da Microsoft; reinstalar o aplicativo não resolvia essa causa. Consulte o registro oficial do incidente e a atualização aplicável do Windows. Esse diagnóstico não deve ser generalizado para qualquer erro do Claude Code.
Leitura rapida para mensagens de reparar/reinstalar: se o Windows sugerir opções avancadas, reparar ou reinstalar este aplicativo, primeiro confirme se o problema e do app, do PATH ou de um incidente do Windows. Rode where.exe claude e claude --version; se o comando existe, use claude doctor antes de reinstalar.
Diagnóstico: o comando claude é encontrado?
No PowerShell, comece pelas verificações abaixo. Elas consultam a instalação, sem reinstalar nem excluir arquivos.
where.exe claude
claude --versionSe o comando responder, execute claude doctor para examinar a instalação e as configurações. Para outras operações, consulte o guia do comando claude.
Erro: “claude não é reconhecido como comando”
Abra um terminal novo e repita a checagem. Se continuar sem encontrar o executável, confira a instalação e o PATH. No instalador nativo, a localização esperada é %USERPROFILE%\.local\bin\claude.exe; instalar apenas a extensão do VS Code não disponibiliza necessariamente o comando no terminal.
A documentação mostra como verificar o PATH e identificar instalações em conflito. Para a instalação inicial, use o tutorial do Claude Code no Windows.
Erro de Node.js ou npm: confira o método de instalação
O instalador nativo recomendado dispensa Node.js. Se você escolheu npm, o pacote exige Node.js 22 ou superior a partir da versão 2.1.198. Confira a versão apenas nessa trilha:
node --version
npm --versionUm aviso EBADENGINE deve ser comparado aos requisitos do pacote; não prova sozinho que o executável do Claude Code está quebrado. Veja os requisitos oficiais da instalação por npm.
Erro: permissão na instalação (EACCES)
Ao instalar pelo npm, você pode ver erros de permissão, como EACCES ou “permission denied”.
O que fazer:
- evite resolver com permissões elevadas de forma insegura;
- prefira o instalador oficial do Claude Code quando possível;
- se usar npm, ajuste as permissões da pasta global do npm conforme a documentação do Node.
Confirme qual diretório e método geraram o erro antes de alterar permissões. A documentação de instalação separa falhas de permissão e instalações em conflito; migrar de método exige identificar a instalação anterior.
Erro: login ou autenticação falha
Confirme se está usando acesso pela assinatura Claude, pelo Console/API ou pelo provedor da sua organização. No Code, consulte /status; se for necessário autenticar novamente, use /login.
Uma chave em ANTHROPIC_API_KEY pode mudar a credencial utilizada. Não crie outra chave nem troque para cobrança por API apenas porque o navegador falhou. Compare a mensagem com a documentação de autenticação; em ambiente corporativo, confira as regras da organização.
Erro: Git não encontrado
O Claude Code funciona no Windows nativo, mas alguns recursos, como o Bash tool, dependem do Git for Windows.
Se você vê avisos sobre Git ausente ou o Bash tool não funciona, instale o Git for Windows. Ele não é obrigatório para começar, mas habilita mais recursos e evita alguns avisos.
Erro: Claude Code lento ou travando
Se o Claude Code está lento ou travando no Windows:
- verifique se não é o antivírus escaneando cada operação de arquivo;
- em projetos muito grandes, tarefas complexas naturalmente demoram mais;
- confirme sua conexão, já que o agente depende de chamadas de rede.
No WSL, acessar um projeto em /mnt/c/ pode prejudicar operações de arquivos. Consulte a orientação para buscas no WSL. Escolha o ambiente conforme o projeto; instalar de novo não é um diagnóstico de lentidão.
Quando considerar reinstalação
Use esta tabela para decidir quando reparar ou reinstalar:
| Mensagem ou sintoma | Primeiro teste | Próximo passo |
|---|---|---|
| claude não e reconhecido | where.exe claude |
corrigir PATH ou reinstalar pelo metodo original |
| Windows sugere reparar o app | claude --version |
confirmar se o CLI funciona antes de apagar dados |
| erro depois de atualizacao do Windows | verificar status/incidente aplicavel | não generalizar para qualquer falha do Claude Code |
Considere reinstalar quando o diagnóstico apontar falha da instalação. Antes, registre a mensagem, a versão e o método usado. Se o executável funcionar, consulte claude doctor; se não, conclua a checagem de instalação e PATH.
Confirme o procedimento adequado ao método original no guia de instalação no Windows. Evite apagar configurações ou histórico como tentativa genérica de corrigir login, rede ou incidente do Cowork.
Se você é novo na ferramenta, vale também entender o que é o Claude e como usar antes de investir tempo na configuração.
Perguntas frequentes
Por que o comando claude não é reconhecido no Windows?
O terminal não localizou o executável. Abra um terminal novo e confira a instalação e o PATH. A extensão do VS Code e a instalação do comando para o terminal são caminhos distintos.
Como resolver erro de instalação do Claude Code?
Identifique o método de instalação e a mensagem exata. Verifique o PATH quando o comando não for encontrado; se ele responder, use claude doctor. Não comece por Node/npm quando tiver usado o instalador nativo.
O Claude Code precisa de Node.js?
Não para o instalador nativo. Na instalação por npm, confira os requisitos da versão do pacote, indicados na seção sobre Node/npm deste guia.
Como diagnosticar problemas no Claude Code?
Confira a mensagem e a versão instalada. Use claude doctor quando o executável estiver disponível; se o comando não for reconhecido, verifique primeiro instalação e PATH.
Preciso de WSL para rodar o Claude Code no Windows?
Não. Há instalação nativa para Windows. Use WSL quando o projeto exigir ambiente Linux.