10 novos recursos que os desenvolvedores precisam saber

1. Subagentes aninhados com profundidade de 3 níveis

Como funciona a decomposição de tarefas em camadas

Claude Code agora oferece suporte à geração hierárquica de agentes, onde um agente pai pode criar agentes filhos, e cada filho pode gerar seus próprios filhos, com até três níveis de profundidade. Essa arquitetura permite a decomposição de tarefas em camadas para operações que abrangem vários módulos ou arquivos. Um agente de nível superior que lida com uma grande migração de base de código, por exemplo, pode delegar a agentes de nível de módulo, que por sua vez delegam a agentes de nível de função para reescritas direcionadas. Você pode atribuir a cada agente na árvore uma função, um modelo e um conjunto de restrições distintos, e cada um opera com sua própria janela de contexto.

Configuração e implementação

Defina a hierarquia em .claude/agents.yaml:

max_depth: 3
agents:
  - agent_role: migration_coordinator
    description: "Top-level agent for Python 2 to 3 migration"
    model: claude-sonnet-4
    delegate_to:
      - agent_role: module_migrator
        description: "Handles per-module migration tasks"
        model: claude-sonnet-4
        delegate_to:
          - agent_role: function_refactorer
            description: "Rewrites individual functions for Python 3 compatibility"
            model: claude-haiku

Invoque o agente de nível superior e observe a cadeia de delegação em tempo real:

claude agent run migration_coordinator --verbose-agents

O --verbose-agents flag gera cada vez que um agente delega para outro, incluindo qual agente filho ele gerou, qual função ele atribuiu e o fragmento de tarefa que recebeu. Isso é essencial para depurar hierarquias onde falhas em níveis inferiores podem ser difíceis de rastrear sem visibilidade estruturada.

Você pode atribuir a cada agente na árvore uma função, um modelo e um conjunto de restrições distintos, e cada um opera com sua própria janela de contexto.

2. Configuração do modelo substituto

Configurando cadeias de fallback de modelo

Limites de taxa, interrupções transitórias do modelo e gerenciamento de custos criam cenários em que uma única meta de modelo é insuficiente. O fallbackModel a configuração resolve isso permitindo uma lista ordenada de modelos que o Código Claude tenta sequencialmente. Se o modelo primário retornar um erro de limite de taxa ou estiver indisponível, o Claude Code tenta automaticamente o próximo modelo na cadeia.

Configuração prática

Salve o seguinte como .claude/settings.json:

{
  "model": "claude-sonnet-4",
  "fallbackModel": (
    {
      "model": "claude-haiku",
      "maxTokens": 4096,
      "costCeiling": 0.25
    },
    {
      "model": "local/codellama-34b",
      "maxTokens": 4096,
      "costCeiling": 0.00,
      "timeoutSeconds": 30
    }
  )
}

O fallbackModel array deve listar apenas alternativa modelos. Não repita o modelo primário como uma entrada de reserva, uma vez que um modelo que já falhou devido a um limite de taxa ou a uma interrupção não terá sucesso na nova tentativa imediata. Cada entrada suporta por modelo maxTokens e costCeiling parâmetros, fornecendo limites por modelo no tamanho da produção e nos gastos à medida que o sistema avança na cadeia. O costCeiling O parâmetro define o gasto máximo (como um valor numérico em dólares) permitido nesse modelo antes de avançar para o próximo substituto. A opção do modelo local com teto de custo zero serve como alternativa de último recurso que garante a disponibilidade.

Suporte ao modelo local: O local/ prefixo requer um servidor de inferência local em execução (por exemplo, Ollama). Configure o endpoint nas configurações do Claude Code antes de usar local/-modelos prefixados. Sem um servidor de inferência em execução, esta entrada alternativa falhará.

Ferramentas de navegação, instalação e publicação

Pule esta seção se sua organização restringir a instalação de ferramentas de terceiros. Para todos os outros: o mercado é um registro de ferramentas Claude Code contribuídas pela comunidade, incluindo linters, formatadores, comandos de barra personalizados e utilitários especializados de refatoração. Opera através da CLI:

claude marketplace search "react"



claude marketplace install @community/react-refactor


claude marketplace publish

⚠️ Aviso de segurança: Verifique suas credenciais de autenticação antes de publicar (claude auth status). As ferramentas publicadas na comunidade não são revisadas ou garantidas pela Anthropic. Antes de instalar ferramentas comunitárias, revise a fonte e as permissões da ferramenta. Tenha o mesmo cuidado que você teria com qualquer pacote de terceiros de um registro público.

O publish O comando percorre um fluxo guiado que empacota a definição da ferramenta, valida seu manifesto e o envia ao registro. Você pode invocar ferramentas instaladas como comandos de barra ou ferramentas que podem ser chamadas pelo agente no projeto atual.

4. Atribuição de uso e rastreamento de custos

Detalhamento dos custos por agente e por tarefa

O novo --attribution sinalizador gera um detalhado .claude/attribution.json arquivo após cada sessão, detalhando o uso do token, custo e seleção de modelo por subagente, tarefa e carimbo de data/hora. Para equipes que cobram o uso de IA para projetos ou clientes específicos, isso fornece a granularidade necessária para estornos precisos.

Lendo relatórios de atribuição

O seguinte é um exemplo ilustrativo. Os valores de custo reais variarão com base nos preços atuais da Antrópico para cada nível de modelo:

{
  "schema_version": "1.0",
  "session_id": "ses_550e8400-e29b-41d4-a716-446655440000",
  "total_cost": 0.87,
  "total_tokens": 142350,
  "agents": (
    {
      "agent_role": "migration_coordinator",
      "model": "claude-sonnet-4",
      "tokens_in": 12000,
      "tokens_out": 4500,
      "cost": 0.12,
      "timestamp": "2026-06-18T14:22:01Z",
      "tasks": ("coordinate migration plan")
    },
    {
      "agent_role": "module_migrator",
      "model": "claude-sonnet-4",
      "tokens_in": 85000,
      "tokens_out": 32000,
      "cost": 0.63,
      "timestamp": "2026-06-18T14:23:15Z",
      "tasks": ("migrate auth module", "migrate payments module")
    },
    {
      "agent_role": "function_refactorer",
      "model": "claude-haiku",
      "tokens_in": 6500,
      "tokens_out": 2350,
      "cost": 0.12,
      "timestamp": "2026-06-18T14:25:44Z",
      "tasks": ("refactor parse_token()", "refactor validate_session()")
    }
  )
}

Tokens de prompt (tokens_in) e tokens de conclusão (tokens_out) são rastreados separadamente, o que é importante porque os preços diferem entre os dois. Cada tasks array vincula os custos a unidades de trabalho específicas, para que você possa identificar uma subtarefa que consumiu, digamos, mais da metade do custo total da sessão e investigar o motivo. Os valores de custo são armazenados como tipos numéricos (por exemplo, 0.87) para consumo programático direto sem análise de string.

5. Permissões com escopo definido para subagentes

Princípio do menor privilégio em árvores de agentes

Agora você pode restringir agentes filhos a diretórios, ferramentas e recursos de gravação específicos. Isso evita que um agente de refatoração em nível de função modifique acidentalmente arquivos de configuração ou invoque ferramentas destrutivas fora do escopo pretendido.

- agent_role: function_refactorer
  model: claude-haiku
  permissions:
    allow_paths:
      - "${PROJECT_ROOT}/src/utils"
    deny_tools:
      - shell_execute
      - file_delete
    can_write: true

O allow_paths campo restringe o acesso do agente ao sistema de arquivos. Usar ${PROJECT_ROOT} para ancorar caminhos para a raiz do projeto (o diretório que contém .claude/), garantindo que os caminhos sejam resolvidos para locais canônicos absolutos e não possam escapar do escopo pretendido por meio de .. segmentos ou links simbólicos. O deny_tools array bloqueia explicitamente ferramentas específicas, mesmo que estejam disponíveis globalmente. Os nomes das ferramentas devem corresponder aos identificadores listados em claude tools list. Contexto can_write: false cria um agente somente leitura útil para tarefas de análise ou revisão.

⚠️ Cuidado: Subagentes com can_write: true e amplo allow_paths valores podem modificar arquivos em todo o seu escopo permitido. Defina os caminhos o mais restrito possível, especialmente em configurações onde os agentes operam em vários repositórios.

6. Registros do agente de streaming

Recurso beta. O comportamento e o esquema podem mudar em versões futuras. Não recomendado para pipelines de produção sem fixar sua versão CLI.

Canalize logs JSON estruturados em tempo real de todos os subagentes ativos para painéis de monitoramento, sistemas CI/CD ou plataformas de agregação de log usando o --stream-logs bandeira.

(Requer jq: brew install jq / apt install jq)

claude agent run migration_coordinator --stream-logs \
  | jq 'select((.agent_level | tonumber) 

Cada linha de log é um objeto JSON contendo campos para agent_role, agent_level, status, messagee timestamp. O jq filtro acima usa tonumber coagir com segurança agent_level (que pode ser emitido como uma string) antes da comparação e restringe a saída aos erros dos dois níveis superiores da árvore do agente. Isso é útil para revelar falhas críticas sem se afogar na saída detalhada dos agentes folha.

7. Ponto de verificação e currículo do agente

Recurso beta. O comportamento e o esquema podem mudar em versões futuras. Não recomendado para pipelines de produção sem fixar sua versão CLI.

Salvando e restaurando o estado do agente no meio da tarefa

Este recurso é diferente da persistência de sessão. A persistência da sessão salva o histórico da conversa. O ponto de verificação do agente também salva todo o estado da árvore do agente, incluindo o progresso de cada subagente, saídas intermediárias e fila de tarefas pendentes. Isso permite que uma migração de várias horas seja pausada e retomada sem reiniciar do zero.

claude checkpoint save migration-v2



claude checkpoint resume migration-v2

O ponto de verificação inclui a fila de tarefas pendentes, portanto as sessões retomadas continuam exatamente de onde pararam, em vez de reavaliar o trabalho concluído.

Importante: Se os arquivos modificados pela árvore do agente tiverem sido alterados externamente desde que o ponto de verificação foi salvo, revise as diferenças antes de continuar para evitar conflitos com o estado intermediário obsoleto. Os arquivos de checkpoint podem conter saídas intermediárias confidenciais (fragmentos de código, contexto de token). Adicione o diretório de armazenamento do ponto de verificação ao .gitignore e restringir permissões de diretório (por exemplo, chmod 700) para evitar confirmar ou expor esses dados.

8. Orçamentos de custos embutidos por agente

Limites de dólares ou tokens podem ser definidos para subagentes individuais para evitar custos excessivos. Quando um orçamento é excedido, o agente para e reporta um erro ao seu pai.

- agent_role: function_refactorer
  model: claude-haiku
  budget:
    max_cost: 0.50
    max_tokens: 50000

Quando excedido, a saída lê: Error: Agent 'function_refactorer' exceeded budget. Used $0.51 of $0.50 limit. Escalating to parent agent. O agente pai pode então decidir se alocará orçamento adicional, reatribuirá a tarefa ou cancelará. O max_cost value é um valor numérico simples em dólares (não uma string). Usar 0.50 em vez de "$0.50" para garantir que a CLI aplique corretamente o limite orçamentário.

9. Modelos de agente personalizados

Você pode predefinir configurações de agentes reutilizáveis ​​como modelos, encapsulando função, modelo, permissões e orçamento em um único arquivo invocável por nome. Os modelos são armazenados em um templates/ diretório na raiz do projeto e o templates_dir digite agents.yaml deve apontar para este diretório para --template para resolver corretamente. Usar ${PROJECT_ROOT}/templates para garantir a resolução correta, independentemente do diretório de trabalho.

agent_role: code_reviewer
description: "Reviews code for style, bugs, and security issues"
model: claude-sonnet-4
permissions:
  can_write: false
  deny_tools:
    - shell_execute
budget:
  max_cost: 0.25
  max_tokens: 30000

Execute a partir da raiz do projeto onde templates/ existe. O --template flag aceita o nome do arquivo base sem extensão:

claude agent run --template code-reviewer

Isso resolve ./templates/code-reviewer.yaml. Os modelos padronizam o comportamento dos agentes entre equipes e projetos, evitando inconsistências, como limites de orçamento ou escopos de permissão incompatíveis quando vários desenvolvedores definem agentes semelhantes de forma independente.

10. Orquestração Multi-Repo

Recurso beta. O comportamento e o esquema podem mudar em versões futuras. Não recomendado para pipelines de produção sem fixar sua versão CLI.

Os subagentes agora podem operar em vários repositórios locais em uma única sessão. Isso permite tarefas entre repositórios, como atualizações de dependências sincronizadas, validação de contrato de API ou alterações de versão coordenadas.

agents:
  - agent_role: dependency_updater
    model: claude-sonnet-4
    repos:
      - "${PROJECT_ROOT}/../frontend-app"
      - "${PROJECT_ROOT}/../backend-api"
      - "${PROJECT_ROOT}/../shared-libs"
    tasks:
      - "Update axios to 1.8.0 across all repos and fix breaking changes"

O repos array aceita ${PROJECT_ROOT}-caminhos relativos para diretórios irmãos. Todos os repositórios listados devem existir nos caminhos especificados antes da invocação; caminhos ausentes causarão um erro. Cada subagente obtém acesso ao sistema de arquivos com escopo definido para os repositórios listados, e o agente pai pode coordenar alterações que abrangem os limites do repositório.

⚠️ Cuidado: Agentes multi-repo com acesso de gravação podem modificar arquivos em todos os repositórios listados simultaneamente. Teste cópias ou ramificações de seus repositórios antes de executar operações destrutivas ou em grande escala.

Juntando tudo: referência completa de configuração

Uma configuração combinada usando todos os 10 recursos:

Salve o seguinte como .claude/settings.json:

{
  "model": "claude-sonnet-4",
  "fallbackModel": (
    {
      "model": "claude-haiku",
      "maxTokens": 4096,
      "costCeiling": 0.25
    }
  )
}

max_depth: 3
templates_dir: "${PROJECT_ROOT}/templates"
agents:
  - agent_role: migration_coordinator
    model: claude-sonnet-4
    budget:
      max_cost: 5.00
      max_tokens: 500000
    repos:
      - "${PROJECT_ROOT}/../backend-api"
      - "${PROJECT_ROOT}/../shared-libs"
    delegate_to:
      - agent_role: module_migrator
        model: claude-sonnet-4
        budget:
          max_cost: 2.00
          max_tokens: 200000
        permissions:
          allow_paths:
            - "${PROJECT_ROOT}/src"
          deny_tools:
            - file_delete
          can_write: true
        delegate_to:
          - agent_role: function_refactorer
            model: claude-haiku
            budget:
              max_cost: 0.50
              max_tokens: 50000
            permissions:
              allow_paths:
                - "${PROJECT_ROOT}/src/utils"
              deny_tools:
                - shell_execute
                - file_delete
              can_write: true

Os desenvolvedores individuais devem começar com modelos alternativos e orçamentos de custos, que fornecem valor imediato sem sobrecarga organizacional. As equipes devem priorizar primeiro a atribuição de uso e as permissões com escopo e, em seguida, adicionar modelos e orquestração de vários repositórios à medida que a complexidade do fluxo de trabalho aumenta.

Resumo e o que vem a seguir

Os recursos do Código Claude 10 de junho de 2026 são abordados aqui:

• Subagentes aninhados com profundidade de até 3 níveis para decomposição de tarefas em camadas
• modelo substituto configuração para cadeias de modelos resilientes
• Mercado de ferramentas comunitárias para descobrir e compartilhar ferramentas
• Atribuição de uso com detalhamentos de custos por agente e por tarefa
• Permissões com escopo que impõem privilégios mínimos em subagentes
• Logs do agente de streaming para monitoramento estruturado em tempo real (beta)
• Ponto de verificação do agente para salvar e retomar o estado da árvore do agente (beta)
• Orçamentos de custos embutidos para limites de gastos por agente
• Modelos de agentes customizados para definições de agentes reutilizáveis
• Orquestração de vários repositórios para tarefas entre repositórios (beta)

Subagentes aninhados, modelos substitutos e o mercado estão geralmente disponíveis a partir do trem de lançamento CLI 2026.6. O ponto de verificação do agente, os logs de streaming e a orquestração de vários repositórios permanecem na versão beta e seus esquemas e comportamento podem mudar. O changelog da Anthropic rastreia o status mais recente de cada recurso. Para obter a cobertura da correção de persistência de sessão que precedeu este lote, consulte o artigo anterior do SitePoint sobre esse tópico.