Message your other Claude Code sessions

개요

Claude Code 세션 간 메시지 기능을 통해 한 세션에서 다른 세션으로 텍스트 메시지를 전달할 수 있으며, 이를 통해 한 세션의 변경 사항이 다른 세션에 미치는 영향을 사전에 경고하거나 질문에 대한 답을 공유할 수 있습니다.

주요 내용

* 크로스 세션 메시징의 용도: 한 세션에서 다른 세션이 작업 중에 필요로 하는 정보(예: 변경 사항 요약, 결정 사항 전달, 장기 실행 작업 상태 보고)를 전달할 때 사용됩니다.
* 메시지 전달 방식: Claude는 ListAgents 도구를 사용하여 도달 가능한 에이전트를 검색하고, SendMessage 도구를 사용하여 지정된 에이전트에게 메시지를 보냅니다. 이 과정에서 사용자가 직접 도구를 호출할 필요는 없습니다.
* 메시지 도달 및 처리: 메시지는 도구 호출 중에 실시간으로 읽히거나, 수신 세션이 유휴 상태일 때 새 턴으로 시작됩니다. 메시지 도착 시 'Delivered', 'Held'(승인 대기), 'Refused'(거부)의 세 가지 상태로 처리될 수 있습니다.
* 권한 및 제어: 메시지를 받는 세션은 자체 권한 설정과 규칙을 따르며, 다른 세션이 거부되거나 차단된 작업을 요청하는 것을 방지합니다. 또한 crossSessionInbound 설정을 통해 수신 메시지를 'accept', 'hold', 'refuse'로 제어할 수 있습니다.
* 보안 및 격리: isolatePeerMachines 설정을 통해 기기 외부로 나가는 메시지에 대한 승인을 요구할 수 있으며, permission deny 규칙을 사용하여 특정 도구(SendMessage, ListAgents)의 사용을 차단할 수 있습니다.
* 메시지 내용 제한: Claude는 세션 간에 일반 텍스트만 보낼 수 있으며, 구조화된 에이전트 팀 프로토콜 메시지는 팀 내에서만 유지됩니다. 메시지 루프는 속도 제한 및 중복 메시지 방지 메커니즘을 통해 제어됩니다.
* 사용 가능한 환경: 크로스 세션 메시징은 Claude Code v2.1.224 이상에서 macOS 및 Linux(WSL 2 포함)에서 사용 가능하며, 특정 클라우드 제공업체 및 기능 플래그 설정에 따라 가용성이 달라질 수 있습니다.

시사점

크로스 세션 메시징 기능은 독립적인 Claude Code 세션 간의 정보 흐름을 원활하게 하여 개발자의 생산성을 향상시키고, 복잡한 작업 워크플로우를 자동화하는 데 기여할 수 있습니다.