AI-translated from English; not yet reviewed by a fluent editor.

# Delegue uma tarefa de código do Claude Code de Opus para Haiku e verifique o resultado

> Um fluxo documentado do Claude Code para passar uma mudança limitada de um processo principal Opus a um subagente Haiku do projeto, verificar o modelo e o diff reais e interpretar o uso sem presumir economia.

By BIG CHANGE Editorial

Published: 2026-10-20T10:17:38.691Z
Updated: 2026-10-20T10:17:38.691Z
Canonical: https://bigchange.ai/blog/claude-code-opus-haiku-subagent-coding-guide

![Conceptual charcoal illustration of a reviewer using a laptop trackpad beside a generic two-column code diff with one orange changed section.](https://bigchange.ai/api/media/file/opus-haiku-diff-review-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

O Claude Code pode dar a um subagente do projeto seu próprio modelo e ferramentas enquanto a conversa principal cuida do planejamento e da revisão. Para uma alteração autorizada no repositório, isso permite que um processo principal Opus passe uma etapa limitada de implementação ao Haiku. O resultado útil é uma mudança de código verificada e um registro dos modelos executados. Só configurar um modelo mais barato não comprova economia.

## A grande mudança

- **O que mudou:** Um arquivo de agente do projeto pode solicitar `model: haiku` para um executor de código nomeado enquanto a sessão principal usa Opus.
- **Por que importa:** O processo principal pode revisar uma tarefa menor, mas o desenvolvedor continua decidindo se o diff atende à verificação de aceitação original.
- **O que observar:** Substituições de modelo, políticas da organização, permissões, revisão e novas tentativas podem mudar o modelo real e o uso total. Verifique antes de afirmar uma vantagem de custo.

## Comece com uma tarefa sob sua responsabilidade

Você precisa de um repositório Git próprio, permissão para modificá-lo, acesso do Claude Code às duas famílias de modelos e uma mudança autorizada pequena o bastante para avaliar pelo diff. Anote o commit inicial, os arquivos ou comportamentos no escopo, o comando de aceitação existente e o que significa passar. Use uma cópia de trabalho limpa. O comando deve vir do seu projeto; este guia não pode fornecer um teste significativo para um repositório desconhecido.

Confira `claude --version`, seu provedor e a forma de cobrança, além das 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`); essa combinação exige Claude Code v2.1.293 ou posterior. Outros provedores podem mapear os mesmos aliases para gerações anteriores. A política `availableModels` de uma organização pode bloquear ou substituir uma escolha. Use `/model` na sessão principal e registre o modelo principal exato exibido. Defina o orçamento autorizado e examine os controles reais da conta ou do provedor; um pedido ao modelo não garante um teto de gastos. [A configuração de modelos da Anthropic](https://code.claude.com/docs/en/model-config) documenta os mapeamentos e as restrições atuais.

## 1. Defina um executor Haiku do projeto

Crie no projeto um arquivo com nome exclusivo, como `.claude/agents/bounded-code-worker.md`, revise-o e inicie o processo principal Opus com `claude --model opus` ou selecione Opus usando `/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 comum logo após o `---` de fechamento no arquivo do agente: Implemente apenas a tarefa e o escopo de arquivos passados pelo processo principal. Antes de editar, examine o código relevante e a verificação de aceitação indicada. Se faltar tarefa, permissão ou entrada necessária, pare e informe a lacuna. Faça a menor mudança pertinente. Execute a verificação original quando permitido; informe o comando exato e o resultado. Devolva os arquivos alterados, a finalidade do diff, as falhas restantes e o trabalho que não pôde verificar. Não faça commit, publique, implante nem amplie a tarefa sem autorização explícita.

A lista `tools` disponibiliza ferramentas; ela **não** limita leituras ou comandos de shell aos caminhos indicados. Confira as permissões efetivas do projeto e da organização, especialmente o acesso ao shell, antes de delegar. Mantenha o processo principal no modo Manual/default neste procedimento: a Anthropic documenta que um processo principal em `acceptEdits`, `auto` ou `bypassPermissions` substitui a configuração `permissionMode` do executor. Se esse for o primeiro arquivo de um diretório de agentes recém-criado e o agente não aparecer, reinicie o Claude Code. [O manual de subagentes](https://code.claude.com/docs/en/sub-agents) descreve esses controles.

A opção `isolation: worktree` fornece ao executor uma cópia de trabalho separada. O ponto inicial documentado é a branch padrão do repositório, que pode ser diferente do commit atual do processo principal. Compare essa revisão inicial com a base registrada da tarefa antes de usar ou comparar as mudanças. Uma cópia limpa e autorizada continua necessária 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 seu próprio limite de arquivos e comando de verificação:

> Planeje brevemente esta mudança autorizada. Delegue somente a implementação especificada a `bounded-code-worker`. Mantenha os critérios de aceitação originais e a revisão final com você. Quando o executor retornar, mostre o diff exato e o resultado da verificação. Não aceite nem amplie a mudança antes da minha revisão.

Enquanto o executor roda, abra `/tasks` e registre o modelo mostrado na linha dele. Essa é a verificação em execução; a palavra `haiku` em um arquivo de agente ou 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` por cerca de 30 segundos; confira logo e preserve a transcrição. Se perder a linha, marque a verificação de modelo como incompleta em vez de inferi-lo pelo arquivo.

Leia o diff real, examine cada arquivo alterado e execute pessoalmente o comando de aceitação **original** na cópia de trabalho própria. Acrescente verificações direcionadas quando a mudança justificar. Aceite somente se comportamento, escopo 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, revise as mudanças antes de incorporá-las à cópia principal.

Para outra abordagem de verificação de uma falha no repositório com assistente de IA, veja nosso [guia de reparo e verificação com AI Goal](https://bigchange.ai/blog/ai-goal-failing-repository-check-guide). Esse fluxo não configura a delegação de Opus para Haiku usada aqui.

Se `/tasks` mostrar outro modelo ou um aviso de substituição, confira o argumento de modelo da chamada, os metadados iniciais do agente, `CLAUDE_CODE_SUBAGENT_MODEL` e a lista de modelos gerenciada. No Claude Code atual, o modelo da chamada tem prioridade sobre os metadados, depois o padrão do ambiente e depois o modelo principal; antes da v2.1.251, a configuração do ambiente tinha prioridade. `CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1` (v2.1.257+) pode sobrescrever a definição, e o hook `agent.spawn` de um mod instalado pode substituir o modelo da chamada. Corrija a origem real da substituição ou pare a execução. Não identifique como Haiku um resultado de outro modelo.

## 3. Registre o uso sem inventar economia

Faça leituras de `/usage` antes e depois desta sessão controlada. Registre por modelo tokens de entrada, saída e cache, estimativa de custo exibida, provedor ou plano, diff aceito, resultado da verificação original e revisão ou retrabalho necessário. O bloco Session agrega a sessão inteira por modelo; não é uma fatura exata desse executor nomeado. Percentuais de atribuição do plano são um histórico local aproximado do dia ou da semana, não uma medição desta tarefa. Para conta API, o Claude Console é a fonte oficial de cobrança. Em uma assinatura, a estimativa em dólares da sessão não é uma cobrança adicional. Marque como desatualizada uma exibição que mostra o último uso conhecido.

Para afirmar que a delegação economizou dinheiro **nesta** tarefa, compare com uma execução de modelo único autorizada separadamente, a partir da mesma revisão inicial limpa, com a mesma tarefa e critérios. Conte planejamento e revisão do processo principal, chamadas do executor, novas tentativas e retrabalho; compare apenas resultados aceitos. Um par de execuções continua sendo uma observação específica da tarefa. Sem essa base, informe a rota de modelos verificada e o resultado de código; a economia é desconhecida. [O guia de custos da Anthropic](https://code.claude.com/docs/en/costs) explica a exibição de uso e os limites da cobrança.

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

## Fontes e leituras adicionais

- [Anthropic, criar subagentes personalizados](https://code.claude.com/docs/en/sub-agents) — arquivos de agente do projeto, prioridade de modelos, `/tasks`, permissões e comportamento de worktrees. Manual atual consultado em 20 de outubro de 2026; documenta a função, não o resultado do exemplo não executado deste guia.
- [Anthropic, configuração de modelos](https://code.claude.com/docs/en/model-config) — aliases atuais, diferenças de provedores, versões necessárias e controles de modelos gerenciados. Confirme versão instalada e provedor ao usar.
- [Anthropic, gerenciar custos com eficiência](https://code.claude.com/docs/en/costs) — `/usage`: campos, estimativas e cobrança por assinatura ou API. Não comprova economia nesta tarefa.
- [Anthropic, configurar permissões](https://code.claude.com/docs/en/permissions) — regras efetivas de permissão de ferramentas que exigem exame antes de executar um agente que altera código.

## Sources

- [Criar subagentes personalizados — documentação do Claude Code](https://code.claude.com/docs/en/sub-agents) — Manual principal do produto sobre arquivos de agente, metadados iniciais, prioridade e substituições de modelos, leitura de /tasks, herança de permissões e worktrees. Não verifica a tarefa não executada nem economia.
- [Configuração de modelos — documentação do Claude Code](https://code.claude.com/docs/en/model-config) — Fonte principal dos aliases e IDs atuais de Opus e Haiku na API da Anthropic, mapeamentos de outros provedores, versões mínimas e restrições availableModels gerenciadas. O leitor deve conferir a resolução local real.
- [Gerenciar custos com eficiência — documentação do Claude Code](https://code.claude.com/docs/en/costs) — Explica tokens de sessão e estimativas de /usage, atribuição local do plano, exibições desatualizadas, cobrança por assinatura ou API e o Console como autoridade de cobrança. Não fornece fatura exata de um executor nomeado nem economia medida da tarefa.
- [Configurar permissões — documentação do Claude Code](https://code.claude.com/docs/en/permissions) — Explica permissões efetivas de shell e arquivos para um executor que altera código. Uma lista de ferramentas de subagente, sozinha, não delimita caminhos do sistema de arquivos.