"O processo do Claude Code foi encerrado com o código 1": como encontrar o erro real e corrigi-lo

Etapa 1: obtenha o erro real

claude --version    # is the CLI there at all?
claude              # start it directly: the real error prints here
claude doctor       # install health check

Se funcionar no terminal e apenas a extensão ou o aplicativo falhar, o problema está no ambiente de onde a camada intermediária é iniciada (PATH, versão do Node, variáveis de proxy) — não no próprio Claude Code. Se também falhar no terminal, procure pela mensagem exibida nele.

Causas conhecidas (do rastreador de problemas)

• Retomar uma sessão em segundo plano no VS Code. Abrir uma sessão iniciada com claude --bg gera exatamente este erro — relatado no macOS, Windows e Linux (#77162). Primeiro, pare o agente em segundo plano ou abra uma nova sessão.
• Windows: processo órfão após uma falha. O aplicativo não consegue abrir novamente porque um processo antigo ainda mantém um bloqueio (#42776, #53247). Encerre os processos claude restantes no Gerenciador de Tarefas; a solução confiável relatada ali é reiniciar completamente o Windows.
• Aplicativo para desktop em Apple Silicon falhando a cada início de sessão enquanto a CLI funciona (#59866, uma duplicata de um problema conhecido) — atualize o aplicativo; enquanto isso, use a CLI em um terminal.
• Node.js anterior a 18 ou PATH com problemas após uma instalação via npm — a camada intermediária não consegue iniciar a CLI. node -v; mude para o instalador nativo para eliminar a dependência do Node.
• `~/.claude/settings.json` inválido. Uma vírgula indevida em um bloco de hooks ou permissões faz a CLI encerrar imediatamente. Valide o JSON.
• Incompatibilidade de shell no Windows — uma ferramenta do PowerShell falha ao ser executada a partir do Git Bash com um modelo específico (#87980); tente o outro shell.

Se nenhuma das situações acima se aplicar

• Atualize tudo: claude update, e atualize a extensão do VS Code ou o aplicativo para desktop.
• Reinstale com o instalador nativo (curl -fsSL https://claude.ai/install.sh | bash, ou os comandos de uma linha para PowerShell / CMD no guia de instalação).
• Inicie o VS Code a partir de um terminal para que ele herde o mesmo ambiente da CLI que funciona.
• Abra um novo relato de problema com a saída de claude doctor — o rastreador faz a triagem de falhas rapidamente.

Relacionados

Se o Claude Code iniciar, mas depois falhar com um erro de API, trata-se de outro problema: consulte Erro de API 500, sobrecarregado / 529, Erro de API 400 ou Erros de OAuth. Para a extensão especificamente, consulte Claude Code no VS Code.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Perguntas frequentes

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.