Aprender

La respuesta corta

La mensajería entre sesiones permite que Claude entregue un mensaje desde una de tus sesiones de Claude Code a otra. Cuando un cambio en una sesión rompe lo que otra está construyendo, Claude puede avisar a esa sesión antes de que te des cuenta. Cuando una sesión resuelve una duda que bloqueaba a otra, Claude puede enviar la respuesta.

Un mensaje es un texto que un Claude escribe a otro — nunca historial de conversación ni archivos. Para trasladar toda una conversación o su contexto, reanuda la sesión en su lugar.

Requiere Claude Code v2.1.224 o posterior y funciona en macOS y Linux. Cuando una sesión cumple los requisitos, la mensajería está activada sin que tengas que habilitar nada.

Cuándo usarlo

Usa la mensajería cuando una sesión tiene algo que otra necesita a mitad de tarea. Casos comunes:

• Transferir un hallazgo — cuando una sesión descubre un cambio disruptivo o toma una decisión, Claude lo resume para la sesión afectada en lugar de que tú lo expliques de nuevo.
• Coordinar worktrees en paralelo — sesiones que trabajan el mismo repositorio en worktrees separados pueden notificarse qué se integró.
• Recibir estado de trabajos de larga duración — una migración o una ejecución de pruebas informa de vuelta a la sesión que estás supervisando.
• Responder entre máquinas — responde a un mensaje que llegó desde una de tus sesiones en otra máquina o en la web. Entre máquinas, Claude solo puede responder; no puede iniciar el intercambio.

Claude Code tiene funciones dedicadas para otras formas de manejar varias sesiones: reanudar para continuar una conversación, agent teams para un equipo supervisado, agent view para vigilar muchas sesiones y Remote Control para controlar una de ellas tú mismo. Usa la que esté diseñada para lo que necesitas.

Cómo funciona

Claude usa dos herramientas: ListAgents para descubrir a qué agentes puede llegar, y SendMessage para entregar un mensaje por nombre. Nunca llamas a ninguna de las dos directamente — Claude descubre el destino y redacta el mensaje. Para solicitar que lo haga, dile a Claude lo que quieres que la otra sesión sepa o haga:

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

Para ver a qué sesiones puede llegar Claude, ejecuta /list-agents. Lista subagentes y tus otras sesiones locales (incluidas las de fondo), y las sesiones más allá de la máquina (etiquetadas como Remote Control) cuando hay conexión.

Una sesión responde al nombre que le asignaste con /rename o --name. Sin uno, Claude le pone un nombre a partir del directorio de trabajo (p. ej. myapp-3f).

Entrega y confianza

El Claude receptor lee el mensaje entre llamadas a herramientas durante un turno activo, así que una herramienta en ejecución nunca se interrumpe. Cuando la sesión está inactiva, Claude Code inicia un nuevo turno con el mensaje.

La entrega termina en uno de tres resultados, gobernados por la configuración crossSessionInbound de la sesión receptora:

• Entregado — Claude Code pasa el mensaje al Claude receptor.
• Retenido — apartado sin entregar hasta que lo apruebes o un cambio posterior de configuración lo permita.
• Rechazado — descartado sin entrega.

Los tokens cuentan como si fuera un prompt que tecleas, y el Claude receptor puede responder de la misma forma (excepto en el caso unidireccional entre máquinas).

El modelo de confianza importa. Los mensajes entre sesiones se tratan como entrada de terceros, no como consentimiento:

• Un mensaje no puede aprobar nada — nunca responde en tu nombre a un prompt de permiso pendiente.
• No puede cambiar la configuración — se indica al Claude receptor que nunca cambie permisos, CLAUDE.md u otra configuración porque otra sesión lo pidió.
• Los comandos no se ejecutan — un /compact en un mensaje llega como texto plano, nunca se ejecuta.
• Los prompts de permiso siguen apareciendo — actuar sobre un mensaje requiere los mismos permisos que cualquier otro trabajo.

Misma máquina vs entre máquinas

Dónde se ejecuta la otra sesión	Cómo viaja	Qué puede enviar Claude aquí
Esta máquina	Socket por sesión, nunca a través de los servidores de Anthropic	Mensajes nuevos y respuestas
Otra de tus máquinas	A través de los servidores de Anthropic, vía Remote Control	Solo respuestas
Claude Code en la web	A través de los servidores de Anthropic, directo a la sesión en la nube	Solo respuestas

La entrega en la misma máquina necesita que ambas sesiones vean el mismo sistema de archivos, así que sesiones en un contenedor y en el host no pueden alcanzarse entre sí (dos sesiones dentro del mismo contenedor sí pueden).

Controla la superficie

• crossSessionInbound — accept, hold, o refuse para mensajes entrantes.
• isolatePeerMachines: true — requiere tu aprobación antes de que cualquier mensaje salga de la máquina.
• Para dejar de enviar/escuchar por completo, añade reglas de denegación de permisos para SendMessage y ListAgents.

El comportamiento por defecto depende de los modos de permiso de ambas sesiones. Una sesión que evita los prompts de permiso trata un mensaje de una sesión que no los evita de forma diferente a como lo haría con otra que también los evita. Cuando el valor por defecto retiene un mensaje, Claude Code abre un diálogo de aprobación mostrando el remitente y una vista previa.

Conclusión

La mensajería entre sesiones es la solución cuando tus sesiones de Claude Code necesitan coordinarse pero no deben compartir todo el contexto. Es económica (un mensaje de texto, no una conversación), prioriza lo local en una máquina y está deliberadamente aislada: los mensajes entrantes no pueden aprobar, reconfigurar ni ejecutar comandos. La práctica productiva: mantén sesiones separadas para trabajos separados, permite que Claude resuma a través del límite y usa crossSessionInbound + isolatePeerMachines para establecer el límite de confianza con el que te sientas cómodo.

---

Fuente principal: Message your other Claude Code sessions (documentación de Claude Code). Requisito de versión (v2.1.224+), entrega, confianza y comportamiento de ajustes verificados contra la documentación oficial el 2026-08-08.