Gerenciar múltiplos agentes com agent view

​

Início rápido

claude agents

• Dica: o rodapé mostra ← for agents por dez segundos após a sessão abrir. Pressionar ← continua funcionando depois que a dica desaparece
• Contagem de aguardando: enquanto sessões em background aguardam sua entrada, o mesmo local as conta, como ← 2 agents, ou ← 99+ agents quando mais de 99 aguardam. A contagem é atualizada aproximadamente a cada dez segundos enquanto o terminal está em foco e imediatamente quando o foco retorna
• Contagem de concluídas: quando sessões em background são concluídas com sucesso enquanto nenhuma aguarda sua entrada, o rodapé mostra brevemente quantas foram concluídas, como ← 2 done para duas

​

Abrir visualização do agente por padrão

/config defaultToAgentsView=true

claude

​

Monitorar sessões com agent view

claude agents --cwd ~/projects/my-app

Pinned
  ✽ clawd walk cycle          Drawing the walk-cycle sprite frames          3m

Ready for review
  ∙ jump physics              Opened PR with collision fix                 #2048  2h

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

Working
  ✽ collision detection       Adding swept-AABB checks to CollisionSystem   2m
  ✢ playtest level 3          all checkpoints cleared ×12                in 4m

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

​

Ler estado da sessão

​

Resumos de linha

​

Custo dos resumos de linha

​

Status de pull request

• Claude Code escreve o rótulo como #1234 para um pull request e como !1234 para um merge request do GitLab.
• Claude Code emite o link mesmo quando não consegue detectar suporte a hiperlink, por exemplo sobre SSH ou tmux. Defina FORCE_HYPERLINK=0 para renderizar o rótulo como texto simples.
• Depois que você envia um acompanhamento para a sessão, Claude Code mantém o rótulo enquanto a linha retorna ao progresso ao vivo.

• Quando Claude edita, comenta, fecha ou marca um pull request como pronto com gh, Claude Code vincula o pull request que a saída do próprio comando nomeia. Um comando gh cuja saída capturada não nomeia nenhum pull request não cria um link; gh pr merge é o caso comum, porque imprime seu resultado apenas para um terminal interativo.
• Quando Claude faz checkout de um pull request com gh pr checkout ou faz push para um branch, Claude Code procura o branch com gh pr view e vincula seu pull request aberto.
• O pull request não precisa existir ainda quando Claude faz push: Claude Code tenta novamente a busca do branch após até cinco comandos git, gh, glab ou curl posteriores executados no mesmo diretório, então um pull request criado após o push, incluindo um que Claude cria através da API REST do GitHub, vincula quando uma nova tentativa o encontra.

​

Espiar e responder

• Uma sessão que está aguardando você: a pergunta exata que está fazendo, acima da entrada de resposta
• Uma sessão concluída: seu resultado
• Uma sessão funcionando: sua sentença de status completa

• Uma linha como waiting 3m: há quanto tempo a sessão está aguardando você. A idade na borda direita da linha é um número diferente: ela conta a partir de quando a sessão começou
• safe mode · customizations are off: esta sessão é executada com suas personalizações desativadas porque você a iniciou a partir do seu shell com claude --bg --safe-mode. Você pode deixá-la como está. Para continuar a conversa com suas personalizações ativadas novamente, execute claude stop <id> e depois claude --resume, ambos no seu shell

• Uma sessão que está funcionando: /model, /effort, /rename e /usage são executados imediatamente. Outras respostas entram na fila de mensagens da sessão em vez de interromper a resposta, e entram em vigor quando a entrada enfileirada entra. Outros comandos aguardam o fim do turno, mesmo aqueles que são executados assim que você os digita no próprio prompt de uma sessão
• Uma resposta que é exatamente /stop: interrompe a sessão imediatamente em vez de ser entregue a ela, esteja a sessão funcionando ou aguardando você
• Um shell job: a resposta, incluindo /stop, vai para o terminal do comando como entrada digitada

• Uma pergunta com opções predefinidas: o painel lista as opções por número. Com a entrada de resposta vazia, pressione o número de uma opção para preenchê-la, depois Enter para enviá-la, ou digite sua própria resposta em vez disso
• Uma pergunta sem opções predefinidas: digite sua resposta. Quando a entrada vazia mostra uma resposta sugerida, pressione Tab para preenchê-la e editá-la antes de enviar
• Um prompt de permissão ou outro diálogo, como um prompt de sandbox ou uma solicitação de entrada de um servidor MCP: responder não o responde. Sua mensagem aguarda na fila. Para responder ao diálogo, anexe com →

​

Anexar a uma sessão

​

Alternar sessões sem sair do terminal

• Pressione Enter para reabrir a conversa.
• Pressione Esc para desfazer a alternância e retornar à conversa. Se Esc mostra Still starting — try again in a moment, a sessão em background ainda não está pronta, então pressione Esc novamente em um momento.
• Pressione Ctrl+C duas vezes para sair para seu shell.

• Subagentes em primeiro plano ainda estão em execução: o Claude Code continua aguardando para que o trabalho dos subagentes em primeiro plano que o Claude iniciou seja preservado, e exibe Still backgrounding after the current tool. Pressione ← novamente para enviar para segundo plano sem aguardar, o que reinicia esses subagentes desde o começo.
• Um prompt de permissão ou uma pergunta está aguardando sua resposta: enquanto um prompt de permissão ou uma pergunta que Claude fez aguarda, Claude Code continua aguardando e mostra Still backgrounding after the current tool — a question is waiting for your answer. Se sua resposta permitir que o turno continue, como Yes em um prompt de permissão, Claude Code coloca a sessão em background quando a ferramenta atual terminar.
• Você digita na entrada do prompt: Claude Code cancela a alternância, porque o texto não enviado fica na caixa de entrada do seu terminal e não se moveria para a sessão em background. Ele mostra Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again. Claude continua trabalhando em primeiro plano.
• Você interrompe o turno: Claude Code cancela a alternância e mostra Backgrounding cancelled — the turn was stopped. Por exemplo, o turno é interrompido quando você interrompe Claude com Esc ou seleciona No sem um comentário em um prompt de permissão da conversa principal, ou pressiona Esc em uma pergunta que Claude faz ali. Pressione ← novamente para colocar a sessão em background.
• Uma mensagem enfileirada não pode ser movida: as mensagens que você enfileirou enquanto Claude estava trabalhando se movem para a sessão em background com a conversa. Quando uma delas não pode ser movida, a sessão permanece em primeiro plano e Claude Code mostra um aviso como Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.

Prompts enviados enquanto a sessão é movida para background

• Enviado enquanto a conversa fecha: a resposta ou o comando é interrompido quando a conversa fecha e agent view abre
• Ainda aguardando hooks naquele momento: o prompt não é enviado, e nada na tela indica isso. Isso inclui um prompt que você digitou enquanto hooks SessionStart ainda estavam em execução

​

Organizar a lista

• Pressione Ctrl+T para fixar uma sessão no topo e manter seu processo em execução 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, exceto enquanto um filtro está ativo, quando todos os grupos permanecem expandidos
• Pressione Ctrl+X para interromper uma sessão e Ctrl+X novamente dentro de dois segundos para deletá-la da lista, ou Esc para descartar a confirmação sem deletar. O segundo pressionamento deleta a sessão mesmo quando a tentativa de parada falha, por exemplo porque o serviço em background não está respondendo. Nesse caso, a confirmação permanece ativa por mais dois segundos, e a exclusão encerra o processo da sessão em si

​

Trazer de volta uma sessão passada

• /resume nomeia um id ou um termo de busca
• a visualização tem escopo com --cwd
• a visualização foi iniciada com --safe-mode
• a visualização foi aberta com uma flag como --permission-mode ou --settings

​

Filtrar sessões

​

Atalhos de teclado

​

Despachar novos agentes

​

Despachar um agente a partir da visualização de agentes

• /exit e /quit fecham a visualização de agentes
• /logout desconecta você
• /model, /effort e /fast definem com o que as sessões que você despachar em seguida começam. /effort e /fast requerem Claude Code v2.1.299 ou posterior.
• /login abre o diálogo de entrada para que você possa entrar novamente sem anexar a uma sessão
• Um /resume simples, ou seu alias /continue, abre um seletor das sessões passadas do repositório para trazer uma de volta como uma sessão em segundo plano

​

Despachar para um diretório específico

• Abra claude agents nesse diretório.
• Abra claude agents em um diretório pai e mencione um repositório filho com @<repo> no prompt. Digitar @ lista esses destinos:
  • Repositórios Git um nível abaixo do diretório de inicialização
  • Os git worktrees registrados do repositório do qual você iniciou que vivem dentro de sua árvore de diretórios, como os que Claude cria sob .claude/worktrees/, rotulados com seu branch em checkout. Worktrees adicionados fora do repositório, como com git worktree add ../feature, não são listados
  • Qualquer diretório que já tenha uma sessão na lista
  Um diretório cujo nome contém um espaço não é listado.
• Do shell, cd para o diretório e execute claude --bg "<prompt>".

​

Enviar ou copiar uma sessão para o segundo plano

​

Enviar a sessão para o segundo plano

​

Copiar a sessão com /fork

Enviar um prompt à cópia e abrir sua sessão

Onde a cópia é executada

• Como qualquer sessão despachada, a cópia se move para seu próprio worktree antes de editar arquivos. Nesse caso, a confirmação não menciona onde a cópia é executada.
• Quando sua sessão se moveu para seu worktree vinculado após iniciar, a cópia começa de volta onde a sessão estava antes da mudança e, a menos que edite no local, faz suas alterações de código em um worktree próprio lá. Quando seu worktree está em checkout em um branch, essa instrução também diz a uma cópia cuja tarefa se baseia em seu trabalho para basear seu novo branch no seu, já que seu branch permanece em checkout no seu worktree. A confirmação termina com runs in the origin tree.
• Quando você iniciou a sessão dentro de um worktree vinculado de um repositório que tem uma árvore de trabalho principal, a cópia começa nessa árvore de trabalho principal, com a mesma regra de worktree próprio, mas sem instrução de branch. A confirmação termina com runs in the origin tree aqui também.
• Uma sessão iniciada dentro de um worktree de um layout de repositório bare não tem árvore de trabalho principal para retornar, portanto a cópia permanece onde está, e a confirmação termina com edits this checkout. A mesma nota aparece quando o isolamento de worktree está desativado em uma sessão que não está dentro de um worktree vinculado, porque a cópia então edita os arquivos que você tem abertos.

Sessões que não podem ser bifurcadas

​

O que é transferido quando você coloca em segundo plano

• É transferido: comandos de shell em segundo plano em execução, subagentes em segundo plano, tarefas agendadas que você criou com /loop e as respostas automáticas do Claude a comentários de artefatos continuam em execução na sessão em segundo plano. Um subagente se move junto com tudo o que iniciou, portanto se transfere apenas quando todo esse trabalho também pode se mover.
• Continua apenas quando Claude o reinicia: um fluxo de trabalho dinâmico em execução. Se o fluxo de trabalho não tiver continuado quando você verificar a sessão em segundo plano, peça a Claude para reiniciá-lo.
• Para: trabalho que não pode ser movido para a sessão em segundo plano, como um monitor em execução. Quando qualquer trabalho desse tipo está em execução, Claude Code mostra o diálogo Background this session? para que você possa confirmar antes de parar o trabalho. Um subagente em segundo plano que possui um monitor para junto com o monitor.

• --mcp-config e --strict-mcp-config
• --settings
• --setting-sources
• --add-dir
• --plugin-dir
• --fallback-model
• --allow-dangerously-skip-permissions

Fluxos de trabalho dinâmicos quando você coloca em segundo plano

​

Despachar um agente a partir do seu shell

claude --bg "investigate the flaky SettingsChangeDetector test"

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

claude --resume 1f0e2c9a-6d0b-4c11-9f39-2a77c1d4e8b5 --bg "pick up where you left off and finish the migration"

claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

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

​

Prompts que contêm --bg

claude --bg "find out why --bg sessions are slow to start on this machine"

​

Executar um comando do shell

claude --bg --exec 'pytest -x'

​

Como os edits de arquivo são isolados

• Você moveu uma sessão que já tinha aberta para o segundo plano com ← ou /background. Essa sessão continua editando arquivos onde já estava trabalhando
• 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 arquivo que Claude está editando está dentro de um git worktree vinculado, como um que a sessão ou seu subagente criou com git worktree add
• O diretório de trabalho não é um repositório git e nenhum WorktreeCreate hook está configurado
• A escrita está fora do diretório de trabalho

{
  "worktree": {
    "bgIsolation": "none"
  }
}

• Commit e push: Claude faz commit sem perguntar, e faz push do branch quando o repositório tem um remote.
• Draft pull request: Claude abre um quando a tarefa pede, e o rótulo #N aparece na linha.
• Nunca: fazer push para main ou master, force-push e merge.
• Suas instruções git têm precedência: se a tarefa, CLAUDE.md ou a memória diz que você lida com commit ou push você mesmo, Claude deixa git para você.

​

O que deletar uma sessão remove

• A visualização de agentes o remove, incluindo alterações não confirmadas, portanto faça commit do que você quer manter primeiro.
• claude rm o mantém, junto com a linha da sessão, quando tem alterações não confirmadas.
• Nem a visualização de agentes nem claude rm remove um worktree que outra sessão em execução está usando ou bloqueou, e deletar novamente não muda isso. Claude Code mantém o worktree e a sessão, e nomeia o diretório mantido e o motivo; na visualização de agentes, a linha da sessão mostra not deleted. Feche a outra sessão, depois delete novamente.
• Quando você deleta uma sessão cujo worktree tem commits que Claude Code não pode confirmar que estão salvos em outro lugar, Claude Code mantém o worktree e a sessão, e a mensagem nomeia o branch do worktree e quantos commits não foram feitos push. A mensagem também oferece os dois caminhos adiante: fazer push dos commits, ou deletar novamente para descartá-los. Commits em um remote não bloqueiam a deleção. Nem commits na cópia local do branch padrão do seu remote origin, desde que esse branch esteja em checkout no seu checkout principal, o diretório do repositório em si em vez de um worktree. Após essa recusa, você escolhe:
  • Para manter os commits, faça push deles, ou mescle-os nesse branch padrão, depois delete a sessão novamente.
  • Para descartá-los, delete a sessão novamente sem fazer push: pressione Ctrl+X duas vezes em sua linha na visualização de agentes, ou execute o comando claude rm <id> --discard-unpushed que a recusa imprimiu. Isso remove a sessão e o worktree junto com seu branch, descartando os commits não feitos push e quaisquer alterações não confirmadas.
  Quando você deleta novamente, Claude Code descarta apenas o que a recusa mostrou: se o worktree ganhou um commit desde então, Claude Code o mantém novamente e mostra o estado atualizado. Quando o registro de outra sessão concluída também nomeia o worktree, ele permanece quando você deleta novamente; faça push dos commits, depois delete novamente.
• Um worktree que git não reconhece mais, por exemplo após git worktree prune, não bloqueia a deleção. Claude Code deleta a sessão e deixa o diretório em disco.
• Quando git ou seu WorktreeRemove hook falha em remover o worktree, Claude Code mantém o worktree e a sessão, e a mensagem nomeia a causa. Para um hook, a mensagem diz como terminou, como exited 1, e cita o início de seu stderr. A mensagem também diz qual destes fazer a seguir:
  • Delete a sessão novamente para remover o diretório mesmo assim, pressionando Ctrl+X duas vezes em sua linha na visualização de agentes ou executando o comando claude rm <id> --force-remove-worktree <worktree-id> que a recusa de claude rm imprimiu. O branch do worktree permanece no repositório. Claude Code oferece isso apenas quando pode confirmar todos os seguintes:
    • O diretório é um dos worktrees vinculados do repositório sob .claude/worktrees/
    • Nem o worktree nem um submódulo em checkout tem alterações não confirmadas em arquivos rastreados
    • Nenhum registro de outra sessão o nomeia
    Quando Claude Code não pode verificar o estado de um checkout de submódulo, como um substituído por um repositório git separado, ele também não oferece isso.
  • Corrija o que está no caminho, como fazer commit ou stash das alterações não confirmadas, mover um repositório git separado para fora do worktree, fechar o que quer que esteja usando o diretório, ou corrigir o hook, depois delete a sessão novamente.
  • Remova o diretório você mesmo, depois delete a sessão novamente.

• A visualização de agentes pede o mesmo duplo Ctrl+X antes de descartá-los. Para um diretório criado por hook, ele executa seu WorktreeRemove hook em vez disso, e sem um ele recusa a deleção e mantém a sessão.
• claude rm mantém a sessão e o worktree, e nomeia o motivo.

​

Definir o modelo, o esforço e o modo rápido

• Modelo: /model <name>, por exemplo /model opus
• Nível de esforço: /effort com low, medium, high, xhigh ou max, por exemplo /effort high. Para iniciar sessões em ultracode, abra a visualização de agentes a partir do seu shell com claude agents --effort ultracode em vez disso; a entrada de despacho não aceita /effort ultracode
• Modo rápido: /fast on ou /fast off. A sessão começa no modo rápido apenas se o modo rápido estiver disponível para você e seu modelo suportar o modo rápido. Em um modelo que não suporta, a sessão começa com o modo rápido desativado, portanto primeiro use /model para escolher um dos modelos que suportam o modo rápido. A dica abaixo da entrada, não o cabeçalho, confirma se as novas sessões recebem o modo rápido.

/model opus
refactor auth
/model sonnet
run the test suite

• Do shell, passe --model com claude --bg.
• Anexe a uma sessão em execução e execute /model para mudar. Uma escolha do seletor, ou um /model <name> digitado, salva como seu padrão para novas sessões a menos que você pressione s no seletor para uma mudança apenas de sessão. Uma mudança apenas de sessão persiste se a sessão for respawnada.
• Despache um subagente que define model em seu frontmatter, começando o prompt com seu nome ou mencionando @name. Enquanto uma escolha de /model na entrada de despacho se aplica, o model do subagente não é usado, portanto digite /model default lá. Se você iniciou com claude agents --model, o do subagente também não é usado, portanto execute claude agents em seu shell sem --model.

​

Modo de permissão, modelo e esforço

​

Configurações e provedor

​

Gateway de LLM

• Você coloca sua própria sessão em segundo plano com ← ou /background
• Você despacha uma sessão para o diretório em que está
• Você acorda uma sessão parada no diretório em que está anexando ou respondendo a ela
• Você reinicia uma sessão no diretório em que está com claude respawn

​

Modo de permissão

• Colocada em segundo plano com /bg ou ←: Claude Code mantém o modo de permissão em que a sessão estava, portanto um que você mudou para acceptEdits ou auto permanece lá após desanexar
• Despachada de claude agents iniciado em um shell, ou com claude --bg: a nova sessão começa da forma que uma nova sessão claude nesse diretório começaria, a menos que você a tenha despachado a partir de uma visualização de agentes que você abriu com padrões de despacho. Em qual modo de permissão uma sessão começa lista a ordem

1. O permissions.defaultMode do diretório alvo. auto e bypassPermissions entram em vigor apenas a partir de configurações gerenciadas, um arquivo --settings ou ~/.claude/settings.json. Claude Code recusa um defaultMode do .claude/settings.json ou .claude/settings.local.json do projeto que seleciona um modo mais permissivo do que a sessão da qual você veio estava.
2. O modo de permissão da sessão da qual você veio. Se essa sessão estava no modo bypassPermissions, a nova sessão pode começar no modo Manual em vez disso, com o aviso Bypass permissions was requested at launch and ignored. Isso acontece quando sua aceitação do aviso de bypass está apenas em .claude/settings.local.json ou em um arquivo --settings. Continue no modo Manual, ou adicione essa aceitação a ~/.claude/settings.json.

​

Padrões de despacho

claude agents --permission-mode plan --model opus --effort high

​

O que persiste entre reinicializações

​

Configurações, plugins e servidores MCP

claude agents --settings ./ci-settings.json --add-dir ../shared-lib

​

Gerenciar sessões do shell

​

Listar sessões como JSON

​

Ler estado da sessão de um script

​

Como as sessões em segundo plano são hospedadas

​

O processo supervisor

• Trabalhando, pausada em um prompt de permissão ou outra caixa de diálogo, ou conectada: o processo continua em execução. Um subagente, fluxo de trabalho ou monitor em execução conta como trabalhando, assim como uma tarefa agendada com escopo de sessão pendente, como um despertar de /loop.
• Concluída ou aguardando sua próxima mensagem, e desconectada por cerca de uma hora: o supervisor interrompe o processo para liberar recursos. Uma sessão que encerrou seu turno fazendo uma pergunta a você conta como aguardando sua próxima mensagem. A conversa permanece no disco e, na próxima vez que você se conectar ou responder, a sessão é retomada de onde parou. Fixe uma sessão com Ctrl+T para manter seu processo em execução.
• Encerrada inesperadamente enquanto o supervisor está em execução: o supervisor reinicia o processo. Encerrar uma sessão que você mesmo enviou para o segundo plano com ← ou /background, por exemplo com kill, a marca como interrompida em vez de reiniciá-la. Para sessões que terminaram com um desligamento, consulte Sessões aparecem como com falha ou interrompidas após o desligamento.
• Após uma atualização automática: o supervisor reinicia a si mesmo na nova versão e transfere as sessões ociosas em segundo plano. Sessões que estão trabalhando, aguardando você ou conectadas não são interrompidas.
• O próprio supervisor para, por exemplo porque seu processo foi encerrado de fora do Claude Code: no macOS e no Linux, suas sessões param, a menos que um novo supervisor se conecte em cerca de um minuto. Para iniciar um, execute claude agents no seu shell. Depois desse minuto, consulte Manter as sessões em execução após o supervisor parar.

​

Manter as sessões em execução após o supervisor parar

Background sessions still running will stop in about a minute. Run 'claude agents' to keep them.

​

Onde o estado é armazenado

​

Desativar a visualização de agentes

​

Solução de problemas

​

claude agents lista subagentes em vez de abrir a visualização de agentes

​

Agent view abre sem sessões

​

Backgrounding mostra um diálogo Background this session?

• Trabalho que não pode se mover: a sessão tem trabalho que não pode se mover para a sessão em background, como um monitor em execução. O diálogo nomeia o trabalho em segundo plano que Claude Code interromperia e, separadamente, conta as tarefas que são transferidas.
• Um fluxo de trabalho com subagentes em execução: um fluxo de trabalho dinâmico ainda tem subagentes em execução. Esses subagentes são interrompidos se você colocar em background mesmo assim, e o diálogo diz quantos. Eles recomeçam do início quando Claude reinicia o fluxo de trabalho na sessão em background.
• Respostas automáticas de artefatos: Claude está respondendo a comentários em um artefato por conta própria. Essas respostas continuam na sessão em background, e o diálogo diz isso.

​

A conversa diz que um agente em background was carried into this session and not resumed

​

Prompt rejected as too short

​

Sessions show as failed or stopped after shutdown

• Dentro de 48 horas, a sessão mostra como falhada. Anexe ou responda a ela e ela reinicia a partir de sua conversa salva. Para retomar o trabalho interrompido, envie a ela uma resposta pedindo que continue.
• Passadas 48 horas, como após a máquina estar desligada por dias, a sessão mostra como parada com ended while the background service was off. Pressione Enter na linha e o rodapé mostra Press enter again to resume this session (it ended while the background service was off), or ctrl+x to delete it. Pressione Enter na mesma linha novamente para retomar sua conversa salva. Uma resposta, ou claude attach <id>, a retoma sem esse prompt de rodapé.

​

Opening a session says the conversation is already open

• Um terminal onde você retomou a conversa, por exemplo com claude --resume ou /resume: a linha mostra Open in a terminal com uma dica para continuar lá, e abrir a linha mostra Can't open — this session is running in another terminal. Continue naquele terminal, ou saia dele e abra a linha novamente.
• Outro processo Claude Code não interativo, por exemplo um processo de sessão em background para a mesma conversa que ainda não saiu: abrir a linha mostra This conversation is already open in another running Claude session. Use esse processo, ou aguarde sua saída e abra a linha novamente.

​

Opening a session says it has no saved transcript

• claude attach imprime This session has no saved transcript.
• Agent view mostra Press enter again to restart this session fresh abaixo da lista.

​

The terminal host died or the session stopped responding

​

A session fails before starting with a possibly low memory note

​

Agent view says the background service did not respond

claude daemon stop --any --keep-workers

​

Dispatch fails with Could not resolve authentication method

claude daemon stop --any --keep-workers

​

Uma sessão em background mostra No LLM gateway

• Você exportou o gateway no seu terminal: em um terminal onde você exportou as variáveis do gateway, faça cd para a pasta que a mensagem nomeia e execute o comando claude respawn <id> da mensagem.
  • O gateway chega à sessão apenas quando o próprio supervisor foi iniciado a partir de um shell que exportou o mesmo gateway. Se o supervisor não foi, reinicie-o a partir do terminal onde você executou o comando respawn, como Dispatch fails with Could not resolve authentication method descreve, depois execute esse comando novamente.
• Você usou agent view em um projeto cujas configurações definem o gateway: coloque ANTHROPIC_BASE_URL e sua credencial no bloco env de um arquivo de configurações. Use ~/.claude/settings.json, ou .claude/settings.local.json no próprio projeto da sessão, ambos lidos por uma sessão reiniciada com respawn. Depois execute claude respawn <id> no seu shell a partir de qualquer diretório para reiniciar esta sessão no gateway.

​

Background sessions can’t read Desktop, Documents, or Downloads on macOS

​

Background sessions can’t reach local-network hosts on macOS

​

A session is slow to respond after attaching

​

.claude/worktrees/ is filling up

​

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: confirme as alterações antes de deletar uma sessão que editou arquivos em seu próprio worktree. Algumas exclusões mantêm o worktree em vez disso.

​

Recursos relacionados

• Executar agentes em paralelo: compare agent view com subagentes, equipes de agentes e worktrees
• Mensagens entre sessões: tenha suas sessões passando descobertas uma para a outra
• Equipes de agentes: coordene múltiplas sessões que se mensageiam
• Use Claude Code na nuvem: execute sessões em um ambiente de nuvem gerenciado em vez de localmente
• Projects: tenha Claude coordenar sessões na nuvem paralelas de uma conversa e dizer a você quais precisam de você

​

Histórico de versões