Tarefa do Claude Code travada: quando parar as tentativas e recuperar o estado
Um protocolo prático para recuperar uma tarefa travada no Claude Code: classifique a falha, interrompa o loop, registre o estado e reinicie com uma checagem limitada.
Tentativas de repetição sem limite são uma causa comum de desperdício de tokens, degradação de contexto e alterações de código danificadas ao usar o Claude Code. Quando um agente falha repetidamente nos mesmos testes, encontra uma variável de ambiente ausente ou edita os mesmos arquivos em círculo, tentar de novo sem um novo sinal externo não resolve a causa. Apenas aprofunda a sessão em um beco sem saída.
A estratégia correta é interromper o loop cedo, classificar a falha tanto na API quanto no código, registrar o estado real do repositório e recuperar a tarefa por meio de uma verificação determinística.
1. Classifique os tipos de falha: quando tentar de novo não ajuda
Nem todo erro é corrigido ao executar o comando outra vez. Sem uma diagnose clara, é fácil confundir limites temporários da API com loops lógicos do agente:
Para não adivinhar a causa e gastar tokens às cegas, separe problemas de uma API externa de defeitos no código. No workflow BetterToken para Claude Code, o Dashboard permite verificar status HTTP, modelo, tempo de resposta e o consumo exato de tokens de entrada, saída e cache. Um timeout de gateway ou um 429 pode justificar uma repetição limitada. Se a API retorna 200 OK de modo consistente enquanto o agente edita em círculo, encerre a sessão imediatamente.
2. Protocolo de recuperação priorizado
Depois de 2 ou 3 tentativas consecutivas sem progresso, siga esta ordem:
```mermaid
graph TD
A[O agente está em um loop de erro] --> B[Etapa 1: parar imediatamente com Ctrl+C]
B --> C[Etapa 2: revisar status e diff do Git]
C --> D[Etapa 3: salvar um Recovery Card]
D --> E[Etapa 4: iniciar uma sessão limpa com uma verificação]
```
Ações passo a passo:
- Etapa 1: encerre a sessão. Interrompa a execução com `Ctrl+C`. Não deixe o agente consumir mais contexto com justificativas longas ou saída desnecessária.
- Etapa 2: inspecione e limpe o estado. Verifique os arquivos alterados com `git status --short`. Se o agente gerou código quebrado, reverta apenas os arquivos afetados: `git checkout -- <file>`.
- Etapa 3: classifique a causa raiz. Compare as métricas da API no Dashboard com os logs de execução do agente para separar uma falha de rede de um erro de lógica.
- Etapa 4: salve um Recovery Card estruturado.
3. O Recovery Card estruturado
Registre o estado exato da tarefa antes de abrir uma nova sessão de recuperação:
```markdown
Recovery Card: falha no serviço de importação
- Objetivo original: adicionar validação de e-mail em `auth/service.ts`.
- Progresso real: a regex foi adicionada, mas o teste unitário `auth_test.go` falhou.
- Causa raiz: o agente tentou criar um mock de um método privado em vez da interface pública.
- Estado do Git: branch `fix/auth-email`, diff válido mantido em `auth/service.ts`.
- Próxima ação para uma sessão limpa: refatorar o teste unitário usando a interface pública `AuthClient`.
```
[!IMPORTANT]
Não inclua segredos: nunca coloque chaves de API, tokens de acesso ou dumps brutos de memória em um Recovery Card. Confira a configuração do endpoint e o gerenciamento de chaves na documentação BetterToken para Claude Code.
4. Recuperação reversível e verificação
Para retomar a execução com segurança:
- Inicie uma nova sessão do Claude Code com uma janela de contexto limpa.
- Informe ao agente apenas o objetivo da tarefa e o campo “Próxima ação” do Recovery Card.
- Exija uma checagem bem delimitada: `npm test -- tests/auth.test.ts`.
- Confirme que o teste-alvo passou (`Passed`) e depois revise o diff final com `git diff --check`.
Esse protocolo transforma um loop descontrolado do agente em um ponto de controle gerenciável e protege a base de código e o orçamento de tokens.
Pagamento e recarga de saldo
O pagamento e a recarga para uso da API são administrados na sua própria conta BetterToken. BetterToken é um serviço de acesso a APIs de modelos cobrado por uso; o saldo pago e recarregado não expira automaticamente a cada mês. Formas de pagamento, valores mínimos, tarifas, câmbio e prazos de processamento podem mudar, portanto confira a conta no momento do pagamento.
Preços e controle de custos
A disponibilidade de modelos e os preços específicos são informações dinâmicas. Antes de decidir sobre custos, consulte a página de preços da BetterToken, em vez de reutilizar números de um artigo antigo. Depois de uma chamada de teste, o Dashboard permite conferir o modelo, o status e os tokens de entrada, saída e cache com o consumo correspondente.