Aula 3 · 18 min
O maior inimigo de uma sessão longa é a compactação repetida: o objetivo sobrevive, mas o que está feito e o que falta se diluem. O hook-longrun mede o contexto e age antes do limite, em três faixas. Nesta aula você liga o hook e provoca as três faixas num ensaio, sem gastar um token.
Começar a aula
Objetivo: ligar o hook-longrun e provocar as três faixas num ensaio, sabendo o que cada uma pede ao agente e quando fazer /clear + /prime.
A porcentagem é sobre o ponto em que o Claude Code compacta por tamanho, não sobre a janela inteira.
Hook-longrun 1.9.6 (18/10/2026). As faixas mudam com LONGRUN_FAIXAS="50,70,85". O aviso chega uma chamada de ferramenta depois, porque a transcrição é gravada com atraso.
O que cada caminho guarda, medido em 15/10/2026 (17 compactações com handoff da mesma sessão nas 3 h antes).
O resumo cita de 20 a 54 arquivos e preserva passos e comandos recentes. Dentro da mesma sessão, guarda mais detalhe concreto que o handoff.
Mas não separa o confirmado do palpite, mistura as decisões na narrativa e não sobrevive a /clear.
Cita de 1 a 27 arquivos, mas marca o que foi provado, guarda as decisões e a próxima ação numa seção própria.
É o único que serve para outra sessão, outro dia ou o Codex. Os dois juntos são melhores que qualquer um sozinho.
Gravar o handoff a partir do resumo da compactação: vira cópia de cópia.
A sessão nova redescobre: 80% dos primeiros 25 passos foram leituras, contra 51–59% depois de compactar.
Por isso a sessão nova vem na faixa 3 ou na 3ª compactação, ao fim da unidade em curso, e não cedo.
Metade de um JSONL de 1,84 GB medido em 01/10/2026 era saída de ferramenta. Grave log em arquivo e leia o trecho (tail -50).
Subagente gasta o contexto dele e devolve só o resumo; a Anthropic cita retornos de 1.000 a 2.000 tokens. Como usar subagentes é assunto do curso 3.
O ensaio escreve uma transcrição falsa com o número de tokens que você quiser e chama o hook como o Claude Code chamaria.
{
"cleanupPeriodDays": 365,
"hooks": {
"PreCompact": [{ "hooks": [{ "type": "command", "command": "bash ~/projetos/execucao-longa/tools/hook-longrun.sh 2>/dev/null || true", "timeout": 10 }] }],
"SessionStart": [{ "matcher": "compact|resume|clear", "hooks": [{ "type": "command", "command": "bash ~/projetos/execucao-longa/tools/hook-longrun.sh 2>/dev/null || true", "timeout": 10 }] }],
"PostToolUse": [{ "hooks": [{ "type": "command", "command": "bash ~/projetos/execucao-longa/tools/hook-longrun.sh 2>/dev/null || true", "timeout": 10 }] }],
"UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "bash ~/projetos/execucao-longa/tools/hook-longrun.sh 2>/dev/null || true", "timeout": 10 }] }],
"Stop": [{ "hooks": [{ "type": "command", "command": "bash ~/projetos/execucao-longa/tools/hook-longrun.sh 2>/dev/null || true", "timeout": 10 }] }]
}
}# ensaio-hook.sh — dispara o hook-longrun com uma transcrição FALSA (nenhum token gasto)
# uso: bash ensaio-hook.sh <tokens|-> [minutos-parado] [evento] ("-" reaproveita a transcrição anterior)
E=/tmp/ensaio-hook; K=~/projetos/execucao-longa
mkdir -p $E/proj/longrun/2026-10-19-teste $E/proj/handoffs/history
[ -f $E/proj/longrun/2026-10-19-teste/state.md ] || echo "# Estado" > $E/proj/longrun/2026-10-19-teste/state.md
[ "${1:-500000}" = "-" ] || python3 - "${1:-500000}" "${2:-0}" > $E/t.jsonl <<'PY'
import json, sys, time, datetime
n, parado = int(sys.argv[1]), float(sys.argv[2])
ts = datetime.datetime.fromtimestamp(time.time() - parado * 60, datetime.timezone.utc).isoformat().replace("+00:00", "Z")
print(json.dumps({"type": "assistant", "timestamp": ts, "message": {"model": "claude-opus-5-5",
"content": [{"type": "text", "text": "ok"}],
"usage": {"input_tokens": 10, "cache_read_input_tokens": n - 10, "cache_creation_input_tokens": 0}}}))
PY
echo "{\"hook_event_name\":\"${3:-PostToolUse}\",\"cwd\":\"$E/proj\",\"session_id\":\"ensaio\",\"transcript_path\":\"$E/t.jsonl\",\"prompt\":\"oi\"}" \
| LONGRUN_ESTADO=$E/estado LONGRUN_AGENDAR_ARQ=$E/agenda.jsonl python3 $K/tools/hook-longrun.py
echorm -rf /tmp/ensaio-hook bash ensaio-hook.sh 500000 # faixa 1 bash ensaio-hook.sh 500000 # mesma faixa: silêncio (uma vez por faixa) bash ensaio-hook.sh 700000 # faixa 2 bash ensaio-hook.sh 830000 # faixa 3
$ bash ensaio-hook.sh 500000
{"hookSpecificOutput": {"hookEventName": "PostToolUse", "additionalContext":
"Contexto em 52% do ponto de compactação (500 mil de 967 mil tokens). FAIXA 1 de 3:
antes de seguir, acrescente em longrun/2026-10-19-teste/canal.md o que você precisaria
se o histórico sumisse agora (…) Só acrescentar. Depois continue o trabalho normalmente."}}
$ bash ensaio-hook.sh 500000
$ bash ensaio-hook.sh 700000
{… "Contexto em 72% do ponto de compactação (700 mil de 967 mil tokens). FAIXA 2 de 3:
atualize state.md, progress.md e (…) canal.md; termine a unidade de trabalho atual e
grave o handoff agora (…)"},
"systemMessage": "Execução longa em 72% do ponto de compactação: hora de /compact
(o agente foi avisado)."}
$ bash ensaio-hook.sh 830000
{… "Contexto em 86% do ponto de compactação (830 mil de 967 mil tokens). FAIXA 3 de 3:
não abra trabalho novo. (…) /session-handoff, sessão nova e /prime (…) ao fim da
unidade em curso, sem largá-la no meio. (…)"},
"systemMessage": "Execução longa em 86% do ponto de compactação: hora de
/session-handoff + sessão nova + /prime."}Quebras de linha e (…) acrescentados para caber na tela; o texto é o do hook-longrun 1.9.6. O additionalContext vai para o agente; o systemMessage aparece para você.
/status; quem segue as faixas é a regra do AGENTS.md (aula 1) e você./compact manual antes.compact_prompt; o prompt estruturado em ~/.codex/config.toml só vale no /compact manual.O primeiro exercício mexe no seu settings.json: faça um backup antes.
Copie o settings.json para settings.json.bak e junte o trecho de hooks aos que você já tem (não apague os seus). Abra uma sessão nova do Claude Code para carregar.
Pronto quando: python3 -c "import json,os;h=json.load(open(os.path.expanduser('~/.claude/settings.json')))['hooks'];print(sorted(e for e,l in h.items() if 'hook-longrun' in json.dumps(l)))" → ['PostToolUse', 'PreCompact', 'SessionStart', 'Stop', 'UserPromptSubmit'].
Salve o ensaio-hook.sh e rode a sequência das três faixas. Depois apague /tmp/ensaio-hook e rode LONGRUN_TETO=600000 bash ensaio-hook.sh 500000.
Pronto quando: aparecem, nesta ordem, FAIXA 1 de 3, nada, FAIXA 2 de 3 e FAIXA 3 de 3; com LONGRUN_TETO=600000, 500 mil já cai na FAIXA 2 de 3 (83% de 600 mil).
Pergunta 1 de 4
Num modelo de 1M, em quantos tokens o hook avisa a faixa 2 por padrão?competência
Pergunta 2 de 4
A faixa 3 disparou no meio de uma refatoração. O que o agente deve fazer?competência
Pergunta 3 de 4
Dentro da mesma sessão, o que guarda mais detalhe concreto (arquivos, passos)?
Pergunta 4 de 4
Você usa o Codex. Como segue as faixas?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.