Claude Code, 같은 기기 세션 간 메시지 기능 문서 공개

Anthropic이 Claude Code의 세션 간 메시징 기능을 공식 문서로 안내했다. 문서에 따르면 한 대의 컴퓨터에서 실행 중인 Claude Code 세션은 다른 세션을 찾아 텍스트 메시지를 주고받을 수 있다. 병렬로 진행하는 작업에서 한 세션이 알아낸 변경 사항이나 결정, 진행 상태를 다른 세션에 전달하는 용도다.

이 기능은 Claude Code 2.1.224 이상에서 macOS와 Linux 환경에 제공된다. 서로 독립적으로 실행한 세션도 연결 대상이 될 수 있으며, 사용자는 `/list-agents` 또는 `/peers`로 연결 가능한 세션을 확인할 수 있다. Anthropic은 메시지가 대화 기록이나 파일을 옮기는 수단은 아니며, 필요한 정보만 텍스트로 전달한다고 설명했다.

수신 세션은 실행 중인 도구 작업을 중단하지 않고 도구 호출 사이에 메시지를 읽는다. 유휴 상태라면 메시지와 함께 새 작업 턴을 시작한다. 다만 전달된 메시지가 수신 세션의 권한을 대신 승인하지는 않는다. 메시지 안의 명령도 일반 텍스트로 취급되며 자동 실행되지 않는다.

세션별 수신 정책도 둘 수 있다. `crossSessionInbound` 설정은 메시지를 즉시 전달하거나 보류, 거부하도록 정한다. 다른 기기나 웹의 Claude Code 세션과는 Remote Control 연결을 통해 답장을 보낼 수 있지만, 해당 세션으로 새 대화를 먼저 시작할 수는 없다. 기기 밖으로 나가는 메시지에 별도 승인을 요구하는 `isolatePeerMachines` 설정도 지원한다.

같은 기기 안의 세션은 운영체제 사용자에게 제한된 개별 소켓을 통해 통신한다. Anthropic은 컨테이너와 호스트처럼 파일 시스템을 공유하지 않는 환경 사이에서는 세션을 찾을 수 없다고 설명했다. Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform, Microsoft Foundry에서는 이 기능을 제공하지 않는다.

이번 기능은 여러 코딩 에이전트를 병렬로 운용할 때 개발자가 직접 복사·붙여넣기하던 작업 맥락을 줄이려는 시도다. 다만 권한 경계와 수신 제어가 세션별로 유지되는 만큼, 실제 팀 개발 환경에서는 메시지 전달 범위와 승인 정책을 함께 설계할 필요가 있다.

출처: Anthropic Claude Code 공식 문서 https://code.claude.com/docs/en/cross-session-messaging