Vídeo de demonstração > https://youtu.be/-INveHwbRz4
TL;DR
claude agents permite disparar, monitorar e responder a sessões em segundo plano do Claude Code em uma única tela
Cada sessão continua viva mesmo sem terminal → um processo supervisor roda separadamente
Conflitos de arquivos são isolados automaticamente com worktree; se houver PR, o status do CI também aparece na linha
Requer Claude Code v2.1.139+; atualmente em Research Preview
Conceito principal
Uma pergunta que surge naturalmente na "era da programação com agentes": como operar 10 sessões ao mesmo tempo?
Antes, isso significava tmux + várias janelas + estado de progresso indefinido, gerando sobrecarga cognitiva
O Agent View organiza tudo isso em uma tabela em uma única tela. Cada linha mostra o nome da sessão, o que ela está fazendo no momento e o horário da última alteração
Como ler os ícones de estado
Animated ✽ - Working, executando ferramentas ou gerando respostas
Yellow - Needs input, aguardando decisão de permissão ou uma pergunta
Dimmed - Idle, aguardando entrada, mas sem estar bloqueado por uma pergunta específica
Green - Completed, concluído com sucesso
Red - Failed, encerrado com erro
Grey - Stopped, interrompido com Ctrl+X ou claude stop
O formato do ícone também indica se o processo ainda está vivo:
✻ (ou a animação ✽ durante o trabalho) = processo ativo, pronto para responder imediatamente
∙ = o processo morreu, mas é reiniciado automaticamente ao usar peek/reply/attach, retomando de onde parou
✢ = uma sessão /loop está em espera até a próxima iteração (mostra a contagem de execuções e a contagem regressiva)
O resumo de uma linha é gerado por um modelo da classe Haiku, então dá para entender o estado sem abrir a transcrição. Ele continua incluído normalmente nos termos de uso e cobrança.
Fluxo de trabalho
Dispatch: digite um prompt no campo de entrada inferior → Enter. O nome é atribuído automaticamente
Peek: Space na linha → ver a saída recente e o link do PR. Se for uma pergunta de múltipla escolha, responda com as teclas numéricas; em outras sessões bloqueadas, também é possível usar Tab para preencher uma resposta sugerida e enviá-la. Com o prefixo !, também é possível executar comandos Bash
Attach: Enter ou tecla →. Entra em uma sessão totalmente interativa. O Claude primeiro mostra um resumo (recap) do que aconteceu enquanto você esteve ausente
Detach: em uma entrada vazia, ← → mantém em segundo plano. Ctrl+C, Ctrl+D, Ctrl+Z e /exit também mantêm a sessão em segundo plano. Para encerrar a sessão de verdade, use /stop
Para enviar uma sessão interativa existente para segundo plano, execute /bg dentro dela ou pressione ← em um prompt vazio. Depois de usar o Agent View uma vez, é possível entrar nele a partir de qualquer sessão usando ← em um prompt vazio.
Truques de dispatch
<subagent-name> <prompt> - se a primeira palavra for um subagente, ele se torna o agente principal
@<agent-name> - mencionar no meio do prompt também faz com que ele atue como agente principal
@<repo> - abre o Agent View no diretório pai e roteia para um repositório específico
/<skill> - dispatch por Skill (bom para empacotar tarefas repetitivas)
#1234 ou URL de PR - se já houver uma sessão trabalhando nesse PR, ela será selecionada; caso contrário, uma nova será disparada
Shift+Enter - dispatch + attach imediato
Diretamente no shell: claude --bg "...", claude --agent code-reviewer --bg "..."
Filtragem da lista
Se você apenas digitar no campo de entrada, isso funciona como filtro em vez de dispatch:
a:<name> - sessões em execução com esse agente
s:<state> - filtro por estado (ex.: s:blocked mostra apenas as que estão aguardando entrada)
#<number> ou URL de PR - sessões que trabalham nesse PR
Principais atalhos
↑ / ↓: mover entre linhas
Enter: attach na sessão selecionada; se houver texto na entrada, faz dispatch
Space: abrir/fechar o painel de peek
Shift+Enter: dispatch e attach imediato
Alt+1~Alt+9: attach direto na N-ésima sessão do grupo correspondente
Ctrl+S: alternar grupo por estado/diretório
Ctrl+T: fixar/desafixar sessão
Ctrl+R: renomear sessão
Ctrl+G: escrever o prompt no $EDITOR
Ctrl+X: parar (pressione mais uma vez em até 2 segundos para remover)
Shift+↑ / Shift+↓: alterar a ordem
?: ver todos os atalhos
Conflitos de arquivos são isolados automaticamente com worktree
Sessões disparadas pelo Agent View criam automaticamente um git worktree em .claude/worktrees/ quando precisam editar
Ao remover a sessão, o worktree também é apagado → atenção: se não fizer merge/push, as mudanças se perdem
Se o frontmatter do subagente tiver isolation: worktree, o isolamento será sempre aplicado
Arquitetura do supervisor
As sessões em segundo plano não são filhas do terminal, e sim de um processo supervisor por usuário
Sessões concluídas e inativas por mais de 1 hora têm apenas o processo desligado, mas permanecem no disco → na próxima conexão, são reiniciadas retomando o estado
O próprio supervisor é encerrado quando todas as sessões terminam, e sobe novamente no próximo dispatch em segundo plano
Durante auto-update, ele reinicia automaticamente com o novo binário, e as sessões em segundo plano continuam vivas
Localização dos arquivos de estado: ~/.claude/daemon.log (log do supervisor), ~/.claude/daemon/roster.json (lista de sessões em execução), ~/.claude/jobs/<id>/state.json (estado de cada sessão)
É possível desativar tudo com a configuração disableAgentView ou com a variável de ambiente CLAUDE_CODE_DISABLE_AGENT_VIEW (também há suporte a gerenciamento em nível organizacional)
Comandos de shell
claude agents # abrir a visão de agentes
claude attach <id> # conectar à sessão
claude logs <id> # saída recente
claude stop <id> # parar (= claude kill)
claude respawn <id> # reiniciar uma sessão parada
claude respawn --all # reviver todas após sleep/shutdown
claude rm <id> # remover da lista
Limitações
A cobrança continua igual - 10 sessões em paralelo consomem a cota 10 vezes mais rápido
As sessões em segundo plano rodam na máquina local - param em caso de sleep/shutdown
O worktree é apagado junto com a sessão
Ainda não há comentários.