Mensajería entre tus otras sesiones de Claude Code

​

Cuándo usar mensajería entre sesiones

• Entregar un hallazgo: cuando una sesión descubre un cambio que rompe algo o toma una decisión, Claude lo resume para la sesión que trabaja en el área afectada, en lugar de que lo re-expliques allí.
• Coordinar worktrees paralelos: cuando las sesiones trabajan el mismo repositorio en worktrees separados, Claude puede decirle a las otras sesiones qué se implementó.
• Obtener estado del trabajo de larga duración: haz que una migración o ejecución de prueba informe a la sesión que estás observando, o pregúntale desde allí. Si esa sesión está en esta máquina, Claude también puede pedirle un aviso cuando la sesión se quede inactiva o salga.
• Enviar mensajes entre máquinas: alcanza una de tus sesiones en otra máquina o en la web.

• Para continuar una conversación en otra terminal, o compartir su contexto con una nueva sesión, reanuda la sesión
• Para un equipo coordinado de sesiones que Claude genera y supervisa, usa equipos de agentes
• Para observar y dirigir muchas sesiones desde un lugar, usa vista de agentes
• Para dirigir una sesión tú mismo desde tu teléfono u otro dispositivo, en lugar de que las sesiones se envíen mensajes entre sí, usa Control Remoto
• Para insertar eventos externos, como resultados de CI o mensajes de chat, en una sesión, usa canales

​

Enviar un mensaje a otra sesión

Pregunta a la sesión que se ejecuta en mi otra terminal si la migración terminó

Explica lo que acabamos de hacer a la sesión que trabaja en la API de pagos

Hazle saber a @api-worker que la migración de esquema terminó

• Una sesión más allá de esta máquina: una sesión en la nube o Control Remoto aparece en el typeahead solo después de que Claude haya listado o enviado mensajes a tus sesiones más allá de esta máquina, así que pídele a Claude que las liste primero.
• Un nombre con un espacio u otros caracteres fuera de letras, dígitos, guiones e guiones bajos: escríbelo entre comillas dobles, como @"release notes". Cuando eliges la sesión del typeahead, Claude Code inserta las comillas por ti.

​

Entrega de mensajes

• El mensaje está por encima del límite de tamaño. Claude Code lo rechaza en la sesión de envío, antes de que se vaya.
• Una ráfaga rápida a una sesión en esta máquina ha alcanzado lo que esa bandeja de entrada de sesión acepta. Claude Code rechaza más mensajes a esa sesión.
• El destino de respuesta en esta máquina falla una verificación de seguridad, como un destino con enlace simbólico o un punto final que no es el proceso esperado. Rechazar enviar un mensaje entre sesiones lista estas verificaciones.
• Claude dirige el mensaje al nombre de esta propia sesión, como se describe en Ver qué sesiones Claude puede alcanzar.

• Entregado: Claude Code pasa el mensaje al Claude receptor.
• Retenido: Claude Code deja el mensaje de lado sin entregar. Un mensaje retenido llega a Claude solo cuando lo apruebas o un modo o cambio de configuración posterior lo permite.
• Rechazado: Claude Code descarta el mensaje sin entregarlo.

​

Obtener un aviso cuando otra sesión se queda inactiva

​

Solicitar un aviso

Dime cuándo la sesión de migración termina lo que está haciendo

​

Lo que cada sesión muestra

​

Límites

• refuse en cualquier lado: nada llega. La sesión observada descarta la solicitud sin registrar o responder, así que la suscripción expira sin respuesta después de 12 horas, y una sesión que pregunta con refuse nunca se suscribe.
• hold en cualquier lado: el aviso llega con menos. La sesión observada deja fuera el estado de una línea, y la sesión que pregunta muestra el aviso en tu transcripción sin entregarlo a Claude.

​

Ver qué sesiones Claude puede alcanzar

• Subagentes: agentes que se ejecutan dentro de la sesión actual.
• Compañeros: los propios compañeros de equipo de agentes de esta sesión. Antes de v2.1.239, los compañeros no aparecían en el listado, aunque Claude ya podía enviarles mensajes por nombre.
• Tus otras sesiones locales: sesiones de Claude Code que se ejecutan en la misma máquina, incluidas sesiones en segundo plano. Una sesión aparece solo cuando vincula un socket de bandeja de entrada.
• Tus sesiones en la nube: tus sesiones de Claude Code en la web, mostradas mientras esta sesión está conectada a Control Remoto. Claude Code las etiqueta como cloud en el listado.
• Tus sesiones de Control Remoto en otras máquinas: mostradas mientras esta sesión está conectada a Control Remoto, y etiquetadas como Remote Control. Claude Code muestra offline como el estado de una sesión cuya conexión de Control Remoto se ha caído.

• Directorios de trabajo: deja fuera el directorio de trabajo de cada sesión local.
• Nombres de sesión: deja fuera cualquier nombre de sesión que no pueda atribuir a una persona, así que una fila dejada sin nombre lee (unnamed session).
• La primera línea: deja fuera la línea con el nombre de esta propia sesión a menos que escribas ese nombre en esta terminal, con --name o con /rename y el nombre, desde que lanzaste o reanudaste la sesión por última vez.

• Una sesión responde al nombre: Claude Code entrega el mensaje solo en el nombre.
• Varias sesiones comparten el nombre, o Claude Code no pudo verificar en todas partes donde se ejecutan tus sesiones: Claude agrega un identificador corto a cada fila de su listado y usa el identificador en la dirección.

​

Enviar mensajes a sesiones en otras máquinas

​

Cómo una sesión trata un mensaje entrante

• No puede aprobar nada: un mensaje de otra sesión nunca cuenta como tu consentimiento, así que no puede responder a un mensaje de permiso pendiente en tu nombre.
• No puede cambiar configuración: Claude Code instruye al Claude receptor a nunca cambiar configuraciones de permisos, CLAUDE.md u otra configuración porque otra sesión lo pidió.
• Los comandos no se ejecutan: un comando en el texto del mensaje, como /compact, llega como texto plano. Claude Code nunca lo ejecuta.
• Los mensajes de permiso aún se disparan: si actuar sobre el mensaje requiere un permiso que la sesión receptora no tiene, ves el mismo mensaje que verías para cualquier otro trabajo.

​

Cómo se ve un mensaje

• Presiona Ctrl+O para abrir el visor de transcripción y lee el texto completo bajo el nombre de sesión del remitente.
• En una sesión iniciada con --verbose, Claude Code muestra el texto completo en lugar de la vista previa.

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

​

Controlar mensajes entrantes

• La sesión receptora solicita permisos: Claude Code entrega cada mensaje. Retiene uno para tu aprobación solo cuando la sesión de envío se identifica como omitiendo mensajes de permiso.
• La sesión receptora omite mensajes de permiso: Claude Code retiene cada mensaje para tu aprobación. Entrega uno solo cuando la sesión de envío se identifica como también omitiendo.

• Aprobar entrega ese mensaje a Claude.
• Denegar, o descartar el diálogo, lo descarta.
• Cuando el diálogo permanece sin respuesta pasado el plazo dialogExpiry, Claude Code lo cierra y descarta el mensaje. El plazo predeterminado es cinco minutos. Mientras ninguna terminal está adjunta a una sesión en segundo plano, Claude Code deja el diálogo abierto pasado el plazo. Después de que adjuntes, Claude Code cierra el diálogo y descarta el mensaje solo si permanece sin respuesta durante un período de plazo completo.
• Si la clase de modo de permiso de esta sesión cambia mientras los mensajes están retenidos, Claude Code re-aplica las reglas de entrada, entrega los mensajes que ahora acepta, y muestra un aviso.
• Si un cambio de configuración hace que refuse se aplique mientras los mensajes están retenidos, Claude Code descarta cada mensaje retenido e informa un rechazo a cada remitente que puede alcanzar.

​

Sesiones no interactivas

• Antes del plazo: si un cambio de modo o configuración permite el mensaje, Claude Code lo entrega.
• Pasado el plazo: Claude Code descarta el mensaje e informa que expiró a un remitente que puede alcanzar.

​

El socket de bandeja de entrada de la sesión

• /status la muestra en la fila Peer address. La ruta tiene el prefijo uds:.
• Claude Code la exporta a hooks y comandos Bash como la variable de entorno CLAUDE_CODE_MESSAGING_SOCKET:
  • En una sesión que inicia con mensajería activada, Claude Code exporta la variable antes de que cualquier hook se ejecute, incluido SessionStart.
  • Cada sesión exporta su propio socket, nunca uno heredado de una sesión padre.

• macOS y Linux, incluido WSL 2: la línea es opcional. Claude Code acepta una conexión con o sin ella.
• Windows nativo: la línea es requerida. Claude Code cierra cualquier conexión cuya primera línea no sea una línea de autenticación válida y no entrega nada de esa conexión.

• Mensajes de propio-hijo: cuando no se aplica ningún valor crossSessionInbound, Claude Code entrega un mensaje que verifica vino de los procesos hijo de la sesión, como un hook o comando Bash que publica de vuelta al socket de su propia sesión.
  • En Linux, incluido dentro de WSL 2, Claude Code puede verificar por evidencia de proceso incluso para un hijo que ya ha salido. En macOS puede verificar de esa manera solo mientras el proceso de publicación aún se está ejecutando, y en un contenedor donde Claude Code se ejecuta como ID de proceso 1 no tiene evidencia de proceso en absoluto. En Windows nativo tampoco la tiene.
  • En macOS después de que el proceso de publicación ha salido y en contenedores donde Claude Code se ejecuta como ID de proceso 1, esa evidencia de proceso falta, y Claude Code en su lugar verifica un hijo que envió el CLAUDE_CODE_MESSAGING_TOKEN exportado de la sesión en la línea de autenticación que abrió su conexión. En Windows nativo, ese token es la única forma en que Claude Code verifica un mensaje de propio-hijo.
  • Cuando Claude Code no puede verificar de ninguna manera, trata el mensaje como cualquier otro que no afirma ninguna clase de permiso, así que una sesión que omite mensajes de permiso lo retiene para tu aprobación.
• Sesiones sandboxed: controla si un comando Bash puede alcanzar el socket desde dentro del sandbox con la configuración de socket Unix del sandbox, sandbox.network.allowAllUnixSockets y sandbox.network.allowUnixSockets.

​

Restringir mensajería entre sesiones

​

Requerir aprobación para mensajes entre máquinas

{
  "isolatePeerMachines": true
}

​

Desactivar mensajería entre sesiones

• Dejar de recibir: establece crossSessionInbound a refuse, y Claude Code descarta mensajes de par entrantes sin entregarlos. Desde configuración de proyecto o local, refuse se aplica sobre todas las otras fuentes, y desde tu configuración de usuario se aplica a menos que la configuración administrada o la bandera --settings establezcan un valor.
• Dejar de enviar y listar: agrega reglas de permiso de denegación específicas de herramienta que nombren SendMessage y ListAgents. Ambas toman el nombre de herramienta desnudo sin especificador.

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

​

Disponibilidad

• Sistema operativo: disponible en macOS, Windows y Linux, incluido Linux dentro de WSL 2.
• Sesiones en esta máquina: disponible en cada proveedor, incluido Amazon Bedrock, Claude Platform en AWS, Google Cloud’s Agent Platform y Microsoft Foundry, y en sesiones que se ejecutan con obtención de bandera de característica desactivada. En esos proveedores, y con obtención de bandera desactivada, la mensajería en la misma máquina requiere Claude Code v2.1.248 o posterior. Claude Code entrega estos mensajes sobre un socket por sesión en tu máquina, nunca a través de servidores de Anthropic. Para evitar que una sesión los reciba, establece crossSessionInbound a refuse.
• Sesiones más allá de esta máquina: Claude encuentra tus sesiones de Claude Code en la web y tus sesiones en otras máquinas desde una sesión que está conectada a Control Remoto, que necesita un inicio de sesión en claude.ai como autenticación activa de esta sesión y los otros requisitos de Control Remoto. Claude no puede encontrar esas sesiones con una clave API o en Amazon Bedrock, Claude Platform en AWS, Google Cloud’s Agent Platform y Microsoft Foundry.

• /list-agents no se reconoce: la sesión no tiene mensajería entre sesiones. Trabaja a través de los requisitos anteriores, comenzando con claude --version para el requisito de versión.
• /list-agents funciona pero un envío no llegó: la mensajería está activada, y algo más estrecho se aplica:
  • Reglas de denegación: una regla de permiso de denegación específica de herramienta elimina las herramientas SendMessage y ListAgents.
  • Controles de entrada: los controles de entrada de la sesión receptora pueden retener o descartar lo que envías.
  • Sesión en la nube faltante: una sesión en la nube aparece solo mientras esta sesión está conectada a Control Remoto.
  • Sesión en otra máquina faltante: una sesión en otra de tus máquinas aparece solo cuando se ejecuta con Control Remoto y esta sesión también está conectada.
  • Sesión en la nube o en otra máquina más antigua faltante: Claude Code lee esas listas de sesiones más nuevas primero y se detiene después de un número acotado de páginas, así que Claude no puede enviar un mensaje a una sesión que cayó pasado ellas por nombre.
  • Iniciando una conversación: Enviar mensajes a sesiones en otras máquinas cubre iniciar una conversación con una sesión más allá de esta máquina.

​

Limitaciones

• Solo texto plano: Claude envía solo texto plano entre sesiones. Los mensajes de protocolo de equipo de agentes estructurados permanecen dentro de un equipo.
• El tamaño del mensaje en la misma máquina está limitado: Claude Code rechaza un mensaje a una sesión en esta máquina una vez que su forma serializada pasa aproximadamente un millón de caracteres. El rechazo nombra los tamaños exactos. Nada llega a la sesión receptora.
• Las ráfagas rápidas a una sesión se rechazan en el remitente: una vez que una ráfaga rápida de mensajes a una sesión en esta máquina alcanza lo que esa bandeja de entrada acepta, Claude Code rechaza más envíos en la sesión de envío. El rechazo nombra la ráfaga y le dice a Claude que agrupe el resto en un mensaje o espere. Antes de v2.1.236, Claude Code reportaba esos envíos como enviados mientras la sesión receptora los descartaba.
• Los bucles de mensajes se limitan: en la sesión receptora, Claude Code limita la velocidad de mensajes repetidos por remitente, descarta repeticiones idénticas que llegan dentro de una ventana corta, y pone en cola como máximo 50 mensajes aceptados para que Claude lea. Un bucle de mensajes entre dos sesiones por lo tanto se detiene por sí solo. Cuando el límite de velocidad, verificación de repetición o límite de cola descarta un mensaje de una sesión interactiva en esta máquina, Claude Code le dice a esa sesión cuál lo descartó y le dice a su Claude que no reenvíe de inmediato.

​

Recursos relacionados

• Subagentes y equipos de agentes: mensajería dentro de una única sesión o equipo
• Agentes en segundo plano: despacha y monitorea las sesiones paralelas que podrías enviar mensajes
• Control Remoto: conecta esta sesión para alcanzar tus sesiones en otras máquinas
• Configuración: crossSessionInbound, isolatePeerMachines y dialogExpiry
• Modos de permiso: los modos detrás de las dos clases del valor predeterminado de entrada
• Referencia de herramientas: las filas ListAgents y SendMessage en la tabla de herramientas
• Ejecutar agentes en paralelo: compara las formas en que Claude Code ejecuta múltiples agentes