> ## Documentation 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.

# 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ê. 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.

<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" />

<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" />

Use 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.

Quando você quer trabalhar de forma mais direta em qualquer sessão de um agente, anexe-se à linha para entrar na conversa completa.

Para comparar agent view com subagentes, equipes de agentes e worktrees, consulte [Executar agentes em paralelo](/pt/agents).

<Note>
  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.
</Note>

Esta página cobre:

* [Início rápido](#quick-start): dê a Claude uma tarefa para trabalhar em background, verifique-a e intervenha quando necessário
* [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
* [Despache novos agentes](#dispatch-new-agents) a partir de agent view, de dentro de uma sessão ou do seu shell
* [Gerenciar sessões do shell](#manage-sessions-from-the-shell)
* [Como as sessões em background são hospedadas](#how-background-sessions-are-hosted) pelo processo supervisor

<h2 id="quick-start">
  Início rápido
</h2>

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.

<Steps>
  <Step title="Abrir visualização do agente">
    Do seu shell, execute:

    ```bash theme={null}
    claude agents
    ```

    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.
  </Step>

  <Step title="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](#permission-mode-model-and-effort) 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](#limitations) antes de despachar muitas de uma vez.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Anexar e desanexar">
    Pressione `Enter` ou `→` em uma linha para anexar quando quiser a conversa completa. A sessão assume o terminal como uma sessão interativa completa do Claude Code. Pressione `←` em um prompt vazio para desanexar e retornar à tabela.
  </Step>

  <Step title="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.
  </Step>
</Steps>

Você 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.

<h2 id="monitor-sessions-with-agent-view">
  Monitorar sessões com agent view
</h2>

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.

Por padrão, 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. Para limitar a lista a um projeto, passe `--cwd` (requer Claude Code v2.1.141 ou posterior):

```bash theme={null}
claude agents --cwd ~/projects/my-app
```

Isso mostra apenas sessões iniciadas sob esse diretório. Uma sessão que [se moveu para um worktree](#how-file-edits-are-isolated) sob `~/projects/my-app/.claude/worktrees/` ainda conta como pertencente a `~/projects/my-app`.

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.

```text theme={null}
Pinned
  ✽ clawd walk cycle          Write assets/sprites/clawd-walk.png           3m

Ready for review
  ∙ jump physics              Opened PR with collision fix              PR #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
```

<h3 id="read-session-state">
  Ler estado da sessão
</h3>

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`                        |

Separadamente, a forma do ícone mostra se o processo subjacente está em execução:

| 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`](/pt/scheduled-tasks) dormindo entre iterações. A linha mostra sua contagem de execução e uma contagem regressiva |

O rótulo `PR #N` que pode aparecer na borda direita de uma linha é o [pull request que a sessão abriu](#pull-request-status), não parte do ícone de estado. Quando uma sessão abriu mais de um pull request, o rótulo mostra uma contagem em vez disso, como `3 PRs`.

O título da aba do terminal mostra a contagem de aguardando-entrada enquanto agent view está aberto: `2 awaiting input · claude agents` quando sessões precisam de entrada, ou `claude agents` quando nenhuma precisa.

Sessõ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.

O estado da sessão persiste no disco através de atualizações automáticas e reinicializações do supervisor. As sessões também são preservadas quando sua máquina dorme. Seus processos retomam ao acordar e o supervisor se reconecta a eles em vez de tratar a lacuna de tempo como inatividade. Desligar ainda interrompe as sessões em execução; veja [Sessions show as failed after shutdown](#sessions-show-as-failed-after-shutdown) para saber como recuperá-las.

<h3 id="row-summaries">
  Resumos de linha
</h3>

O 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.

A partir da v2.1.161, quando a sessão está executando dois ou mais itens de trabalho paralelos, como subagents, comandos shell em background ou monitores, uma contagem `done/total` como `2/5` aparece antes do texto do resumo.

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. Em provedores de terceiros como Bedrock, Vertex AI, Microsoft Foundry e gateways personalizados, a solicitação volta para o modelo principal da sessão quando nenhum modelo Haiku está configurado. Defina [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/pt/model-config#environment-variables) para escolher o modelo para esses resumos nesses provedores.

<h3 id="pull-request-status">
  Status de pull request
</h3>

Quando uma sessão abre um pull request, um rótulo `PR #1234` aparece na borda direita da linha, vinculado ao pull request em terminais que suportam hiperlinks. O rótulo persiste quando você envia um acompanhamento para a sessão, então o pull request permanece visível enquanto a linha reverte para progresso ao vivo.

Quando uma sessão abriu mais de um pull request, o rótulo mostra uma contagem em vez disso, como `3 PRs`, colorido pelo pull request aberto que mais precisa de atenção. Abra o [painel de espiada](#peek-and-reply) para ver todos eles.

O número do pull request é colorido pelo seu status:

| Cor     | 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 coluna é onde você coleta o resultado: revise e mescle o pull request quando seu número ficar verde.

<h3 id="peek-and-reply">
  Peek and reply
</h3>

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.

A partir da v2.1.161, quando a sessão está executando itens de trabalho paralelos, o painel também nomeia o que está em execução há mais tempo e há quanto tempo está acontecendo, para que você possa ver o que a sessão está aguardando sem anexar.

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.

A partir da v2.1.145, com [voice dictation](/pt/voice-dictation) ativada, segure ou toque sua tecla push-to-talk enquanto a entrada de resposta está focada para ditar uma resposta em vez de digitá-la. O mesmo funciona na entrada de despacho na parte inferior de agent view.

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

<h3 id="attach-to-a-session">
  Anexar a uma sessão
</h3>

Pressione `Enter` ou `→` em uma linha selecionada para anexar. Agent view é substituído pela sessão interativa completa. 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](/pt/commands), atalho de teclado e recurso funciona.

Sessões anexadas sempre renderizam em [modo fullscreen](/pt/fullscreen), independentemente de sua configuração `tui`, porque uma sessão em background não tem scrollback de terminal para anexar. Role com `PgUp`, `PgDn` ou a roda do mouse, e pressione `Ctrl+O` para modo de transcript. O scroll nativo do seu terminal e o modo de cópia tmux mostram apenas o viewport atual, o mesmo que quando você executa qualquer aplicativo fullscreen.

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.

`Ctrl+C` mantém seu comportamento de interrupção padrão enquanto anexado: ele cancela uma resposta em execução ou comando shell `!` em vez de desanexar. Pressionar `Ctrl+C` duas vezes em um prompt vazio desanexa, o mesmo que em qualquer sessão.

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

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 linha selecionada, para que você possa alternar sessões sem sair do terminal. A linha é criada mesmo a partir de uma sessão nova sem histórico de conversa, então `→` retorna a ela. Quando essa linha é a única, agent view mostra uma dica de integração abaixo dela. Você pode desativar este atalho em `/config` (a configuração `leftArrowOpensAgents`).

<h3 id="organize-the-list">
  Organizar a lista
</h3>

Agent 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.

Dentro de um grupo:

* Pressione `Ctrl+T` para fixar uma sessão no topo e [manter seu processo em execução](#the-supervisor-process) enquanto inativo
* Pressione `Shift+↑` ou `Shift+↓` para reordenar sessões
* Pressione `Ctrl+R` para renomear uma sessão
* Pressione `Enter` em um cabeçalho de grupo para recolhê-lo

Para 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.

Deletar remove a sessão de agent view. Se Claude [criou um worktree](#how-file-edits-are-isolated) para a sessão, deletar remove esse worktree também, incluindo quaisquer alterações não confirmadas nele, então faça push ou commit do trabalho que você quer manter primeiro. Um worktree que você criou você mesmo e iniciou a sessão dentro é deixado no lugar. O transcript de conversa fica em sua máquina local e permanece 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.

<h3 id="filter-sessions">
  Filtrar sessões
</h3>

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                                                                   |
| Qualquer outra URL           | A sessão cujo primeiro prompt continha essa URL                                                             |

<h3 id="keyboard-shortcuts">
  Atalhos de teclado
</h3>

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 diretório da sessão focada                                               |
| `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 `$VISUAL` ou `$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                                                                        |

<h2 id="dispatch-new-agents">
  Despachar novos agentes
</h2>

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.

<h3 id="from-agent-view">
  From agent view
</h3>

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; 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](/pt/sub-agents) 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á                                                                                              |
| `/<command>`                           | Sugerir [skills](/pt/skills) e [commands](/pt/commands) para despachar como o prompt                                                                                                        |
| `! <command>`                          | Execute um comando shell como um trabalho em background em vez de iniciar uma sessão Claude. O trabalho aparece como uma linha que você pode anexar, observar e desanexar                   |
| `#<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                                                                                                                                              |

Um pequeno conjunto de comandos é executado em agent view em vez de ser despachado: `/exit` e `/quit` fecham agent view, `/logout` desconecta você, e `/model` define o [modelo de despacho](#set-the-model). Skills, seus próprios comandos e built-ins que expandem prompts como `/init` são enviados para uma nova sessão em background como seu primeiro prompt. Outros comandos built-in mostram uma dica `attach to a session to run it` em vez disso.

Empacotar 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.

Quando 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 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.

<h4 id="dispatch-to-a-specific-directory">
  Dispatch to a specific directory
</h4>

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.

<h3 id="from-inside-a-session">
  From inside a session
</h3>

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. Se Claude estiver respondendo quando você executar `/bg`, a resposta continua na sessão em background.

Colocar 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.

As flags de configuração do lançamento original são transferidas para a sessão colocada em background, portanto seus servidores MCP, settings e modelo de fallback permanecem em vigor:

* `--mcp-config` e `--strict-mcp-config`
* `--settings`
* `--add-dir`
* `--plugin-dir`
* `--fallback-model`
* `--allow-dangerously-skip-permissions`

Diretórios que você adicionou durante a sessão com [`/add-dir`](/pt/permissions#additional-directories-grant-file-access-not-configuration) também são transferidos.

Transferir `--allow-dangerously-skip-permissions` mantém `bypassPermissions` acessível na sessão colocada em background, mas não concede nada novo. O modo ainda requer a mesma aceitação interativa única descrita em [Permission mode, model, and effort](#permission-mode-model-and-effort) antes que qualquer sessão possa usá-lo.

<h3 id="from-your-shell">
  From your shell
</h3>

Passe `--bg` ou sua forma longa `--background` para iniciar uma sessão que vai direto para o background:

```bash theme={null}
claude --bg "investigate the flaky SettingsChangeDetector test"
```

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

```bash theme={null}
claude --agent code-reviewer --bg "address review comments on PR 1234"
```

Passe `--name` para definir o nome de exibição da sessão em agent view em vez do gerado automaticamente:

```bash theme={null}
claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"
```

Após colocar em background, Claude imprime o ID curto da sessão e os comandos para gerenciá-la. Quando você passa `--name`, o nome aparece após o ID curto:

```text theme={null}
backgrounded · 7c5dcf5d · flaky-test-fix
  claude agents             list sessions
  claude attach 7c5dcf5d    open in this terminal
  claude logs 7c5dcf5d      show recent output
  claude stop 7c5dcf5d      stop this session
```

<h4 id="run-a-shell-command">
  Run a shell command
</h4>

Para executar um comando shell como um trabalho em background em vez de uma sessão Claude, digite `!` como o primeiro caractere da entrada de despacho de agent view. O `!` aparece como um prefixo e tudo que você digita após ele é o comando. O exemplo a seguir despacha `pytest -x` a partir da caixa de entrada de agent view:

```text theme={null}
! pytest -x
```

Pressione `Enter` para iniciar o trabalho. O mesmo trabalho também pode ser lançado diretamente do seu shell com `--exec`:

```bash theme={null}
claude --bg --exec 'pytest -x'
```

O comando é executado como um trabalho com suporte PTY e aparece como uma linha em agent view, com a linha de saída mais recente como seu status. Um trabalho shell executa o comando no lugar de Claude, portanto nenhum modelo é invocado e a saída não é enviada para nenhuma sessão.

Para ver a saída, anexe à linha, pressione `Space` para espreitar sem anexar, ou execute `claude logs <id>` do seu shell. A saída capturada permanece na memória e não é escrita em disco. A linha e sua saída são limpas automaticamente cerca de cinco minutos após o comando sair, portanto leia-a antes disso se precisar do resultado.

<h3 id="how-file-edits-are-isolated">
  How file edits are isolated
</h3>

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](/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 o worktree quando:

* A sessão já está dentro de um git worktree vinculado, seja Claude o criou sob `.claude/worktrees/` ou você o criou com `git worktree add` em outro lugar
* O diretório de trabalho não é um repositório git e nenhum hook [`WorktreeCreate`](/pt/hooks#worktreecreate) está configurado
* A escrita está fora do diretório de trabalho

Para desativar o isolamento de worktree para um repositório onde git worktrees são impraticáveis, defina [`worktree.bgIsolation`](/pt/settings#worktree-settings) como `"none"`. As sessões em background editam sua cópia de trabalho diretamente sem se mover para um worktree primeiro. Adicione a configuração ao `.claude/settings.json` do projeto:

```json theme={null}
{
  "worktree": {
    "bgIsolation": "none"
  }
}
```

<Note>
  A configuração `worktree.bgIsolation` requer Claude Code v2.1.143 ou posterior.
</Note>

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. Se você usar um sistema de controle de versão diferente, configure um hook [`WorktreeCreate`](/pt/worktrees#non-git-version-control) e Claude isola edições da mesma forma que faz para git.

Deletar uma sessão em agent view (`Ctrl+X` duas vezes) remove um worktree que Claude criou para ela, incluindo quaisquer alterações não confirmadas, portanto mescle ou envie as alterações que você quer manter primeiro. Deletar do shell com [`claude rm`](#manage-sessions-from-the-shell) mantém um worktree que tem alterações não confirmadas e imprime seu caminho para que você possa limpá-lo você mesmo. Um worktree que você criou você mesmo e iniciou a sessão dentro é deixado no lugar de qualquer forma.

Para encontrar o caminho do worktree de uma sessão, espreite a sessão ou anexe e verifique seu diretório de trabalho.

Um [subagent](/pt/sub-agents) que a sessão em background gera herda o diretório de trabalho da sessão, portanto suas edições de arquivo chegam ao worktree da sessão em vez de sua cópia de trabalho. Para dar a um subagent seu próprio worktree separado, defina [`isolation: worktree`](/pt/sub-agents#supported-frontmatter-fields) em seu frontmatter ou passe `isolation: "worktree"` ao gerá-lo.

<h3 id="set-the-model">
  Set the model
</h3>

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 vem da configuração [`model`](/pt/settings#available-settings) em suas settings de usuário. Defina-o selecionando um modelo no seletor [`/model`](/pt/model-config), ou edite a configuração diretamente. Para substituir para toda a sessão de agent view, passe `--model` ao abrir agent view. Veja [Permission mode, model, and effort](#permission-mode-model-and-effort).

Para alterar o padrão de despacho de dentro de agent view, digite `/model` seguido de um nome de modelo na entrada de despacho e pressione `Enter`. O cabeçalho é atualizado para mostrar esse modelo com um marcador `(session)`, e as sessões que você despacha depois usam-no. Digite `/model default` para limpar a substituição e retornar ao padrão de despacho. Essa substituição dura o resto da execução atual de `claude agents`, não escreve no seu arquivo de settings e requer Claude Code v2.1.172 ou posterior. {/* min-version: 2.1.172 */} O exemplo a seguir despacha uma sessão em Opus e a próxima em Sonnet:

```text theme={null}
/model opus
refactor auth
/model sonnet
run the test suite
```

Cada sessão em background pode ser executada em um modelo diferente. Para substituir para uma sessão:

* Do shell, passe `--model` com `claude --bg`.
* Anexe a uma sessão em execução, abra `/model` e pressione `s` em um modelo para alternar apenas para essa sessão. A alteração persiste se a sessão for reiniciada.
* Despache um [subagent](/pt/sub-agents) cujo frontmatter define um campo `model`.

<h3 id="permission-mode-model-and-effort">
  Permission mode, model, and effort
</h3>

Uma sessão em background lê suas [settings](/pt/settings) do diretório em que é executada, da mesma forma que se você tivesse iniciado `claude` lá. Isso inclui valores [`env`](/pt/settings#available-settings) em settings de projeto, portanto uma `ANTHROPIC_MODEL` ou variável de provedor definida lá se aplica a sessões em background naquele diretório.

A seleção de provedor de nuvem, como `CLAUDE_CODE_USE_BEDROCK` ou `CLAUDE_CODE_USE_VERTEX`, e aliases `ANTHROPIC_DEFAULT_*_MODEL` seguem o shell que despachou a sessão. Variáveis de endpoint de gateway como `ANTHROPIC_BASE_URL` e seu `ANTHROPIC_AUTH_TOKEN` pareado não. Veja [o processo supervisor](#the-supervisor-process) para como sessões em background obtêm configurações de provedor e credenciais.

O [permission mode](/pt/permissions) depende de como você iniciou a sessão. Colocar em background uma sessão existente com `/bg` ou `←` mantém o permission mode atual, portanto uma sessão que você alterou para `acceptEdits` ou `auto` permanece naquele modo após desanexar. Despachar a partir da entrada de agent view ou executar `claude --bg` do seu shell usa o `defaultMode` das settings daquele diretório, ou o `permissionMode` do [frontmatter do subagent despachado](/pt/sub-agents#supported-frontmatter-fields).

O permission mode, modelo e esforço com os quais uma sessão em background foi iniciada, juntamente com os [flags de configuração que ela carrega](#from-inside-a-session), todos persistem quando o supervisor posteriormente [para e reinicia](#the-supervisor-process) seu processo. Uma sessão que você lançou com `claude --bg --dangerously-skip-permissions` ou `claude --bg --permission-mode bypassPermissions` permanece em `bypassPermissions` após esse reinício em vez de voltar ao `defaultMode` do diretório, e um modelo ou esforço que você alterou no meio da sessão com `/model` ou `/effort` é mantido.

Para definir padrões para cada sessão que você despacha a partir de agent view, passe qualquer um de `--permission-mode`, `--model`, `--effort` ou `--agent` ao abri-lo:

```bash theme={null}
claude agents --permission-mode plan --model opus --effort high
```

`--agent` define o [subagent](/pt/sub-agents) usado quando um prompt de despacho não nomeia um, seja com `@name` ou como a primeira palavra. O padrão é a configuração [`agent`](/pt/settings#available-settings) se uma estiver definida, caso contrário o agente `claude` integrado catch-all. Nomear um subagent na entrada de despacho substitui ambos.

`claude agents` também aceita `--dangerously-skip-permissions` como abreviação para `--permission-mode bypassPermissions`, e `--allow-dangerously-skip-permissions` para tornar `bypassPermissions` disponível no ciclo `Shift+Tab` de cada sessão despachada sem iniciar naquele modo. Ambos correspondem aos [flags CLI de nível superior](/pt/cli-reference).

Essas flags foram adicionadas em diferentes versões. Versões anteriores as rejeitam com um erro de opção desconhecida.

| Flag ou configuração                                                         | Versão mínima                         |
| :--------------------------------------------------------------------------- | :------------------------------------ |
| `--permission-mode`, `--model`, `--effort`, `--dangerously-skip-permissions` | v2.1.142 {/* min-version: 2.1.142 */} |
| `--allow-dangerously-skip-permissions`                                       | v2.1.143 {/* min-version: 2.1.143 */} |
| `--agent` e honrando a configuração `agent` para sessões despachadas         | v2.1.157 {/* min-version: 2.1.157 */} |

Antes de v2.1.157, agent view ignora a configuração `agent` e despacha o agente `claude` integrado.

Os padrões ativos aparecem no rodapé abaixo da entrada de despacho.

Sem essas flags, a sessão usa o `defaultMode` das settings daquele diretório ou o `permissionMode` do [frontmatter do subagent despachado](/pt/sub-agents#supported-frontmatter-fields), 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`.

<h3 id="settings-plugins-and-mcp-servers">
  Settings, plugins, and MCP servers
</h3>

Agent view aceita os mesmos flags de configuração que `claude` para carregar settings, plugins, servidores MCP e diretórios adicionais. Esses flags requerem Claude Code v2.1.142 ou posterior. Cada flag se aplica a agent view em si e é passado 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>`](/pt/settings)                                                      | Substituir settings para agent view e sessões despachadas                         |
| [`--add-dir <path>`](/pt/permissions#additional-directories-grant-file-access-not-configuration) | Conceder acesso a arquivo a um diretório adicional                                |
| [`--plugin-dir <path>`](/pt/plugins)                                                             | Carregar um plugin de um diretório local                                          |
| [`--mcp-config <file-or-json>`](/pt/mcp)                                                         | 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 |

Repita `--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:

```bash theme={null}
claude agents --settings ./ci-settings.json --add-dir ../shared-lib
```

<h2 id="manage-sessions-from-the-shell">
  Gerenciar sessões do shell
</h2>

Cada 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.

| Comando                      | Propósito                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `claude agents`              | Abrir agent view                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `claude agents --cwd <path>` | Abrir agent view com escopo para sessões iniciadas em `<path>`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `claude agents --json`       | Imprimir sessões ativas como um array JSON e sair: cada sessão ativa, mais sessões em background que ainda estão funcionando ou bloqueadas mesmo quando seu processo saiu. Adicione `--all` para também incluir sessões em background concluídas. Cada entrada tem `cwd`, `kind` e `startedAt`. Entradas em background também têm `id`, utilizável com `claude attach`/`logs`/`stop`, e `state`: um de `working`, `blocked`, `done`, `failed` ou `stopped`. `pid` e `status` estão presentes apenas enquanto o processo está ativo, mais `waitingFor` quando status é `waiting`, que diz no que a sessão está bloqueada, como `permission prompt` ou `input needed`; `sessionId` e `name` aparecem quando definidos. Combine com `--cwd <path>` para filtrar |
| `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, em execução ou interrompida, com sua conversa intacta, por exemplo, para usar um binário Claude Code atualizado                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `claude respawn --all`       | Reiniciar cada sessão em execução, por exemplo, para mover todas as sessões para um binário Claude Code atualizado de uma vez                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `claude rm <id>`             | Remover uma sessão da lista. Remove um worktree que Claude criou para a sessão se não houver alterações não confirmadas; caso contrário, imprime o caminho do worktree para que você possa limpá-lo. Deixa um worktree que você criou por conta própria no lugar. A transcrição da conversa permanece em sua máquina local e continua disponível através de `claude --resume`                                                                                                                                                                                                                                                                                                                                                                                |
| `claude daemon status`       | Imprimir o estado do [supervisor](#the-supervisor-process), versão, diretório de socket e contagem de workers                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `claude daemon stop --any`   | Parar o processo supervisor e as sessões em background que ele hospeda. Passe `--keep-workers` para deixar as sessões em background em execução para que o próximo supervisor se reconecte a elas. O próximo `claude agents` ou `claude --bg` inicia um novo supervisor                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

<h2 id="how-background-sessions-are-hosted">
  Como as sessões em background são hospedadas
</h2>

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 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).

<h3 id="the-supervisor-process">
  O processo supervisor
</h3>

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 mantém um processo worker pré-aquecido pronto para que um dispatch da visualização de agente ou `claude --bg` seja iniciado sem o atraso de um cold launch. Quando você faz um dispatch, o supervisor atribui o worker pré-aquecido à sua sessão, aplica o diretório, configurações e credenciais dessa sessão a ele e, em seguida, inicia um substituto para o próximo dispatch. Se nenhum worker pré-aquecido saudável estiver disponível, o supervisor inicia um novo processo.

O supervisor e suas sessões se autenticam com as mesmas credenciais armazenadas que suas sessões interativas e não fazem conexões de rede adicionais além da API do modelo. Variáveis de seleção de provedor, como `CLAUDE_CODE_USE_BEDROCK` e aliases `ANTHROPIC_DEFAULT_*_MODEL`, são lidas do shell que fez dispatch de cada sessão e são aplicadas ao seu worker.

{/* min-version: 2.1.174 */}Uma sessão em background não herda variáveis de endpoint de gateway, como `ANTHROPIC_BASE_URL`, as variáveis de URL base equivalentes do Bedrock, Vertex e Foundry, ou um `ANTHROPIC_AUTH_TOKEN` pareado do shell que iniciou o supervisor ou do shell que fez dispatch. A sessão usa suas credenciais armazenadas e quaisquer valores `env` no [settings](/pt/settings) do diretório do projeto. Para apontar sessões em background em um projeto para um [gateway LLM](/pt/llm-gateway), defina `ANTHROPIC_BASE_URL` no bloco `env` do `settings.json` do `.claude/` desse projeto em vez de exportá-lo no seu shell. Antes da v2.1.174, uma sessão em background herdava essas variáveis do shell de inicialização do supervisor, então poderia usar o gateway que você tinha configurado naquele shell em vez do configurado para o diretório do projeto.

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. Um comando de shell em background em execução, subagente, workflow dinâmico ou monitor conta como trabalho ativo, então um processo de longa duração, como um servidor de desenvolvimento, mantém a sessão ativa.

Depois que uma sessão termina e fica desanexada por cerca de uma hora, o supervisor interrompe seu processo para liberar recursos. Uma sessão que você [fixou](#organize-the-list) com `Ctrl+T` é isenta e mantém seu processo em execução enquanto inativo. O transcript e o estado permanecem no disco de qualquer forma, e na próxima vez que você anexar, espreitar ou responder a uma sessão parada, 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.

Uma linha vazia deixada ao pressionar `←` que nunca recebeu um prompt é removida completamente após cerca de cinco minutos para que a lista se limpe por conta própria. Sessões iniciadas com `claude --bg` e sessões aguardando um prompt de configuração, como um diálogo de confiança, não são removidas dessa forma.

Quando o host fica com pouca memória, o supervisor interrompe as sessões inativas não fixadas primeiro e interrompe as fixadas inativas apenas se isso não liberou nada.

O 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. Uma sessão fixada inativa também é reiniciada no local para a nova versão para que ela pegue a atualização sem você se reconectar.

<h3 id="where-state-is-stored">
  Onde o estado é armazenado
</h3>

O 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.

| 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                                                         |
| `~/.claude/jobs/<id>/tmp/`       | Diretório de rascunho por sessão. Escritas aqui não solicitam permissão. Removido quando a sessão é excluída |

Cada sessão em background tem a variável de ambiente `CLAUDE_JOB_DIR` definida para seu diretório `~/.claude/jobs/<id>`, então comandos de shell que a sessão executa podem escrever arquivos temporários em `$CLAUDE_JOB_DIR/tmp` sem colidir com sessões paralelas.

Para inspecionar este estado sem ler os arquivos diretamente, execute `claude daemon status`. Ele relata se o supervisor está acessível, seu ID de processo e versão, o diretório do socket e quantas sessões em background estão ativas. `/doctor` inclui um resumo da mesma verificação.

O comando também avisa quando o supervisor em execução está em uma versão diferente do `claude` que você invocou, o que acontece após uma atualização que o supervisor ainda não reiniciou. O aviso mostra ambas as versões e diz para você executar `claude daemon stop --any` para pegar a nova versão. Quando Claude Code é instalado como um serviço do SO, o comando sugerido é `claude daemon stop` sem a flag.

No Windows, `claude daemon status` expõe o erro de arquivo subjacente quando o arquivo de chave de pipe do daemon está bloqueado ou ilegível em vez de relatar uma falha de conexão genérica.

<h3 id="turn-off-agent-view">
  Desativar a visualização de agente
</h3>

Para 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).

<h2 id="troubleshooting">
  Troubleshooting
</h2>

<h3 id="claude-agents-lists-subagents-instead-of-opening-agent-view">
  `claude agents` lista subagentes em vez de abrir a visualização de agentes
</h3>

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](#turn-off-agent-view) por uma configuração ou variável de ambiente.

<h3 id="agent-view-opens-with-no-sessions">
  Agent view abre sem sessões
</h3>

Antes de você despachar sua primeira sessão, agent view mostra uma dica de integração breve com prompts de exemplo no lugar da lista de sessões. Digite um prompt na entrada na parte inferior e pressione `Enter` para despachar sua primeira sessão.

<h3 id="cannot-open-agents-because-work-is-running-in-the-background">
  Cannot open agents because work is running in the background
</h3>

Se pressionar `←` para colocar a sessão atual em background mostrar `Cannot open agents — N still running in the background`, a sessão tem trabalho em andamento, como um subagente, um workflow dinâmico 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.

<h3 id="prompt-rejected-as-too-short">
  Prompt rejected as too short
</h3>

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 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`.

<h3 id="sessions-show-as-failed-after-shutdown">
  Sessions show as failed after shutdown
</h3>

Desligar ou reiniciar sua máquina interrompe as sessões em execução em background, então elas mostram como falhadas quando você abre agent view novamente. Anexe, espreite ou responda a qualquer uma delas e a sessão reinicia de onde parou.

Sleep sozinho não causa isso. Sessões são preservadas durante o sleep e o supervisor se reconecta a elas ao acordar.

<h3 id="agent-view-says-the-background-service-did-not-respond">
  Agent view says the background service did not respond
</h3>

Se anexar, espreitar ou `claude logs` relatar que o serviço de background não respondeu, o processo supervisor provavelmente travou. Interrompa-o e deixe o próximo `claude agents` iniciar um novo. Para manter suas sessões em background em execução durante a reinicialização, passe `--keep-workers`:

```bash theme={null}
claude daemon stop --any --keep-workers
```

O novo supervisor se reconecta às sessões em execução. Sem `--keep-workers`, o comando também encerra as sessões em background. O sinalizador `--any` confirma que você deseja interromper um supervisor que foi iniciado sob demanda em vez de como um serviço instalado, que é o padrão.

No Windows, se o supervisor não responder à solicitação de parada, o comando imprime seu ID de processo. Encerre esse processo com `taskkill /PID <pid>` para concluir a recuperação. As sessões em background ainda são preservadas quando você passou `--keep-workers`.

<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">
  Dispatch fails with `Could not resolve authentication method`
</h3>

{/* min-version: 2.1.174 */}Se um dispatch em background falhar com `Could not resolve authentication method` enquanto sessões interativas autenticam normalmente, o worker que recebeu o dispatch não pegou as credenciais. Na v2.1.174 e posterior, o supervisor fornece um snapshot de credencial fresco quando atribui um [pre-warmed worker](#the-supervisor-process), então este erro significa que nenhuma credencial armazenada estava disponível para o próprio processo supervisor. Confirme que você executou `/login` ou configurou uma chave de API, depois interrompa o supervisor:

```bash theme={null}
claude daemon stop --any --keep-workers
```

O próximo `claude agents` ou `claude --bg` inicia um novo supervisor que lê suas credenciais armazenadas. Se você autenticar com uma variável de ambiente como `ANTHROPIC_API_KEY` em vez de `/login`, execute esse próximo comando a partir de um shell onde a variável está definida.

Veja a [referência de erro](/pt/errors#could-not-resolve-authentication-method) para a lista completa de causas e correções. Antes da v2.1.174, um pre-warmed worker que ficou ocioso poderia exibir este erro quando foi atribuído a um dispatch mesmo quando suas credenciais eram válidas. Atualize para recuperar.

<h3 id="background-sessions-cannot-read-desktop-documents-or-downloads-on-macos">
  Background sessions cannot read Desktop, Documents, or Downloads on macOS
</h3>

No macOS, o host da sessão em background é executado como seu próprio processo e solicita acesso a pastas protegidas separadamente do seu terminal. Se uma sessão em background relatar `Operation not permitted` ao ler `~/Desktop`, `~/Documents`, `~/Downloads` ou outro local protegido, conceda acesso em Configurações do Sistema em Privacidade e Segurança > Arquivos e Pastas, ou ative Acesso Total ao Disco para a entrada.

Com o instalador nativo, a entrada aparece como Claude Code e a concessão persiste entre atualizações. Com outros métodos de instalação, como Homebrew ou npm, a entrada mostra o caminho do binário e pode precisar ser concedida novamente após atualizar.

<h3 id="a-session-is-slow-to-respond-after-attaching">
  A session is slow to respond after attaching
</h3>

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, aguardando você ou [fixadas](#organize-the-list) não são interrompidas dessa forma, então fixe uma sessão com `Ctrl+T` para mantê-la responsiva.

<h3 id="claude/worktrees/-is-filling-up">
  `.claude/worktrees/` is filling up
</h3>

Deletar uma sessão em agent view remove a worktree que Claude criou para ela. `claude rm` mantém uma worktree que tem mudanças não commitadas e imprime seu caminho. 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).

<h2 id="limitations">
  Limitações
</h2>

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. Elas são preservadas durante o sleep, mas param se a máquina desligar.
* **Worktrees criadas pelo Claude são deletadas com a sessão em agent view**: mescle ou envie alterações antes de deletar uma sessão que editou arquivos em seu próprio worktree. `claude rm` mantém um worktree que tem alterações não confirmadas; um worktree que você criou você mesmo é deixado no lugar.

<h2 id="related-resources">
  Recursos relacionados
</h2>

Para outras maneiras de executar Claude em paralelo, consulte:

* [Executar agentes em paralelo](/pt/agents): compare agent view com subagentes, equipes de agentes e worktrees
* [Equipes de agentes](/pt/agent-teams): coordene múltiplas sessões que se mensageiam
* [Claude Code na web](/pt/claude-code-on-the-web): execute sessões em um ambiente de nuvem gerenciado em vez de localmente
