Esses dez problemas representam a grande maioria dos tickets de suporte de instalação e autenticação relacionados ao Claude Code. Cada entrada inclui a solução mais confiável.
1. claude: comando não encontrado logo após a instalação.
O instalador adicionou claude ao seu PATH, mas seu shell atual ainda não o detectou. Abra um novo terminal ou execute source ~/.zshrc (ou ~/.bashrc). No Windows, feche e reabra o PowerShell.
2. npm install falha com EACCES / permissão negada.
Isso geralmente significa que a instalação foi executada com sudo, ou seu diretório npm global é de propriedade do root. Não use sudo. Em vez disso, use o instalador curl ou corrija o prefixo do npm com npm config set prefix ~/.npm-global e adicione esse diretório bin ao seu PATH.
3. "Versão do Node não suportada" ou travamento silencioso ao iniciar.
Claude Code requer Node 18 ou posterior. Verifique sua versão com node -v. Se for mais antiga, instale uma versão atual via nvm install --lts ou use o instalador curl, que inclui seu próprio runtime e evita esse problema completamente.
4. WSL: claude executa o Node do Windows em vez do Node do Linux.
O PATH do Windows vaza para o WSL e substitui o nvm. Adicione seu node do Linux no início do PATH em ~/.bashrc: export PATH="$HOME/.nvm/versions/node/$(nvm current)/bin:$PATH"
5. O instalador trava ou falha atrás de uma rede corporativa.
O host de download (storage.googleapis.com) provavelmente está bloqueado. Defina seu proxy primeiro com export HTTPS_PROXY=http://your-proxy:port, depois execute o instalador novamente. Se isso não for possível, peça ao seu time de TI pelo pacote offline.
6. SELF_SIGNED_CERT_IN_CHAIN ou outros erros de TLS.
Sua empresa injeta seu próprio certificado. Aponte o Node para o pacote de CA corporativo: export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem Adicione-o ao seu perfil de shell para que persista.
7. /login abre um navegador, mas o terminal nunca termina ("Aguardando autenticação…").
Isso geralmente significa que o callback localhost está bloqueado, o que é comum em SSH remoto, em devcontainers ou atrás de um firewall rigoroso. Use o fluxo manual em vez disso: copie a URL impressa no terminal, conclua o login em qualquer navegador e cole o código retornado de volta no terminal.
8. "Não autenticado" mesmo que você tenha definido ANTHROPIC_API_KEY.
Existem três causas comuns: a chave foi exportada em um shell diferente (execute echo $ANTHROPIC_API_KEY para verificar), você executou anteriormente /login e a sessão OAuth está tendo precedência (execute /logout primeiro), ou a chave é uma chave de Console, mas sua organização requer login SSO em vez disso.
9. Bedrock / Vertex: "Não foi possível carregar as credenciais."
Claude Code usa os SDKs de provedor padrão, portanto a solução é a mesma para qualquer ferramenta AWS/GCP CLI. Para Bedrock, confirme que aws sts get-caller-identity funciona e que AWS_REGION está definido para uma região onde seu modelo está habilitado. Para Vertex, confirme que gcloud auth application-default login foi executado e que GOOGLE_CLOUD_PROJECT está definido.
10. Instalou e autenticou, mas cada solicitação gera erro 403 / "modelo não disponível."
Sua conta existe, mas não tem acesso ao modelo que o Claude Code está solicitando. Para assentos Enterprise, confirme que seu assento está ativo nas configurações de administrador da sua organização. No Bedrock ou Vertex, confirme que o modelo Claude específico está habilitado nessa região ou projeto. Como solução rápida, execute /model e selecione um modelo ao qual você sabe que tem acesso.
Ainda preso?
Execute claude doctor do seu shell normal (não de dentro de uma sessão Claude). Ele imprime um relatório de diagnóstico que você pode anexar a um ticket de suporte.