Modelo, harness e provider
Um agent de código não é só um modelo. É um modelo mais um harness (o programa que lhe dá ferramentas, contexto e regras) acessado por meio de um provider. A maior parte da confusão neste campo vem de misturar os três.
As três camadas
- Modelo: a rede neural que prevê o próximo passo (Claude, GPT, Gemini, DeepSeek, Qwen e outros). Lê texto de entrada e produz texto de saída, incluindo pedidos para chamar ferramentas.
- Harness: o programa em torno do modelo. Monta o prompt, dá ao modelo ferramentas (ler um arquivo, editar, executar um comando, buscar, chamar um servidor ), aplica permissões, gerencia o contexto e repete o loop até a tarefa terminar. Claude Code, OpenCode, e Codex CLI são harnesses.
- Provider: onde o modelo roda e como você chega até ele: a API do próprio fornecedor, uma nuvem (Bedrock, Vertex, Azure), um roteador (OpenRouter) ou a sua própria máquina (Ollama, llama.cpp, vLLM).
Por que o mesmo modelo parece diferente em duas ferramentas
O harness decide o que o modelo vê e o que ele pode fazer. Duas ferramentas com o mesmo modelo podem diferir muito em como editam arquivos (reescrita do arquivo inteiro versus edições pontuais), quanto do repositório carregam, se usam um language server para achar definições, como se recuperam de um comando que falhou e como comprimem uma conversa longa. Relatos de grandes diferenças de qualidade entre ferramentas com o mesmo modelo geralmente remontam a esses detalhes, não ao modelo.
O inverso também vale: um harness ajustado para uma família de modelos pode render menos com outra, porque prompts e formatos de ferramentas são adaptados aos hábitos de cada modelo.
O que um harness realmente faz
- Monta o contexto: system prompt, instruções do projeto (CLAUDE.md ou ), arquivos abertos, resultados de busca, histórico da conversa.
- Expõe ferramentas com um schema: ler, escrever, editar, shell, buscar, fetch e qualquer servidor MCP que você conectar.
- Aplica permissões: quais comandos rodam sem perguntar, quais caminhos são proibidos, se há sandbox.
- Executa o loop: o modelo propõe uma chamada de ferramenta, o harness a executa, o resultado volta ao modelo, e assim até terminar ou ser interrompido.
- Gerencia custo e contexto: cache, resumo de turnos antigos, troca para um modelo mais barato em passos pequenos.
Por que isso importa na hora de escolher
Escolha o harness pelo fluxo de trabalho (terminal ou IDE, modelo de permissões, trabalho paralelo, extensibilidade) e o modelo pelo trabalho (qualidade, velocidade, preço, privacidade). Harnesses que suportam vários providers permitem trocar de modelo sem reaprender a ferramenta; harnesses atrelados a um único fornecedor podem aprofundar mais a integração. Nenhum é melhor universalmente. Os próximos tópicos comparam as ferramentas comuns e os trade-offs de modelos.
conexões no mapa
- O espectro do vibecodingé construído a partir deModelo, harness e provider
- Modelo, harness e providerclassificaAgents de código comparados
- Modelo, harness e providersepara o modelo emEscolhendo um modelo: de fronteira, barato e aberto
atualizado em 14/10/2026 · fontes para aprofundar · reportar erro
Desbloqueia
teste o que entendeu
Carregando perguntas…