Stop hook do Claude: por que exit 2 faz o modelo tentar novamente

Um Stop hook do Claude pode devolver o modelo à tarefa após uma verificação falha, mas deve terminar com o código 2 e enviar os erros para stderr.
Stop hook do Claude: por que exit 2 faz o modelo tentar novamente
Um Stop hook pode fazer o Claude repetir uma tentativa quando uma verificação falha. Mas é importante que o hook termine com o código 2.
Diferença entre os códigos de saída:
exit 2devolve o Claude à execução da tarefa e envia o conteúdo destderrdo hook para que o modelo corrija o erro.exit 1não bloqueia a finalização, então o Claude apenas termina, mesmo se a verificação falhou.
Além disso, exit 1 pode indicar um erro no próprio hook, como uma dependência ausente ou um bug no script.
Portanto, se quiser que o Claude tente novamente, use exit 2 e envie os erros para stderr.
Exemplo:
[your command] >&2 || { echo failed; exit 2; }
Por que isso importa
AnáliseO uso correto dos códigos de saída transforma Stop hooks em um mecanismo de autocorreção para agentes de IA, em vez de um sinal silencioso de falha.
Debater na comunidade
Compartilhe suas dúvidas e insights com desenvolvedores
Relacionado no ecossistema
Guias práticos, terminologia essencial e skills de agentes
Claude Sonnet 4.6 vs GPT-5.5 vs Gemini 3.1 Pro: Comparação de Modelos 2026
A cada poucas semanas, surge um novo modelo, e sempre as mesmas perguntas: vale a pena migrar? O que mudou? Pelo que pagar?
Claude Fable 5: quando usar o modelo avançado e qual nível de esforço escolher
Análise completa do modelo Claude Fable 5 e do parâmetro effort: como funciona o sinal comportamental de raciocínio, a matriz de disponibilidade dos níveis (low/xhigh), o cálculo de custo por execução e as configurações na API e no Claude Code.
ClaudeMom no GitHub: projeto que «hipnotiza» o cliente oficial do Claude
Um projeto no GitHub chamado ClaudeMom é descrito como um gateway local que faz o cliente oficial do Claude considerar o usuário autenticado.
Anthropic adiciona personalização da interface do Claude por prompt no desktop
A versão desktop do Claude agora permite alterar o design da interface usando um prompt.