6 6
7> 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.7> 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.
8 8
9Agent 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.9Agent 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ê. 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.
10 10
11Use 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.11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="Agent view em um terminal: o cabeçalho mostra Claude Code v2.1.140, o modelo, o diretório de trabalho e uma contagem de resumo. As sessões são agrupadas em Precisa de entrada, Trabalhando e Concluído, com uma entrada de despacho na parte inferior e um rodapé de dicas de atalhos de teclado." width="1772" height="780" data-path="images/agent-view-light.png" />
12 12
13Sessõ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](/pt/agents).13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="Agent view em um terminal: o cabeçalho mostra Claude Code v2.1.140, o modelo, o diretório de trabalho e uma contagem de resumo. As sessões são agrupadas em Precisa de entrada, Trabalhando e Concluído, com uma entrada de despacho na parte inferior e um rodapé de dicas de atalhos de teclado." width="1772" height="780" data-path="images/agent-view-dark.png" />
14
15Use agent view quando você tiver várias tarefas independentes que Claude pode trabalhar sem você observar cada passo. Despache uma correção de bug, uma revisão de pull request e uma investigação de teste instável como três linhas, continue trabalhando em outra janela e verifique quando uma linha mostrar que precisa de você ou tem um resultado.
16
17Quando você quer trabalhar de forma mais direta em qualquer sessão de um agente, anexe-se à linha para entrar na conversa completa.
18
19Para comparar agent view com subagentes, equipes de agentes e worktrees, consulte [Executar agentes em paralelo](/pt/agents).
14 20
15<Note>21<Note>
16 Agent view é uma 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, e os administradores podem desabilitar agent view para uma organização com a configuração gerenciada [`disableAgentView`](#how-background-sessions-are-hosted).22 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.
17</Note>23</Note>
18 24
19Esta página cobre:25Esta página cobre:
20 26
21* [Início rápido](#quick-start)27* [Início rápido](#quick-start): dê a Claude uma tarefa para trabalhar em background, verifique-a e intervenha quando necessário
22* [Monitorar sessões com agent view](#monitor-sessions-with-agent-view), incluindo ícones de estado, espiada e resposta, anexação, organização e atalhos de teclado28* [Monitorar sessões com agent view](#monitor-sessions-with-agent-view), incluindo ícones de estado, espiada e resposta, anexação, organização e atalhos de teclado
23* [Despache novos agentes](#dispatch-new-agents) a partir de agent view, de dentro de uma sessão ou do shell29* [Despache novos agentes](#dispatch-new-agents) a partir de agent view, de dentro de uma sessão ou do seu shell
24* [Gerenciar sessões do shell](#manage-sessions-from-the-shell)30* [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 supervisor31* [Como as sessões em background são hospedadas](#how-background-sessions-are-hosted) pelo processo supervisor
26 32
27## Início rápido33## Início rápido
28 34
29Este passo a passo abre agent view, despacha uma sessão, responde do painel de espiada e anexa para a conversa completa.35Este 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.
30 36
31<Steps>37<Steps>
32 <Step title="Abrir agent view">38 <Step title="Abrir visualização do agente">
33 Do seu shell, execute:39 Do seu shell, execute:
34 40
35 ```bash theme={null}41 ```bash theme={null}
36 claude agents42 claude agents
37 ```43 ```
38 44
39 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.45 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.
40 </Step>46 </Step>
41 47
42 <Step title="Despache uma sessão">48 <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 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.49 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](#permission-mode-and-settings) que você obteria executando `claude` naquele diretório.
50
51 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.
52
53 Cada sessão usa sua cota de assinatura independentemente, portanto, consulte [Limitações](#limitations) antes de despachar muitas de uma vez.
44 </Step>54 </Step>
45 55
46 <Step title="Espiada e resposta">56 <Step title="Espreite e responda">
47 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.57 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.
48 </Step>58 </Step>
49 59
50 <Step title="Anexar e desanexar">60 <Step title="Anexar e desanexar">
51 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.61 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.
52 </Step>62 </Step>
53</Steps>
54 63
55Para 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>"`.64 <Step title="Trazer uma sessão existente">
65 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.
66 </Step>
67</Steps>
56 68
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.69Você pode usar `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.
58 70
59## Monitorar sessões com agent view71## Monitorar sessões com agent view
60 72
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.73Execute `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 74
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.75A 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](#from-inside-a-session). [Subagents](/pt/sub-agents) e [teammates](/pt/agent-teams) que uma sessão gera não são listados como linhas separadas.
64 76
65```text theme={null}77```text theme={null}
66Pinned78Pinned
67 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m79 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m
68 80
69Ready for review81Ready for review
70 ∙ jump physics github.com/anthropics/example/pull/2048 ● 2h82 ∙ jump physics github.com/example/game/pull/2048 ● 2h
71 83
72Needs input84Needs input
73 ✻ power-up design needs input: double jump or wall climb? 1m85 ✻ power-up design needs input: double jump or wall climb? 1m
82 … 6 more94 … 6 more
83```95```
84 96
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:97### Ler estado da sessão
98
99Cada linha começa com um ícone cuja cor e animação mostram o estado da sessão:
100
101| Estado | Ícone mostra como | O que significa |
102| :---------- | :---------------- | :----------------------------------------------------------------------------- |
103| Working | Animado | Claude está executando ativamente ferramentas ou gerando uma resposta |
104| Needs input | Amarelo | Claude está aguardando uma pergunta específica ou decisão de permissão de você |
105| Idle | Esmaecido | A sessão não tem nada a fazer e está pronta para seu próximo prompt |
106| Completed | Verde | A tarefa foi concluída com sucesso |
107| Failed | Vermelho | A tarefa terminou com um erro |
108| Stopped | Cinza | A sessão foi interrompida com `Ctrl+X` ou `claude stop` |
86 109
87| Indicador | Estado | O que significa |110Separadamente, a forma do ícone mostra se o processo subjacente está em execução:
88| :-------- | :---------- | :-------------------------------------------------------------------------------------- |
89| Animado | Working | Claude está executando ativamente ferramentas ou gerando uma resposta |
90| Amarelo | Needs input | Claude está aguardando sua entrada, geralmente uma decisão de permissão ou uma resposta |
91| Esmaecido | Idle | A sessão está aguardando entrada, mas não está bloqueada em uma pergunta específica |
92| Verde | Completed | A tarefa foi concluída com sucesso |
93| Vermelho | Failed | A tarefa terminou com um erro |
94| Cinza | Stopped | A sessão foi interrompida com `Ctrl+X` ou `claude stop` |
95 111
96A 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`](/pt/commands) dormindo entre iterações, com a linha mostrando sua contagem de execução e uma contagem regressiva para a próxima iteração.112| Forma | O que significa |
113| :----------------- | :------------------------------------------------------------------------------------------------------------------------------------ |
114| `✻` ou `✽` animado | O processo da sessão está vivo e responde imediatamente |
115| `∙` | O processo saiu. Você ainda pode espreitar, responder ou anexar, e Claude reinicia de onde parou |
116| `✢` | Uma sessão [`/loop`](/pt/scheduled-tasks) dormindo entre iterações. A linha mostra sua contagem de execução e uma contagem regressiva |
97 117
98Sessões em background não precisam de nenhum terminal aberto para continuar funcionando. Um [processo supervisor](#how-background-sessions-are-hosted) 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.118Sessões em background não precisam de nenhum terminal aberto para continuar funcionando. Um [processo supervisor](#the-supervisor-process) 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.
99 119
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`.120O estado da sessão persiste no disco através de atualizações automáticas e reinicializações do supervisor. Se sua máquina dormir ou desligar, as sessões em execução param; reinicie-as com `claude respawn --all`.
101 121
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.122### Resumos de linha
123
124O resumo de uma linha em cada linha é gerado por um [modelo Haiku-class](/pt/model-config) 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.
125
126Cada 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.
127
128### Status de pull request
103 129
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.130Quando 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 131
120 146
121Use `↑` e `↓` para espreitar sessões adjacentes sem fechar o painel, ou `→` para anexar.147Use `↑` e `↓` para espreitar sessões adjacentes sem fechar o painel, ou `→` para anexar.
122 148
123### Attach to a session149### Anexar a uma sessão
124 150
125Pressione `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.151Pressione `Enter` 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.
126 152
127Enquanto anexado, a sessão se comporta como qualquer outra sessão Claude Code: cada [comando](/pt/commands), atalho de teclado e recurso funciona.153Enquanto anexado, a sessão se comporta como qualquer outra sessão Claude Code: cada [comando](/pt/commands), atalho de teclado e recurso funciona.
128 154
132 158
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`.159Depois 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`.
134 160
135### Organize the list161### Organizar a lista
162
163Agent view agrupa sessões para que as que precisam de entrada estejam no topo, com `Ready for review` e `Needs input` acima de `Working` e `Completed`. Esses nomes de grupo não mapeiam um-para-um para os [estados](#read-session-state) 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.
164
165Dentro de um grupo:
136 166
137Agent 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.167* Pressione `Ctrl+T` para fixar uma sessão no topo
168* Pressione `Shift+↑` ou `Shift+↓` para reordenar sessões
169* Pressione `Ctrl+R` para renomear uma sessão
170* Pressione `Enter` em um cabeçalho de grupo para recolhê-lo
138 171
139Sessõ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.172Para remover uma sessão da lista, 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.
140 173
141### Filter the list174Deletar remove a sessão de agent view e limpa seu [worktree](#how-file-edits-are-isolated), 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`.
175
176Sessõ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.
177
178### Filtrar sessões
142 179
143Digite na entrada de despacho para filtrar em vez de despachar:180Digite na entrada de despacho para filtrar em vez de despachar:
144 181
145| Filtro | Mostra |182| Filtro | Mostra |
146| :--------------------------- | :------------------------------------------------------------------------------ |183| :--------------------------- | :---------------------------------------------------------------------------------------------------------- |
147| `a:<name>` | Sessões executando o agente nomeado |184| `a:<name>` | Sessões executando o agente nomeado |
148| `s:<state>` | Sessões no estado fornecido, como `s:blocked` para sessões que precisam de você |185| `s:<state>` | Sessões no estado fornecido, como `s:working`. Também aceita `s:blocked` para tudo que está aguardando você |
149| `#<number>` ou uma URL de PR | A sessão trabalhando naquele pull request |186| `#<number>` ou uma URL de PR | A sessão trabalhando naquele pull request |
150 187
151### Keyboard shortcuts188### Atalhos de teclado
152 189
153Pressione `?` em agent view para ver cada atalho. Os mais comuns:190Pressione `?` em agent view para ver cada atalho em contexto. A tabela abaixo os resume.
154 191
155| Atalho | Ação |192| Atalho | Ação |
156| :-------------------- | :------------------------------------------------------------------------------- |193| :-------------------- | :---------------------------------------------------------------------------------------------- |
157| `↑` / `↓` | Mover entre linhas |194| `↑` / `↓` | Mover entre linhas |
158| `Enter` | Anexar à sessão selecionada, ou despachar se houver texto na entrada |195| `Enter` | Anexar à sessão selecionada, ou despachar se houver texto na entrada |
159| `Space` | Abrir ou fechar o painel de espiada para a sessão selecionada |196| `Space` | Abrir ou fechar o painel de espiada para a sessão selecionada |
160| `Shift+Enter` | Despachar e anexar imediatamente |197| `Shift+Enter` | Despachar e anexar imediatamente |
161| `→` | Anexar à sessão selecionada |198| `→` | Anexar à sessão selecionada |
162| `Alt+1`..`Alt+9` | Anexar à Nª sessão no grupo focado |199| `Alt+1`..`Alt+9` | Anexar à sessão 1–9 no grupo atual |
163| `Tab` | Procurar todos os subagents, ou aplicar a sugestão destacada |200| `Tab` | Em uma entrada vazia, procurar todos os subagents. Caso contrário, aplicar a sugestão destacada |
164| `Ctrl+S` | Alternar agrupamento entre estado e diretório |201| `Ctrl+S` | Alternar agrupamento entre estado e diretório |
165| `Ctrl+T` | Fixar ou desafixar a sessão selecionada |202| `Ctrl+T` | Fixar ou desafixar a sessão selecionada |
166| `Ctrl+R` | Renomear a sessão selecionada |203| `Ctrl+R` | Renomear a sessão selecionada |
177 214
178### From agent view215### From agent view
179 216
180Digite 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.217Digite 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; renomeie-a mais tarde com `Ctrl+R`.
218
219Cole uma imagem no prompt para incluir uma captura de tela ou diagrama com a tarefa.
181 220
182Prefixe ou mencione partes do prompt para controlar como a sessão é iniciada:221Prefixe ou mencione partes do prompt para controlar como a sessão é iniciada:
183 222
190| `#<number>` ou uma URL de pull request | Se uma sessão já está trabalhando naquele PR, selecione-a em vez de despachar |229| `#<number>` ou uma URL de pull request | Se uma sessão já está trabalhando naquele PR, selecione-a em vez de despachar |
191| `Shift+Enter` | Despachar e anexar imediatamente à nova sessão |230| `Shift+Enter` | Despachar e anexar imediatamente à nova sessão |
192 231
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.232Empacotar uma tarefa recorrente como uma [skill](/pt/skills) permite que você inicie o mesmo fluxo de trabalho a partir de agent view repetidamente sem redigitar o prompt.
194 233
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.234Quando o mesmo `@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.
196 235
197#### Dispatch to a specific directory236#### Dispatch to a specific directory
198 237
206 245
207### From inside a session246### From inside a session
208 247
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.248Execute `/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.
249
250Colocar em background a partir de uma sessão interativa inicia um novo processo que retoma da conversa salva, portanto executar subagents, [monitors](/pt/tools-reference#monitor-tool) 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.
210 251
211### From the shell252### From your shell
212 253
213Passe `--bg` para iniciar uma sessão que vai direto para o background:254Passe `--bg` para iniciar uma sessão que vai direto para o background:
214 255
234 275
235### How file edits are isolated276### How file edits are isolated
236 277
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.278Toda 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](/pt/worktrees) 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.
279
280Fora 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.
238 281
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.282O 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 283
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.284Para 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 285
286### Set the model
287
288O 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`](/pt/model-config) controla em qualquer sessão.
289
290Cada sessão em background pode ser executada em um modelo diferente. Para substituir para uma sessão:
291
292* Do shell, passe `--model` com `claude --bg`.
293* Anexe a uma sessão em execução e execute `/model` lá. A alteração persiste se a sessão for reiniciada.
294* Despache um [subagent](/pt/sub-agents) cujo frontmatter define um campo `model`.
295
243### Permission mode and settings296### Permission mode and settings
244 297
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.298Uma 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 299
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.300Para 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 301
249## Manage sessions from the shell302## Gerenciar sessões do shell
250 303
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.304Cada sessão em background tem um ID curto que você pode usar do shell. O ID é impresso quando você inicia uma sessão com `claude --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.
252 305
253| Comando | Propósito |306| Comando | Propósito |
254| :--------------------- | :--------------------------------------------------------- |307| :--------------------- | :--------------------------------------------------------------------------------------- |
255| `claude agents` | Abrir agent view |308| `claude agents` | Abrir agent view |
256| `claude attach <id>` | Anexar a uma sessão neste terminal |309| `claude attach <id>` | Anexar a uma sessão neste terminal |
257| `claude logs <id>` | Imprimir a saída recente da sessão |310| `claude logs <id>` | Imprimir a saída recente da sessão |
258| `claude stop <id>` | Interromper uma sessão. Também aceita `claude kill` |311| `claude stop <id>` | Interromper uma sessão. Também aceita `claude kill` |
259| `claude respawn <id>` | Reiniciar uma sessão interrompida com sua conversa intacta |312| `claude respawn <id>` | Reiniciar uma sessão interrompida com sua conversa intacta |
260| `claude respawn --all` | Reiniciar cada sessão interrompida |313| `claude respawn --all` | Reiniciar cada sessão interrompida |
261| `claude rm <id>` | Remover uma sessão da lista |314| `claude rm <id>` | Remover uma sessão da lista. Limpa seu worktree se não houver alterações não confirmadas |
315
316## Como as sessões em background são hospedadas
317
318Toda 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 executando `claude` diretamente está vinculada a esse terminal e termina quando ele fecha, a menos que você [a envie para o background](#from-inside-a-session).
319
320### O processo supervisor
321
322Sessõ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.
262 323
263## How background sessions are hosted324O 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.
264 325
265Sessõ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.326Cada 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.
266 327
267Cada 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.328Depois 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.
268 329
269O supervisor observa o binário Claude Code instalado no disco e reinicia para a nova versão após o [auto-updater](/pt/setup#auto-updates) 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.330O supervisor observa o binário Claude Code instalado no disco e reinicia para a nova versão após o [auto-updater](/pt/setup#auto-updates) 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.
270 331
332### Onde o estado é armazenado
333
271O estado da sessão é armazenado sob seu diretório de configuração Claude Code. Se você definir [`CLAUDE_CONFIG_DIR`](/pt/env-vars), o supervisor usa esse diretório em vez de `~/.claude` e é executado como uma instância separada com suas próprias sessões.334O estado da sessão é armazenado sob seu diretório de configuração Claude Code. Se você definir [`CLAUDE_CONFIG_DIR`](/pt/env-vars), o supervisor usa esse diretório em vez de `~/.claude` e é executado como uma instância separada com suas próprias sessões.
272 335
273| Caminho | Conteúdo |336| Caminho | Conteúdo |
274| :------------------------------- | :-------------------------------------------------------------------------------------------- |337| :------------------------------- | :-------------------------------------------------------------------------------------------- |
275| `~/.claude/daemon.log` | Log do supervisor |338| `~/.claude/daemon.log` | Log do supervisor |
276| `~/.claude/daemon/roster.json` | Lista de sessões em background em execução, usada para se reconectar após uma reinicialização |339| `~/.claude/daemon/roster.json` | Lista de sessões em background em execução, usada para se reconectar após uma reinicialização |
277| `~/.claude/jobs/<id>/state.json` | Estado por sessão mostrado em agent view |340| `~/.claude/jobs/<id>/state.json` | Estado por sessão mostrado na visualização de agente |
341
342### Desativar a visualização de agente
278 343
279Para desativar agentes em background e agent view completamente, defina a [configuração](/pt/settings) `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](/pt/permissions#managed-settings).344Para desativar agentes em background e a visualização de agente completamente, defina a [configuração](/pt/settings) `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](/pt/permissions#managed-settings).
280 345
281## Troubleshooting346## Troubleshooting
282 347
348### `claude agents` lista subagentes em vez de abrir a visualização de agentes
349
350Se `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.
351
352Se a visualização de agentes ainda não abrir após atualizar, verifique se ela foi [desativada](#turn-off-agent-view) por uma configuração ou variável de ambiente.
353
283### Agent view opens with no sessions354### Agent view opens with no sessions
284 355
285Agent view está vazio até que você despache sua primeira sessão. Digite um prompt na entrada na parte inferior e pressione `Enter`.356Agent view está vazio até que você despache sua primeira sessão. Digite um prompt na entrada na parte inferior e pressione `Enter`.
286 357
287### Sessions show as stopped after waking your machine358### Cannot open agents because background tasks are running
359
360Se 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](#from-inside-a-session) para saber o que é e o que não é transferido quando você coloca em background.
361
362### Prompt rejected as too short
363
364A entrada de dispatch espera uma descrição de tarefa, não um abridor conversacional. Um prompt com menos de quatro caracteres é rejeitado com uma dica `Too 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`.
365
366### Sessions show as failed after waking your machine
288 367
289Sessõ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`.368Sessõ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, execute `claude respawn --all`.
290 369
291### A session is slow to respond after attaching370### A session is slow to respond after attaching
292 371
298 377
299## Limitações378## Limitações
300 379
301Agent view é uma visualização de pesquisa. Limitações atuais a serem observadas:380Agent view está em visualização de pesquisa com as seguintes limitações:
302 381
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.382* **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.
304* **Sessões são locais**: sessões em background são executadas em sua máquina e param se ela dormir ou desligar.383* **Sessões são locais**: sessões em background são executadas em sua máquina e param se ela dormir ou desligar.
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.384* **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.
306 385
307## Próximos passos386## Recursos relacionados
308 387
309Agora que você entende agent view, explore esses recursos relacionados:388Para outras maneiras de executar Claude em paralelo, consulte:
310 389
311* [Executar agentes em paralelo](/pt/agents): compare agent view com subagentes, equipes de agentes e worktrees390* [Executar agentes em paralelo](/pt/agents): compare agent view com subagentes, equipes de agentes e worktrees
312* [Subagentes](/pt/sub-agents): defina configurações de agente reutilizáveis com prompts, ferramentas e isolamento personalizados
313* [Equipes de agentes](/pt/agent-teams): coordene múltiplas sessões que se mensageiam391* [Equipes de agentes](/pt/agent-teams): coordene múltiplas sessões que se mensageiam
314* [Claude Code na web](/pt/claude-code-on-the-web): execute sessões em um ambiente de nuvem gerenciado em vez de localmente392* [Claude Code na web](/pt/claude-code-on-the-web): execute sessões em um ambiente de nuvem gerenciado em vez de localmente
