O Claude Code pode dar a um subagente do projeto um modelo e ferramentas próprios enquanto a conversa principal trata do planeamento e da revisão. Numa alteração autorizada do repositório, um processo principal Opus pode passar uma etapa limitada de implementação ao Haiku. O resultado útil é uma alteração de código verificada e um registo dos modelos executados. Uma definição de modelo mais barato, por si só, não demonstra poupança.

A grande mudança

  • O que mudou: Um ficheiro de agente do projeto pode pedir model: haiku para um executor de código com nome próprio enquanto a sessão principal usa Opus.
  • Porque importa: O processo principal pode rever uma tarefa menor, mas o programador continua a decidir se o diff cumpre a verificação de aceitação original.
  • A que deve prestar atenção: Substituições de modelo, políticas da organização, permissões, revisão e novas tentativas podem alterar o modelo real e a utilização total. Verifique antes de afirmar uma vantagem de custo.

Comece com uma tarefa sob a sua responsabilidade

Precisa de um repositório Git próprio, autorização para o alterar, acesso do Claude Code às duas famílias de modelos e uma alteração autorizada suficientemente pequena para avaliar pelo diff. Registe o commit inicial, os ficheiros ou comportamentos incluídos, o comando de aceitação existente e o significado de um resultado aprovado. Use uma cópia de trabalho limpa. O comando deve vir do projeto; este guia não pode fornecer um teste significativo para um repositório desconhecido.

Verifique claude --version, o fornecedor e o regime de faturação, bem como as restrições efetivas de modelos antes de começar. Na API da Anthropic, os aliases atuais opus e haiku correspondem a Opus 5.5 (claude-opus-5-5) e Haiku 5.5 (claude-haiku-5-5); esse par exige Claude Code v2.1.293 ou posterior. Outros fornecedores podem associar os mesmos aliases a gerações anteriores. A política availableModels de uma organização pode bloquear ou substituir uma escolha. Use /model na sessão principal e registe o modelo principal exato apresentado. Defina o orçamento autorizado e examine os controlos reais da conta ou do fornecedor; uma instrução ao modelo não garante um teto de despesa. A configuração de modelos da Anthropic documenta as correspondências e restrições atuais.

1. Defina um executor Haiku do projeto

Crie no projeto um ficheiro com nome único, como .claude/agents/bounded-code-worker.md, reveja-o e depois inicie o processo principal Opus com claude --model opus ou selecione Opus através de /model. Este exemplo define um executor, não uma tarefa de teste:

Markdown
---
name: bounded-code-worker
description: Implements one explicitly bounded, authorized repository change and reports the diff and checks for parent review.
model: haiku
tools: Read, Glob, Grep, Edit, Bash
permissionMode: default
---

Acrescente esta instrução de sistema em linguagem corrente imediatamente após o --- de fecho no ficheiro do agente: Implemente apenas a tarefa e o âmbito de ficheiros transmitidos pelo processo principal. Antes de editar, examine o código relevante e a verificação de aceitação indicada. Se faltar a tarefa, a autorização ou uma entrada necessária, pare e indique a lacuna. Faça a menor alteração pertinente. Execute a verificação original quando permitido; comunique o comando exato e o resultado. Devolva os ficheiros alterados, a finalidade do diff, as falhas restantes e o trabalho não verificado. Não faça commits, publique, implemente em produção nem amplie a tarefa sem autorização explícita.

A lista tools disponibiliza ferramentas; não limita leituras ou comandos de shell aos caminhos indicados. Antes de delegar, verifique as permissões efetivas do projeto e da organização, sobretudo o acesso ao shell. Mantenha o processo principal no modo Manual/default neste procedimento: a Anthropic documenta que um processo principal em acceptEdits, auto ou bypassPermissions substitui a definição permissionMode do executor. Se este for o primeiro ficheiro de um diretório de agentes novo e o agente não aparecer, reinicie o Claude Code. O manual de subagentes descreve estes controlos.

A opção isolation: worktree dá ao executor uma cópia de trabalho separada. O ponto inicial documentado é o ramo predefinido do repositório, que pode diferir do commit atual do processo principal. Compare essa revisão inicial com a base registada da tarefa antes de usar ou comparar as alterações. Continua a ser necessária uma cópia limpa e autorizada para a verificação de aceitação original.

2. Delegue, examine e depois aceite ou rejeite

Dê ao processo principal uma instrução ligada à tarefa real, com os seus limites de ficheiros e comando de verificação:

Planeie brevemente esta alteração autorizada. Delegue apenas a implementação indicada a bounded-code-worker. Mantenha consigo os critérios de aceitação originais e a revisão final. Quando o executor regressar, mostre-me o diff exato e o resultado da verificação. Não aceite nem amplie a alteração antes da minha revisão.

Enquanto o executor trabalha, abra /tasks e registe o modelo apresentado na sua linha. Essa é a verificação em execução; a palavra haiku num ficheiro de agente ou numa instrução é apenas um pedido. Claude Code v2.1.242 ou posterior mostra ali o modelo em execução. Uma tarefa de segundo plano concluída permanece em /tasks durante cerca de 30 segundos; examine-a rapidamente e guarde a transcrição. Se perder a linha, marque a verificação do modelo como incompleta, sem o inferir a partir do ficheiro.

Leia o diff real, examine cada ficheiro alterado e execute pessoalmente o comando de aceitação original na sua cópia de trabalho. Acrescente verificações específicas quando a alteração o justificar. Aceite apenas se comportamento, âmbito e verificações corresponderem à tarefa. Se o executor parar cedo ou devolver trabalho parcial, examine o que mudou antes de continuar ou reparar. Se usou um worktree separado, reveja as alterações antes de as incorporar na cópia principal.

Para outra abordagem à verificação de uma falha do repositório com um assistente de IA, consulte o nosso guia de reparação e verificação com AI Goal. Esse fluxo não configura a delegação de Opus para Haiku usada aqui.

Se /tasks apresentar outro modelo ou um aviso de substituição, verifique o argumento de modelo da chamada, os metadados iniciais do agente, CLAUDE_CODE_SUBAGENT_MODEL e a lista de modelos gerida. No Claude Code atual, o modelo da chamada tem precedência sobre os metadados, depois o valor predefinido do ambiente e depois o modelo principal; antes da v2.1.251, a configuração do ambiente tinha precedência. CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 (v2.1.257+) pode sobrepor a definição, e o hook agent.spawn de um mod instalado pode substituir o modelo da chamada. Corrija a origem real da sobreposição ou pare a execução. Não apresente como Haiku um resultado de outro modelo.

3. Registe a utilização sem inventar poupança

Recolha leituras de /usage antes e depois desta sessão controlada. Registe por modelo tokens de entrada, saída e cache, estimativa de custo apresentada, fornecedor ou plano, diff aceite, resultado da verificação original e revisão ou retrabalho necessário. O bloco Session agrega toda a sessão por modelo; não é uma fatura exata deste executor com nome próprio. As percentagens de atribuição do plano são um histórico local aproximado diário ou semanal, não uma medição desta tarefa. Para uma conta API, o Claude Console é a fonte oficial de faturação. Numa subscrição, a estimativa em dólares da sessão não é uma fatura adicional. Identifique como desatualizada uma apresentação do último estado conhecido de utilização.

Para afirmar que a delegação poupou dinheiro nesta tarefa, compare-a com uma execução de modelo único autorizada separadamente, desde a mesma revisão inicial limpa e com a mesma tarefa e critérios. Conte planeamento e revisão do processo principal, chamadas do executor, novas tentativas e retrabalho; compare apenas resultados aceites. Um par de execuções continua a ser uma observação específica da tarefa. Sem essa referência, apresente o percurso de modelos verificado e o resultado do código; a poupança é desconhecida. O guia de custos da Anthropic explica a apresentação da utilização e as limitações da faturação.

Este procedimento baseia-se na documentação atual, não numa execução do Claude Code pela BIG CHANGE nem numa tarefa medida. Não envie código ou segredos que a organização não tenha autorizado para o fornecedor configurado. Este percurso usa a seleção nativa de Opus e Haiku do Claude Code; outro fornecedor exigiria um gateway ou fluxo de orquestração especificado separadamente e verificações próprias.

Fontes e leituras adicionais

  • Anthropic, criar subagentes personalizados — ficheiros de agente do projeto, precedência de modelos, /tasks, permissões e comportamento dos worktrees. Manual atual consultado em 20 de outubro de 2026; documenta a funcionalidade, não o resultado do exemplo não executado deste guia.
  • Anthropic, configuração de modelos — aliases atuais, diferenças entre fornecedores, requisitos de versão e controlos de modelos geridos. Confirme a versão instalada e o fornecedor ao utilizar.
  • Anthropic, gerir custos eficazmente — /usage: campos, estimativas e faturação por subscrição ou API. Não demonstra poupança nesta tarefa.
  • Anthropic, configurar permissões — regras efetivas de permissão de ferramentas a examinar antes de executar um agente que altera código.