Build This Now
Build This Now
O que é o Código Claude?Instalar o Claude CodeInstalador Nativo do Claude CodeO Teu Primeiro Projeto com Claude Code
Fundamentos do agenteAgentes em Background no Claude CodeRoteamento de Sub-AgentesDesign de Sub-Agentes no Claude CodeDistribuição de Tarefas no Claude CodeEquipas de Agentes Builder-ValidatorEquipas de Agentes do Claude CodeControlos de Equipas de AgentesTemplates de Prompts para Equipas de AgentesBoas Práticas para Equipas de AgentesFluxo de Trabalho das Equipas de AgentesAgentes PersonalizadosPadrões de AgentesHow Garry Tan (YC CEO) Uses Claude Code: Inside the 23-Tool gstack SetupAgentes com Comportamento HumanoHermes Agent: IA que Se Aprimora SozinhaEngenharia de Harness para Agentes
speedy_devvkoen_salo
Blog/Handbook/Agents/Background Agents in Claude Code

Agentes em Background no Claude Code

Carrega Ctrl+B assim que um sub-agente do Claude Code começa e ele passa para background. Continua a escrever na sessão principal enquanto a pesquisa ou análise corre sozinha.

Pare de configurar. Comece a construir.

Templates SaaS com orquestração de IA.

Published Mar 13, 2026Handbook hubAgents index

Problema: Um sub-agente costumava congelar a tua sessão. O agente principal criava-o para pesquisa ou uma análise pesada, e tinhas de ficar parado até ele terminar.

Ganho Rápido: Carrega Ctrl+B assim que um sub-agente começa e ele passa para background:

You: Research authentication best practices for our Next.js app
Claude: I'll spawn a sub-agent to research this...
[Sub-agent starts]
You: [Press Ctrl+B]
You: While that runs, let's work on the database schema...

Tu ficas no chat. O sub-agente continua a trabalhar sozinho. Quando termina, os resultados aparecem de volta.

Execução Verdadeiramente Paralela

Sub-agentes assíncronos são agora uma funcionalidade de primeira classe. Sempre que o agente principal cria um, podes enviá-lo para background e continuar outra linha de trabalho com Claude.

O fluxo:

  1. Pedido: Dá ao Claude uma tarefa adequada para um sub-agente.
  2. Claude cria: O agente principal cria um sub-agente para a executar.
  3. Background: Carrega Ctrl+B enquanto o sub-agente ainda está a trabalhar.
  4. Continua: Fala com o agente principal sobre qualquer outra coisa.
  5. Retoma automática: Ao terminar, o sub-agente acorda o agente principal e entrega os resultados.

Queres ver o que está a correr? Escreve /tasks:

/tasks

Cada agente em background aparece com um estado, uma contagem de tokens e um indicador de progresso. Clica num para ver os detalhes.

Quando Enviar um Agente para Background

Ótimos candidatos:

  • Pesquisa que precisa de pesquisas na web
  • Análise de código em codebases grandes
  • Geração de documentação
  • Auditorias de segurança e scans de vulnerabilidades
  • Relatórios de profiling de performance

Mantém estes em primeiro plano:

  • Qualquer coisa que precisa da tua resposta a seguir
  • Edições de ficheiros que queres verificar antes de ficarem guardadas
  • Trabalho que depende do que estás a fazer agora

Também Funciona com Comandos Shell

O mesmo truque funciona com comandos shell lentos. Se Claude inicia npm install, docker build, ou um trabalho ffmpeg, envia-o para background:

Claude: Running npm install...
[Command starts]
You: [Press Ctrl+B]
You: While that installs, can you review the API routes?

Verifica-o com /tasks, tal como farias com um agente.

A Flag --agent

Uma nova flag CLI inicia o Claude Code já com a configuração de um sub-agente:

claude --agent plan

Essa linha arranca o Claude com a configuração do agente de planeamento carregada. Podes fazer perguntas, explorar o seu comportamento e ver como trata casos extremos antes de o integrar num workflow real.

Quando ajuda:

  • Depurar um sub-agente personalizado antes de te fiares nele
  • Verificar as instruções e acesso a ferramentas de um agente
  • Correr um especialista diretamente para uma tarefa pontual
  • Perceber o que os agentes integrados fazem de facto

Os agentes integrados funcionam (plan, explore, e os restantes), e também funciona tudo o que definiste em .claude/agents/.

Lançado Junto

A Anthropic incluiu vários outros melhoramentos no mesmo lançamento.

Compactação instantânea: /compact já não te faz esperar. Claude mantém um resumo da sessão em direto em background, por isso o comando apenas carrega esse resumo num contexto limpo.

Arquitetura de memória de sessão: Cada sessão tem agora um resumo estruturado. Acompanha estado, trabalho concluído, tópicos de discussão e um registo de trabalho.

Dashboard de stats: /stats mostra os teus padrões de uso, modelos favoritos, totais de tokens e streaks. Carrega Ctrl+S para copiar o output para partilhar.

Nomeação de sessões: /rename dá um nome a uma sessão e claude --resume session-name retoma-a pelo nome. O ecrã /resume agrupa agora sessões bifurcadas e tem atalhos de teclado (P para pré-visualizar, R para renomear, B para navegar bifurcações).

Toggle rápido de MCP: Liga ou desliga servidores MCP sem tocar no ficheiro de configuração.

Integração Slack: Passa tarefas ao Claude Code a partir de um canal Slack. Menciona @Claude num bug ou pedido de funcionalidade e o workflow da equipa encarrega-se.

Problemas Comuns

O agente não vai para background: Ctrl+B só funciona enquanto o agente está de facto a correr. Carrega durante o trabalho, não depois de terminar.

Perdeste o rasto dos teus agentes: Corre /tasks. Lista todos os processos em background com um ID.

O agente terminou mas nada apareceu: Os resultados voltam normalmente através do AgentOutputTool por conta própria. Se perdeste um, encontra-o em /tasks e vai buscar o output de lá.

Próximos Passos

  • Padrões de execução: Paralelo, sequencial, background. Escolhe o certo para a tarefa.
  • Fundamentos: Lê os fundamentos de agentes antes de construir algo maior.
  • Padrões de design: Sub-agent design cobre como dividir o trabalho de forma limpa.
  • Distribuição: Task distribution trata da orquestração multi-agente.
  • Agentes personalizados: Custom agent patterns mostra como construir os teus próprios especialistas.

O background transforma o Claude Code em algo mais próximo de uma estação de trabalho paralela do que um chat por turnos. Inicia uma pesquisa. Continua a enviar código. Pega nos resultados quando estiverem prontos.

Continue in Agents

  • Fundamentos do agente
    Cinco maneiras de criar agentes especializados no Código Claude: Sub-agentes de tarefas, .claude/agents YAML, comandos de barra personalizados, personas CLAUDE.md e prompts de perspetiva.
  • Engenharia de Harness para Agentes
    O harness é cada camada ao redor do seu agente de IA, exceto o modelo em si. Aprenda os cinco pontos de controle, o paradoxo das restrições, e por que o design do harness determina o desempenho do agente mais do que o modelo.
  • Padrões de Agentes
    Orchestrator, fan-out, cadeia de validação, routing especializado, refinamento progressivo e watchdog. Seis formas de orquestração para ligar sub-agentes no Claude Code.
  • Boas Práticas para Equipas de Agentes
    Padrões testados em produção para Equipas de Agentes Claude Code. Prompts de criação ricos em contexto, tarefas bem dimensionadas, posse de ficheiros, modo delegado, e correções das versões v2.1.33-v2.1.45.
  • Controlos de Equipas de Agentes
    Configura o modo delegado, modos de exibição, aprovação de planos, limites de ficheiros e regras CLAUDE.md para que o líder da tua equipa Claude Code coordene em vez de codificar.
  • Templates de Prompts para Equipas de Agentes
    Dez prompts testados de Equipas de Agentes para o Claude Code. Revisão de código paralela, debugging, builds de funcionalidades, decisões de arquitetura e investigação de campanhas. Cole e use.

More from Handbook

  • Técnicas de Pensamento Profundo
    Frases de gatilho como think harder, ultrathink e think step by step empurram o Claude Code para raciocínio expandido e mais computação em tempo de inferência, no mesmo modelo.
  • Padrões de Eficiência
    Frameworks de permutação transformam 8 a 12 builds manuais numa template CLAUDE.md que o Claude Code usa para gerar as variações 11, 12 e 13 a pedido. Capturas uma vez.
  • Modo Fast do Claude Code
    O modo fast encaminha os teus pedidos ao Opus 4.6 por uma via de serviço prioritária no Claude Code. Mesmo modelo, mesmo teto de qualidade, respostas 2.5x mais rápidas a uma taxa de tokens mais elevada.
  • Otimização da velocidade
    A seleção do modelo, o tamanho do contexto e a especificidade do pedido são as três alavancas que decidem a rapidez com que o Código Claude responde. /modelo de haiku, /compacto, e /claro coberto.

Pare de configurar. Comece a construir.

Templates SaaS com orquestração de IA.

Fundamentos do agente

Cinco maneiras de criar agentes especializados no Código Claude: Sub-agentes de tarefas, .claude/agents YAML, comandos de barra personalizados, personas CLAUDE.md e prompts de perspetiva.

Roteamento de Sub-Agentes

Um bloco de roteamento para o CLAUDE.md que ensina a sua thread principal do Claude Code quando despachar sub-agentes em paralelo, sequencialmente ou em segundo plano. Copie e cole.

On this page

Execução Verdadeiramente Paralela
Quando Enviar um Agente para Background
Também Funciona com Comandos Shell
A Flag --agent
Lançado Junto
Problemas Comuns
Próximos Passos

Pare de configurar. Comece a construir.

Templates SaaS com orquestração de IA.