Harness
Harness
O programa que embrulha o modelo: o loop de runtime, as ferramentas e os permission modes que transformam um LLM num agente. O fecho conceitual do guide.
Um modelo de linguagem, sozinho, só produz texto. O que transforma o Claude — o modelo — num agente que lê arquivos, roda comandos e abre um pull request é o harness: o programa que embrulha o modelo, dá a ele um conjunto de ferramentas e executa o que ele decide fazer. O Claude Code é esse harness. A documentação da Anthropic usa o termo literalmente — agentic harness — para o runtime que costura modelo, ferramentas e ambiente de execução num agente capaz.
O loop do agente
O harness roda um loop. A cada volta ele reúne contexto (lê os arquivos que precisa), age (edita, roda um comando) e verifica (roda os testes, confere a saída) — e decide a próxima volta com base no que acabou de aprender. O modelo raciocina e escolhe o passo; o harness executa e devolve o resultado para o modelo ler. Repete até a tarefa fechar. As fases se misturam: o agente não segue um roteiro fixo, adapta a sequência a cada descoberta.
As ferramentas
O modelo não toca no seu sistema diretamente. Ele pede, e o harness executa por um conjunto de ferramentas: Read e Write para arquivos, Edit para alterações pontuais, Bash para o terminal, Glob e Grep para busca, WebFetch e WebSearch para a internet, Agent para delegar a um subagent. Cada extensão que você viu neste guia — skills, MCP servers, hooks — entra por esse mesmo mecanismo: amplia o repertório de ferramentas que o harness sabe executar.
Os permission modes
Entre o "o modelo pediu" e o "o harness executou" há uma camada de permissão. Ela decide o que roda sozinho e o que espera o seu OK, e o modo ajusta a rigidez:
- default — pede confirmação antes de cada ação que altera algo.
- acceptEdits — aceita as edições de arquivo automaticamente, sem perguntar a cada uma.
- plan — só lê e planeja; não altera nada até você aprovar o plano.
- bypassPermissions — pula as confirmações: rápido, mas você abre mão da revisão. Reserve para ambientes isolados.
Shift+Tab alterna os modos durante a sessão, então você aperta o cerco ou solta a rédea conforme a confiança na tarefa.
O fecho do mapa
Entender o harness costura o resto do guide. O CLAUDE.md dá as instruções, as extensões dão as capacidades, os hooks dão as garantias — e o harness é o que envolve tudo isso ao redor do modelo, volta após volta do loop, com a camada de permissão decidindo o que passa. É a diferença entre um chatbot que responde e um agente que faz.