Agent view, aberto comDocumentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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ê. Cada sessão em background é uma conversa completa do Claude Code que continua em execução sem um terminal anexado, então você pode abri-la, responder e sair sempre que quiser.

Agent view está em visualização de pesquisa e requer Claude Code v2.1.139 ou posterior. Verifique sua versão com
claude --version. A interface e os atalhos de teclado podem mudar conforme o recurso evolui.- Início rápido: dê a Claude uma tarefa para trabalhar em background, verifique-a e intervenha quando necessário
- 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 seu 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 aborda o loop de visualização do agente principal: despache uma tarefa, observe sua linha ser atualizada conforme Claude trabalha, espreite para verificar e responda, e anexe para a conversa completa. A sessão que você despacha continua em execução após você fechar a visualização do agente, portanto você pode sair e voltar a ela.Abrir visualização do agente
Do seu shell, execute:A visualização do agente 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 retornar ao seu shell. Suas sessões continuam em execução enquanto você está ausente e reaparecem na próxima vez que você abrir a visualização do agente.Despache uma sessão
Digite um prompt descrevendo uma tarefa e pressione
Enter. Uma nova sessão em background é iniciada nessa tarefa e aparece como uma linha mostrando se está funcionando, aguardando você ou concluída. A nova sessão usa o modelo mostrado no cabeçalho da visualização do agente e o mesmo modo de permissão que você obteria executando claude naquele diretório.Cada prompt que você digita aqui inicia sua própria sessão nova. Digitar outro prompt e pressionar Enter inicia uma segunda sessão ao lado da primeira em vez de enviar um acompanhamento para ela. Você pode executar várias em paralelo desta forma.Cada sessão usa sua cota de assinatura independentemente, portanto, consulte Limitações antes de despachar muitas de uma vez.Espreite e responda
Selecione uma linha com as teclas de seta e pressione
Space para abrir o painel de espiada. Ele mostra a saída mais recente da sessão, ou a pergunta que está aguardando, em vez da transcrição completa. Digite uma resposta e pressione Enter para enviá-la sem sair da visualização do agente.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.Trazer uma sessão existente
Para mover uma sessão que você já tem aberta para a visualização do agente, execute
/bg dentro dela, ou pressione ← em um prompt vazio para colocá-la em background e abrir a visualização do agente em uma etapa. A sessão continua em execução e aparece como uma linha ao lado das que você despachou.claude agents como seu ponto de entrada principal em vez de claude: despache cada tarefa da visualização do agente, anexe quando quiser a conversa completa e pressione ← para retornar à tabela.
Monitorar sessões com agent view
Executeclaude 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 mostra cada sessão em background que você iniciou, em todos os seus projetos. Uma sessão funcionando em um repositório e outra em um worktree diferente aparecem aqui, independentemente de qual diretório você abriu agent view. Sessões interativas que você tem abertas em outros terminais não aparecem até que você as coloque em background. Subagents e teammates que uma sessão gera não são listados como linhas separadas.
Ler estado da sessão
Cada linha começa com um ícone cuja cor e animação mostram o estado da sessão:| Estado | Ícone mostra como | O que significa |
|---|---|---|
| Working | Animado | Claude está executando ativamente ferramentas ou gerando uma resposta |
| Needs input | Amarelo | Claude está aguardando uma pergunta específica ou decisão de permissão de você |
| Idle | Esmaecido | A sessão não tem nada a fazer e está pronta para seu próximo prompt |
| Completed | Verde | A tarefa foi concluída com sucesso |
| Failed | Vermelho | A tarefa terminou com um erro |
| Stopped | Cinza | A sessão foi interrompida com Ctrl+X ou claude stop |
| Forma | O que significa |
|---|---|
✻ ou ✽ animado | O processo da sessão está vivo e responde imediatamente |
∙ | O processo saiu. Você ainda pode espreitar, responder ou anexar, e Claude reinicia de onde parou |
✢ | Uma sessão /loop dormindo entre iterações. A linha mostra sua contagem de execução e uma contagem regressiva |
claude respawn --all.
Resumos de linha
O resumo de uma linha em cada linha é gerado por um modelo Haiku-class 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.Status de pull request
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 |
Peek and reply
PressioneSpace 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.
Anexar a uma sessão
PressioneEnter ou → em uma linha selecionada para anexar. 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.
Organizar a lista
Agent view agrupa sessões para que as que precisam de entrada estejam no topo, comReady for review e Needs input acima de Working e Completed. Esses nomes de grupo não mapeiam um-para-um para os estados acima: uma sessão se move para Ready for review quando tem um pull request aberto, e Completed coleta sessões concluídas, falhadas e interrompidas juntas. Pressione Ctrl+S para agrupar por diretório em vez disso. Sua escolha persiste entre execuções.
Dentro de um grupo:
- Pressione
Ctrl+Tpara fixar uma sessão no topo - Pressione
Shift+↑ouShift+↓para reordenar sessões - Pressione
Ctrl+Rpara renomear uma sessão - Pressione
Enterem um cabeçalho de grupo para recolhê-lo
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.
Deletar remove a sessão de agent view e limpa seu worktree, incluindo quaisquer alterações não confirmadas nele, então faça push ou commit do trabalho que você quer manter antes de deletar. O transcript da conversa permanece no disco e continua disponível através de claude --resume.
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.
Filtrar sessões
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:working. Também aceita s:blocked para tudo que está aguardando você |
#<number> ou uma URL de PR | A sessão trabalhando naquele pull request |
Atalhos de teclado
Pressione? em agent view para ver cada atalho em contexto. A tabela abaixo os resume.
| 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 à sessão 1–9 no grupo atual |
Tab | Em uma entrada vazia, procurar todos os subagents. Caso contrário, 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 pressioneEnter para iniciar uma nova sessão em background. A sessão é nomeada automaticamente a partir do prompt; renomeie-a 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 |
@name corresponde tanto a um subagent quanto a um repositório irmão, o subagent tem precedência. A correspondência de primeira palavra sem @ também se aplica, portanto um prompt que começa com um de seus nomes de subagent despacha esse subagent em vez de tratar a palavra como texto simples. Use a forma @ quando quiser ser explícito, ou comece o prompt com uma palavra diferente para evitar a correspondência.
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 agentsnaquele diretório. - Abra
claude agentsem 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,
cdpara o diretório e executeclaude --bg "<prompt>".
From inside a session
Execute/background ou seu alias /bg para mover a conversa atual para uma sessão em background. Passe um prompt como /bg run the test suite and fix any failures para dar uma instrução adicional primeiro.
Colocar em background a partir de uma sessão interativa inicia um novo processo que retoma da conversa salva, portanto executar subagents, monitors e comandos em background não são transferidos para ele. Claude pede que você confirme antes de colocar em background quando algum deles está em execução. Uma vez em background, a sessão pode iniciar novos subagents, monitors e comandos em background, e esses continuam em execução em desanexações e reanexações posteriores.
From your shell
Passe--bg para iniciar uma sessão que vai direto para o background:
--bg com --agent:
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. Antes de editar arquivos, Claude move a sessão para um git worktree isolado sob .claude/worktrees/, para que sessões paralelas possam ler o mesmo checkout, mas cada uma escreve no seu próprio. Claude pula isso quando a sessão já está sob .claude/worktrees/, quando o diretório de trabalho não é um repositório git, ou para escritas fora do diretório de trabalho.
Fora de um repositório git, as sessões escrevem no diretório de trabalho diretamente e não são isoladas uma da outra, portanto evite despachar sessões paralelas que editam os mesmos arquivos.
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.
Set the model
O nome do modelo mostrado no cabeçalho de agent view é o padrão de despacho. Novas sessões que você inicia a partir da entrada usam este modelo, que é a mesma configuração que/model controla em qualquer sessão. Para substituir para toda a sessão de agent view, passe --model ao abrir agent view. Veja Permission mode, model, and effort.
Cada sessão em background pode ser executada em um modelo diferente. Para substituir para uma sessão:
- Do shell, passe
--modelcomclaude --bg. - Anexe a uma sessão em execução e execute
/modellá. A alteração persiste se a sessão for reiniciada. - Despache um subagent cujo frontmatter define um campo
model.
Permission mode, model, and effort
Uma sessão despachada lê suas settings e permission mode do diretório em que é executada, da mesma forma que se você tivesse iniciadoclaude lá.
Para definir padrões para cada sessão que você despacha a partir de agent view, passe qualquer um de --permission-mode, --model ou --effort ao abri-lo:
defaultMode das settings daquele diretório ou o permissionMode do frontmatter do subagent despachado, e o modelo mostrado no cabeçalho de agent view.
Usar bypassPermissions ou auto é 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. O mesmo se aplica se você passar o modo para claude agents ou para claude --bg --permission-mode.
Settings, plugins, and MCP servers
Agent view aceita as mesmas flags de configuração queclaude para carregar settings, plugins, servidores MCP e diretórios adicionais. Cada flag se aplica a agent view em si e é passada para cada sessão que você despacha a partir dele, portanto um plugin ou servidor MCP que você carrega desta forma está disponível nessas sessões também.
| Flag | Efeito |
|---|---|
--settings <file-or-json> | Substituir settings para agent view e sessões despachadas |
--add-dir <path> | Conceder acesso a arquivo a um diretório adicional |
--plugin-dir <path> | Carregar um plugin de um diretório local |
--mcp-config <file-or-json> | Carregar servidores MCP de um arquivo de configuração ou string JSON |
--strict-mcp-config | Usar apenas os servidores MCP de --mcp-config, ignorando outra configuração MCP |
--add-dir, --plugin-dir ou --mcp-config uma vez por valor. A forma separada por espaço, como --add-dir a b c, não é suportada com claude agents.
O exemplo a seguir abre agent view com uma substituição de settings e um diretório extra:
Gerenciar sessões do shell
Cada sessão em background tem um ID curto que você pode usar do shell. O ID é impresso quando você inicia uma sessão comclaude --bg, e o ID de cada sessão é seu nome de diretório em ~/.claude/jobs/. 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. Limpa seu worktree se não houver alterações não confirmadas |
Como as sessões em background são hospedadas
Toda sessão listada na visualização de agente é considerada uma sessão em background, independentemente de você estar atualmente anexado a ela. Em contraste, uma sessão iniciada executandoclaude diretamente está vinculada a esse terminal e termina quando ele fecha, a menos que você a envie para o background.
O processo supervisor
Sessões em background são hospedadas por um processo supervisor por usuário, separado do seu terminal e da visualização de agente. O supervisor é iniciado automaticamente na primeira vez que você coloca uma sessão em background ou abre a visualização de agente, 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, gerenciado pelo supervisor em vez de estar vinculado ao 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ê precisar dele. 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.Onde o estado é armazenado
O estado da sessão é armazenado sob seu diretório de configuração Claude Code. Se você definirCLAUDE_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 na visualização de agente |
Desativar a visualização de agente
Para desativar agentes em background e a visualização de agente completamente, defina a configuraçãodisableAgentView 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
claude agents lista subagentes em vez de abrir a visualização de agentes
Se claude agents imprime uma contagem seguida pelos seus subagentes configurados e depois sai, a visualização de agentes não está disponível no seu ambiente. Versões anteriores não abriam a visualização de agentes em todos os ambientes, incluindo quando conectado através de Bedrock, Vertex AI ou Foundry. Execute claude update para instalar a versão mais recente.
Se a visualização de agentes ainda não abrir após atualizar, verifique se ela foi desativada por uma configuração ou variável de ambiente.
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 pressioneEnter.
Cannot open agents because background tasks are running
Se pressionar← para colocar a sessão atual em background mostrar Cannot open agents — N background task(s) running, a sessão tem trabalho em andamento, como um subagente, um workflow ou um comando shell em background, e o atalho não o abandonará silenciosamente. Execute /tasks para ver o que está em execução, depois /bg para confirmar o abandono deles. Veja From inside a session para saber o que é e o que não é transferido quando você coloca em background.
Prompt rejected as too short
A entrada de dispatch espera uma descrição de tarefa, não um abridor conversacional. Um prompt com menos de quatro caracteres é rejeitado com uma dicaToo short para que um pressionamento de tecla acidental não inicie uma sessão. Descreva o que você quer que a sessão faça, como investigate the flaky checkout test.
Sessions show as failed after waking your machine
Sessões em background não sobrevivem ao sono ou desligamento, então sessões que estavam em execução mostram como falhadas após você acordar. Anexe, espreite ou responda a qualquer uma delas e a sessão reinicia de onde parou. Para reiniciar todas elas de uma vez, executeclaude 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 está em visualização de pesquisa com as seguintes limitações:- 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.
Recursos relacionados
Para outras maneiras de executar Claude em paralelo, consulte:- Executar agentes em paralelo: compare agent view com subagentes, equipes de agentes e worktrees
- 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
