Source: https://aiprimetech.io/pt/claude-code/errors/process-exited-code-1/ [Início](/pt/) › [Claude Code](/pt/claude-code/) › [Erros](/pt/claude-code/errors/) › Encerrado com o código 1 [Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/) Última atualização: 11 de outubro de 2026 # "O processo do Claude Code foi encerrado com o código 1": como encontrar o erro real e corrigi-lo "O processo do Claude Code foi encerrado com o código 1" é uma mensagem da camada intermediária: a extensão do VS Code ou o aplicativo para desktop iniciou a claude CLI, e a CLI encerrou antes de conseguir informar o motivo. A correção começa pela obtenção do erro real. ## TLDR - Execute claude em um terminal comum — a CLI exibe o erro real que a camada intermediária oculta. - Causas comuns: Node.js / PATH desatualizado, settings.jsoninválido, uma sessão em segundo plano travada, processos órfãos no Windows. - claude doctor verifica a instalação; reinstalar com o instalador nativo corrige a maioria das instalações com problemas. - Windows: se o aplicativo não abrir novamente após uma falha, uma reinicialização completa elimina o bloqueio mantido pelo processo órfão. ## 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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/42776), [#53247](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](https://github.com/anthropics/claude-code/issues/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](/pt/claude-code/install/)). - 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](/pt/claude-code/errors/api-error-500/), [sobrecarregado / 529](/pt/claude-code/errors/overloaded-529/), [Erro de API 400](/pt/claude-code/errors/api-error-400/) ou [Erros de OAuth](/pt/claude-code/errors/oauth-error/). Para a extensão especificamente, consulte [Claude Code no VS Code](/pt/claude-code/vscode/). ## Cansado de lidar com esse problema? Execute o Claude Code pelo gateway da AI Prime Tech: os mesmos modelos Claude nas contas upstream do próprio gateway, duas variáveis de ambiente para fazer a mudança, e novas contas recebem $5 em crédito gratuito para a API com o código FIXIT — sem cartão. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Crie uma conta com o código FIXIT](/register?promo=FIXIT) ## Perguntas frequentes O que significa 'O processo do Claude Code foi encerrado com o código 1'? A extensão do VS Code ou o aplicativo para desktop iniciou a CLI do Claude Code, e ela encerrou com um erro. Execute claude em um terminal para ver a mensagem de erro real.Como corrigir o encerramento do Claude Code com o código 1 no Windows? Encerre os processos claude restantes (ou reinicie o Windows se o aplicativo não abrir novamente), verifique node -v e PATH, valide ~/.claude/settings.json e reinstale com o instalador nativo, se necessário.Por que o Claude Code funciona no terminal, mas não no VS Code? O VS Code foi iniciado com um ambiente diferente (PATH, Node, variáveis de proxy). Inicie o VS Code a partir do terminal em que claude funciona ou corrija as variáveis no perfil do seu shell. ## Execute o Claude Code no gateway Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código FIXIT.[Obter uma chave de API](/register?promo=FIXIT) [Ver planos ilimitados](/pt/plans/) 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. ## Mais guias do Claude Code [Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)["Erro de API: 500" no Claude Code: o que significa e o que realmente resolve](/pt/claude-code/errors/api-error-500/)[Erro "Sobrecarregado" no Claude (erro 529 de API): o que significa e o que fazer](/pt/claude-code/errors/overloaded-529/)[Erro 400 da API do Claude Code: prompt longo demais, concorrência no uso de ferramentas e os demais](/pt/claude-code/errors/api-error-400/)[Erros de OAuth no Claude Code: tempo limite de 15000ms excedido e código de status 500](/pt/claude-code/errors/oauth-error/)["O prompt é longo demais", "A entrada é longa demais para o modelo solicitado" e "Limite de contexto atingido" no Claude: o que preenche a janela e como liberar espaço](/pt/claude-code/errors/prompt-too-long/)[Limite de uso do Claude atingido: limites de sessão, semanais e do Opus, "limites especificados de uso da API", "o saldo de créditos é insuficiente" — e o que fazer](/pt/claude-code/errors/usage-limit-reached/)[Erros 401 e 403 no Claude Code: credenciais de autenticação inválidas, chave de API inválida, "Você não está conectado", host_not_allowed](/pt/claude-code/errors/auth-401-403/)[Erros de conexão no Claude Code: ECONNRESET, conexão perdida durante a resposta, "Aguardando resposta da API", "Não foi possível conectar à API", erros de certificado SSL](/pt/claude-code/errors/connection-lost/)[O Claude Code trava, fica preso ou para de responder: como descobrir onde travou e sair dessa situação](/pt/claude-code/errors/claude-code-hangs/)[Claude.ai não funciona: "Algo deu errado", restrições de capacidade, "limite de 5 horas atingido", "erro ao fazer login" e os demais](/pt/claude-code/errors/claude-ai-not-working/)