Gerenciar múltiplos agentes com agent view

Despache e gerencie muitas sessões Claude Code a partir de uma tela. Agent view mostra o que cada sessão está fazendo e quais precisam de sua entrada.

Agent view, aberto com claude agents, é uma tela para todas as suas sessões em background: o que está em execução, o que precisa de sua entrada e o que está concluído. Despache novas sessões, observe seu estado rapidamente em vez de rolar pelos transcritos e intervenha apenas quando uma precisar de você. As sessões continuam em execução no background sem um terminal anexado.

Use agent view quando você tiver várias tarefas independentes que Claude pode trabalhar simultaneamente, como corrigir um bug, revisar um pull request ou investigar um log. Quando você quer trabalhar em um problema junto, anexe-se a uma sessão e use Claude Code interativamente como de costume.

Sessões em agent view são executadas independentemente e relatam apenas para você. Para comparar com subagentes, equipes de agentes e worktrees, consulte Executar agentes em paralelo.

Esta página cobre:

Início rápido
Monitorar sessões com agent view, incluindo ícones de estado, espiada e resposta, anexação, organização e atalhos de teclado
Despache novos agentes a partir de agent view, de dentro de uma sessão ou do shell
Gerenciar sessões do shell
Como as sessões em background são hospedadas pelo processo supervisor

Início rápido

Este passo a passo abre agent view, despacha uma sessão, responde do painel de espiada e anexa para a conversa completa.

Abrir agent view

Do seu shell, execute:

claude agents

Agent view abre com uma entrada na parte inferior e uma tabela que se preenche conforme as sessões começam. Pressione Esc a qualquer momento para sair. Suas sessões continuam em execução.

Despache uma sessão

Digite um prompt na entrada e pressione Enter. Uma nova sessão é iniciada e aparece como uma linha mostrando se está funcionando, aguardando você ou concluída. Repita para executar várias sessões em paralelo. Cada uma usa sua cota de assinatura independentemente, portanto, consulte Limitações antes de despachar muitas de uma vez.

Espiada e resposta

Selecione uma linha com as teclas de seta e pressione Space para ver o que a sessão está fazendo ou o que precisa de você. Digite uma resposta e pressione Enter para enviá-la sem sair de agent view.

Anexar e desanexar

Pressione Enter ou → em uma linha para anexar quando quiser a conversa completa. A sessão assume o terminal exatamente como se você tivesse executado claude. Pressione ← em um prompt vazio para desanexar e retornar à tabela.

Para trazer uma sessão interativa existente para agent view, execute /bg dentro dela, ou pressione ← em um prompt vazio para colocar a sessão em background e abrir agent view em uma etapa. A sessão continua em execução no background e aparece como uma linha. Para iniciar uma nova sessão em background diretamente do shell, execute claude --bg "<prompt>".

Você pode usar claude agents como seu ponto de entrada principal em vez de claude: despache cada tarefa de agent view, anexe quando quiser a conversa completa e pressione ← para retornar à tabela.

Monitorar sessões com agent view

Execute claude agents para abrir agent view. Ele assume o terminal completo e lista cada sessão agrupada por estado, com sessões fixadas e as que precisam de você no topo. Cada linha mostra o nome da sessão, atividade atual e há quanto tempo foi alterada pela última vez.

A lista abrange cada sessão em background sob seu diretório de configuração, independentemente de qual projeto ou worktree está trabalhando, então uma sessão iniciada em um repositório e outra iniciada em um worktree diferente aparecem juntas. Sessões interativas que você tem abertas em outros terminais não aparecem até que você as coloque em background, e subagents em execução dentro de uma sessão não são listados como linhas separadas.

Pinned
  ✽ clawd walk cycle          Write assets/sprites/clawd-walk.png           3m

Ready for review
  ∙ jump physics              github.com/anthropics/example/pull/2048    ●  2h

Needs input
  ✻ power-up design           needs input: double jump or wall climb?       1m

Working
  ✽ collision detection       Edit src/physics/CollisionSystem.ts           2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

Completed
  ✻ title screen              result: menu, options, and credits done       9m
  ∙ sound effects             result: 14 SFX exported to assets/audio       4h
  … 6 more

O ícone de cada linha carrega dois sinais. O indicador informa o estado da sessão, e a forma do ícone informa se o processo subjacente ainda está em execução. Os estados são:

Indicador	Estado	O que significa
Animado	Working	Claude está executando ativamente ferramentas ou gerando uma resposta
Amarelo	Needs input	Claude está aguardando sua entrada, geralmente uma decisão de permissão ou uma resposta
Esmaecido	Idle	A sessão está aguardando entrada, mas não está bloqueada em uma pergunta específica
Verde	Completed	A tarefa foi concluída com sucesso
Vermelho	Failed	A tarefa terminou com um erro
Cinza	Stopped	A sessão foi interrompida com `Ctrl+X` ou `claude stop`

A forma do ícone informa se o processo subjacente ainda está em execução. Um ✻, ou um ✽ animado enquanto Claude está trabalhando, significa que a sessão está ativa e você pode responder a ela imediatamente. Um ∙ significa que o processo saiu, mas você ainda pode espreitar, responder ou anexar: Claude reinicia a sessão de onde parou. Um ✢ é uma sessão /loop dormindo entre iterações, com a linha mostrando sua contagem de execução e uma contagem regressiva para a próxima iteração.

Sessões em background não precisam de nenhum terminal aberto para continuar funcionando. Um processo supervisor separado as executa, então você pode fechar agent view, fechar seu shell ou iniciar uma nova sessão interativa e seu trabalho despachado continua.

As sessões persistem no disco: fechar seu terminal ou uma atualização automática não as perde, e reabrir claude agents as mostra todas. Se sua máquina dormir ou desligar, as sessões em execução param; reinicie-as com claude respawn --all.

O resumo de uma linha em cada linha é gerado pelo seu modelo Haiku-class configurado, para que a linha possa informar o que a sessão está fazendo, o que precisa ou o que produziu sem abrir o transcript. Enquanto uma sessão está ativamente funcionando, o resumo é atualizado no máximo uma vez a cada 15 segundos, mais uma vez quando cada turno termina. Cada atualização é uma solicitação curta de Haiku-class através de seu provedor normal, cobrada e tratada sob os mesmos termos de uso de dados que a sessão em si.

Quando uma sessão abre um pull request, um ponto de status aparece na borda direita da linha, vinculado ao pull request em terminais que suportam hiperlinks. Quando a sessão abriu mais de um pull request, a contagem aparece antes do ponto e a cor reflete qual deles mais precisa de atenção.

Cor do ponto	Status do pull request
Amarelo	Aguardando verificações ou revisão, ou verificações falharam
Verde	Verificações passaram e nenhuma revisão está bloqueando
Roxo	Mesclado
Cinza	Rascunho ou fechado

Para a maioria das tarefas, esta linha é onde você coleta o resultado: revise e mescle o pull request quando o ponto ficar verde.

Peek and reply

Pressione Space em uma linha selecionada para abrir o painel de espiada. Ele mostra o que a sessão precisa de você, sua saída mais recente e quaisquer pull requests que abriu. Na maioria das vezes, isso é suficiente e você nunca precisa abrir o transcript completo.

Digite uma resposta no painel de espiada e pressione Enter para enviá-la para essa sessão. Quando a sessão está fazendo uma pergunta de múltipla escolha, o painel de espiada mostra as opções e você pode pressionar uma tecla numérica para escolher uma. Para outras sessões bloqueadas, pressione Tab para preencher a entrada com uma resposta sugerida que você pode editar antes de enviar. Prefixe uma resposta com ! para enviar um comando Bash em vez disso.

Use ↑ e ↓ para espreitar sessões adjacentes sem fechar o painel, ou → para anexar.

Attach to a session

Pressione Enter ou → em uma linha selecionada para anexar, ou pressione Alt+1 até Alt+9 para anexar diretamente à Nª sessão no grupo focado. Agent view é substituído pela sessão interativa completa, exatamente como se você tivesse executado claude naquele diretório. Quando você anexa, Claude publica um breve resumo do que aconteceu enquanto você estava ausente.

Enquanto anexado, a sessão se comporta como qualquer outra sessão Claude Code: cada comando, atalho de teclado e recurso funciona.

Pressione ← em um prompt vazio para desanexar e retornar a agent view. Se um diálogo tem foco e não está respondendo a ←, pressione Ctrl+Z para desanexar imediatamente.

Desanexar nunca interrompe uma sessão em background: ←, Ctrl+C, Ctrl+D, Ctrl+Z e /exit a deixam em execução. Para encerrar uma sessão de dentro dela, execute /stop.

Depois de ter despachado ou colocado uma sessão em background, pressionar ← em um prompt vazio funciona de qualquer sessão Claude Code, não apenas as que você anexou a partir de agent view. Coloca a sessão atual em background e abre agent view com essa sessão pré-selecionada, para que você possa alternar sessões sem sair do terminal. Você pode desativar este atalho em /config.

Organize the list

Agent view agrupa sessões por estado, com sessões que precisam de entrada acima de sessões que estão funcionando ou concluídas. Pressione Ctrl+S para alternar para agrupamento por diretório em vez disso. Sua escolha é salva entre execuções. Dentro de um grupo, fixe uma sessão no topo com Ctrl+T, reordene com Shift+↑ e Shift+↓, ou pressione Enter em um cabeçalho de grupo para recolhê-lo. Para remover uma sessão, pressione Ctrl+X para interrompê-la e Ctrl+X novamente dentro de dois segundos para deletá-la. Pressionar Ctrl+X em um cabeçalho de grupo deleta cada sessão naquele grupo após confirmação.

Sessões concluídas mais antigas se dobram em uma linha "… N more" para manter a lista curta. Falhas e sessões com um pull request aberto sempre permanecem visíveis.

Filter the list

Digite na entrada de despacho para filtrar em vez de despachar:

Filtro	Mostra
`a:<name>`	Sessões executando o agente nomeado
`s:<state>`	Sessões no estado fornecido, como `s:blocked` para sessões que precisam de você
`#<number>` ou uma URL de PR	A sessão trabalhando naquele pull request

Keyboard shortcuts

Pressione ? em agent view para ver cada atalho. Os mais comuns:

Atalho	Ação
`↑` / `↓`	Mover entre linhas
`Enter`	Anexar à sessão selecionada, ou despachar se houver texto na entrada
`Space`	Abrir ou fechar o painel de espiada para a sessão selecionada
`Shift+Enter`	Despachar e anexar imediatamente
`→`	Anexar à sessão selecionada
`Alt+1`..`Alt+9`	Anexar à Nª sessão no grupo focado
`Tab`	Procurar todos os subagents, ou aplicar a sugestão destacada
`Ctrl+S`	Alternar agrupamento entre estado e diretório
`Ctrl+T`	Fixar ou desafixar a sessão selecionada
`Ctrl+R`	Renomear a sessão selecionada
`Ctrl+G`	Abrir o prompt de despacho em seu `$EDITOR`
`Ctrl+X`	Interromper a sessão; pressione novamente dentro de dois segundos para deletá-la
`Shift+↑` / `Shift+↓`	Reordenar a sessão selecionada
`Esc`	Fechar o painel de espiada, limpar a entrada ou sair
`Ctrl+C`	Limpar a entrada; pressione duas vezes para sair
`?`	Mostrar todos os atalhos

Despachar novos agentes

Você pode despachar novas sessões em background a partir de agent view, enviar uma sessão interativa existente para o background ou iniciar uma diretamente do shell.

From agent view

Digite um prompt na entrada na parte inferior de agent view e pressione Enter para iniciar uma nova sessão em background. A sessão é nomeada automaticamente a partir do prompt. Você pode renomeá-la mais tarde com Ctrl+R. Cole uma imagem no prompt para incluir uma captura de tela ou diagrama com a tarefa.

Prefixe ou mencione partes do prompt para controlar como a sessão é iniciada:

Entrada	Efeito
`<agent-name> <prompt>`	Se a primeira palavra corresponder a um nome de subagent personalizado, esse subagent é executado como o agente principal da sessão com a configuração de seu frontmatter
`@<agent-name>`	Mencione um subagent personalizado em qualquer lugar do prompt para executá-lo como o agente principal
`@<repo>`	Mencione um repositório sob o diretório em que você abriu agent view para executar a sessão lá
`/<skill>`	Sugerir skills para despachar como o prompt
`#<number>` ou uma URL de pull request	Se uma sessão já está trabalhando naquele PR, selecione-a em vez de despachar
`Shift+Enter`	Despachar e anexar imediatamente à nova sessão

Digite / para despachar uma skill. Empacotar uma tarefa recorrente como uma skill permite que você inicie o mesmo fluxo de trabalho muitas vezes a partir de agent view sem redigitar o prompt. Pressione Tab em uma entrada vazia para procurar cada subagent despachável, ou para aplicar a sugestão destacada quando as sugestões estão sendo exibidas.

Quando o mesmo @name corresponde tanto a um subagent quanto a um repositório irmão, o subagent tem precedência. A forma de primeira palavra sem @ também se aplica a qualquer nome de subagent, portanto um prompt que começa com uma palavra correspondente a um de seus nomes de subagent despacha esse subagent. Use a forma @ quando quiser ser explícito.

Dispatch to a specific directory

Uma nova sessão é executada no diretório em que você abriu agent view. Para direcionar um diretório diferente:

Abra claude agents naquele diretório.
Abra claude agents em um diretório pai que contém vários repositórios e mencione um com @<repo> no prompt para executar a sessão lá.
Do shell, cd para o diretório e execute claude --bg "<prompt>".

Quando agent view é agrupado por diretório, o diretório da linha destacada se torna o alvo de despacho, para que você possa rolar para um grupo e despachar nele sem redigitar o caminho.

From inside a session

Execute /background ou seu alias /bg para desanexar a conversa atual e mantê-la em execução. Passe um prompt como /bg run the test suite and fix any failures para enviar uma instrução adicional antes de desanexar.

From the shell

Passe --bg para iniciar uma sessão que vai direto para o background:

claude --bg "investigate the flaky SettingsChangeDetector test"

Para executar um subagent específico como o agente principal da sessão, combine --bg com --agent:

claude --agent code-reviewer --bg "address review comments on PR 1234"

Após colocar em background, Claude imprime o ID curto da sessão e os comandos para gerenciá-la:

backgrounded · 7c5dcf5d
  claude agents             list sessions
  claude attach 7c5dcf5d    open in this terminal
  claude logs 7c5dcf5d      show recent output
  claude stop 7c5dcf5d      stop this session

How file edits are isolated

Toda sessão em background, seja iniciada a partir de agent view, /bg ou claude --bg, inicia no seu diretório de trabalho, mas é bloqueada de escrever arquivos lá. Quando a sessão precisa editar arquivos, Claude a move para um git worktree isolado sob .claude/worktrees/ automaticamente, para que sessões paralelas possam ler o mesmo checkout, mas cada uma escreve no seu próprio. O bloqueio não se aplica quando a sessão já está dentro de um worktree, quando o diretório de trabalho não é um repositório git, ou para escritas fora do diretório de trabalho.

O worktree é removido quando você deleta a sessão, portanto mescle ou envie as alterações que você quer manter antes de deletar. Para encontrar o caminho do worktree de uma sessão, espreite a sessão ou anexe e verifique seu diretório de trabalho.

Para fazer um subagent sempre executar em seu próprio worktree independentemente de como foi iniciado, defina isolation: worktree em seu frontmatter.

Permission mode and settings

Uma sessão despachada lê suas settings e permission mode do diretório em que é executada, da mesma forma que se você tivesse iniciado claude lá. Despachar a partir da entrada de agent view não passa um permission mode, portanto a sessão usa o defaultMode das settings daquele diretório ou o permissionMode do frontmatter do subagent despachado.

Para definir o modo a partir do shell, passe --permission-mode com claude --bg. Usar bypassPermissions ou auto desta forma é recusado até que você tenha aceitado esse modo executando claude com ele uma vez interativamente, já que esses modos permitem que uma sessão que você não está observando aja sem aprovação.

Manage sessions from the shell

Cada sessão em background tem um ID curto que você pode usar do shell. Esses comandos são úteis para scripts ou quando você não quer abrir agent view.

Comando	Propósito
`claude agents`	Abrir agent view
`claude attach <id>`	Anexar a uma sessão neste terminal
`claude logs <id>`	Imprimir a saída recente da sessão
`claude stop <id>`	Interromper uma sessão. Também aceita `claude kill`
`claude respawn <id>`	Reiniciar uma sessão interrompida com sua conversa intacta
`claude respawn --all`	Reiniciar cada sessão interrompida
`claude rm <id>`	Remover uma sessão da lista

How background sessions are hosted

Sessões em background são hospedadas por um processo supervisor por usuário, separado do seu terminal e de agent view. Ele é iniciado automaticamente na primeira vez que você coloca uma sessão em background ou abre agent view, e você não o gerencia diretamente. O supervisor e suas sessões se autenticam com as mesmas credenciais que suas sessões interativas e não fazem conexões de rede adicionais além da API do modelo.

Cada sessão em background é seu próprio processo Claude Code, com pai no supervisor em vez de no seu terminal. Uma sessão que está ativamente funcionando, aguardando sua entrada ou tem um terminal anexado mantém seu processo em execução. Depois que uma sessão termina e fica desanexada por cerca de uma hora, o supervisor interrompe seu processo para liberar recursos. O transcript e o estado permanecem no disco, e na próxima vez que você anexar, espreitar ou responder, o supervisor inicia um novo processo de onde parou. Quando cada sessão terminou e nenhum terminal está conectado, o supervisor em si sai e é iniciado novamente na próxima vez que você coloca uma sessão em background ou abre agent view.

O supervisor observa o binário Claude Code instalado no disco e reinicia para a nova versão após o auto-updater regular substituí-lo. Esta é uma observação de arquivo local, não uma verificação de rede. Sessões em background são processos desanexados, então continuam em execução durante a reinicialização e o novo supervisor se reconecta a elas.

O estado da sessão é armazenado sob seu diretório de configuração Claude Code. Se você definir CLAUDE_CONFIG_DIR, o supervisor usa esse diretório em vez de ~/.claude e é executado como uma instância separada com suas próprias sessões.

Caminho	Conteúdo
`~/.claude/daemon.log`	Log do supervisor
`~/.claude/daemon/roster.json`	Lista de sessões em background em execução, usada para se reconectar após uma reinicialização
`~/.claude/jobs/<id>/state.json`	Estado por sessão mostrado em agent view

Para desativar agentes em background e agent view completamente, defina a configuração disableAgentView como true ou defina a variável de ambiente CLAUDE_CODE_DISABLE_AGENT_VIEW. Os administradores podem impor isso através de configurações gerenciadas.

Troubleshooting

Agent view opens with no sessions

Agent view está vazio até que você despache sua primeira sessão. Digite um prompt na entrada na parte inferior e pressione Enter.

Sessions show as stopped after waking your machine

Sessões em background não sobrevivem ao sono ou desligamento. Anexe, espreite ou responda a qualquer sessão interrompida e ela reinicia de onde parou. Para reiniciar todas elas de uma vez, execute claude respawn --all.

A session is slow to respond after attaching

Depois que uma sessão termina e fica desanexada por cerca de uma hora, o supervisor interrompe seu processo para liberar recursos. Anexar inicia um novo processo de onde parou, o que leva um momento. Sessões que estão funcionando ou aguardando você nunca são interrompidas dessa forma.

`.claude/worktrees/` is filling up

Worktrees são removidos quando você deleta a sessão que as criou. Se uma sessão terminou sem limpar, liste entradas restantes com git worktree list no diretório do projeto e remova cada uma com git worktree remove <path>. Veja Clean up worktrees.

Limitações

Agent view é uma visualização de pesquisa. Limitações atuais a serem observadas:

Limites de taxa se aplicam: sessões em background consomem o uso de sua assinatura da mesma forma que sessões interativas, então executar dez agentes em paralelo usa cota aproximadamente dez vezes mais rápido do que executar um.
Sessões são locais: sessões em background são executadas em sua máquina e param se ela dormir ou desligar.
Worktrees são deletados com a sessão: mescle ou envie alterações antes de deletar uma sessão que editou arquivos em seu próprio worktree.

Próximos passos

Agora que você entende agent view, explore esses recursos relacionados:

Executar agentes em paralelo: compare agent view com subagentes, equipes de agentes e worktrees
Subagentes: defina configurações de agente reutilizáveis com prompts, ferramentas e isolamento personalizados
Equipes de agentes: coordene múltiplas sessões que se mensageiam
Claude Code na web: execute sessões em um ambiente de nuvem gerenciado em vez de localmente

agent-view.md +38 −19

24* [Gerenciar sessões do shell](#manage-sessions-from-the-shell)24* [Gerenciar sessões do shell](#manage-sessions-from-the-shell)

25* [Como as sessões em background são hospedadas](#how-background-sessions-are-hosted) pelo processo supervisor25* [Como as sessões em background são hospedadas](#how-background-sessions-are-hosted) pelo processo supervisor

26 26

~~27## Quick start~~27## Início rápido

28 28

29Este passo a passo abre agent view, despacha uma sessão, responde do painel de espiada e anexa para a conversa completa.29Este passo a passo abre agent view, despacha uma sessão, responde do painel de espiada e anexa para a conversa completa.

30 30

40 </Step>40 </Step>

41 41

42 <Step title="Despache uma sessão">42 <Step title="Despache uma sessão">

43 Digite um prompt na entrada e pressione `Enter`. Uma nova sessão é iniciada e aparece como uma linha mostrando se está funcionando, aguardando você ou concluída. Repita para executar quantas sessões em paralelo desejar.43 Digite um prompt na entrada e pressione `Enter`. Uma nova sessão é iniciada e aparece como uma linha mostrando se está funcionando, aguardando você ou concluída. Repita para executar várias sessões em paralelo. Cada uma usa sua cota de assinatura independentemente, portanto, consulte [Limitações](#limitations) antes de despachar muitas de uma vez.

44 </Step>44 </Step>

45 45

46 <Step title="Espiada e resposta">46 <Step title="Espiada e resposta">

56 56

57Você pode usar `claude agents` como seu ponto de entrada principal em vez de `claude`: despache cada tarefa de agent view, anexe quando quiser a conversa completa e pressione `←` para retornar à tabela.57Você pode usar `claude agents` como seu ponto de entrada principal em vez de `claude`: despache cada tarefa de agent view, anexe quando quiser a conversa completa e pressione `←` para retornar à tabela.

58 58

~~59## Monitor sessions with agent view~~59## Monitorar sessões com agent view

60 60

61Execute `claude agents` para abrir agent view. Ele assume o terminal completo e lista cada sessão agrupada por estado, com sessões fixadas e as que precisam de você no topo. Cada linha mostra o nome da sessão, atividade atual e há quanto tempo foi alterada pela última vez.61Execute `claude agents` para abrir agent view. Ele assume o terminal completo e lista cada sessão agrupada por estado, com sessões fixadas e as que precisam de você no topo. Cada linha mostra o nome da sessão, atividade atual e há quanto tempo foi alterada pela última vez.

62 62

63A lista é global para sua máquina e inclui cada sessão em background independentemente de qual projeto ou worktree está trabalhando. Sessões interativas que você tem abertas em outros terminais não aparecem até que você as [coloque em background](#from-inside-a-session), e [subagents](/pt/sub-agents) em execução dentro de uma sessão não são listados como linhas separadas.63A lista abrange cada sessão em background sob seu [diretório de configuração](#how-background-sessions-are-hosted), independentemente de qual projeto ou worktree está trabalhando, então uma sessão iniciada em um repositório e outra iniciada em um worktree diferente aparecem juntas. Sessões interativas que você tem abertas em outros terminais não aparecem até que você as [coloque em background](#from-inside-a-session), e [subagents](/pt/sub-agents) em execução dentro de uma sessão não são listados como linhas separadas.

64 64

65```text theme={null}65```text theme={null}

66Pinned66Pinned

67 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m67 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m

68 68

69Ready for review69Ready for review

~~70 ∙ jump physics github.com/anthropics/example/pull/2048 2h~~70 ∙ jump physics github.com/anthropics/example/pull/2048 ● 2h

71 71

72Needs input72Needs input

73 ✻ power-up design needs input: double jump or wall climb? 1m73 ✻ power-up design needs input: double jump or wall climb? 1m

82 … 6 more82 … 6 more

83```83```

84 84

~~85O ícone informa o estado da sessão:~~85O ícone de cada linha carrega dois sinais. O indicador informa o estado da sessão, e a forma do ícone informa se o processo subjacente ainda está em execução. Os estados são:

86 86

88| :-------- | :---------- | :-------------------------------------------------------------------------------------- |88| :-------- | :---------- | :-------------------------------------------------------------------------------------- |

99 99

100As sessões persistem no disco: fechar seu terminal ou uma atualização automática não as perde, e reabrir `claude agents` as mostra todas. Se sua máquina dormir ou desligar, as sessões em execução param; reinicie-as com `claude respawn --all`.100As sessões persistem no disco: fechar seu terminal ou uma atualização automática não as perde, e reabrir `claude agents` as mostra todas. Se sua máquina dormir ou desligar, as sessões em execução param; reinicie-as com `claude respawn --all`.

101 101

102O resumo de uma linha em cada linha é gerado pelo seu [modelo Haiku-class](/pt/model-config) configurado, para que a linha possa informar o que a sessão está fazendo, o que precisa ou o que produziu sem abrir o transcript. Cada resumo é uma solicitação curta de Haiku-class através de seu provedor normal, cobrada e tratada sob os mesmos [termos de uso de dados](/pt/data-usage) que a sessão em si.102O resumo de uma linha em cada linha é gerado pelo seu [modelo Haiku-class](/pt/model-config) configurado, para que a linha possa informar o que a sessão está fazendo, o que precisa ou o que produziu sem abrir o transcript. Enquanto uma sessão está ativamente funcionando, o resumo é atualizado no máximo uma vez a cada 15 segundos, mais uma vez quando cada turno termina. Cada atualização é uma solicitação curta de Haiku-class através de seu provedor normal, cobrada e tratada sob os mesmos [termos de uso de dados](/pt/data-usage) que a sessão em si.

103 103

104Quando uma sessão abre um pull request, a linha mostra o link do PR e um indicador de status para suas verificações de CI. Para a maioria das tarefas, esta linha é como você coleta o trabalho: revise e mescle o pull request quando suas verificações passarem.104Quando uma sessão abre um pull request, um ponto de status aparece na borda direita da linha, vinculado ao pull request em terminais que suportam hiperlinks. Quando a sessão abriu mais de um pull request, a contagem aparece antes do ponto e a cor reflete qual deles mais precisa de atenção.

105

106| Cor do ponto | Status do pull request |

107| :----------- | :----------------------------------------------------------- |

108| Amarelo | Aguardando verificações ou revisão, ou verificações falharam |

109| Verde | Verificações passaram e nenhuma revisão está bloqueando |

110| Roxo | Mesclado |

111| Cinza | Rascunho ou fechado |

112

113Para a maioria das tarefas, esta linha é onde você coleta o resultado: revise e mescle o pull request quando o ponto ficar verde.

105 114

106### Peek and reply115### Peek and reply

107 116

121 130

122Desanexar nunca interrompe uma sessão em background: `←`, `Ctrl+C`, `Ctrl+D`, `Ctrl+Z` e `/exit` a deixam em execução. Para encerrar uma sessão de dentro dela, execute `/stop`.131Desanexar nunca interrompe uma sessão em background: `←`, `Ctrl+C`, `Ctrl+D`, `Ctrl+Z` e `/exit` a deixam em execução. Para encerrar uma sessão de dentro dela, execute `/stop`.

123 132

124Depois de usar agent view, pressionar `←` em um prompt vazio funciona de qualquer sessão Claude Code, não apenas as que você anexou. Abre agent view com sua sessão atual pré-selecionada, para que você possa alternar sessões sem sair do terminal.133Depois de ter despachado ou colocado uma sessão em background, pressionar `←` em um prompt vazio funciona de qualquer sessão Claude Code, não apenas as que você anexou a partir de agent view. Coloca a sessão atual em background e abre agent view com essa sessão pré-selecionada, para que você possa alternar sessões sem sair do terminal. Você pode desativar este atalho em `/config`.

125 134

126### Organize the list135### Organize the list

127 136

163| `?` | Mostrar todos os atalhos |172| `?` | Mostrar todos os atalhos |

164 173

165## Dispatch new agents174## Despachar novos agentes

166 175

167Você pode despachar novas sessões em background a partir de agent view, enviar uma sessão interativa existente para o background ou iniciar uma diretamente do shell.176Você pode despachar novas sessões em background a partir de agent view, enviar uma sessão interativa existente para o background ou iniciar uma diretamente do shell.

168 177

183 192

184Digite `/` para despachar uma [skill](/pt/skills). Empacotar uma tarefa recorrente como uma skill permite que você inicie o mesmo fluxo de trabalho muitas vezes a partir de agent view sem redigitar o prompt. Pressione `Tab` em uma entrada vazia para procurar cada subagent despachável, ou para aplicar a sugestão destacada quando as sugestões estão sendo exibidas.193Digite `/` para despachar uma [skill](/pt/skills). Empacotar uma tarefa recorrente como uma skill permite que você inicie o mesmo fluxo de trabalho muitas vezes a partir de agent view sem redigitar o prompt. Pressione `Tab` em uma entrada vazia para procurar cada subagent despachável, ou para aplicar a sugestão destacada quando as sugestões estão sendo exibidas.

185 194

195Quando o mesmo `@name` corresponde tanto a um subagent quanto a um repositório irmão, o subagent tem precedência. A forma de primeira palavra sem `@` também se aplica a qualquer nome de subagent, portanto um prompt que começa com uma palavra correspondente a um de seus nomes de subagent despacha esse subagent. Use a forma `@` quando quiser ser explícito.

196

186#### Dispatch to a specific directory197#### Dispatch to a specific directory

187 198

188Uma nova sessão é executada no diretório em que você abriu agent view. Para direcionar um diretório diferente:199Uma nova sessão é executada no diretório em que você abriu agent view. Para direcionar um diretório diferente:

193 204

194Quando agent view é agrupado por diretório, o diretório da linha destacada se torna o alvo de despacho, para que você possa rolar para um grupo e despachar nele sem redigitar o caminho.205Quando agent view é agrupado por diretório, o diretório da linha destacada se torna o alvo de despacho, para que você possa rolar para um grupo e despachar nele sem redigitar o caminho.

195 206

196#### Isolate file edits in a worktree

~~197~~

198Sessões despachadas a partir de agent view compartilham seu diretório de trabalho por padrão, então dois agentes editando os mesmos arquivos podem entrar em conflito. Para evitar isso, Claude Code bloqueia uma sessão despachada a partir de agent view de escrever arquivos até que se mova para um [git worktree](/pt/worktrees) isolado. Claude lida com isso automaticamente quando precisa editar arquivos. O worktree é criado sob `.claude/worktrees/` dentro do diretório do projeto e removido quando você deleta a sessão. Deletar uma sessão também deleta seu worktree, então mescle ou envie as alterações que você quer manter antes de deletar.

~~199~~

200Para fazer um subagent sempre executar em seu próprio worktree independentemente de como foi iniciado, defina [`isolation: worktree`](/pt/sub-agents#supported-frontmatter-fields) em seu frontmatter.

~~201~~

202### From inside a session207### From inside a session

203 208

204Execute `/background` ou seu alias `/bg` para desanexar a conversa atual e mantê-la em execução. Passe um prompt como `/bg run the test suite and fix any failures` para enviar uma instrução adicional antes de desanexar.209Execute `/background` ou seu alias `/bg` para desanexar a conversa atual e mantê-la em execução. Passe um prompt como `/bg run the test suite and fix any failures` para enviar uma instrução adicional antes de desanexar.

227 claude stop 7c5dcf5d stop this session232 claude stop 7c5dcf5d stop this session

228```233```

229 234

235### How file edits are isolated

236

237Toda sessão em background, seja iniciada a partir de agent view, `/bg` ou `claude --bg`, inicia no seu diretório de trabalho, mas é bloqueada de escrever arquivos lá. Quando a sessão precisa editar arquivos, Claude a move para um [git worktree](/pt/worktrees) isolado sob `.claude/worktrees/` automaticamente, para que sessões paralelas possam ler o mesmo checkout, mas cada uma escreve no seu próprio. O bloqueio não se aplica quando a sessão já está dentro de um worktree, quando o diretório de trabalho não é um repositório git, ou para escritas fora do diretório de trabalho.

238

239O worktree é removido quando você deleta a sessão, portanto mescle ou envie as alterações que você quer manter antes de deletar. Para encontrar o caminho do worktree de uma sessão, espreite a sessão ou anexe e verifique seu diretório de trabalho.

240

241Para fazer um subagent sempre executar em seu próprio worktree independentemente de como foi iniciado, defina [`isolation: worktree`](/pt/sub-agents#supported-frontmatter-fields) em seu frontmatter.

242

243### Permission mode and settings

244

245Uma sessão despachada lê suas [settings](/pt/settings) e [permission mode](/pt/permissions) do diretório em que é executada, da mesma forma que se você tivesse iniciado `claude` lá. Despachar a partir da entrada de agent view não passa um permission mode, portanto a sessão usa o `defaultMode` das settings daquele diretório ou o `permissionMode` do [frontmatter do subagent](/pt/sub-agents#supported-frontmatter-fields) despachado.

246

247Para definir o modo a partir do shell, passe `--permission-mode` com `claude --bg`. Usar `bypassPermissions` ou `auto` desta forma é recusado até que você tenha aceitado esse modo executando `claude` com ele uma vez interativamente, já que esses modos permitem que uma sessão que você não está observando aja sem aprovação.

248

230## Manage sessions from the shell249## Manage sessions from the shell

231 250

232Cada sessão em background tem um ID curto que você pode usar do shell. Esses comandos são úteis para scripts ou quando você não quer abrir agent view.251Cada sessão em background tem um ID curto que você pode usar do shell. Esses comandos são úteis para scripts ou quando você não quer abrir agent view.

277 296

278Worktrees são removidos quando você deleta a sessão que as criou. Se uma sessão terminou sem limpar, liste entradas restantes com `git worktree list` no diretório do projeto e remova cada uma com `git worktree remove <path>`. Veja [Clean up worktrees](/pt/worktrees#clean-up-worktrees).297Worktrees são removidos quando você deleta a sessão que as criou. Se uma sessão terminou sem limpar, liste entradas restantes com `git worktree list` no diretório do projeto e remova cada uma com `git worktree remove <path>`. Veja [Clean up worktrees](/pt/worktrees#clean-up-worktrees).

279 298

280## Limitations299## Limitações

281 300

282Agent view é uma visualização de pesquisa. Limitações atuais a serem observadas:301Agent view é uma visualização de pesquisa. Limitações atuais a serem observadas:

283 302

284* **Limites de taxa se aplicam**: sessões em background reduzem seu uso de assinatura da mesma forma que sessões interativas, então executar dez agentes em paralelo usa cota dez vezes mais rápido.303* **Limites de taxa se aplicam**: sessões em background consomem o uso de sua assinatura da mesma forma que sessões interativas, então executar dez agentes em paralelo usa cota aproximadamente dez vezes mais rápido do que executar um.

285* **Sessões são locais**: sessões em background são executadas em sua máquina e param se ela dormir ou desligar.304* **Sessões são locais**: sessões em background são executadas em sua máquina e param se ela dormir ou desligar.

286* **Worktrees são deletados com a sessão**: mescle ou envie alterações antes de deletar uma sessão que editou arquivos em seu próprio worktree.305* **Worktrees são deletados com a sessão**: mescle ou envie alterações antes de deletar uma sessão que editou arquivos em seu próprio worktree.

287 306

agent-view.md 2026-05-11 23:00 UTC to 2026-05-12 22:57 UTC

Gerenciar múltiplos agentes com agent view

Início rápido

Abrir agent view

Despache uma sessão

Espiada e resposta

Anexar e desanexar

Monitorar sessões com agent view

Peek and reply

Attach to a session

Organize the list

Filter the list

Keyboard shortcuts

Despachar novos agentes

From agent view

Dispatch to a specific directory

From inside a session

From the shell

How file edits are isolated

Permission mode and settings

Manage sessions from the shell

How background sessions are hosted

Troubleshooting

Agent view opens with no sessions

Sessions show as stopped after waking your machine

A session is slow to respond after attaching

.claude/worktrees/ is filling up

Limitações

Próximos passos

`.claude/worktrees/` is filling up