Programação e agentes de IA

[Claude Code #7] /background e /tasks: agentes em segundo plano

Claude Code /background (/bg) envia a sessão em andamento para segundo plano e libera o terminal. Reuni despacho com claude --bg, monitoramento com agent view, painel /tasks e isolamento por worktree.

4 min de leitura
Imagem de capa de [Claude Code #7] /background e /tasks: agentes em segundo plano

Quando você dá uma tarefa longa para a IA, o terminal fica sequestrado. Enquanto centenas de testes são corrigidos, resta apenas ficar olhando para aquela janela.

Claude Code resolve isso com sessões em segundo plano. O trabalho em andamento é enviado inteiro para o fundo, liberando o terminal para outras tarefas.

Este artigo reúne /background (abreviado como /bg), /tasks e o agent view, que gerencia sessões em segundo plano.

Se o /goal de Claude Code, parte 6 era o dispositivo para concluir a jornada, desta vez é o dispositivo para dividir o trabalho.

/bg: enviar a sessão atual para segundo plano

Digite /bg na sessão em andamento: a conversa passa para uma sessão em segundo plano e o terminal é liberado.

Segundo Documentação oficial, a resposta continua em segundo plano mesmo se Claude já estiver respondendo. Você também pode acrescentar instruções e enviá-las.

/bg Execute a suíte de testes e corrija todas as falhas

Comandos de Shell e subagentes que já estavam em execução também são transferidos.

claude –bg: começar diretamente em segundo plano

Também é possível começar sem ocupar o terminal.

claude --bg --name "flaky-test" "SettingsChangeDetector Investigue os testes instáveis"

A execução mostra o ID da sessão e instruções de gerenciamento. O Shell aceita imediatamente a próxima entrada.

  • claude agents: abrir a visualização de sessões
  • claude attach <id>: abrir a sessão neste terminal
  • claude logs <id>: consultar a saída recente
  • claude stop <id>: interromper a sessão

agent view: a torre de controle dos trabalhadores

Ao executar claude agents, aparece uma tela com as sessões agrupadas por status. Em execução, aguardando entrada, concluídas e com falha são diferenciadas pela cor e pela animação dos ícones.

Cada linha traz um resumo de uma linha. Durante o trabalho, ele é atualizado a partir da saída da sessão no máximo a cada 15 segundos. Ao fim do turno, um modelo pequeno e rápido reescreve o resumo.

Selecione uma linha e pressione Space para espiar os detalhes (peek). Pressione Enter para se conectar totalmente à sessão (attach). Com a entrada vazia, pressione ← para voltar à torre de controle.

Diagrama do caminho para entrar nas sessões em segundo plano do Claude Code e da estrutura de gerenciamento do agent view
Seja enviando com /bg ou iniciando com --bg, tudo é gerenciado em um só lugar: agent view

Digite um prompt no campo de entrada para despachar imediatamente uma nova sessão em segundo plano.

Worktrees impedem conflitos de arquivos

Se várias sessões em segundo plano alterarem o mesmo repositório, não haverá conflitos?

Por padrão, antes de editar arquivos, a sessão em segundo plano é movida para um git worktree isolado sob .claude/worktrees/. Cada uma trabalha em sua própria cópia.

Sessões movidas para um worktree fazem commit das alterações automaticamente e também fazem push quando há um remoto. Não fazem push direto para main·master nem force push. Se você informar em CLAUDE.md ou outro arquivo que fará o commit manualmente, o git deixa essa tarefa com você.

Se não for um repositório git ou já estiver dentro de um worktree, o isolamento é ignorado. Também é possível desativá-lo com worktree.bgIsolation.

/tasks: lista de tarefas em segundo plano desta sessão

Com base em Documentação oficial de comandos, /tasks lista as tarefas em segundo plano da sessão atual, inclusive subagentes concluídos.

Se o agent view é a torre de controle por sessão, /tasks é o painel das tarefas dentro da sessão.

Ele avisa automaticamente quando termina

Com o agent view aberto, o terminal notifica quando uma sessão em segundo plano aguarda entrada, termina ou falha.

Abaixo do campo de entrada de uma sessão normal também aparece a quantidade de agentes aguardando entrada, como em ← 2 agents. Não é preciso monitorar a tela continuamente.

Não é preciso se preocupar com permissões. Ao ir para segundo plano, os modos atuais, como acceptEdits·auto, permanecem, e os diretórios adicionados com /add-dir também são levados junto.

Ilustração de robôs trabalhando separadamente em estufas de vidro com o texto ISOLATED WORKTREES
Cada um trabalha em sua própria estufa, então os branches não se enroscam

Resumo

Envie tarefas longas que ocupam o terminal para segundo plano com /bg e despache novas tarefas desde o início com claude --bg.

Gerencie tudo na torre de controle claude agents e veja o status interno com /tasks. O isolamento por worktree elimina a preocupação com conflitos de arquivos em trabalhos paralelos.

Na próxima edição, reuniremos /model, /effort, /fast e /advisor, que controlam a velocidade e a qualidade das sessões.

Fontes e critérios de verificação

Continue lendo

Série Claude Code

Tópicos relacionados