Claude Code의 세션 간 메시지는 따로 실행 중인 작업에 발견 사항이나 진행 상황을 텍스트로 전달하는 기능입니다. 메시지는 대화 전체나 파일, 발신 세션의 권한을 자동으로 넘기지 않습니다. 여러 작업을 연결할 수 있지만, 수신 세션의 권한과 실제 변경을 확인해야 하는 책임은 그대로 남습니다.
어떤 상황에서 도움이 될까?
Claude Code 공식 문서는 한 세션에서 발견한 변경 사항을 다른 세션에 알리거나, 별도의 작업 트리에서 진행 중인 작업에 결과를 전달하는 사례를 소개합니다. 예를 들어 데이터 구조를 변경한 세션이 그 변경의 영향을 받는 화면 개발 세션에 요약을 전할 수 있습니다.
메시지는 발신자가 작성한 평문입니다. 상대 세션에 대화 기록이나 파일이 자동 첨부되지 않습니다. 파일 경로가 메시지에 적혀 있더라도 수신 측이 자신의 도구와 권한으로 파일을 열 수 있는지는 별개입니다. 전체 대화 맥락이 필요하다면 같은 세션을 재개하는 방식을 고려해야 합니다.
| 연결 방식 | 주로 전달하는 것 | 확인할 점 |
|---|---|---|
| 세션 간 메시지 | 현재 필요한 발견·상태·질문을 담은 텍스트 | 수신 여부와 내용의 정확성 |
| 세션 재개 | 기존 세션의 대화 맥락 | 재개 환경과 접근 가능한 자료 |
| 작업 트리 | 별도 경로의 코드 변경 | 충돌·통합·최종 테스트 |
작업 트리를 나눈다고 충돌이 영원히 사라지는 것은 아닙니다. 같은 파일이나 의존성을 서로 바꿨다면 통합할 때 충돌을 해결하고 실제 동작을 다시 확인해야 합니다. Git worktree와 AI 병렬 작업에서 이 부분을 더 자세히 다룹니다.
메시지는 어떻게 도착하나요?
공식 문서에 따르면 Claude는 ListAgents로 도달 가능한 세션을 찾고 SendMessage로 메시지를 보냅니다. 사용자는 도구를 직접 호출하기보다 어떤 세션에 무엇을 알려 달라고 요청할 수 있습니다. /list-agents 명령으로 사용 가능한 세션을 확인하는 방법도 안내됩니다.
상대 세션이 작업 중이면 도구 호출 사이에 메시지를 읽고, 유휴 상태라면 새 턴이 시작될 수 있습니다. 실행 중인 도구가 메시지 때문에 강제로 중단되는 것은 아닙니다. 수신 설정에 따라 메시지는 전달되거나, 승인 대기 상태로 보류되거나, 거부될 수 있습니다. 따라서 보냈다는 사실과 상대가 내용을 반영해 작업을 끝냈다는 사실은 구분해야 합니다.
예를 들어 다음 요청은 설명을 위한 가상 예시입니다.
다른 세션에 방금 바뀐 데이터 필드와 영향을 받는 파일을 알려 주세요.
상대가 실제로 확인한 결과와 아직 남은 작업도 요약해 주세요.
상대가 전달한 내용 역시 검토 대상입니다. 완료 메시지만 믿지 말고 필요한 테스트나 변경 이력을 확인하세요.
로컬과 원격 메시지는 어디를 거칠까?
공식 문서는 같은 기기에서 실행되는 세션 간 메시지는 로컬 통신을 사용하며 Anthropic 서버를 거치지 않는다고 설명합니다. 다른 기기나 클라우드 세션으로 전달되는 경우에는 Anthropic 서버를 거칩니다. 다른 기기와 연결하려면 로그인과 Remote Control 등 별도의 조건이 적용됩니다.
현재 문서는 macOS·Linux·WSL 2에서 Claude Code 2.1.224 이상, Windows 네이티브 환경에서 2.1.234 이상을 안내합니다. 제공자와 설정에 따라 추가 버전 조건이 있으며, 기능은 바뀔 수 있으므로 실제 사용 전 공식 문서를 확인하세요. 이 글은 독자 환경에서 메시지 전달을 직접 시험한 결과가 아닙니다.
다른 세션의 말이 곧 사용자 승인은 아닙니다
공식 문서에 따르면 수신 세션에는 메시지가 다른 세션에서 왔다는 사실이 전달됩니다. 다른 세션의 메시지는 대기 중인 사용자 승인에 대신 답할 수 없고, 그 세션의 요청만으로 권한 설정이나 지침 파일을 바꾸지 않도록 안내됩니다. 메시지 속 명령도 자동 실행되는 것이 아니라 텍스트로 도착합니다.
하지만 메시지를 받은 AI가 내용을 바탕으로 작업을 계속할 수는 있습니다. 수신 세션의 실제 권한 설정, 샌드박스와 승인 방식이 중요하며, 메시지 출처가 내부 세션이라는 이유만으로 내용이 정확하거나 안전하다고 가정해서는 안 됩니다. 코딩 에이전트의 권한과 샌드박스를 함께 확인하세요.
협업할 때 먼저 정할 기준
다음은 병렬 작업을 안전하고 이해하기 쉽게 운영하기 위한 편집 제안입니다.
- 작업 범위: 각 세션의 목표와 담당 파일, 공유하는 의존성을 정합니다.
- 전달 내용: 확인한 사실, 바뀐 파일, 실행한 검사와 남은 위험을 구분합니다.
- 전달 경로: 같은 기기인지 원격인지 확인하고 민감한 내용은 필요한 범위만 보냅니다.
- 권한: 상대의 메시지를 사용자 승인이나 권한 변경 지시로 취급하지 않습니다.
- 종료 확인: 메시지 전달, 코드 통합, 테스트 통과와 사용자 확인을 각각 확인합니다.
여러 세션이 정보를 빠르게 주고받아도 중복 수정이나 잘못된 요약이 생길 수 있습니다. 협업의 속도보다 누가 무엇을 확인했는지 남기는 것이 최종 검토에 도움이 됩니다.
자주 묻는 질문
세션 메시지에 대화 기록이나 파일이 함께 전송되나요?
공식 문서상 메시지는 평문이며 발신자의 전체 대화나 파일을 자동으로 포함하지 않습니다. 수신 세션이 접근할 수 있는 파일은 별도로 정해집니다.
메시지가 오면 실행 중인 명령이 즉시 중단되나요?
아닙니다. 문서는 작업 중인 수신 세션이 도구 호출 사이에 메시지를 읽는다고 설명합니다.
다른 세션이 내 대신 권한 요청을 승인할 수 있나요?
공식 문서상 다른 세션의 메시지는 사용자의 동의로 취급되지 않습니다. 실제로 가능한 행동은 수신 세션의 권한과 설정을 따라야 합니다.
자료 확인일: 2026년 11월 7일.
다음 한 걸음
내 환경에서 막힌 부분은 실행 단계와 함께 질문해 주세요. 바꿔 만든 결과도 함께 나눌 수 있습니다.