Edição Markdown

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 alteração limitada de um processo principal Opus a um subagente Haiku do projeto, verificar o modelo e o diff reais e interpretar a utilização sem presumir poupança.

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 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](https://code.claude.com/docs/en/model-config) 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](https://code.claude.com/docs/en/sub-agents) 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](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` 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](https://code.claude.com/docs/en/costs) 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](https://code.claude.com/docs/en/sub-agents) — 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](https://code.claude.com/docs/en/model-config) — 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](https://code.claude.com/docs/en/costs) — `/usage`: campos, estimativas e faturação por subscrição ou API. Não demonstra poupança nesta tarefa.
- [Anthropic, configurar permissões](https://code.claude.com/docs/en/permissions) — regras efetivas de permissão de ferramentas a examinar 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 para ficheiros de agente, metadados iniciais, precedência e sobreposições de modelos, leitura de /tasks, herança de permissões e comportamento de worktrees. Não verifica a tarefa não executada nem poupança.
- [Configuração de modelos — documentação do Claude Code](https://code.claude.com/docs/en/model-config) — Fonte principal para aliases e IDs atuais de Opus e Haiku na API da Anthropic, correspondências de outros fornecedores, versões mínimas e restrições availableModels geridas. O leitor deve verificar a resolução local real.
- [Gerir custos eficazmente — documentação do Claude Code](https://code.claude.com/docs/en/costs) — Explica campos de tokens e estimativas de sessão de /usage, atribuição local do plano, apresentações desatualizadas, faturação por subscrição ou API e o Console como autoridade de faturação. Não fornece fatura exata de um executor nem poupança medida da tarefa.
- [Configurar permissões — documentação do Claude Code](https://code.claude.com/docs/en/permissions) — Explica regras efetivas de permissão de shell e ficheiros para um executor que altera código. A lista de ferramentas de um subagente, por si só, não define limites de caminhos do sistema de ficheiros.