Módulo 2.4 — Alternando Effort + Output Tokens

🎨 Padrão desenho→aplicação→revisão

Padrão de 3 fases com efforts diferentes. Economia real em features médias e grandes.

Desenho — xhigh

Arquitetura, trade-offs, alternativas. Saída = plano em markdown.

Aplicação — medium

Executar o plano aprovado. Menos decisões → effort menor.

Revisão — xhigh

Auditoria crítica do diff. Bugs sutis aparecem aqui.

🧱 max_output_tokens=64000

Novo limite do 4.7: 64k tokens de output por resposta. Sem configurar, pode haver truncamento silencioso em respostas grandes.

# SDK Python
response = client.messages.create(
  model="claude-opus-4-7",
  max_tokens=64000,
  thinking={"type": "adaptive"},
  output_config={"effort": "xhigh"},
  messages=[...],
)

⚠️ Pegadinha

Manter max_tokens de 4.6 (geralmente 8192) trunca respostas longas do 4.7 sem erro visível. O output chega incompleto.

🎚️ Trocando effort no meio

Troca viva: /effort medium no Claude Code. Anuncie a troca no prompt seguinte para clareza.

/effort xhigh
# Fase 1: desenhe o plano em markdown...

/effort medium
# Fase 2: aplique o plano aprovado...

/effort xhigh
# Fase 3: revise criticamente o diff...

🧪 A/B testing pessoal

Calibração com dados próprios > intuição. 5 experimentos/mês é uma boa meta.

Variável	Congelar	Medir
Effort	Briefing, arquivos, critério	Tokens, tempo, qualidade percebida
Ordem ICCA	Mesmo conteúdo, effort	Turnos, decisões erradas
Frase-gatilho	Tudo menos a frase	Tipo de raciocínio no output

📝 Documentando escolhas

Anexe "Execution notes" no fim do briefing — útil ao repetir e compartilhar.

# Execution notes (preencher após rodar)
- Effort final usado: xhigh → medium → xhigh
- Trocas manuais: troquei no passo 2 depois do plano aprovado
- Tokens totais: 34k
- Tempo de turno humano: 3 turnos
- O que eu mudaria: adicionar critério de diff ≤ 4 arquivos

⚠️ Pegadinhas ao alternar

Trocar effort em sessão longa pode expor context rot que não aparecia em xhigh.

✗ Sinais de rot

• Confunde itens de turnos antigos
• Repete trabalho já feito
• Esquece constraint declarada

✓ Cura

• /compact com hint
• Reafirmar constraints no prompt
• /clear + briefing destilado

🔧 Automatizando via config

Defaults em ~/.claude/settings.json. Versione no git.

{
  "model": "claude-opus-4-7",
  "output_config": {
    "effort": "xhigh"
  },
  "max_tokens": 64000,
  "thinking": { "type": "adaptive" }
}

💡 Dica

Tenha 2 configs: settings.json (default xhigh) e settings.batch.json (medium) — troque via símlink no início da sessão.

📋 Resumo

✓

xhigh→medium→xhigh — padrão ouro de 3 fases

✓

64k output tokens — não mantenha defaults do 4.6

✓

Documente escolhas — execution notes

✓

Settings.json — versione no git

Próximo Módulo:

2.5 — Adaptive Thinking (Migração)

← Módulo Anterior Próximo Módulo →