A Anthropic lançou uma funcionalidade experimental de mensagens entre sessões para o Claude Code, permitindo que sessões diferentes se enviem mensagens diretamente. Essa funcionalidade não transmite o contexto completo, apenas os resultados da tarefa e informações de dependência, implementada por meio de duas ferramentas internas: ListAgents e SendMessage. Cada sessão local é registrada no disco e vinculada a um Socket de Inbox; mensagens locais são transmitidas diretamente pelo Socket, enquanto mensagens entre máquinas são enviadas por meio do servidor da Anthropic. As mensagens acionam um novo Turn quando a sessão está inativa e são lidas entre chamadas de Tool em Turns ativos. O receptor distingue as mensagens entre sessões das mensagens do usuário, não podendo substituir a autorização do usuário, e oferece três modos de controle de entrada: accept/hold/refuse. Essa funcionalidade integra-se com capacidades existentes como Resume Session, Agent Teams e Worktree, fornecendo ao Claude Code uma camada de coordenação entre sessões.

Autor e fonte do artigo: LeiFeng.com

Nestes dias, a Anthropic adicionou ao Claude Code uma nova capacidade experimental: mensagens entre sessões.

Em poucas palavras, ele permite que vários Sessions do Claude Code em execução simultânea se enviem mensagens diretamente entre si.

Por exemplo, você abre 3 sessões do Claude Code: uma responsável pelo banco de dados, outra pelo API backend e outra pelos testes. Antes, embora essas 3 sessões pudessem trabalhar em paralelo, elas não sabiam o progresso umas das outras. Após a sessão do banco de dados alterar o esquema, o desenvolvedor geralmente precisava alternar para outro terminal e informar manualmente às sessões de backend sobre as mudanças.

Após a inclusão da mensageria entre sessões, este passo pode ser concluído diretamente pelo Claude. A sessão do banco de dados pode notificar a sessão de backend quais campos sofreram alterações; a sessão de teste, ao identificar problemas de regressão na interface, também pode enviar os resultados à sessão que está modificando o código relacionado. O Claude pode decidir autonomamente quando é necessário notificar outras sessões ou entrar em contato com sessões específicas conforme solicitado pelos desenvolvedores.

Para entender exatamente o que ele faz, siga o caminho completo de uma mensagem: o que ela transmite, como encontra o destino, quando a mensagem entra no Claude e por que o receptor não pode simplesmente agir diretamente.

01

As mensagens entre sessões não alteraram a isolamento de sessão original do Claude Code.

Ao enviar uma mensagem da Sessão A para a Sessão B, não é enviado o histórico da conversa, os arquivos lidos ou toda a janela de contexto. Conforme as diretrizes oficiais, apenas o texto é transmitido entre sessões. Se for necessário migrar a conversa completa e o contexto para outro dispositivo, deve-se retomar a Sessão original, em vez de usar mensagens entre sessões.

Isso determina a forma como vários Claude colaboram.

Suponha que a sessão do banco de dados tenha lido dezenas de arquivos e tentado várias abordagens para concluir a migração, concluindo finalmente que um determinado campo precisa ser modificado. A sessão de backend não precisa conhecer todo o processo de análise anterior; basta receber as alterações finais e como elas afetarão sua API.

Portanto, o Cross-session messaging transmite os resultados das tarefas e informações de dependência, e não a memória de trabalho completa.

A vantagem disso é que as informações locais geradas por diferentes tarefas não invadem constantemente outras Sessions. Detalhes relacionados ao banco de dados podem permanecer na Session do banco de dados, processos de teste podem permanecer na Session de teste, e apenas quando uma alteração começar a afetar outras tarefas, as informações relevantes cruzam a fronteira da Session.

Ele pertence a uma abordagem diferente da de “todos os Agentes compartilham um grande Contexto”. A mensagens entre sessões escolhe manter as Sessões independentes e sincronizar explicitamente os estados necessários quando surgirem dependências entre tarefas.

Como uma mensagem clara está sendo transmitida, a próxima pergunta é: como a Session A encontra a Session B?

02 Primeiro, é necessário encontrar outra sessão

Claude Code adicionou sua própria entrada de comunicação para sessões com suporte a mensagens entre sessões.

Cada sessão local registra as informações relevantes no disco e vincula um socket de entrada. O Claude pode usar ListAgents para encontrar as sessões atualmente acessíveis e, em seguida, usar SendMessage para enviar mensagens ao destino especificado.

Os usuários não precisam operar essas ferramentas internas por conta própria; basta informar ao Claude qual Session deseja contatar ou permitir que ele notifique automaticamente a outra parte quando houver dependências na tarefa.

O nome da sessão também passa a ser usado para endereçamento. O Claude pode localizar o destino pelo nome; se houver nomes duplicados, o sistema adiciona um identificador curto para distinguir, além de exibir o Diretório de Trabalho, ajudando a identificar qual projeto ou diretório cada sessão está processando.

Após localizar o destino, as mensagens locais são transmitidas diretamente pelo Socket da sessão correspondente, sem passar pelo servidor Anthropic. Apenas sessões em outro computador ou no Claude Code Web utilizam a conexão com o servidor Anthropic e os recursos de controle remoto.

Este mecanismo de descoberta também determina os limites da comunicação local.

Claude Code precisa ler as informações de registro gravadas em disco por outras sessões; portanto, mesmo que dois Claude estejam executando fisicamente no mesmo computador, se os sistemas de arquivos forem isolados entre si, eles podem não conseguir se detectar. Um cenário típico é o Host e um contêiner independente; se ambas as sessões estiverem executando no mesmo contêiner, a comunicação funcionará normalmente.

O Inbox Socket também está sujeito às permissões de usuário do sistema operacional; outros usuários do OS no servidor compartilhado não podem acessar diretamente sua sessão.

Portanto, o chamado "comunicação local" aqui depende na verdade de se as informações de registro são visíveis, se o Socket é acessível e se o sistema operacional permite o acesso.

A mensagem já conseguiu encontrar o destino e foi encaminhada para a Inbox; agora cabe ao Runtime do Claude Code decidir quando enviar essa mensagem ao modelo.

03 Após a entrega da informação

Suponha que a sessão de backend esteja modificando o arquivo, e nesse momento a sessão de teste envie uma mensagem informando que acabou de detectar um problema de regressão na interface.

Claude Code não interromperá imediatamente a ferramenta em execução.

Se a sessão-alvo estiver em estado de inatividade, a mensagem pode acionar uma nova rodada; se o Claude já estiver em uma rodada ativa, a mensagem aguardará e será lida entre duas chamadas de ferramenta.

A razão para esse tratamento está relacionada à forma como o Coding Agent executa as tarefas. O Claude pode estar escrevendo um arquivo, executando testes, realizando uma migração ou processando outras tarefas demoradas. Se mensagens externas puderem forçar a alteração da ação atual a qualquer momento, é fácil que a ferramenta tenha executado apenas parte da tarefa, enquanto o agente já começou a replanejar com base nas novas informações.

Portanto, a mensagem afeta as próximas decisões do Claude, mas não interrompe diretamente as operações em andamento.

Isso também significa que o Cross-session messaging já foi integrado ao Agentic Loop do Claude Code, tornando-se uma fonte de entrada assíncrona. E essa entrada não é destinada apenas a outras sessões do Claude.

Claude Code expõe o Socket de Mensagens da Sessão atual para processos filhos iniciados por Hook e Bash. Após a conclusão de uma tarefa em segundo plano de longa duração, é possível enviar ativamente o resultado de volta à Sessão atual, sem a necessidade de Claude fazer polling constante para verificar se foi concluída.

Este canal em si não é uma fila de mensagens confiável. Mensagens duplicadas serão limitadas, e conteúdo idêntico em curto espaço de tempo pode ser descartado; mensagens já aceitas, mas ainda não lidas pelo Claude, são mantidas até um máximo de 50 por sessão, enquanto mensagens em estado Hold utilizam outro buffer, com capacidade máxima de 100.

Portanto, é mais adequado para enviar mudanças de status, resultados de tarefas e notificações de colaboração. Fatos que devem ser mantidos permanentemente ainda devem ser registrados no Git, arquivos, banco de dados ou outros sistemas persistentes.

Após a mensagem entrar no Runtime, ainda não pode ser convertida diretamente em uma ação executável, pois o receptor precisa primeiro determinar: qual é o nível de permissão do conteúdo enviado por outro Claude.

04 Como as permissões são herdadas

Claude Code distingue claramente a Mensagem do Usuário e a Mensagem da Sessão entre Pares.

O conteúdo enviado por outra sessão não será considerado autorização do usuário, portanto não pode aprovar o Prompt de Permissão em nome do usuário nem solicitar, por meio de mensagem, que o destinatário altere as Configurações de Permissão,CLAUDE.md ou outras configurações. Mesmo que a mensagem contenha Comandos de Código do Claude, eles serão tratados apenas como texto comum.

Suponha que a Sessão A solicite à Sessão B que exclua um arquivo, e essa operação exija autorização do usuário na Sessão B; o prompt de permissão original ainda aparecerá.

Claude Code também limita outra forma de contornar permissões: se uma operação já foi recusada pelo Sistema de Permissões na sessão atual, o Claude não deve solicitar a outro session que execute em seu lugar.

Caso contrário, sempre que houver permissões diferentes entre várias sessões, a sessão de baixa permissão poderá transferir continuamente operações que não pode realizar para a sessão de alta permissão, fazendo com que o limite de permissão original se torne inválido.

Além das permissões de execução, a própria mensagem possui um controle de entrada. O receptor pode definir mensagens entre sessões como accept、hold ou refuse: encaminhar diretamente para o Claude, manter temporariamente à espera de confirmação adicional ou descartar diretamente.

Se o usuário não configurar explicitamente as regras, o Claude Code também considerará o Permission Mode atual do remetente e do destinatário. Uma Session que possa contornar o Permission Prompt normal não será considerada uma fonte de mensagem idêntica a uma Session normal; quando as permissões do destinatário forem mais elevadas, mensagens externas também podem ser encaminhadas para Hold.

Na verdade, há duas verificações: primeiro, determinar se a mensagem pode entrar no Claude, e depois, verificar se a ação que o Claude pretende executar com base nessa mensagem tem permissão.

Neste ponto, o caminho completo de uma mensagem Cross-session já foi percorrido: desde a geração da mensagem, descoberta do destino, entrega concluída, até a leitura da mensagem pelo Runtime e passagem pelo controle de permissões do receptor.

Camada de coordenação entre as sessões 05

Colocar este caminho de volta nas capacidades atuais do Claude Code deixa a posição da mensagens entre sessões mais clara.

Resume Session é usado para continuar a conversa e o contexto anteriores, Agent Teams é usado para criar e gerenciar um grupo de agents colaborativos, Worktree é responsável por isolar as alterações de código de diferentes sessões e Remote Control resolve o problema de continuar controlando a sessão a partir de outros dispositivos.

As mensagens entre sessões lidam com outro cenário: várias sessões que originalmente operam independentemente, e que, durante a execução da tarefa, desenvolvem dependências, precisam transmitir as informações necessárias umas às outras.

Anteriormente, abrir várias sessões do Claude Code resolvia principalmente problemas de paralelismo, mas os desenvolvedores ainda precisavam monitorar o progresso de cada terminal e repetidamente transmitir o status das tarefas entre as pessoas e as sessões. Agora, informações como mudanças na interface, resultados de testes e conclusão da migração podem ser enviadas diretamente às sessões afetadas.

A mensagens entre sessões não combinam vários Claude em um único Agente, mas adicionam uma camada de comunicação além do contexto, diretório de trabalho e limites de permissão originais.

Visto em um cenário de engenharia maior, esse design oferece uma abordagem alternativa para múltiplos Agentes: diferentes Agentes não precisam compartilhar um Contexto cada vez maior, mas ainda podem colaborar por meio de interfaces de comunicação bem definidas. Após separar tarefas, estados e permissões, o sistema torna-se mais fácil de escalar.

À medida que o número de Agentes continua a aumentar, a questão passará gradualmente de “o quanto um único Agente pode fazer” para “se esses Agentes conseguem trocar estados, gerenciar dependências e realizar transferências de forma estável entre si”.

Embora o messaging entre sessões resolva apenas uma parte, ele já permite que o modo de trabalho multissessão do Claude Code comece a adquirir uma estrutura de engenharia mais completa. Talvez, no futuro, esse mecanismo de comunicação entre sessões dentro da mesma rede local evolua para um protocolo de comunicação Agente-a-Agente entre máquinas e ecossistemas distintos, e nesse momento, essas breves conversas entre dois Claude representem um passo fundamental para a formação de uma fábrica de software altamente automatizada.