SSD Nodes Learn Hosting plans →
Guias Matt ConnorPor Matt Connor · Atualizado 2026-10-18

Como sessões do Claude Code trocam mensagens

Saiba como ListAgents e SendMessage conectam sessões no mesmo VPS, quais versões suportam o recurso e por que mensagens podem ficar retidas.

O que significa as sessões do Claude Code enviarem mensagens entre si

Duas sessões do Claude Code podem enviar mensagens entre si quando são executadas na mesma máquina, com o mesmo utilizador do sistema operativo. Uma mensagem é um bloco de texto simples que uma sessão do Claude escreve para outra. Não inclui histórico da conversa nem ficheiros. O Claude encontra a outra sessão com a ferramenta ListAgents e envia-lhe o texto com SendMessage, pelo que nunca chama nenhuma das ferramentas manualmente. Basta indicar o que a outra sessão precisa de saber, e o Claude escreve a própria mensagem.

Esta funcionalidade chama-se messaging entre sessões. Em outubro de 2026, requer o Claude Code v2.1.224 ou posterior no macOS e Linux, incluindo Linux dentro do WSL 2, e v2.1.234 ou posterior no Windows nativo. O messaging entre sessões na mesma máquina funciona com todos os providers, incluindo Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry, onde requer a versão v2.1.248 ou posterior. O acesso às suas sessões noutras máquinas ou na cloud é mais limitado: passa pelo Remote Control, que requer um início de sessão em claude.ai, pelo que não funciona com uma API key nem com esses quatro providers. Quando uma sessão cumpre estes requisitos, o messaging já está ativo e não é necessário ativar nada. O comportamento descrito abaixo baseia-se na documentação da Anthropic sobre messaging entre sessões.

É num VPS que esta funcionalidade é útil, porque é num VPS que as sessões permanecem em execução tempo suficiente para justificar o envio de mensagens. Num portátil, fecha a tampa. Num servidor com tmux, uma sessão iniciada na segunda-feira continua em execução na quinta-feira, mantendo o contexto de um repositório. Quando tem duas sessões desse tipo, a forma como comunicam deixa de ser uma questão teórica. Se ainda não configurou isto, comece por executar o Claude Code num VPS com tmux, que explica a configuração das sessões assumida neste guia.

Quando vale a pena usar uma segunda sessão

Comece pelo custo. Cada sessão é uma instância separada do Claude, com a sua própria janela de contexto. Por isso, duas sessões custam aproximadamente o dobro de uma sessão no mesmo período. Uma mensagem entregue conta para a utilização exatamente como um prompt que tenha introduzido. A coordenação não é gratuita. Um trabalho que é realmente uma sequência única de passos fica mais lento e mais caro quando é dividido entre sessões.

Os casos em que uma segunda sessão compensa têm uma característica comum. Duas partes do trabalho são executadas em simultâneo, sem dependerem uma da outra, e uma delas obtém durante a tarefa uma informação de que a outra precisa.

  • Uma sessão encontra uma alteração incompatível enquanto a outra está a desenvolver com base no código afetado. O Claude resume a alteração e envia-a, em vez de ter de a introduzir novamente no outro terminal.
  • Duas sessões trabalham no mesmo repositório, em git worktrees separados, e uma precisa de saber o que foi integrado.
  • Uma migração longa ou uma execução de testes comunica o resultado à sessão que está a acompanhar.
  • Uma sessão de desenvolvimento e uma sessão de revisão, em que a sessão de revisão lê o que a primeira produziu e envia as conclusões.

Quando o trabalho é sequencial ou quando ambas as sessões editariam os mesmos ficheiros, use uma única sessão. Quando pretende um grupo coordenado que o Claude cria e supervisiona dentro de uma única tarefa, trata-se de agent teams, uma funcionalidade separada e ainda experimental. Quando pretende apenas a mesma conversa noutro terminal, retome a sessão. A troca de mensagens entre sessões destina-se a sessões independentes que inicia e orienta manualmente.

Confirme se o recurso existe antes de planear com base nele

Primeiro, confirme a versão:

claude --version

Compare o número com 2.1.224. Depois, dentro de uma sessão, introduza /list-agents, que também responde a /peers. O comando apresenta todos os agentes que esta sessão consegue alcançar, com o nome a que cada um responde. Se o comando não for reconhecido, esta sessão não tem mensagens entre sessões, e nenhum valor de crossSessionInbound irá alterar isso. Introduza /status e procure uma linha Peer address: ela contém o endereço da caixa de entrada desta sessão, com o prefixo uds:.

Os utilizadores de VPS em versões antigas enfrentam uma armadilha. Antes da v2.1.248, as mensagens entre sessões na mesma máquina dependiam da obtenção de sinalizadores de funcionalidades, e várias variáveis de privacidade desativavam essa obtenção. Isso deixava o recurso desativado por predefinição. DO_NOT_TRACK, DISABLE_TELEMETRY, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC e DISABLE_GROWTHBOOK fazem todos isso. Os administradores reforçam um servidor novo colando essas variáveis em ~/.bashrc e depois não percebem por que razão /list-agents não existe. A partir da v2.1.248, as mensagens entre sessões na mesma máquina funcionam com a obtenção desativada, por isso atualizar é a correção mais simples. As variáveis continuam a ser relevantes para sessões fora desta máquina: com a obtenção desativada, Claude só consegue alcançar essas sessões quando o Remote Control está disponível, e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC e DISABLE_GROWTHBOOK tornam o Remote Control indisponível. Os mesmos valores podem vir do mapa env num ficheiro de definições ou de definições geridas, por isso verifique primeiro a shell.

env | grep -E 'DO_NOT_TRACK|DISABLE_TELEMETRY|DISABLE_GROWTHBOOK|NONESSENTIAL'

Numa versão antiga, remova a variável que for apresentada. Para DISABLE_TELEMETRY e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, qualquer valor não vazio ativa o comportamento, incluindo a cadeia 0. Por isso, DISABLE_TELEMETRY=0 não faz o que parece fazer. Para o desativar, remova a variável ou defina-a como uma cadeia vazia.

Dê um nome às sessões, ou o Claude não conseguirá endereçá-las

O Claude endereça uma mensagem a uma sessão pelo nome. Defina o nome quando iniciar a sessão:

claude --name builder-api

Também pode defini-lo com /rename dentro de uma sessão em execução. Quando não define nenhum nome, o Claude Code deriva um nome do diretório de trabalho, como myapp-3f. Isso é aceitável para uma sessão, mas torna-se confuso com quatro, e duas sessões podem acabar com o mesmo nome. A menos que a sessão esteja ligada ao Remote Control, a saída de /list-agents mostra o diretório de trabalho de cada sessão local, permitindo distinguir sessões com o mesmo nome, e a própria listagem do Claude acrescenta um identificador curto ao endereço quando há colisões de nomes. Escolher os nomes é mais simples do que consultar identificadores. Um nome definido por si também torna útil o preenchimento antecipado de @: a partir da v2.1.232, escrever @builder num prompt e selecionar a sessão indica ao Claude exatamente a que sessão se refere.

Um layout do tmux com duas sessões que pode reproduzir

Esta é uma sessão de implementação e uma sessão de revisão no mesmo repositório. O revisor trabalha numa worktree separada do git, por isso as duas sessões nunca escrevem no mesmo ficheiro. git worktree add com HEAD cria um checkout desanexado, que é o que pretende para uma sessão que lê em vez de fazer commits. Como as duas sessões têm funções diferentes, vale a pena dar ao revisor um estilo de saída próprio. Isso altera o prompt de sistema dessa sessão e mantém-se em todos os turnos, em vez de desaparecer como uma instrução introduzida uma única vez.

cd ~/src/api
git worktree add ../api-review HEAD
tmux new-session -d -s agents -n builder -c ~/src/api
tmux new-window -t agents -n reviewer -c ~/src/api-review
tmux send-keys -t agents:builder 'claude --name builder-api' C-m
tmux send-keys -t agents:reviewer 'claude --name reviewer-api' C-m
tmux attach -t agents

Ctrl+b e w listam as janelas pelo nome, para poder escolher uma. Na janela de implementação, execute /list-agents. Deverá ver reviewer-api com o diretório de trabalho ~/src/api-review. Se não aparecer, a sessão de revisão ainda não terminou de arrancar ou aplica-se um dos dois problemas da secção seguinte. Depois, envie algo em linguagem simples:

Tell reviewer-api which files I changed for the rate limiter and what to look at first.

O Claude escreve o resumo e envia-o. Não escreve o texto da mensagem, e o conteúdo enviado pelo Claude varia. Na janela de revisão, a mensagem aparece como uma pré-visualização de uma linha, esbatida, com o nome do remetente e a primeira linha do texto, como › Message from @builder-api: …. Se essa sessão estiver inativa, o Claude inicia imediatamente um novo turno. Se estiver a meio de um turno, a mensagem aguarda até ao intervalo entre chamadas de ferramentas, para que um comando em execução nunca seja interrompido. Ctrl+O abre o visualizador do histórico com o texto completo, e o Claude lê a mensagem inteira, quer a expanda quer não. O par funciona melhor quando a sessão de implementação mantém as alterações pequenas, porque um diff limitado produz uma transferência mais curta e uma revisão que a outra sessão consegue concluir num turno. É esse o comportamento que a competência do programador sénior preguiçoso procura impor.

Quem consegue ver quem num único VPS

A entrega entre processos na mesma máquina nunca passa pelos servidores da Anthropic. Cada sessão associa o seu próprio socket de caixa de entrada, um socket de domínio Unix com um caminho no sistema de ficheiros dessa máquina. Uma sessão só aparece nas listagens das suas outras sessões quando associa esse socket. Num servidor, há duas consequências importantes.

O socket é restrito ao seu utilizador do sistema operativo. Uma sessão iniciada como root e outra iniciada como deploy não conseguem ver-se, mesmo lado a lado no mesmo servidor tmux, porque as sessões de um utilizador não conseguem aceder ao socket de outro utilizador. Execute as duas sessões com o mesmo utilizador.

Um contentor tem o seu próprio sistema de ficheiros. Uma sessão dentro do Docker e uma sessão no host não conseguem comunicar entre si. Duas sessões dentro do mesmo contentor podem trocar mensagens normalmente. Se mantiver os agentes em contentores para isolamento, como em executar agentes de programação numa VM descartável, espere que as mensagens funcionem dentro de um contentor, mas não através do limite entre contentores.

As suas sessões noutras máquinas e as suas sessões na cloud aparecem na listagem apenas enquanto esta sessão estiver ligada ao Remote Control. As sessões noutras máquinas são identificadas como Remote Control. A partir da v2.1.225, o Claude pode iniciar uma conversa com uma dessas sessões, e não apenas responder-lhe. Essas mensagens passam pelos servidores da Anthropic. Se esta sessão não estiver ligada ao Remote Control quando o Claude enviar uma mensagem para fora da máquina, a mensagem será entregue na mesma, mas sem um endereço de resposta. Por isso, o outro lado não poderá responder-lhe.

Por que sua mensagem nunca chegou

O motivo mais comum não tem relação com a rede. A sessão receptora decidiu o que fazer com a mensagem, e decidiu não entregá-la. Toda mensagem recebida termina em um de três estados: entregue, retida (separada e não entregue até você aprová-la) ou recusada (descartada sem entrega).

Quando nenhum valor de crossSessionInbound se aplica, o Claude Code decide por mensagem comparando os modos de permissão das duas sessões. Ele agrupa as sessões que ignoram os prompts de permissão em uma classe e todas as outras na outra. auto, acceptEdits e dontAsk contam como modos que exibem prompts. O modo de plano conta como modo que ignora prompts em uma sessão de terminal interativa que tenha permissões para ignorá-los. Se você não tiver certeza de em qual classe uma sessão se enquadra, vale ler o que cada modo de permissão realmente faz primeiro, porque auto é o modo em que a maioria das sessões começa atualmente e ele fica no lado dos prompts dessa divisão. A regra é simétrica:

  • Uma sessão receptora que exibe prompts de permissão recebe cada mensagem. Ela retém uma mensagem somente quando a sessão remetente se identifica como uma sessão que ignora prompts.
  • Uma sessão receptora que ignora prompts retém todas as mensagens para sua aprovação. Ela entrega uma mensagem somente quando o remetente também ignora prompts.

Por isso, o primeiro fluxo de trabalho que a maioria das pessoas cria é exatamente o que não funciona. Você inicia um builder com --permission-mode bypassPermissions porque quer que ele seja executado sem supervisão, deixa o reviewer com os padrões, e todas as mensagens enviadas pelo builder ficam aguardando em uma caixa de diálogo de aprovação que ninguém está monitorando. Essa caixa de diálogo é fechada após o prazo de dialogExpiry, que por padrão é 5m, e a mensagem é descartada. Verifique a tela da sessão receptora para procurar uma caixa de diálogo de aprovação pendente antes de atribuir o problema ao socket.

Para fazer uma sessão receber mensagens sem supervisão, defina crossSessionInbound como accept. O local onde você define isso determina o escopo da configuração. O Claude Code lê primeiro as configurações gerenciadas, depois a flag --settings e, por fim, as configurações do usuário; ele aplica o primeiro valor encontrado. Um valor nas configurações do projeto ou locais só se aplica quando é mais restritivo, na ordem accept < hold < refuse. Um accept em .claude/settings.json é menos restritivo que qualquer outra opção, portanto é ignorado sempre que uma fonte confiável tiver definido um valor. Coloque-o em ~/.claude/settings.json ou passe-o para uma única sessão. A partir da v2.1.232, a linha /config Mensagens das suas outras sessões grava a mesma configuração do usuário para você.

claude --name runner --settings '{"crossSessionInbound":"accept"}'

Um worker claude -p sem interface vincula um socket de caixa de entrada como uma sessão interativa e aparece na lista, mas não consegue mostrar uma caixa de diálogo de aprovação. O Claude Code mantém uma mensagem retida ali durante o mesmo prazo de dialogExpiry, que por padrão é de cinco minutos, entrega-a se uma alteração no modo ou nas configurações permitir isso dentro desse intervalo e, caso contrário, descarta-a e informa que ela expirou a um remetente que consiga alcançar. A linha --settings acima é o que permite que esse worker receba mensagens. Uma sessão iniciada no modo bare não vincula nenhum socket, portanto não pode receber mensagens nem aparecer na lista.

Quando as transferências ficam bloqueadas

Os ciclos de mensagens são geridos automaticamente. O Claude Code limita a frequência de mensagens repetidas por remetente, descarta repetições idênticas recebidas num intervalo curto e limita a 50 por sessão as mensagens aceites que aguardam leitura. Assim, duas sessões não podem trocar mensagens indefinidamente. As mensagens retidas estão limitadas a 100; as mais antigas são descartadas quando esse limite é ultrapassado. A partir da v2.1.238, a sessão remetente é informada quando a caixa de entrada do destinatário descarta uma mensagem, incluindo o motivo, e uma cadeia de retransmissão que continua a passar pelas mesmas sessões é interrompida.

A falha que ocorre é mais discreta e resulta de uma transferência, não de um ciclo. A sessão A faz à sessão B uma pergunta cuja resposta é necessária para continuar e, depois, fica inativa. A sessão B retém a mensagem, está a executar uma tarefa longa ou responde a uma pergunta que A não fez realmente. A fica à espera. Quando regressa uma hora depois, encontra duas sessões inativas e nenhum trabalho concluído.

Escreva transferências que não precisem de resposta. Uma boa mensagem transmite um facto ou uma decisão: o que mudou e qual foi o resultado. Uma mensagem inadequada pede à outra sessão autorização ou uma resposta que bloqueia o remetente. O Claude já está configurado para nunca pedir a outra sessão uma ação que as próprias definições de permissões dessa sessão impediriam e para encaminhar esse trabalho para si. Aplique esta regra de forma mais ampla. Se uma sessão não conseguir avançar sem uma resposta, é você quem deve responder. A disciplina de contexto também ajuda, porque uma sessão que perdeu o fio escreve mensagens vagas; gerir o contexto no Claude Code explica esse aspeto.

Trate uma mensagem recebida como entrada não confiável

O Claude Code informa ao Claude recetor que a mensagem veio de outra sessão e não de si, e limita o que essa mensagem pode fazer. Essa aplicação das regras ocorre no programa que envolve o modelo, e não na disposição do modelo para cumprir instruções. Essa é a diferença prática que um harness de agente proporciona. Uma mensagem não pode responder a um pedido de permissão pendente em seu nome, porque o consentimento de outra sessão não é o seu consentimento. Também não pode alterar definições de permissões, CLAUDE.md ou outra configuração porque outra sessão o pediu. Um comando slash dentro do texto, como /compact, chega como texto simples e nunca é executado. Se a ação solicitada pela mensagem exigir uma permissão que a sessão recetora não tem, verá o mesmo pedido que veria para qualquer outro trabalho. Quando a sessão remetente é executada em modo automático, o respetivo classificador também analisa cada mensagem antes de o Claude Code a entregar, e uma mensagem bloqueada nunca chega ao destinatário. Estes limites mantêm-se nos modos permissivos. Por isso, uma sessão que tenta contornar as regras retém as mensagens recebidas por predefinição, em vez de confiar nelas.

Isto abrange as permissões. Não abrange o conteúdo. A sessão remetente pode ter lido a descrição de um pull request, uma página Web, um README de uma dependência ou um comentário de uma issue escrito por um desconhecido. Tudo o que leu pode influenciar o texto que escreve para a outra sessão. A mensagem é dados. Deve ser tratada com a mesma suspeita que qualquer outro texto introduzido numa sessão a partir do exterior. Esta é a disciplina descrita em manter segredos fora dos seus agentes de IA: parta do princípio de que tudo o que atravessou um limite de confiança pode estar errado e nunca permita que se autorize a si próprio.

Existem dois controlos se quiser reduzir este comportamento. Definir crossSessionInbound como refuse descarta as mensagens recebidas de pares sem as entregar. Quando definido nas configurações do projeto ou locais, esse valor prevalece sobre qualquer outra origem, porque é o mais restritivo da hierarquia. Para impedir esta sessão de enviar ou listar mensagens, adicione regras de negação de permissões que indiquem SendMessage e ListAgents. Ambos devem ser escritos como nomes de ferramentas isolados, sem especificador. Definir isolatePeerMachines como true exige a sua aprovação explícita antes de qualquer mensagem chegar a uma sessão fora desta máquina. Essa aprovação é exigida mesmo no modo bypassPermissions.

{
  "crossSessionInbound": "refuse",
  "isolatePeerMachines": true
}

Negar SendMessage também remove as mensagens para subagentes, porque a mesma ferramenta serve para ambos. Uma sessão que recusa mensagens não apresenta alterações visíveis no seu próprio /status nem nas listagens de outras sessões. Por isso, confirme a definição na configuração da sessão, e não no ecrã.

Bridges e servidores MCP com memória partilhada

Vários projetos de terceiros foram lançados no mesmo período para casos adjacentes: bridges locais entre agentes, que retransmitem texto entre agentes em execução, e servidores MCP (model context protocol), que fornecem a vários agentes um armazenamento partilhado para leitura e escrita. Avalie-os como uma abordagem diferente, não como concorrentes, e confirme qualquer comando de instalação no README do próprio projeto antes de o executar. As mensagens usam push, porque o remetente coloca o texto no turno do recetor. Um armazenamento partilhado usa pull, porque ninguém é interrompido e uma sessão vê a nota quando a consulta na próxima vez. O pull é mais adequado para estados que mudam lentamente e só funciona quando uma sessão consulta efetivamente o armazenamento.

Se seguir essa abordagem, as perguntas importantes dizem respeito ao processo, não à lista de funcionalidades. Com que utilizador o servidor é executado e a que dados pode aceder no sistema. Executar servidores MCP numa VPS aborda essa configuração. Partilhar competências de agentes entre repositórios aborda o caso mais simples, em que o que pretende partilhar entre sessões são instruções, não estado em tempo real, eliminando muitas das mensagens que teria de enviar. Para uma visão mais abrangente, executar um agente de programação numa VPS é o ponto de partida.

FAQ

Por que /list-agents não é reconhecido na minha sessão?

A sessão não tem mensagens entre sessões. Verifique primeiro claude --version: o recurso precisa da versão 2.1.224 ou posterior no macOS e no Linux, da versão 2.1.234 ou posterior no Windows nativo e da versão 2.1.248 ou posterior no Amazon Bedrock, no Claude Platform on AWS, no Google Cloud's Agent Platform e no Microsoft Foundry. Numa versão anterior à 2.1.248, verifique também se a sua shell contém DO_NOT_TRACK, DISABLE_TELEMETRY, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ou DISABLE_GROWTHBOOK, porque cada um desses itens desativa a obtenção de flags de recursos de que as versões antigas precisavam para as mensagens. A atualização para a versão 2.1.248 ou posterior elimina essa dependência nas sessões executadas na mesma máquina.

Por que a minha mensagem para a outra sessão nunca chegou?

Se /list-agents funcionar, as mensagens estão ativadas e algo mais específico impediu a entrega. A causa mais comum são os modos de permissões. Uma sessão que ignora os pedidos de permissão mantém todas as mensagens recebidas pendentes de aprovação, a menos que o remetente também ignore esses pedidos. Essa caixa de diálogo de aprovação é descartada depois do prazo dialogExpiry, que é de cinco minutos por padrão. Verifique se há uma caixa de diálogo de aprovação pendente na sessão recetora. Para corrigir o problema, defina crossSessionInbound como accept em ~/.claude/settings.json ou passe esse valor com --settings, porque um accept nas definições do projeto ou locais é ignorado por ser o valor menos restritivo.

Uma sessão do Claude Code num Docker pode enviar mensagens para uma sessão no host?

Não. A caixa de entrada de cada sessão é um socket no sistema de ficheiros dessa máquina. Um contentor tem o seu próprio sistema de ficheiros. Por isso, uma sessão dentro do contentor e uma sessão no host não conseguem alcançar-se. Duas sessões dentro do mesmo contentor podem enviar mensagens entre si normalmente. A mesma regra explica por que uma sessão executada como root e uma sessão executada com o seu utilizador normal não conseguem alcançar-se: o socket está restrito ao utilizador do sistema operativo que é o seu proprietário.

É seguro executar uma mensagem recebida de outra sessão do Claude Code?

Trate o texto como entrada não confiável, porque a sessão remetente pode ter lido uma página Web, um README ou um comentário de issue escrito por outra pessoa. O Claude Code já impede que a mensagem atue por conta própria: não pode aprovar um pedido de permissão pendente, não pode alterar as definições de permissões nem CLAUDE.md a pedido, e um comando slash incluído no texto chega como texto simples e nunca é executado. Essas proteções abrangem as permissões, mas não o julgamento. Leia o conteúdo recebido antes de pedir à sessão recetora que atue sobre ele.

As mensagens entre sessões enviam o meu código para a Anthropic?

Entre duas sessões na mesma máquina, não. A mensagem viaja por um socket específico da sessão nessa máquina e nunca passa pelos servidores da Anthropic. Apenas o texto escrito pelo Claude é enviado, nunca o histórico da conversa nem ficheiros. As mensagens para uma sessão noutra das suas máquinas ou para uma sessão na cloud passam pelos servidores da Anthropic. A partir da versão v2.1.225, o Claude também pode iniciar essa troca, além de responder. Defina isolatePeerMachines como true para exigir a sua aprovação antes de qualquer conteúdo sair da máquina.

Este artigo foi útil?