O Claude Code é um harness: CLAUDE.md, hooks, MCP, subagents e permissões são os guides e sensors que ficam em volta do modelo. A Anthropic descreve o impacto do "harness design" em agentes de código de execução longa (março de 2026). A formulação explícita "Claude Code é o harness, o Claude é o modelo dentro dele" é de terceiros (MindStudio, WaveSpeed), não da Anthropic.
Claude Code já vem com as peças de um harness
O Claude Code já chega com as peças de um harness. CLAUDE.md guarda instruções persistentes que o Claude lê no início de cada sessão. Hooks são comandos shell que rodam sozinhos em pontos específicos do ciclo de vida. MCP conecta a centenas de ferramentas e fontes de dados externas. Subagents rodam em context windows separados, cada um com system prompt, acesso a ferramentas e permissões próprios. E as permissões são em níveis: o plan mode, por exemplo, só lê arquivo e roda comando de leitura. Isso encaixa direto na taxonomia de Birgitta Böckeler (Thoughtworks, 2 de abril de 2026): guides antecipam e direcionam o agente antes de ele agir; sensors observam depois e ajudam a se auto-corrigir.
Uma ressalva de atribuição (e um ponto prático)
Uma ressalva de atribuição, porque a distinção importa. A Anthropic não chama o Claude Code de "um harness" com essas palavras. Ela fala em "harness design" e diz que isso tem impacto substancial na eficácia de agentes de código de execução longa (março de 2026). A frase explícita "Claude Code é o harness, o Claude é o modelo dentro dele" vem de terceiros (MindStudio, WaveSpeed), não da Anthropic. E tem um ponto prático nisso: você não ganha um harness pronto. Você recebe primitivos e engenheira o harness configurando eles. O jeito de engenheirar é o loop do Hashimoto: cada vez que o agente erra, você escreve uma regra permanente no CLAUDE.md, em vez de corrigir na mão.
Recurso por recurso: guide ou sensor
| Recurso do Claude Code | Guide ou sensor | O que faz |
|---|---|---|
| CLAUDE.md | Guide (feedforward) | Instruções persistentes que o Claude lê no início de cada sessão |
| Hooks | Sensor (e gate) | Comandos shell definidos pelo usuário que rodam automaticamente em pontos do ciclo de vida |
| MCP | Guide | Conecta a centenas de ferramentas e fontes de dados externas |
| Subagents | Guide | Cada um roda no próprio context window, com system prompt, ferramentas e permissões próprios |
| Permissões | Guide (gate) | Níveis de permissão; o plan mode só lê arquivos e roda comandos de leitura |
capivaOS: um harness engenheirado sobre o Claude Code
Dá pra ver o padrão num exemplo concreto. O capivaOS é um harness engenheirado em cima do Claude Code: um pipeline de desenvolvimento spec-first e test-enforced, com máquina de estados, instalado como plugin (segundo o README). Ele não substitui o Claude Code. Ele pega os primitivos (CLAUDE.md, hooks, subagents, permissões) e amarra num fluxo disciplinado, com fases, artefatos e gates. É isso que harness engineering permite: engenheirar um harness como uma camada sobre outro.
O harness de código é a parte visível
O harness de código é a parte visível. Claude Code, Cursor, agentes que leem repositório e rodam teste. Configurar bem esses primitivos já muda o resultado. Mas a parte maior, e onde quase ninguém está engenheirando com disciplina, é o harness operacional: o mesmo padrão de guides e sensors aplicado à operação de um negócio inteiro, IA além do código. A camada de código a gente resolve com o capivaOS, o harness open-source sobre o Claude Code. Se você quer entender o conceito antes dos recursos, comece por O que é um AI Harness.
Perguntas frequentes
O Claude Code é um harness?▼
Funciona como um. Os recursos dele encaixam no modelo de guides e sensors: CLAUDE.md, hooks, MCP, subagents e permissões são a camada em volta do modelo. A Anthropic trata isso como "harness design" (março de 2026); a formulação explícita "Claude Code é o harness" é de terceiros (MindStudio, WaveSpeed), não da Anthropic.
Quais recursos do Claude Code formam o harness?▼
CLAUDE.md (instruções persistentes lidas a cada sessão), hooks (comandos shell em pontos do ciclo de vida), MCP (conexão com ferramentas e dados externos), subagents (context windows isolados, com prompt e permissões próprios) e permissões em níveis. Juntos, são os guides e sensors em volta do modelo.
O CLAUDE.md é um guide ou um sensor?▼
Um guide. Na taxonomia de Böckeler (Thoughtworks, 2 de abril de 2026), guides são feedforward: antecipam e direcionam o agente antes de ele agir. O CLAUDE.md guarda instruções persistentes que o Claude lê no início de cada sessão, então ele direciona o comportamento na largada, não depois.
Como os hooks funcionam como sensors?▼
Hooks são comandos shell definidos pelo usuário que rodam automaticamente em pontos do ciclo de vida do Claude Code. Ligue eles pra rodar testes, linters ou typecheck depois de uma edição e eles viram sensors: feedback legível pelo agente, que o modelo pode usar. Também dá pra usar como gate: um hook que falha pode barrar a ação.
O que é o capivaOS e como ele se relaciona com o Claude Code?▼
O capivaOS é um harness open-source engenheirado sobre o Claude Code: um pipeline de desenvolvimento spec-first e test-enforced, com máquina de estados, instalado como plugin (segundo o README). Ele não substitui o Claude Code. Ele transforma os primitivos num fluxo disciplinado, com fases, artefatos e gates.
Como engenheirar meu próprio harness sobre o Claude Code?▼
Comece pelas regras no CLAUDE.md, adicione hooks como sensors (testes e linters que o agente lê), conecte ferramentas via MCP, isole trabalho em subagents e use as permissões como gates. Depois rode o loop erro para regra do Hashimoto: cada vez que o agente erra, escreva uma regra permanente em vez de corrigir na mão.
O Claude Code te dá as peças. O harness que decide se o agente funciona, você engenheira.