Deepseek ArtifactsDeepseek Artifacts
Guia prático do Claude Code

Tarefas em segundo plano do Claude Code: ver, parar e gerenciar

Comandos que não acabam, subagentes fora de controle, sessões que você quer deixar trabalhando enquanto troca de contexto — aqui está o painel de controle completo: Ctrl+B, /tasks, agent view e todos os timeouts e interruptores de corte no meio do caminho.

Resumo

  • Pressione Ctrl+B (duas vezes dentro do tmux) para mandar um comando Bash em execução para o segundo plano — ou simplesmente peça ao Claude para rodar algo em segundo plano.
  • Use /tasks para ver os shells em segundo plano e subagentes em execução. A lista de tarefas do Ctrl+T é outra coisa — não é a tela de segundo plano.
  • Sessões inteiras também vão para o segundo plano: o /bg destaca a conversa atual, e o claude agents abre o agent view, onde você acompanha, responde ou para cada uma.
  • Tarefas em segundo plano param após 30 minutos por padrão (2 horas no máximo), são limpas quando o Claude Code sai e podem ser desativadas de vez com CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1.

Introducing agent view in Claude Code (official)

Canal: Claude — official YouTube channel0:39

Assistir no YouTube

The Explore → Plan → Code → Commit workflow (official)

Canal: Claude — official YouTube channel3:12

Assistir no YouTube

Claude Code v2.1.287 — Claude Mods and Agent Plugins

Canal: Claude Code Changelog2:13

Assistir no YouTube

Interactive mode & agent view — official docs

Docs: code.claude.com/docs

Assistir no YouTube

As capturas vêm do anúncio oficial do agent view da Anthropic, do walkthrough oficial Explore → Plan → Code → Commit e de um resumo tipográfico do changelog v2.1.287. Os fatos foram conferidos com a documentação oficial de interactive-mode e agent-view.

Os carimbos de tempo de cada quadro apontam de volta para os vídeos de origem. Claude Code é uma marca da Anthropic; este guia é independente e sem vínculo.

Dominar as tarefas em segundo plano passo a passo

Mandar um comando para o segundo plano

  1. 1

    Saber o que conta como tarefa em segundo plano

    Duas coisas rodam em segundo plano no Claude Code: comandos de shell empurrados para o canto (um dev server, uma bateria longa de testes) e subagentes trabalhando por conta própria enquanto você continua digitando. Os dois aparecem nas mesmas telas e os dois consomem o mesmo orçamento de timeout.

  2. 2

    Mandar um comando para o segundo plano com Ctrl+B

    Enquanto uma chamada da ferramenta Bash roda, pressione Ctrl+B para empurrá-la para o segundo plano e recuperar o seu prompt — dentro do tmux pressione duas vezes, porque o tmux engole a primeira. Você também pode simplesmente pedir ao Claude, em linguagem natural, para rodar o comando em segundo plano desde o início.

    Claude Code terminal showing an Explore subagent running with the hint ctrl+b to run in background above the Scrying progress line
    O walkthrough oficial mostra um passo Explore em execução com a dica ctrl+b to run in background logo acima da linha de progresso.Assistir em 2:42
  3. 3

    Entender as regras de timeout

    Um comando que estoura o timeout vai automaticamente para o segundo plano — a menos que comece com sleep. Tarefas em segundo plano rodam por até 30 minutos por padrão, ou o timeout pedido pelo Claude, com 2 horas de teto firme. Saída além de 5 GB encerra a tarefa.

Acompanhar, parar e limitar

  1. 4

    Ver tudo com o /tasks

    Digite /tasks para listar os shells em segundo plano e subagentes desta sessão. Não confunda com a lista de tarefas do Ctrl+T — essa fixa sessões no agent view e não tem nada a ver com shells em segundo plano.

  2. 5

    Parar o que precisa ser parado

    Pressione Ctrl+X e depois Ctrl+K para parar todos os subagentes em segundo plano em execução na sessão — repita a combinação duas vezes em 3 segundos para confirmar. Shells individuais você encerra na tela do /tasks, e quando o Claude Code sai tudo é limpo automaticamente.

  3. 6

    Desativar as tarefas em segundo plano, se precisar

    Defina CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 no seu ambiente (ou inicie em modo bare) e os comandos mandados para o segundo plano simplesmente param no timeout, sem segurar recursos. Em máquinas macOS e Linux sob pressão de memória, o Claude Code também pode eliminar tarefas ociosas há mais de 30 minutos — CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1 desliga isso.

  4. 7

    No VS Code: cartões de tarefas em segundo plano

    Desde o Claude Code 2.1.287, a extensão do VS Code pode mandar comandos e subagentes em execução para o segundo plano e mostra a saída do shell direto nos cartões do agent map — o workspace fica limpo enquanto as tarefas seguem processando.

    Claude Code v2.1.287 release notes slide describing VS Code background task management with background shell output visible in agent map cards
    Notas da v2.1.287: o gerenciamento de tarefas em segundo plano do VS Code coloca a saída do shell direto nos cartões do agent map.Assistir em 0:58

Sessões inteiras em segundo plano com o agent view

  1. 8

    Mandar uma sessão inteira para o segundo plano com /bg

    Digite /bg (ou /background) para mandar a conversa atual para o segundo plano — opcionalmente com uma tarefa anexada, tipo /bg run the test suite and fix any failures. O /fork copia a conversa para uma nova sessão em segundo plano enquanto a original segue rodando.

  2. 9

    Abrir o agent view

    Rode claude agents do seu terminal para ver todas as sessões em segundo plano de uma vez. Dentro de uma sessão, pressionar ← no prompt vazio a manda para o segundo plano e te derruba no agent view num único passo. Se quiser que o claude puro abra essa tela em vez de um novo chat, defina defaultToAgentsView=true no /config.

    Claude Code agent view listing one needing input, five working and two completed background sessions with the dispatch bar at the bottom
    Agent view: uma sessão pedindo entrada, cinco trabalhando, duas concluídas — com uma barra para despachar novas tarefas em segundo plano.Assistir em 0:14
  3. 10

    Ler os estados num relance

    As sessões são agrupadas em Needs input, Working e Completed. Cada linha mostra um resumo gerado e a idade dele, e o formato dos ícones diz se o processo vive, saiu ou dorme numa /loop — uma olhada rápida já diz onde sua atenção é necessária.

    Agent view in Claude Code showing the Needs input, Working and Completed session groups with per-session summaries and ages
    Os três grupos do agent view: Needs input (dark-mode, release-notes), Working (pr-review, perf-audit, payment-migration), Completed (test-coverage).Assistir em 0:17
  4. 11

    Responder sem anexar

    Pressione Space numa sessão selecionada para abrir o painel de prévia e responder na hora — prefixe uma mensagem com ! para rodá-la como comando de shell, ou envie /stop para parar aquela sessão. Enter anexa você à sessão; ← desanexa sem pará-la.

    Claude Code agent view with the pr-review session selected showing the space to reply inline panel and enter to open hint
    O painel de prévia respondendo na linha à sessão pr-review — enter para abrir, space para responder, ctrl+x para apagar.Assistir em 0:19
  5. 12

    Achar a sessão certa rápido

    O agent view tem filtros: n:<texto> casa com nomes de sessão ou primeiros prompts (v2.1.287+), s:<estado> filtra por estado, a:<nome> por agente, e #1234 pula direto para um pull request. Combine-os, tipo s:blocked a:reviewer, e fixe com Ctrl+T as sessões que você nunca quer ver eliminadas.

    Claude Code changelog slide for agent view filtering showing the n: text filter that searches session names and tasks
    O filtro n:<texto> do agent view busca nomes de sessão e tarefas; Enter abre o primeiro match.Assistir em 1:14

Cola de teclado para tarefas em segundo plano

Todos os controles que importam, numa lista só — imprima e cole do lado do terminal:

  • 1Ctrl+B — manda a chamada da ferramenta Bash em andamento para o segundo plano (pressione duas vezes no tmux).
  • 2/tasks — lista os shells em segundo plano e subagentes desta sessão.
  • 3Ctrl+X, Ctrl+K — para todos os subagentes em segundo plano desta sessão; pressione duas vezes em 3 segundos para confirmar.
  • 4/bg — manda a conversa atual para o segundo plano, opcionalmente com um prompt de trabalho junto.
  • 5← no prompt vazio — manda esta sessão para o segundo plano e abre o agent view.
  • 6Space — painel de prévia: responda na hora, ! roda um comando de shell, /stop para aquela sessão.
  • 7Enter / → anexa a uma sessão; ← ou /exit desanexam sem pará-la.
  • 8Ctrl+T fixar · Ctrl+R renomear · Ctrl+S agrupar por diretório · Ctrl+X duas vezes: parar e apagar.

Os ajudantes do lado do shell fecham a conta: claude attach, claude logs, claude stop e claude rm recebem um id de sessão, e o claude agents --json te entrega o tabuleiro inteiro para scripts.

FAQ de tarefas em segundo plano do Claude Code

Guias relacionados