다른 Claude Code 세션에 메시지 보내기

​

교차 세션 메시징을 사용할 때

• 발견 사항 전달: 한 세션이 주요 변경 사항을 발견하거나 결정을 내릴 때, Claude는 영향을 받는 영역에서 작업 중인 세션에 요약을 제공하므로 사용자가 거기서 다시 설명할 필요가 없습니다.
• 병렬 worktree 조정: 세션이 별도의 worktree에서 동일한 저장소에서 작업할 때, Claude는 다른 세션에 무엇이 병합되었는지 알릴 수 있습니다.
• 장기 실행 작업에서 상태 가져오기: 마이그레이션 또는 테스트 실행이 보고 있는 세션으로 다시 보고하도록 하거나, 거기서 직접 요청하십시오. 해당 세션이 이 머신에 있으면, Claude는 다음 유휴 상태가 되거나 종료될 때 한 번의 알림을 요청할 수도 있습니다.
• 머신 간 메시지: 다른 머신이나 웹의 세션 중 하나에 도달합니다.

• 다른 터미널에서 한 대화를 계속하거나 새 세션과 컨텍스트를 공유하려면 세션을 재개하십시오.
• Claude가 생성하고 감독하는 조정된 세션 팀의 경우 에이전트 팀을 사용하십시오.
• 한 곳에서 많은 세션을 보고 조종하려면 에이전트 보기를 사용하십시오.
• 세션이 서로 메시지를 보내는 대신 휴대폰이나 다른 장치에서 세션을 직접 조종하려면 원격 제어를 사용하십시오.
• CI 결과나 채팅 메시지와 같은 외부 이벤트를 세션으로 푸시하려면 채널을 사용하십시오.

​

다른 세션에 메시지 보내기

다른 터미널에서 실행 중인 세션에 마이그레이션이 완료되었는지 물어보십시오.

결제 API에서 작업 중인 세션에 방금 수행한 작업을 설명하십시오.

@api-worker에 스키마 마이그레이션이 완료되었음을 알려주십시오.

• 이 머신을 넘어선 세션: 클라우드 또는 원격 제어 세션은 Claude가 이 머신을 넘어선 세션을 나열하거나 메시지를 보낸 후에만 자동 완성에 나타나므로, Claude에게 먼저 나열하도록 요청하십시오.
• 공백이나 문자, 숫자, 하이픈, 밑줄 이외의 문자가 있는 이름: 큰따옴표로 입력하십시오. 예: @"release notes". 자동 완성에서 세션을 선택하면, Claude Code가 따옴표를 삽입합니다.

​

메시지 전달

• 메시지가 크기 제한을 초과합니다. Claude Code는 발신 세션에서 거부하며, 메시지가 떠나기 전입니다.
• 이 머신의 세션으로의 빠른 버스트가 해당 세션의 받은편지함이 수용하는 것에 도달했습니다. Claude Code는 해당 세션으로의 추가 메시지를 거부합니다.
• 이 머신의 회신 대상이 심볼릭 링크된 대상이나 예상 프로세스가 아닌 엔드포인트와 같은 안전 검사에 실패합니다. 교차 세션 메시지 전송 거부는 이러한 검사를 나열합니다.
• Claude가 메시지를 이 세션의 자신의 이름으로 주소 지정합니다. Claude가 도달할 수 있는 세션 확인에서 설명합니다.

• 전달됨: Claude Code는 메시지를 수신 Claude에게 전달합니다.
• 보류됨: Claude Code는 메시지를 전달하지 않고 따로 설정합니다. 나중에 accept가 적용되거나 모드 또는 설정 변경이 허용하면, Claude Code는 보류된 메시지를 해제합니다.
• 거부됨: Claude Code는 메시지를 전달하지 않고 삭제합니다.

​

다른 세션이 유휴 상태가 될 때 알림 받기

​

알림 요청

마이그레이션 세션이 작업 중인 것을 완료할 때 알려주십시오.

​

각 세션이 표시하는 것

​

제한

• 양쪽에서 refuse: 아무것도 도착하지 않습니다. 보고 있는 세션은 요청을 기록하거나 답변하지 않고 삭제하므로, 구독은 12시간 후 답변 없이 만료되며, refuse가 있는 요청하는 세션은 절대 구독하지 않습니다.
• 양쪽에서 hold: 알림이 더 적게 도착합니다. 보고 있는 세션은 한 줄 상태를 생략하며, 요청하는 세션은 Claude에게 전달하지 않고 대화 기록에 알림을 표시합니다.

​

Claude가 도달할 수 있는 세션 확인

• 서브에이전트: 현재 세션 내에서 실행 중인 에이전트.
• 팀원: 이 세션의 자신의 에이전트 팀 팀원. v2.1.239 이전에는 팀원이 나열에 나타나지 않았지만, Claude는 이미 이름으로 메시지를 보낼 수 있었습니다.
• 다른 로컬 세션: 동일한 머신에서 실행 중인 Claude Code 세션(배경 세션 포함). 세션은 받은편지함 소켓을 바인딩할 때만 나타납니다.
• 클라우드 세션: 원격 제어에 연결되어 있는 동안 표시되는 Claude Code on the web 세션. Claude Code는 나열에서 cloud로 레이블을 지정합니다.
• 다른 머신의 원격 제어 세션: 원격 제어에 연결되어 있는 동안 표시되며, Remote Control로 레이블이 지정됩니다. Claude Code는 원격 제어 연결이 끊어진 세션의 상태를 offline으로 표시합니다.

• 작업 디렉토리: 각 로컬 세션의 작업 디렉토리를 생략합니다.
• 세션 이름: 사람에게 귀속될 수 없는 세션 이름을 생략하므로, 이름이 없는 행은 (unnamed session)으로 읽습니다.
• 첫 번째 줄: 이 터미널에서 해당 이름을 입력하지 않은 한 이 세션의 자신의 이름이 있는 줄을 생략합니다. --name 또는 /rename과 이름을 사용하여, 세션을 시작하거나 마지막으로 재개한 이후입니다.

• 한 세션이 이름에 응함: Claude Code는 이름만으로 메시지를 전달합니다.
• 여러 세션이 이름을 공유하거나 Claude Code가 세션이 실행되는 모든 곳을 확인할 수 없음: Claude는 나열의 각 행에 짧은 식별자를 추가하고 주소에서 식별자를 사용합니다.

​

다른 머신의 세션에 메시지 보내기

​

세션이 들어오는 메시지를 처리하는 방식

• 아무것도 승인할 수 없음: 다른 세션의 메시지는 사용자의 동의로 절대 계산되지 않으므로, 사용자를 대신하여 보류 중인 권한 프롬프트에 답변할 수 없습니다.
• 구성을 변경할 수 없음: Claude Code는 수신 Claude에게 다른 세션이 요청했기 때문에 권한 설정, CLAUDE.md 또는 기타 구성을 변경하지 않도록 지시합니다.
• 명령이 실행되지 않음: /compact와 같은 메시지 텍스트의 명령은 일반 텍스트로 도착합니다. Claude Code는 절대 실행하지 않습니다.
• 권한 프롬프트는 여전히 발생함: 메시지에 따라 행동하려면 수신 세션이 갖지 않은 권한이 필요하면, 다른 작업에 대해 표시되는 동일한 프롬프트가 표시됩니다.

​

메시지가 어떻게 보이는지

• Ctrl+O를 눌러 대화 기록 뷰어를 열고 발신자의 세션 이름 아래에서 전체 텍스트를 읽습니다.
• --verbose로 시작한 세션에서, Claude Code는 미리보기 대신 전체 텍스트를 표시합니다.

스키마 마이그레이션 완료됨
새 열은 tenant_id이며, main에 리베이싱하는 것이 안전합니다.

​

들어오는 메시지 제어

• 수신 세션이 권한을 프롬프트함: Claude Code는 각 메시지를 전달합니다. 발신 세션이 권한 프롬프트를 우회하는 것으로 식별될 때만 하나를 승인을 위해 보류합니다.
• 수신 세션이 권한 프롬프트를 우회함: Claude Code는 각 메시지를 승인을 위해 보류합니다. 발신 세션이 또한 우회하는 것으로 식별될 때만 하나를 전달합니다.

• 승인은 해당 메시지를 Claude에게 전달합니다.
• 거부 또는 대화를 닫으면 삭제합니다.
• 대화가 dialogExpiry 기한을 지나 답변되지 않으면, Claude Code는 이를 닫고 메시지를 삭제합니다. 기한은 기본적으로 5분입니다.
• 터미널이 배경 세션에 첨부되지 않은 동안, Claude Code는 대화를 기한을 지나 열어 둡니다. 첨부한 후, 대화가 전체 기한 기간 동안 답변되지 않으면, Claude Code는 이를 닫고 메시지를 삭제합니다.
• 메시지가 보류되는 동안 이 세션의 권한 모드 클래스가 변경되면, Claude Code는 인바운드 규칙을 다시 적용하고, 이제 수용하는 메시지를 전달하며, 알림을 표시합니다.
• 메시지가 보류되는 동안 설정 변경이 refuse를 적용하면, Claude Code는 모든 보류된 메시지를 삭제하고 도달할 수 있는 각 발신자에게 거부를 보고합니다.

​

비대화형 세션

• 기한 전: 모드 또는 설정 변경이 메시지를 허용하면, Claude Code는 이를 전달합니다.
• 기한 후: Claude Code는 메시지를 삭제하고 도달할 수 있는 발신자에게 만료로 보고합니다.

​

세션의 받은편지함 소켓

• /status는 Peer address 행에 표시합니다. 경로는 uds:로 접두사가 붙습니다.
• Claude Code는 훅 및 Bash 명령에 CLAUDE_CODE_MESSAGING_SOCKET 환경 변수로 내보냅니다:
  • 메시징이 켜진 상태로 시작하는 세션에서, Claude Code는 SessionStart를 포함한 모든 훅이 실행되기 전에 변수를 내보냅니다.
  • 각 세션은 자신의 소켓을 내보내며, 부모 세션에서 상속된 것은 절대 아닙니다.

• macOS 및 Linux(WSL 2 포함): 줄은 선택 사항입니다. Claude Code는 이를 포함하거나 포함하지 않고 연결을 수용합니다.
• 기본 Windows: 줄은 필수입니다. Claude Code는 첫 줄이 유효한 인증 줄이 아닌 모든 연결을 닫고 해당 연결에서 아무것도 전달하지 않습니다.

• 자신의 자식 메시지: crossSessionInbound 값이 적용되지 않을 때, Claude Code는 훅이나 Bash 명령과 같은 세션의 자신의 자식 프로세스에서 온 것으로 확인된 메시지를 전달합니다.
  • Linux(WSL 2 내부 포함)에서, Claude Code는 게시하는 프로세스가 이미 종료된 경우에도 프로세스 증거로 확인할 수 있습니다. macOS에서는 게시하는 프로세스가 여전히 실행 중일 때만 확인할 수 있으며, Claude Code가 프로세스 ID 1로 실행되는 컨테이너에서는 프로세스 증거가 없습니다. 기본 Windows에서도 없습니다.
  • 게시하는 프로세스가 종료된 후 macOS에서 그리고 Claude Code가 프로세스 ID 1로 실행되는 컨테이너에서, 프로세스 증거가 누락되며, Claude Code는 대신 연결을 연 인증 줄에서 세션의 내보낸 CLAUDE_CODE_MESSAGING_TOKEN을 보낸 자식을 확인합니다. 기본 Windows에서는 해당 토큰이 Claude Code가 자신의 자식 메시지를 확인하는 유일한 방법입니다.
  • Claude Code가 어느 쪽도 확인할 수 없을 때, 권한 클래스를 주장하지 않는 다른 메시지처럼 처리하므로, 권한 프롬프트를 우회하는 세션은 승인을 위해 이를 보류합니다.
• 샌드박스된 세션: Bash 명령이 샌드박스 내부의 소켓에 도달할 수 있는지 제어하며, 샌드박스의 Unix 소켓 설정 sandbox.network.allowAllUnixSockets 및 sandbox.network.allowUnixSockets를 사용합니다.

​

교차 세션 메시징 제한

​

교차 머신 메시지에 대한 승인 요구

{
  "isolatePeerMachines": true
}

​

교차 세션 메시징 끄기

• 수신 중지: crossSessionInbound를 refuse로 설정하면, Claude Code는 인바운드 피어 메시지를 전달하지 않고 삭제합니다. 프로젝트 또는 로컬 설정에서, refuse는 다른 모든 소스를 통해 적용되며, 사용자 설정에서는 관리 설정이나 --settings 플래그가 값을 설정하지 않는 한 적용됩니다.
• 전송 및 나열 중지: SendMessage 및 ListAgents를 이름 지정하는 권한 거부 규칙을 추가하십시오. 둘 다 지정자 없이 도구 이름을 사용합니다.

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

​

가용성

• 운영 체제: macOS, Windows 및 Linux(WSL 2 내부의 Linux 포함)에서 사용 가능합니다.
• 이 머신의 세션: Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 및 Microsoft Foundry를 포함한 모든 공급자에서 사용 가능하며, 기능 플래그 가져오기가 꺼진 세션에서 사용 가능합니다. 이러한 공급자에서 그리고 플래그 가져오기가 꺼진 상태에서, 동일한 머신 메시징은 Claude Code v2.1.248 이상이 필요합니다. Claude Code는 이러한 메시지를 머신의 세션별 소켓을 통해 전달하며, Anthropic 서버를 통하지 않습니다. 세션이 이를 받는 것을 중지하려면, crossSessionInbound를 refuse로 설정하십시오.
• 이 머신을 넘어선 세션: Claude는 Claude Code on the web 세션과 원격 제어에 연결된 세션에서 다른 머신의 세션을 찾으며, 이는 이 세션의 활성 인증으로 claude.ai 로그인이 필요하며 다른 원격 제어 요구사항이 필요합니다. Claude는 API 키 또는 Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 및 Microsoft Foundry에서 이러한 세션을 찾을 수 없습니다.

• /list-agents가 인식되지 않음: 세션에 교차 세션 메시징이 없습니다. 위의 요구사항을 통해 작업하십시오. claude --version으로 버전 요구사항을 시작하십시오.
• /list-agents는 작동하지만 전송이 도착하지 않음: 메시징이 켜져 있으며, 더 좁은 것이 적용됩니다:
  • 거부 규칙: 권한 거부 규칙은 SendMessage 및 ListAgents 도구를 제거합니다.
  • 인바운드 제어: 수신 세션의 인바운드 제어는 보내는 것을 보류하거나 삭제할 수 있습니다.
  • 클라우드 세션 누락: 클라우드 세션은 이 세션이 원격 제어에 연결되어 있는 동안만 나타납니다.
  • 다른 머신 세션 누락: 다른 머신의 세션은 원격 제어로 실행되고 이 세션도 연결되어 있을 때만 나타납니다.
  • 다른 머신 세션 offline: offline으로 나열된 세션으로의 메시지는 진행되지만, 해당 세션의 머신이 다시 연결된 후에만 도착합니다.
  • 오래된 클라우드 또는 다른 머신 세션 누락: Claude Code는 이러한 세션 목록을 최신 순서로 읽고 제한된 페이지 수 후에 중지하므로, Claude는 이름으로 지난 세션에 메시지를 보낼 수 없습니다.
  • 대화 시작: 다른 머신의 세션에 메시지 보내기는 이 머신을 넘어선 세션과 대화를 시작하는 것을 다룹니다.

​

제한

• 일반 텍스트만: Claude는 세션 간에 일반 텍스트만 보냅니다. 구조화된 에이전트 팀 프로토콜 메시지는 팀 내에 유지됩니다.
• 동일한 머신 메시지 크기는 제한됨: Claude Code는 직렬화된 형식이 약 백만 문자를 통과하면 이 머신의 세션으로의 메시지를 거부합니다. 거부는 정확한 크기를 이름 지음합니다. 아무것도 수신 세션에 도달하지 않습니다.
• 한 세션으로의 빠른 버스트는 발신자에서 거부됨: 한 세션으로의 빠른 메시지 버스트가 해당 세션의 받은편지함이 수용하는 것에 도달하면, Claude Code는 발신 세션에서 추가 전송을 거부합니다. 거부는 버스트를 이름 지음하고 Claude에게 나머지를 하나의 메시지로 일괄 처리하거나 기다리도록 알려줍니다. v2.1.236 이전에는 Claude Code가 이러한 전송을 보낸 것으로 보고했으며 수신 세션이 이를 삭제했습니다.
• 메시지 루프는 제한됨: 수신 세션에서, Claude Code는 발신자별로 반복된 메시지의 속도를 제한하고, 짧은 창 내에 도착하는 동일한 반복을 삭제하며, Claude가 읽을 수 있도록 최대 50개의 수용된 메시지를 큐에 넣습니다. 따라서 두 세션 간의 메시지 루프는 자체적으로 중지됩니다. 속도 제한, 반복 검사 또는 큐 제한이 이 머신의 대화형 세션에서 메시지를 삭제할 때, Claude Code는 어떤 것이 삭제했는지 알려주고 Claude에게 즉시 다시 보내지 않도록 알려줍니다.

​

관련 리소스

• 서브에이전트 및 에이전트 팀: 단일 세션이나 팀 내의 메시징
• 배경 에이전트: 메시지를 보낼 수 있는 병렬 세션 디스패치 및 모니터링
• 원격 제어: 이 세션을 연결하여 다른 머신의 세션에 도달
• 설정: crossSessionInbound, isolatePeerMachines 및 dialogExpiry
• 권한 모드: 인바운드 기본값의 두 클래스 뒤의 모드
• 도구 참조: 도구 테이블의 ListAgents 및 SendMessage 행
• 에이전트를 병렬로 실행: Claude Code가 여러 에이전트를 실행하는 방식 비교