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 AgentesAgentes com Comportamento Humano
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.
  • 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.
  • Fluxo de Trabalho das Equipas de Agentes
    O fluxo de trabalho de sete passos das Equipas de Agentes Claude Code. Brain dump, Q&A, plano estruturado, contexto novo, cadeias de contratos, execução em vagas, e validação antes de lançar.

More from Handbook

  • Melhores Práticas do Claude Code
    Cinco hábitos separam os engenheiros que entregam com Claude Code: PRDs, regras modulares em CLAUDE.md, slash commands personalizados, resets com /clear e uma mentalidade de evolução do sistema.
  • Modo Auto do Claude Code
    Um segundo modelo Sonnet revê cada chamada de ferramenta do Claude Code antes de ser executada. O que o modo auto bloqueia, o que permite e as regras de permissão que cria nas tuas definições.
  • Channels do Claude Code
    Liga o Claude Code ao Telegram, Discord ou iMessage com plugins MCP. Walkthroughs de configuração e os fluxos de trabalho assíncronos e mobile-first que tornam a ligação válida.
  • Melhores Práticas para o Claude Opus 4.7
    Use o Claude Opus 4.7 bem no Claude Code: primeiras interações, configurações de esforço, pensamento adaptativo, prompts de ferramentas, subagentes, reinícios de sessão e controlo de tokens.

Pare de configurar. Comece a construir.

Templates SaaS com orquestração de IA.

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.