Aula 2 · 15 min
O modelo sozinho só prevê texto: não lembra, não enxerga seus arquivos, não age e não confere. Quem faz o trabalho no Claude Code e no Codex é o harness, o programa em volta do modelo. Quando o agente falha, a pergunta útil quase nunca é "tente de novo": é qual peça do harness está faltando. Nesta aula você faz o inventário do seu.
Começar a aula
Objetivo: listar as peças do harness da sua máquina (contexto, memória, ferramentas, verificação, permissões) e dizer qual delas segura cada falha.
Clique em cada bloco: o que a peça faz e onde ela mora na sua máquina.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
No início de cada sessão o modelo não sabe nada do seu projeto. O harness carrega as regras (CLAUDE.md no Claude Code, AGENTS.md no Codex), a estrutura de pastas e o que mudou. Você escreve uma vez; ele lê em toda sessão.
Quanto mais longa a sessão, mais cheia a janela de contexto. O harness compacta: mantém o objetivo, encolhe os passos antigos. Compactar demais perde detalhe; por isso os loops longos guardam o estado em arquivo (aula 5) e o curso 2 trata das faixas de contexto.
O modelo só produz texto. Quando esse texto é um pedido de ferramenta (ler arquivo, rodar comando, editar), o harness executa e devolve o resultado ao modelo. MCP é o jeito padrão de plugar ferramentas de outros sistemas.
Sem verificação o modelo olha o código e diz "parece bom". Com ela, roda o teste e lê o resultado. Resultado real vale mais do que a IA dizer que está bom. É a peça que o loop mais precisa (aulas 1 e 6; curso 1).
O harness confere cada ação antes de executar: editar passa, apagar pergunta. Hooks rodam seus scripts antes e depois das ferramentas; a sandbox limita o que um comando alcança. Em loop sem você olhando, é o que segura o raio de dano (curso 4).
Juntando tudo: o modelo pensa e pede uma ferramenta, a permissão confere, o harness roda, o resultado volta, e o ciclo segue até o objetivo. O harness não deixa o modelo mais inteligente; deixa mais útil.
Esqueceu a regra do projeto: contexto. Perdeu o fio depois de horas: memória. Não conseguiu fazer: ferramenta. Disse pronto sem estar: verificação. Fez o que não devia: permissões.
Claude Code e Codex são harnesses. O mesmo modelo em harnesses diferentes dá resultados diferentes.
De posts de engenharia públicos (pesquisa de 19/10/2026).
No post "Harness engineering", a lição central é: quando o agente falha, perguntar qual capacidade, contexto ou estrutura está faltando, em vez de mandar tentar mais.
Na prática: a correção vai para o harness (uma regra no AGENTS.md, uma ferramenta, um teste), não para um prompt mais enfático.
No post sobre o harness de apps longos, a equipe precisou de resets de contexto com handoff para um modelo que encerrava cedo; num modelo seguinte o comportamento sumiu e os resets saíram, ficando a compactação automática.
Lição: cada peça do harness codifica uma suposição sobre o modelo. Troca de modelo pede reavaliar as peças.
Só leitura: nada é alterado. Rode na sua máquina e anote o que apareceu.
ls -la ~/.claude/CLAUDE.md ~/.codex/AGENTS.md 2>&1 wc -l ~/.claude/CLAUDE.md ~/.codex/AGENTS.md 2>/dev/null ls CLAUDE.md AGENTS.md 2>&1 # no projeto atual
claude mcp list ls ~/.claude/skills 2>/dev/null | wc -l
python3 - <<'PY'
import json, pathlib
for p in (pathlib.Path.home() / ".claude/settings.json", # usuário
pathlib.Path(".claude/settings.json"), # projeto (vai para o git)
pathlib.Path(".claude/settings.local.json")): # projeto, só nesta máquina
if not p.exists():
print(f"{p}: não existe")
continue
d = json.loads(p.read_text())
perm = d.get("permissions", {})
print(f"{p}: hooks {sorted(d.get('hooks', {})) or 'nenhum'} · allow {len(perm.get('allow', []))} · deny {len(perm.get('deny', []))}")
PYgrep -nE '^(sandbox_mode|approval_policy)' ~/.codex/config.toml || echo "padrão do Codex (sem chave no config)"
# Meu harness — <data> contexto: <arquivos de regras que o agente lê ao começar> memória: <como guardo o que não pode se perder: handoff, arquivos de estado, nada> ferramentas: <MCP e skills que uso de verdade> verificação: <o comando que prova que deu certo no meu projeto principal> permissões: <hooks e regras allow/deny; sandbox do Codex> peça mais fraca: <qual e por quê>
Contexto, memória, ferramentas, verificação, permissões e o loop do agente, uma peça por capítulo (10/10/2026).
Na sua máquina. Só passe para o próximo quando o "pronto quando" for verdade.
Rode os quatro blocos do inventário e preencha o harness.md com o que apareceu, uma linha por peça. Escreva as marcas do começo da linha exatamente como estão no modelo: o grep do "pronto quando" procura por elas.
Pronto quando: grep -cE '^(contexto|memória|ferramentas|verificação|permissões):' harness.md → 5, e grep -c '<' harness.md → 0 (nenhum marcador do modelo ficou sem preencher).
Acrescente ao CLAUDE.md (ou AGENTS.md) do projeto uma regra fácil de conferir, por exemplo "toda resposta termina com a palavra CONFERIDO". Abra uma sessão nova e peça qualquer coisa.
Pronto quando: A resposta da sessão nova termina com CONFERIDO sem você pedir. Depois apague a regra: grep -c CONFERIDO CLAUDE.md → 0.
Lembre de uma falha real do agente nas últimas semanas. Escreva em harness.md a linha "peça mais fraca:" com a peça dona da falha e a correção que vai para o harness, não para o prompt.
Pronto quando: grep '^peça mais fraca:' harness.md → uma linha que cita uma das cinco peças e um arquivo, comando ou ferramenta concreta.
Pergunta 1 de 4
Toda sessão nova o agente esquece que o projeto usa pnpm e roda npm. Qual peça do harness resolve?competência
Pergunta 2 de 4
O agente disse "corrigi o bug" e o bug continua. Qual peça faltou, e qual a correção de harness?
Pergunta 3 de 4
Segundo o post de engenharia da Anthropic de março/2026, o que fazer com o harness quando troca o modelo?
Pergunta 4 de 4
Por que o mesmo modelo dá resultados diferentes no Claude Code e no Codex?competência
Escolha uma alternativa. A explicação aparece depois da sua tentativa.