클로드 코드 세션 간 통신 배포 가이드

2026년 8월 11일 기준 공식 릴리스 기록에는 클로드 코드 v2.1.224의 세션 간 SendMessage와 ListAgents, v2.1.225의 원격 세션 대화 보완, v2.1.227의 최신 안정 버전이 기록되어 있습니다. 공식 릴리스 기록을 기준으로 버전을 맞춘 뒤, 먼저 맥 또는 리눅스 한 대에서 검증하십시오. 클로드 코드 세션 간 통신은 상태와 결정 사항을 전달하는 메시지 통로이지, 공유 기억이나 파일 동기화 또는 권한 승인 통로가 아닙니다.

증상: 여러 터미널의 작업 진행 상황을 계속 복사하고, 서로 다른 세션이 같은 파일을 수정합니다.
가장 빠른 해결: 같은 컴퓨터에서 이름이 분명한 세션 두 개와 독립된 Git worktree를 만들고, 읽기 전용 메시지 테스트부터 진행합니다.

이 글은 여러 클로드 코드 터미널을 동시에 사용하는 개인 개발자에게 적합합니다. 프런트엔드, 백엔드, 테스트 에이전트를 병렬로 운영하는 팀과 원격 맥에 장시간 코딩 세션을 맡기려는 플랫폼 엔지니어도 대상입니다.

마지막 업데이트: 2026년 8월 12일. 버전과 기능 범위는 클로드 코드 공식 문서, 공식 에이전트 팀 문서, 공식 릴리스 목록을 대조했습니다.

시작 전 기능 경계

먼저 통신으로 보낼 내용을 제한해야 합니다. 다음 네 가지는 적합합니다.

• 현재 작업 단계와 남은 차단 요소
• API 필드 변경이나 인터페이스 결정
• 커밋 완료 여부와 테스트 결과
• 다음 세션이 확인해야 할 파일 경로와 실행 명령

반대로 전체 대화 기록, 대용량 로그, 파일 자체, 비밀 키를 메시지에 넣으면 안 됩니다. 각 세션은 독립적인 문맥 창을 사용하므로 한 세션의 대화가 다른 세션에 자동으로 이어지지 않습니다. 파일은 Git 커밋과 작업 트리를 통해 전달하고, 긴 설명은 프로젝트의 CLAUDE.md 또는 이슈에 남기는 편이 안전합니다. 병렬 실행 방식 비교 문서도 하위 에이전트, 에이전트 팀, 작업 트리의 차이를 이 기준으로 설명합니다.

지원 범위도 먼저 확인하십시오.

• 같은 컴퓨터의 첫 검증은 macOS 또는 Linux에서 진행합니다.
• 원시 Windows 환경은 이 세션 간 통신 기능의 지원 대상으로 가정하지 않습니다.
• Anthropic이 직접 제공하지 않는 모델 경로는 기능별 제한이 있을 수 있으므로, 연결된 제공 채널에서 SendMessage를 사용할 수 있다고 미리 단정하지 않습니다.
• 같은 컴퓨터와 다른 컴퓨터는 메시지가 지나가는 경로와 발견 조건이 다릅니다.
• 에이전트 팀은 별도 기능이며 기본값이 꺼져 있고, 공식 문서상 실험 기능입니다. 이를 켠다고 일반 독립 세션이 자동으로 같은 팀이 되는 것은 아닙니다.

클로드 코드의 두 터미널은 어떻게 메시지를 주고받습니까?
각 터미널에서 세션을 별도로 시작한 뒤, 수신 세션이 목록에 보이는지 확인하고 SendMessage로 상태를 보냅니다. 중요한 점은 메시지 수신이 명령 실행이나 파일 수정에 대한 승인을 의미하지 않는다는 사실입니다.

첫 번째 시간의 이중 세션 검증

검증은 기능을 바로 개발 업무에 투입하지 않고, 읽기 전용 작업으로 제한하는 방식이 좋습니다.

1. 공식 릴리스와 설치된 버전을 대조합니다. 터미널에서 claude --version을 실행하고, 최소 기능 버전과 현재 안정 버전을 기록합니다. 에이전트 팀 자체는 공식 문서 기준 v2.1.32 이상이지만, 이번 글의 세션 간 통신 기능은 해당 기능이 추가된 릴리스 이상인지 별도로 확인해야 합니다.
2. 같은 프로젝트에서 터미널 두 개를 엽니다.
3. 세션 이름을 frontend-check와 backend-check처럼 역할 중심으로 정합니다.
4. /list-agents를 실행해 상대 세션이 검색되는지 확인합니다.
5. 파일을 수정하지 않는 질문을 보냅니다. 예를 들어 “현재 테스트를 실행하지 않았다고 답해 달라”처럼 응답 내용이 명확한 요청을 사용합니다.
6. 발신 화면에 전달됨, 대기 중, 거부됨 중 어떤 상태가 표시되는지 기록합니다.
7. 수신 세션이 실제로 답장을 보냈는지, 연결이 끊겼을 때 재시도하지 않고 멈추는지 확인합니다.

첫 검증의 합격 기준은 메시지 하나가 도착했다는 사실만이 아닙니다. 세션 이름을 혼동하지 않고, 잘못된 대상에 보내지 않으며, 수신 세션의 파일 변경이나 명령 실행이 자동으로 시작되지 않아야 합니다.

주의: 실제 저장소를 열기 전에 비밀 값이 없는 임시 프로젝트로 테스트하십시오. 메시지 본문에 접근 토큰, 고객 데이터, 내부 주소를 넣지 않는 규칙을 먼저 정해야 합니다.

두 번째 단계의 작업 트리 격리

세션 두 개가 같은 폴더에서 파일을 수정하면 통신 기능이 있어도 충돌은 사라지지 않습니다. 가장 먼저 Git worktree를 역할별로 나누십시오.

권장 구조는 다음과 같습니다.

• 프런트엔드 세션: worktree/frontend
• 백엔드 세션: worktree/backend
• 테스트 세션: worktree/test

각 작업 트리에서 브랜치를 따로 만들고, 담당 파일 범위를 문서로 고정합니다. 프런트엔드가 응답 필드를 바꾸면 다음 형식으로 메시지를 보냅니다.

• 변경된 필드 이름
• 호환 여부
• 커밋 식별자
• 실행한 테스트
• 백엔드 또는 테스트 세션이 해야 할 다음 작업

파일 내용은 메시지로 복사하지 않습니다. 수신 세션은 커밋을 가져온 뒤 자신의 작업 트리에서 변경 사항을 확인해야 합니다. 이 구조는 충돌을 줄이지만 코드 리뷰를 대신하지 않습니다. 인터페이스 변경 뒤에는 반드시 다음 순서로 검증하십시오.

1. 발신 세션이 변경 사항을 커밋합니다.
2. 수신 세션이 커밋을 확인합니다.
3. 수신 세션이 회귀 테스트를 실행합니다.
4. 실패하면 실패 원인과 로그 위치만 메시지로 보냅니다.
5. 리뷰 세션이 실제 변경 내역을 검토합니다.

여러 클로드 코드 세션이 같은 파일을 수정하지 않게 하려면 어떻게 합니까?
파일 소유권을 세션별로 나누고, 독립 Git worktree를 사용하십시오. 같은 파일을 만져야 하는 순차 작업은 병렬 통신보다 단일 세션 또는 하위 에이전트가 더 적합합니다. 공식 병렬 실행 문서도 작업 트리는 별도 체크아웃을 제공하지만, 에이전트 팀이 자동으로 모든 팀원을 독립 작업 트리에 넣는 방식은 아니라고 설명합니다.

원격 확장의 연결 경로

같은 컴퓨터에서 검증이 끝난 뒤에만 원격 맥이나 다른 머신으로 넓히십시오. 여기서는 세 가지 경로를 구분해야 합니다.

• 동일 머신: 여러 세션이 같은 운영 체제와 사용자 환경에서 서로를 찾습니다.
• 본인 컴퓨터에서 원격 세션으로 연결: 로컬 터미널과 원격 실행 환경 사이에 원격 제어 연결이 추가됩니다.
• 서로 다른 머신의 양방향 통신: 양쪽 버전, 로그인 상태, 연결 지속성, 세션 이름 확인이 모두 필요합니다.

클로드 코드의 세션 간 메시지는 서버를 거칩니까?
경로는 배포 방식에 따라 다릅니다. 동일 머신의 세션 통신과 원격 제어를 통한 세션 통신을 같은 소켓 구조로 가정하면 안 됩니다. 공식 문서에 명시되지 않은 중계 경로를 추측하지 말고, 원격 환경에서는 제공되는 연결 방식과 조직 정책을 기준으로 검증하십시오. 민감한 저장소라면 메시지에 소스나 자격 증명을 넣지 않고, 연결 로그와 접근 기록을 별도로 남겨야 합니다.

원격 테스트는 비민감한 문자열 하나로 시작합니다.

1. 원격 세션의 이름을 짧고 고유하게 지정합니다.
2. 로컬에서 대상 이름과 회신 주소를 확인합니다.
3. “연결 확인” 같은 테스트 문장만 보냅니다.
4. 원격 세션에서 회신을 보냅니다.
5. 네트워크를 잠시 끊고 메시지가 대기, 실패, 재전송 중 무엇으로 처리되는지 확인합니다.
6. 컨테이너 안과 밖에서 각각 세션을 시작해 발견 여부를 비교합니다.

컨테이너는 프로세스와 파일 시스템이 분리될 수 있습니다. 호스트에서 보이는 세션이 컨테이너 안에서 보이지 않거나, 반대 상황이 생길 수 있으므로 이 문제를 기능 고장으로 결론 내리기 전에 배포 토폴로지를 확인해야 합니다.

SendMessage가 도착하지 않을 때 무엇부터 확인합니까?

• 양쪽 버전이 기능이 추가된 릴리스 이상인지 확인합니다.
• /list-agents에서 대상 세션이 실제로 보이는지 확인합니다.
• 세션 이름의 철자와 대상 주소를 다시 확인합니다.
• 두 세션이 같은 프로젝트 또는 허용된 연결 범위에서 실행되는지 확인합니다.
• 컨테이너와 호스트 사이의 격리 여부를 확인합니다.
• 수신 세션이 대기 상태인지, 이미 종료됐는지 확인합니다.
• 민감한 프로젝트 정책이 메시지 수신을 거부하고 있지 않은지 확인합니다.
• 마지막으로 짧은 일반 문장으로 재시험합니다.

이 순서는 커뮤니티에서 자주 언급되는 원인을 공식 기능 조건과 분리해 확인하는 방법입니다. 특정 오류 비율이나 생산성 향상 수치는 개인 환경에 따른 사례일 뿐, 공식 성능 보장으로 해석하면 안 됩니다.

배포 전 권한과 입출력 정책

메시지를 받을 수 있다는 사실과 도구 권한은 별개입니다. 권한 설정 문서에 따르면 읽기, 셸 실행, 파일 수정은 서로 다른 승인 수준을 가질 수 있고, 거부 규칙은 허용 규칙보다 우선합니다.

세션 유형별로 정책을 나누면 운영이 단순해집니다.

• 대화형 세션: 메시지는 수신하되 파일 수정과 셸 실행은 ask로 둡니다.
• 승인 생략 세션: 원격 메시지를 기본 거부하거나, 허용된 발신자와 작업 범위만 받습니다.
• 무인 작업: 메시지를 받아도 허용된 명령 목록 밖의 작업은 중지하도록 설정합니다.

민감한 프로젝트에서는 ListAgents와 SendMessage 자체를 막는 선택도 고려할 수 있습니다. 반대로 모든 메시지를 허용한 채 --dangerously-skip-permissions를 사용하는 방식은 빠르지만, 세션 간 통신과 도구 실행의 경계를 약하게 만듭니다. 공식 에이전트 팀 문서도 팀원이 리드의 권한 설정에서 시작할 수 있다고 설명하므로, 팀을 만들기 전에 리드 세션의 권한을 먼저 점검해야 합니다.

• [ ] 메시지에 파일 내용과 비밀 값이 포함되지 않았습니다.
• [ ] 각 세션의 작업 트리와 담당 파일이 정해졌습니다.
• [ ] 원격 세션은 테스트 메시지로 발견과 회신을 확인했습니다.
• [ ] 셸 실행과 파일 수정은 메시지 수신만으로 승인되지 않습니다.
• [ ] 거부, 대기, 재연결 상태를 기록할 로그 위치가 정해졌습니다.
• [ ] 실패 시 단일 세션으로 되돌릴 절차가 있습니다.
• [ ] 팀 규모를 늘리기 전에 실제 조정 비용을 측정합니다.

첫 주 운영 기록

첫 주에는 메시지 개수보다 조정 비용을 기록해야 합니다. 다음 항목을 업무별로 남기십시오.

• 전달 성공과 실패
• 사람이 승인한 횟수
• 같은 내용을 반복해서 보낸 횟수
• 두 세션이 같은 파일을 건드린 횟수
• 메시지를 기다리며 멈춘 시간
• 커밋 후 회귀 테스트가 실패한 횟수

이 기록에서 반복 알림과 충돌이 늘면 통신을 확대하지 마십시오. 작업이 순차적이거나 같은 파일을 자주 수정하거나, 메시지 왕복 없이는 진행되지 않는다면 단일 세션이나 하위 에이전트가 더 적합합니다. 에이전트 팀은 직접 메시지와 공유 작업 목록을 제공하지만, 공식 문서상 실험 기능이고 세션 복구와 종료 동작에 제한이 있습니다.

장시간 운영이 확인된 뒤에만 원격 맥을 검토하십시오. 개인 개발 장비를 계속 점유하지 않고, 여러 시간대에 걸쳐 세션을 유지하며, 작업 트리와 접근 정책을 고정해야 할 때 원격 환경의 가치가 생깁니다. 반대로 짧은 일회성 수정, 물리 장치 접근이 필요한 테스트, 지속적인 대화형 확인이 필요한 작업은 로컬 맥이 더 낫습니다.

현재의 개인 맥이나 일반 클라우드 환경은 세션을 오래 유지하기 어렵고, 화면 연결이 끊기면 상태 확인이 번거롭습니다. 여러 개발자가 한 장비를 공유하면 권한과 작업 트리도 섞이기 쉽습니다. 이런 조건에서 지속 실행, 교대 작업, 독립된 macOS 환경이 필요하다면 원격 맥 운영 관련 안내와 클로드 코드 활용 글 모음을 먼저 확인한 뒤, 세션 수와 온라인 기간에 맞춰 kvmsync의 원격 맥 임대를 비교하는 편이 합리적입니다. 단순히 세션 수만 늘리는 것이 아니라, 독립 작업 트리와 승인 정책까지 함께 운영할 수 있을 때 임대 환경이 실제 이점을 만듭니다. 자세한 조건은 서비스 이용 옵션에서 확인할 수 있습니다.