Claude Code는 v2.1.224부터 독립적으로 실행 중인 세션 하나가 다른 세션에 텍스트 메시지를 보내는 세션 간 메시지 기능을 갖췄다. macOS와 Linux(WSL 2 포함)에서 요구 사항을 만족하면 별도로 켜야 할 설정 없이 바로 작동한다. 이 기능은 한 세션의 대화 전체나 파일을 옮기는 것이 아니라, 다른 세션이 지금 필요로 하는 한 문장만 건네는 좁은 통로다.
세 가지 구체적 활용 장면
공식 문서가 꼽는 활용은 세 가지로 좁다. 첫째, 발견 사항 인계다. 한 세션이 다른 영역을 건드리는 변경이나 판단을 내리면, 그 내용을 사용자가 다시 설명하지 않아도 관련 작업을 하는 세션에 직접 요약해 건넨다. 둘째, 병렬 워크트리 조율이다. 여러 세션이 같은 저장소를 서로 다른 워크트리에서 작업할 때, 한 세션에서 반영된 변경을 다른 세션들에 알린다. 셋째, 장시간 작업 상태 보고다. 마이그레이션이나 테스트처럼 오래 걸리는 작업을 지켜보는 세션에 진행 상황을 보고하게 하거나, 그 세션에서 직접 물어볼 수 있다.
무엇이, 어떻게 오가는가
메시지는 한 Claude가 다른 Claude에게 쓰는 순수 텍스트 한 조각이며, 대화 기록이나 파일은 절대 함께 전달되지 않는다. 대화 전체나 맥락을 옮기려면 세션 재개(resume session)를 대신 써야 한다. Claude는 이를 위해 두 도구를 쓴다. ListAgents는 지금 닿을 수 있는 세션 목록을 찾고, SendMessage는 그중 하나에 이름으로 메시지를 전달한다. 사용자가 이 도구를 직접 호출하는 일은 없다. "다른 터미널에서 돌아가는 세션에 마이그레이션이 끝났는지 물어봐줘"처럼 자연어로 요청하면 Claude가 알아서 대상을 찾아 보낸다.
메시지가 오가는 경로는 상대 세션이 어디서 도는지에 따라 갈린다. 같은 컴퓨터 위의 세션끼리는 세션마다 만들어지는 소켓을 통해 Anthropic 서버를 거치지 않고 직접 주고받으며, 새 메시지와 답장을 모두 보낼 수 있다. 다른 컴퓨터에 있는 세션이나 Claude Code on the web 세션에는 Anthropic 서버를 통해 닿는다. Claude Code v2.1.225 이상이면 목록에 보이는 다른 기기 세션에도 먼저 메시지를 시작할 수 있다. 보내는 세션이 Remote Control에 연결돼 답장 주소를 함께 보낼 수 있으면 받는 세션도 같은 경로로 답장한다. 그렇지 않은 직접 요청은 도착해도 답장 주소가 없어 일방향이 된다.
세션 재개·에이전트 팀·Remote Control과 무엇이 다른가
Claude Code에는 여러 세션을 다루는 방법이 이미 여럿 있고, 세션 간 메시지는 그중 하나의 좁은 역할만 맡는다. 한 대화를 다른 터미널에서 이어가거나 맥락 전체를 새 세션과 공유하려면 세션 재개를 쓴다. Claude가 스스로 만들고 감독하는 세션 팀이 필요하면 에이전트 팀을 쓴다. 여러 세션을 한곳에서 지켜보고 조종하려면 에이전트 뷰를 쓴다. 휴대폰이나 다른 기기에서 세션 하나를 직접 조종하려면 Remote Control을 쓴다. CI 결과나 채팅 메시지 같은 외부 이벤트를 세션에 밀어 넣으려면 채널을 쓴다. 세션 간 메시지는 이 중 어디에도 속하지 않는, 사용자가 직접 켜고 조종하는 독립된 세션들 사이의 통로다.
제한: 버전, 플랫폼, 메시지 안전장치
이 기능은 Claude Code v2.1.224 이상에서만 작동하고, 지원 플랫폼은 macOS와 Linux로 한정된다. 네이티브 Windows에서는 제공되지 않는다. Amazon Bedrock, AWS의 Claude Platform, Google Cloud의 Agent Platform, Microsoft Foundry 경로에서는 쓸 수 없다. 받는 세션 쪽에서도 안전장치가 있다. 도착한 메시지는 사용자의 승인을 대신하지 못하고, 설정을 바꾸지 못하며, 메시지 안에 적힌 명령은 그대로 텍스트로 남을 뿐 실행되지 않는다. 실행에 권한이 필요하면 평소와 같은 승인 프롬프트가 뜬다. 또한 Claude Code는 반복 메시지를 세션마다 속도 제한하고, 세션당 대기 중인 메시지를 최대 50개까지만 쌓아 두므로 두 세션이 서로에게 메시지를 계속 보내는 순환도 스스로 멈춘다.
출처: Claude Code 공식 문서 Cross-session messaging (2026-08-08 확인)