Mensagem para suas outras sessões do Claude Code

​

Quando usar cross-session messaging

• Entregar uma descoberta: quando uma sessão descobre uma mudança quebrada ou toma uma decisão, Claude a resume para a sessão trabalhando na área afetada, em vez de você re-explicá-la lá.
• Coordenar worktrees paralelos: quando sessões trabalham o mesmo repositório em worktrees separadas, Claude pode dizer às outras sessões o que foi entregue.
• Obter status de trabalho de longa duração: ter uma migração ou execução de teste relatar de volta para a sessão que você está observando, ou pedir você mesmo de lá. Se essa sessão estiver nesta máquina, Claude também pode pedir a ela um aviso quando ela próxima ficar ociosa ou sair.
• Mensagem entre máquinas: alcance uma de suas sessões em outra máquina ou na web.

• Para continuar uma conversa em outro terminal, ou compartilhar seu contexto com uma nova sessão, retome a sessão
• Para uma equipe coordenada de sessões que Claude gera e supervisiona, use equipes de agentes
• Para observar e direcionar muitas sessões de um lugar, use visualização de agentes
• Para direcionar uma sessão você mesmo do seu telefone ou outro dispositivo, em vez de ter sessões se enviando mensagens, use Controle Remoto
• Para enviar eventos externos, como resultados de CI ou mensagens de chat, para uma sessão, use canais

​

Mensagem para outra sessão

Ask the session running in my other terminal whether the migration finished

Explain what we just did to the session working on the payments API

Let @api-worker know the schema migration finished

• Uma sessão além desta máquina: uma sessão na nuvem ou Controle Remoto aparece no typeahead apenas depois que Claude listou ou enviou mensagem para suas sessões além desta máquina, então peça a Claude para listá-las primeiro.
• Um nome com espaço ou outros caracteres fora de letras, dígitos, hífens e sublinhados: digite-o entre aspas duplas, como @"release notes". Quando você escolhe a sessão do typeahead, Claude Code insere as aspas para você.

​

Entrega de mensagem

• A mensagem está acima do limite de tamanho. Claude Code a recusa na sessão de envio, antes de sair.
• Uma rajada rápida para uma sessão nesta máquina atingiu o que a caixa de entrada dessa sessão aceita. Claude Code recusa mais mensagens para essa sessão.
• O alvo de resposta nesta máquina falha em uma verificação de segurança, como um alvo com link simbólico ou um endpoint que não é o processo esperado. Recusando enviar uma mensagem cross-session lista essas verificações.
• Claude endereça a mensagem ao nome da própria sessão, conforme descrito em Veja quais sessões Claude pode alcançar.

• Entregue: Claude Code passa a mensagem para o Claude receptor.
• Retida: Claude Code coloca a mensagem de lado não entregue. Uma mensagem retida alcança Claude apenas quando você a aprova ou uma mudança de modo ou configurações posterior a permite.
• Recusada: Claude Code descarta a mensagem sem entregá-la.

​

Obter um aviso quando outra sessão fica ociosa

​

Pedir um aviso

Tell me when the migration session finishes what it's working on

​

O que cada sessão mostra

​

Limites

• refuse em qualquer lado: nada chega. A sessão observada descarta a solicitação sem registrar ou responder a ela, então a inscrição expira sem resposta após 12 horas, e uma sessão solicitante com refuse nunca se inscreve.
• hold em qualquer lado: o aviso chega com menos. A sessão observada deixa o status de uma linha de fora, e a sessão solicitante mostra o aviso em sua transcrição sem entregá-lo a Claude.

​

Veja quais sessões Claude pode alcançar

• Subagentes: agentes executando dentro da sessão atual.
• Colegas: os próprios colegas de equipe de agentes dessa sessão. Antes de v2.1.239, colegas não apareciam na listagem, embora Claude já pudesse enviá-los mensagem pelo nome.
• Suas outras sessões locais: sessões Claude Code executando na mesma máquina, incluindo sessões em background. Uma sessão aparece apenas quando vincula um socket de caixa de entrada.
• Suas sessões na nuvem: suas sessões Claude Code na web, mostradas enquanto essa sessão está conectada a Controle Remoto. Claude Code as rotula cloud na listagem.
• Suas sessões Controle Remoto em outras máquinas: mostradas enquanto essa sessão está conectada a Controle Remoto, e rotuladas Remote Control. Claude Code mostra offline como o status de uma sessão cuja conexão Controle Remoto caiu.

• Diretórios de trabalho: deixa de fora o diretório de trabalho de cada sessão local.
• Nomes de sessão: deixa de fora qualquer nome de sessão que não possa atribuir a uma pessoa, então uma linha deixada sem nome lê (unnamed session).
• A primeira linha: deixa de fora a linha com o nome dessa própria sessão a menos que você tenha digitado esse nome neste terminal, com --name ou com /rename e o nome, desde que iniciou ou retomou a sessão pela última vez.

• Uma sessão responde ao nome: Claude Code entrega a mensagem apenas no nome.
• Várias sessões compartilham o nome, ou Claude Code não conseguiu verificar em todos os lugares onde suas sessões executam: Claude adiciona um identificador curto a cada linha de sua listagem e usa o identificador no endereço.

​

Mensagem para sessões em outras máquinas

​

Como uma sessão trata uma mensagem chegando

• Não pode aprovar nada: uma mensagem de outra sessão nunca conta como seu consentimento, então não pode responder a um prompt de permissão pendente em seu nome.
• Não pode mudar configuração: Claude Code instrui o Claude receptor nunca mudar configurações de permissão, CLAUDE.md ou outra configuração porque outra sessão pediu.
• Comandos não executam: um comando no texto da mensagem, como /compact, chega como texto simples. Claude Code nunca o executa.
• Prompts de permissão ainda disparam: se agir na mensagem requer uma permissão que a sessão receptora não tem, você vê o mesmo prompt que veria para qualquer outro trabalho.

​

Como uma mensagem parece

• Pressione Ctrl+O para abrir o visualizador de transcrição e ler o texto completo sob o nome da sessão do remetente.
• Em uma sessão iniciada com --verbose, Claude Code mostra o texto completo em vez da prévia.

Schema migration finished
The new column is tenant_id, and rebasing on main is safe now.

​

Controlar mensagens chegando

• A sessão receptora solicita permissões: Claude Code entrega cada mensagem. Retém uma apenas para sua aprovação quando a sessão de envio se identifica como contornando prompts de permissão.
• A sessão receptora contorna prompts de permissão: Claude Code retém cada mensagem para sua aprovação. Entrega uma apenas quando a sessão de envio se identifica como também contornando.

• Approve entrega essa mensagem a Claude.
• Deny, ou descartar o diálogo, a descarta.
• Quando o diálogo fica sem resposta após o prazo dialogExpiry, Claude Code o fecha e descarta a mensagem. O prazo padrão é cinco minutos.
• Enquanto nenhum terminal está anexado a uma sessão em background, Claude Code deixa o diálogo aberto após o prazo. Depois que você anexa, se o diálogo fica sem resposta por um período de prazo completo, Claude Code o fecha e descarta a mensagem.
• Se a classe de modo de permissão dessa sessão muda enquanto mensagens estão retidas, Claude Code re-aplica as regras de entrada, entrega as mensagens que agora aceita, e mostra um aviso.
• Se uma mudança de configurações faz refuse se aplicar enquanto mensagens estão retidas, Claude Code descarta cada mensagem retida e relata uma recusa a cada remetente que pode alcançar.

​

Sessões não-interativas

• Antes do prazo: se um modo ou mudança de configurações permite a mensagem, Claude Code a entrega.
• Após o prazo: Claude Code descarta a mensagem e a relata como expirada a um remetente que pode alcançar.

​

O socket de caixa de entrada da sessão

• /status o mostra na linha Peer address. O caminho é prefixado com uds:.
• Claude Code o exporta para hooks e comandos Bash como a variável de ambiente CLAUDE_CODE_MESSAGING_SOCKET:
  • Em uma sessão que inicia com messaging ativado, Claude Code exporta a variável antes de qualquer hook executar, incluindo SessionStart.
  • Cada sessão exporta seu próprio socket, nunca um herdado de uma sessão pai.

• macOS e Linux, incluindo WSL 2: a linha é opcional. Claude Code aceita uma conexão com ou sem ela.
• Windows nativo: a linha é obrigatória. Claude Code fecha qualquer conexão cuja primeira linha não é uma linha de autenticação válida e não entrega nada dessa conexão.

• Mensagens own-child: quando nenhum valor crossSessionInbound se aplica, Claude Code entrega uma mensagem que verifica veio dos processos filhos da própria sessão, como um hook ou comando Bash postando de volta para o socket da própria sessão.
  • Em Linux, incluindo dentro de WSL 2, Claude Code pode verificar por evidência de processo mesmo para um filho que já saiu. Em macOS pode verificar assim apenas enquanto o processo de postagem ainda está executando, e em um contêiner onde Claude Code executa como ID de processo 1 não tem evidência de processo. No Windows nativo também não tem.
  • Em macOS depois que o processo de postagem saiu e em contêineres onde Claude Code executa como ID de processo 1, essa evidência de processo está faltando, e Claude Code em vez disso verifica um filho que enviou o CLAUDE_CODE_MESSAGING_TOKEN exportado da sessão na linha de autenticação que abriu sua conexão. No Windows nativo, esse token é a única forma que Claude Code verifica uma mensagem own-child.
  • Quando Claude Code não consegue verificar de nenhuma forma, trata a mensagem como qualquer outra que não afirma nenhuma classe de permissão, então uma sessão que contorna prompts de permissão a retém para sua aprovação.
• Sessões sandboxed: controle se um comando Bash pode alcançar o socket de dentro do sandbox com as configurações de socket Unix do sandbox, sandbox.network.allowAllUnixSockets e sandbox.network.allowUnixSockets.

​

Restringir cross-session messaging

​

Exigir aprovação para mensagens cross-machine

{
  "isolatePeerMachines": true
}

​

Desativar cross-session messaging

• Parar de receber: defina crossSessionInbound para refuse, e Claude Code descarta mensagens peer de entrada sem entregá-las. De configurações de projeto ou local, refuse se aplica sobre toda outra fonte, e de suas configurações de usuário se aplica a menos que configurações gerenciadas ou a flag --settings definam um valor.
• Parar de enviar e listar: adicione regras de negação de permissão nomeando SendMessage e ListAgents. Ambas pegam o nome da ferramenta simples sem especificador.

{
  "permissions": {
    "deny": ["SendMessage", "ListAgents"]
  },
  "crossSessionInbound": "refuse"
}

​

Disponibilidade

• Sistema operacional: disponível em macOS, Windows e Linux, incluindo Linux dentro de WSL 2.
• Sessões nesta máquina: disponível em cada provedor, incluindo Amazon Bedrock, Claude Platform em AWS, Google Cloud’s Agent Platform e Microsoft Foundry, e em sessões que executam com busca de flag de recurso desativada. Naqueles provedores, e com busca de flag desativada, messaging na mesma máquina requer Claude Code v2.1.248 ou posterior. Claude Code entrega essas mensagens sobre um socket por sessão em sua máquina, nunca através de servidores Anthropic. Para parar uma sessão de recebê-las, defina crossSessionInbound para refuse.
• Sessões além desta máquina: Claude encontra suas sessões Claude Code na web e suas sessões em outras máquinas de uma sessão que está conectada a Controle Remoto, que precisa de um sign-in claude.ai como autenticação ativa dessa sessão e os outros requisitos Controle Remoto. Claude não consegue encontrar essas sessões com uma chave de API ou em Amazon Bedrock, Claude Platform em AWS, Google Cloud’s Agent Platform e Microsoft Foundry.

• /list-agents não é reconhecido: a sessão não tem cross-session messaging. Trabalhe através dos requisitos acima, começando com claude --version para o requisito de versão.
• /list-agents funciona mas um envio não chegou: messaging está ativado, e algo mais estreito se aplica:
  • Regras de negação: uma regra de negação de permissão remove as ferramentas SendMessage e ListAgents.
  • Controles de entrada: os controles de entrada da sessão receptora podem reter ou descartar o que você envia a ela.
  • Sessão na nuvem faltando: uma sessão na nuvem aparece apenas enquanto essa sessão está conectada a Controle Remoto.
  • Sessão em outra máquina faltando: uma sessão em outra de suas máquinas aparece apenas quando executa com Controle Remoto e essa sessão também está conectada.
  • Sessão em outra máquina offline: uma mensagem para uma sessão listada como offline passa, mas chega apenas depois que a máquina dessa sessão se reconecta.
  • Sessão na nuvem ou em outra máquina mais antiga faltando: Claude Code lê essas listas de sessão mais recentes primeiro e para após um número limitado de páginas, então Claude não consegue enviar mensagem para uma sessão que caiu além delas pelo nome.
  • Iniciando uma conversa: Mensagem para sessões em outras máquinas cobre iniciar uma conversa com uma sessão além desta máquina.

​

Limitações

• Apenas texto simples: Claude envia apenas texto simples entre sessões. Mensagens de protocolo equipe de agentes estruturadas ficam dentro de uma equipe.
• O tamanho da mensagem na mesma máquina é limitado: Claude Code recusa uma mensagem para uma sessão nesta máquina uma vez que sua forma serializada passa cerca de um milhão de caracteres. A recusa nomeia os tamanhos exatos. Nada alcança a sessão receptora.
• Rajadas rápidas para uma sessão são recusadas no remetente: uma vez que uma rajada rápida de mensagens para uma sessão nesta máquina atinge o que a caixa de entrada dessa sessão aceita, Claude Code recusa envios adicionais na sessão de envio. A recusa nomeia a rajada e diz a Claude para agrupar o resto em uma mensagem ou esperar. Antes de v2.1.236, Claude Code relatava esses envios como enviados enquanto a sessão receptora os descartava.
• Loops de mensagem são limitados: na sessão receptora, Claude Code limita a taxa de mensagens repetidas por remetente, descarta repetições idênticas chegando dentro de uma janela curta, e enfileira no máximo 50 mensagens aceitas para Claude ler. Um loop de mensagem entre duas sessões portanto para por conta própria. Quando o limite de taxa, verificação de repetição ou limite de fila descarta uma mensagem de uma sessão interativa nesta máquina, Claude Code diz a essa sessão qual descartou e diz seu Claude não reenviar imediatamente.

​

Recursos relacionados

• Subagentes e equipes de agentes: messaging dentro de uma única sessão ou equipe
• Agentes em background: despache e monitore as sessões paralelas que você pode enviar mensagem
• Controle Remoto: conecte essa sessão para alcançar suas sessões em outras máquinas
• Configurações: crossSessionInbound, isolatePeerMachines e dialogExpiry
• Modos de permissão: os modos por trás das duas classes do padrão de entrada
• Referência de ferramentas: as linhas ListAgents e SendMessage na tabela de ferramentas
• Executar agentes em paralelo: compare as formas que Claude Code executa múltiplos agentes