Claude Code 2.1.224 새로운 세션 간 메시지 전달 기능 추가, 병렬 개발 워크플로우 지원

Anthropic이 Claude Code에 조정 계층을 추가했습니다. 이제 독립적인 코딩 세션이 서로 직접 메시지를 보낼 수 있습니다. 이 기능은 Claude Code v2.1.2에서 출시되었습니다.

发布于 2026年8月11日generalGEO 评分: 018 次阅读
Claude Code 2.1.224 새로운 세션 간 메시지 전달 기능 추가, 병렬 개발 워크플로우 지원

Claude Code 2.1.224에 새로 추가된 세션 간 메시징, 병렬 개발 워크플로우 지원

서론

Anthropic이 Claude Code에 새로운 조정 계층을 추가했습니다. 이제 독립적인 코딩 세션이 서로 직접 메시지를 주고받을 수 있습니다.

이 기능은 Claude Code v2.1.224와 함께 2026년 8월 7일에 출시되었습니다. Anthropic은 이를 세션 간 메시징(Cross-Session Messaging) 이라고 부릅니다.

개발자는 더 이상 여러 터미널 창 사이에서 발견한 결과를 수동으로 복사할 필요 없이, 하나의 Claude Code 세션이 다른 세션에게 의존성이 변경되었고, 마이그레이션이 완료되었고, 버그가 수정되었으며, 특정 결정이 내려졌다는 사실을 알릴 수 있습니다.

원본 AIBase 기사는 이 기능을 동시에 여러 작업을 처리하는 개발자에게 큰 개선점으로 보았습니다. 이러한 설명 방향은 맞지만, Anthropic의 공식 문서에는 몇 가지 중요한 세부 사항이 추가로 포함되어 있습니다.

세션 간 메시징:

  • Claude Code v2.1.224 이상이 필요합니다
  • macOS 및 Linux(WSL 2의 Linux 포함)에서 실행 가능
  • 네이티브 Windows에서는 지원되지 않음
  • 전체 대화 기록이나 파일이 아닌 텍스트 메시지 교환
  • ListAgents를 사용하여 접근 가능한 세션 검색
  • SendMessage를 사용하여 메시지 전달
  • 동일한 머신의 여러 세션 간에 적용 가능
  • 다른 머신에서 지원되는 세션 또는 웹용 Claude Code에도 연결 가능
  • 메시지를 수락, 보류 또는 거부할 수 있는 인바운드 제어 기능 포함

8월 10일 기준으로 공식 변경 로그는 v2.1.224를 넘어섰습니다. 버전 2.1.225는 머신 간 시작 기능을 개선했으며, 이 글을 준비할 당시 v2.1.227이 Anthropic 변경 로그의 최신 버전으로 등재되어 있습니다.

핵심은 v2.1.224에서 이 기능이 도입되었고, 이후 버전에서 동작 방식이 최적화되었다는 점입니다.

Claude Code 세션이 이제 서로 통신할 수 있습니다

세션 간 메시징이 등장하기 전에는 여러 Claude Code 세션을 실행하는 개발자는 종종 세션 사이에서 통신 계층 역할을 해야 했습니다.

다음 세 개의 터미널을 상상해 보세요:

세션 A: 인증 리팩토링
세션 B: 결제 API 업데이트
세션 C: 마이그레이션 및 통합 테스트 실행

세션 A가 세션 B가 의존하는 공유 인터페이스를 변경했다면, 개발자는 이 변경 사항을 인지하고 수동으로 설명해야 했습니다.

세션 C가 오래 걸리는 마이그레이션을 완료했다면, 개발자는 터미널을 확인하고 그 결과를 기다리고 있는 세션에게 보고해야 했습니다.

세션 간 메시징을 통해 Claude가 이러한 정보를 직접 전달할 수 있습니다.

간소화된 워크플로우는 다음과 같습니다:

세션 A
  │
  │ "인증 인터페이스가 변경되었습니다. createSessionV2()를 사용하세요."
  ▼
세션 B

세션 C
  │
  │ "마이그레이션이 성공적으로 완료되었습니다."
  ▼
세션 A

Anthropic의 문서에는 두 가지 대표적인 예시가 있습니다.

어떤 변경이 다른 세션이 의존하는 것을 깨뜨렸을 때, 한 세션이 다른 세션에게 경고를 보낼 수 있습니다. 특정 문제를 해결한 세션은 그 문제로 차단된 다른 세션에게 답변을 보낼 수도 있습니다.

간단해 보이지만, 병렬 Claude Code 워크플로우의 조직 방식을 변화시킵니다.

메시지는 텍스트이지, 공유 컨텍스트가 아닙니다

세션 간 메시징이 하지 않는 일이 가장 중요한 기술적 세부 사항 중 하나입니다.

메시지는 단지 어떤 Claude 세션이 작성하여 다른 세션에 전달하는 텍스트 조각일 뿐입니다.

자동으로 전송되지 않는 것:

  • 전체 대화 기록

발신자의 전체 대화 기록

  • 파일
  • 도구 출력
  • 숨겨진 컨텍스트
  • 전체 저장소 상태
  • 권한 승인

개발자가 다른 터미널에서 동일한 컨텍스트로 동일한 대화를 계속 이어가기를 원한다면, Anthropic은 세션 간 메시징 대신 세션 복원을 권장합니다.

세션 간 메시징은 다음과 같은 짧은 조정 메시지에 더 적합합니다:

결제 통합은 이제 `user_id` 대신 `customer_id`를 기대합니다.
전체 테스트 스위트를 실행하기 전에 브랜치를 업데이트하세요.

또는:

데이터베이스 마이그레이션이 성공적으로 완료되었습니다.
214개의 통합 테스트가 모두 통과했습니다.
배포 검증을 계속 진행할 수 있습니다.

이러한 설계는 메시징을 가볍게 유지합니다.

동시에 어떤 세션이 다른 세션으로부터 방대한 양의 관련 없는 컨텍스트를 조용히 수신할 위험도 줄입니다.

Claude는 ListAgents와 SendMessage를 사용합니다

개발자는 일반적으로 메시징 도구를 직접 호출하지 않습니다.

Claude Code는 두 가지 내부 도구를 사용합니다:

  • ListAgents
  • SendMessage

ListAgents는 Claude가 현재 접근할 수 있는 지원되는 세션을 검색할 수 있게 합니다.

SendMessage는 텍스트 메시지를 해당 세션 중 하나에 전달합니다.

개발자는 자연어로 Claude에게 직접 요청할 수 있습니다.

예를 들어:

다른 터미널에서 실행 중인 세션에게 마이그레이션이 완료되었는지 물어봐 주세요.

Claude는 관련 세션을 찾아 실제 메시지를 작성합니다.

또 다른 예:

결제 API를 처리 중인 세션에게 방금 수행한 인증 변경 사항을 설명해 주세요.

개발자는 기계가 읽을 수 있는 메시지를 수동으로 작성하거나 세션 ID를 기본 API에 전달할 필요가 없습니다.

이러한 방식은 일반적인 Claude Code 사용 방식과 일관된 상호 작용을 유지합니다.

Anthropic이 강조하는 네 가지 주요 사용 사례

Anthropic의 문서는 세션 간 메시징이 특히 유용한 몇 가지 상황을 지적합니다.

1. 발견 결과 전달

한 세션이 다른 세션에 필요한 정보를 발견할 수 있습니다.

예시는 다음과 같습니다:

  • 파괴적인 API 변경
  • 데이터베이스 제약 조건
  • 의존성 버전 요구 사항
  • 새로운 구현 결정
  • 디버깅 중 발견한 근본 원인
  • 다른 모듈로 인한 테스트 실패

메시징이 없다면 개발자가 전달자 역할을 해야 합니다.

메시징이 있으면 세션이 발견 결과를 요약하여 직접 보낼 수 있습니다.

예시:

세션 A 발견:
"OAuth 콜백은 이제 PKCE 검증을 요구합니다."

세션 A가 세션 B에게 전송:
"인증 구현은 이제 PKCE를 요구합니다.
병합 전에 모바일 콜백 흐름을 업데이트하세요."

여러 세션이 동일한 프로젝트에서 서로 연관된 부분을 처리할 때 매우 유용합니다.

2. 병렬 Git Worktree 조정

Git worktree는 세션 간 메시징과 자연스러운 조합을 이룹니다.

개발자는 독립적인 작업을 위해 별도의 작업 디렉터리를 만들고 각 디렉터리에서 하나의 Claude Code 세션을 실행할 수 있습니다.

예를 들어:

저장소/
├── 메인 브랜치
├── worktree-auth
├── worktree-payments
└── worktree-tests

각 worktree는 독립적으로 진행될 수 있습니다.

한 세션이 다른 브랜치에 영향을 주는 내용을 변경하면, Claude가 관련 세션에 알릴 수 있습니다.

이는 병렬 개발의 일반적인 위험, 즉 여러 브랜치가 오래된 가정에 기반하여 앞으로 나아가는 상황을 줄여줍니다.

세션 간

메시징은 코드를 자동으로 병합하지 않습니다.

인간이 병합 단계에 들어가기 전에 에이전트가 서로 조정할 수 있도록 도와줍니다.

3. 오래 걸리는 작업에서 상태 얻기

일부 코딩 작업은 일반적인 상호 작용 한 턴보다 훨씬 오래 걸립니다.

예를 들어:

  • 대규모 마이그레이션
  • 전체 통합 테스트 스위트
  • 오래 걸리는 빌드
  • 정적 분석
  • 대규모 리팩토링
  • 저장소 수준 코드 생성
  • 의존성 업그레이드

개발자는 다른 세션에서 작업하는 동안 한 세션을 계속 실행해 둘 수 있습니다.

세션 간 메시징은 오래 실행되는 작업자가 결과를 보고할 수 있게 합니다.

예를 들어:

세션 A:
전체 마이그레이션 및 테스트 스위트를 실행하세요.
완료되면 결과를 아키텍처 세션에 보내세요.

개발자는 오래 걸리는 터미널을 반복해서 확인할 필요 없이 다른 곳에서 계속 작업할 수 있습니다.

4. 머신 간 통신

Anthropic은 동일한 컴퓨터의 세션을 넘어서도 메시징을 지원합니다.

지원되는 워크플로우에는 다음이 포함될 수 있습니다:

  • 특정 머신의 다른 Claude Code 세션
  • 웹상의 Claude Code
  • 원격 제어에 연결된 세션

중요한 버전 세부 사항이 있습니다.

Claude Code v2.1.

224는 세션 간 메시징을 도입했으며 크로스 머신 지원을 포함하지만, Anthropic의 현재 문서에 따르면 이름으로 다른 머신의 세션과 새 대화를 시작하려면 v2.1.225 이상이 필요합니다.

v2.1.225 이전에는 세션이 다른 머신에서 온 메시지에 응답할 수 있었지만, 크로스 머신 대화를 시작하는 기능은 더 제한적이었습니다.

따라서 가장 완전한 동작을 원하는 개발자에게는 2.1.224 이상 버전으로 업데이트하는 것이 권장됩니다.

같은 머신 내 메시지는 로컬로 전송됩니다

세션 간 메시징은 수신 세션이 실행되는 위치에 따라 다른 전달 경로를 사용합니다.

Anthropic은 다음 동작을 문서화했습니다:

대상 전달 경로
같은 머신의 다른 세션 세션별 로컬 소켓
다른 머신의 세션 Anthropic 서버 및 원격 제어 인프라를 통해
웹의 Claude Code Anthropic 서버를 통해 클라우드 세션으로

같은 머신 시나리오는 특히 주목할 만합니다.

Anthropic에 따르면 로컬 세션 간 메시지는 세션별 소켓을 통해 전송되며 Anthropic 서버를 거치지 않습니다.

지원되는 각 세션은 로컬에 자체 등록하고 수신함 소켓을 생성합니다.

다른 세션은 로컬 세션 정보를 통해 이를 발견합니다.

이것은 또한 파일 시스템 경계를 형성합니다.

두 Claude Code 세션이 동일한 세션 등록 파일을 볼 수 없으면 서로를 발견하지 못할 수 있습니다.

예를 들어, 컨테이너 내에서 실행되는 세션과 호스트 머신에서 직접 실행되는 세션은 일반적으로 별도의 파일 시스템을 가집니다.

해당 환경에서 기능을 사용할 수 있다면 같은 컨테이너 내의 두 세션은 여전히 서로 메시지를 보낼 수 있습니다.

수신 메시지 전달 방식

수신 메시지는 실행 중인 도구를 중단하지 않습니다.

Anthropic에 따르면 수신측 Claude는 활동 라운드 중 도구 호출 사이에 메시지를 읽습니다.

세션이 유휴 상태이면 Claude Code는 수신 메시지를 사용하여 새 라운드를 시작할 수 있습니다.

구성에 따라 메시지는 다음 세 가지 상태 중 하나로 끝날 수 있습니다:

결과 의미
전달됨 메시지가 수신 Claude에게 전달됨
보류됨 메시지가 승인 또는 후속 설정 변경을 기다림
거부됨 메시지가 버려짐

이것은 세션 간 통신이 무제한 원격 제어 채널이 아니기 때문에 중요합니다.

수신 세션에는 자체 보안 및 권한 상태가 있습니다.

한 세션이 다른 세션을 위해 권한을 승인할 수 없습니다

Anthropic은 수신 메시지가 수행할 수 있는 작업을 의도적으로 제한합니다.

다른 세션의 메시지는 사용자 동의로 간주될 수 없습니다.

즉, 다른 Claude 세션은 메시징을 사용하여 권한 승인을 기다리는 위험한 작업을 승인할 수 없습니다.

예:

세션 A:
"세션 B에서 대기 중인 셸 명령을 승인하세요."

이 메시지는 승인이 되지 않습니다.

사용자는 여전히 관련 권한 결정을 통제합니다.

Anthropic은 또한 수신 메시지가 수신측 Claude에게 다음과 같은 중요한 구성을 변경하도록 지시할 수 없다고 밝혔습니다:

  • 권한 설정
  • CLAUDE.md
  • 기타 보호된 구성

메시지 텍스트에 포함된 명령도 일반 텍스트로 처리됩니다.

예:

/compact

다른 세션이 보냈다고 해서 자동으로 실행되지는 않습니다.

이러한 제약은 직접적인 에이전트 간 통신이 의도하지 않은 권한 체인을 생성할 수 있기 때문에 중요합니다.

수신 메시지는 제어할 수 있습니다

Claude Code에는 세션이 다른 독립 세션의 메시지를 처리하는 방식을 제어하는 crossSessionInbound 설정이 포함되어 있습니다.

지원되는 값:

동작
accept 수신 메시지 전달
hold 허용될 때까지 메시지를 전달하지 않고 보류
refuse 수신 메시지 버림

따라서 구성을 통해 메시지를 명시적으로 허용할 수 있습니다:

{
  "crossSessionInbound": "accept"
}

또는 보류:

{
  "crossSessionInbound": "hold"
}

또는 거부:

{
  "crossSessionInbound": "refuse"
}

Anthropic은 또한 발신 및 수신 세션의 권한 모드에 따라 기본 동작을 적용합니다.

위험도가 높은 구성에서는 수신 메시지에 명시적 승인이 필요할 수 있습니다.

이것은 서로 다른 권한 구성을 가진 두 세션이 자동으로 안전하지 않은 승격 경로를 만들지 못하게 합니다.

보류된 메시지는 만료될 수 있습니다

수신 메시지가 승인 대기로 보류되면 Claude Code는 다음을 표시하는 승인 대화상자를 표시할 수 있습니다:

  • 발신자
  • 메시지 미리보기

사용자는 승인하거나 거부할 수 있습니다.

Anthropic의 문서에 따르면 기본 승인 마감 시간은 5분입니다.

메시지가 구성된 dialogExpiry 전에 승인되지 않으면 버려질 수 있습니다.

Claude Code는 또한 보류된 메시지 수를 제한하여 세션이 무한정 백로그를 축적하지 못하게 합니다.

버전 2.1.225는 여러 경우에서 보류된 세션 간 메시지가 헤드리스 세션에서 예상치 못한 알림 또는 만료 상태로 머무를 수 있는 문제를 수정했습니다.

이것은 v2.1.224가 기능을 도입했다고 해서 최종 구현으로 간주해서는 안 되는 또 다른 이유입니다.

가용성 요구 사항

세션 간 메시징에는 특정 플랫폼 및 제공업체 요구 사항이 있습니다.

Anthropic의 현재 문서에 따르면:

지원되는 운영 체제

  • macOS
  • Linux
  • WSL 2 내의 Linux

지원되지 않음

  • 네이티브 Windows

이 구분은 중요합니다.

Claude Code 자체는 Windows를 지원하지만 세션 간 메시지 기능은 현재 네이티브 Windows 시스템에서는 사용할 수 없습니다.

제공업체 제한

Anthropic에 따르면 Claude Code가 다음을 포함한 여러 외부 제공업체 경로를 통해 실행될 때 세션 간 메시지 기능을 사용할 수 없습니다:

  • Amazon Bedrock
  • AWS의 Claude Platform
  • Google Cloud의 Agent Platform
  • Microsoft Foundry

가용성은 기능 플래그 평가 및 환경 설정에 따라 달라질 수도 있습니다.

따라서 개발자는 실제로 사용하려는 환경에서 기능을 검증해야 합니다.

Claude Code 버전 확인 방법

Anthropic의 공식 변경 로그는 설치된 버전을 확인하기 위해 다음 명령을 사용할 것을 권장합니다:

claude --version

세션 간 메시지 기능 요구 사항:

Claude Code 2.1.224 이상

후속 버전에 수정 사항과 크로스 머신 개선 사항이 포함되어 있으므로, 조직에 통제된 배포 정책이 없는 한 특별히 v2.1.224에 고정하기보다는 현재 지원되는 버전을 사용하는 것이 일반적으로 권장됩니다.

Claude Code 업데이트 방법

네이티브 Claude Code 설치의 경우 Anthropic은 다음을 지원합니다:

claude update

네이티브 설치는 일반적으로 백그라운드에서 업데이트를 확인하고 설치합니다.

새 버전은 다음에 Claude Code를 시작할 때 적용됩니다.

Anthropic은 또한 다음을 문서화했습니다:

claude doctor

설치 및 업데이트 상태를 확인하는 데 사용됩니다.

패키지 관리자 설치는 별도의 업데이트 명령이 필요할 수 있습니다.

예를 들어, Homebrew 설치는 다음 명령으로 업데이트할 수 있습니다:

brew upgrade claude-code

또는 최신 채널을 추적할 때:

brew upgrade claude-code@latest

정확한 업데이트 방법은 Claude Code가 설치된 방식에 따라 다릅니다.

예시: 두 세션이 관련 기능 처리

개발자가 두 개의 관련 작업을 포함하는 애플리케이션을 구축하고 있다고 가정해 보겠습니다.

터미널 1

목표:
인증 서비스를 리팩터링하고 세션 생성을 업데이트합니다.

터미널 2

목표:
결제 API를 업데이트하여 새로 인증된 사용자 객체를 사용합니다.

터미널 1은 인터페이스가 다음과 같은 것을 발견합니다:

createSession(userId)

를 다음과 같이 변경합니다:

createSession({ userId, organizationId })

터미널 1은 개발자가 알아차릴 때까지 기다릴 필요 없이 다른 세션에 이 변경 사항을 설명하는 메시지를 보낼 수 있습니다.

수신 세션은 결제 구현을 완료하기 전에 자신의 작업을 업데이트할 수 있습니다.

많은 AI 코딩 세션이 독립적으로 실행될 때, 바로 이러한 소규모 조정 이벤트가 비용이 많이 들게 됩니다.

예시: 병렬 조사

세션 간 메시징 기능은 디버깅에도 유용합니다.

개발자는 세 개의 세션을 실행할 수 있습니다:

세션 A:
API 오류 조사.

세션 B:
데이터베이스 로그 확인.

세션 C:
최근 배포 및 구성 변경 사항 확인.

세션 B가 자격 증명이 순환된 직후 데이터베이스 연결이 실패하기 시작하는 것을 발견했다고 가정해 보겠습니다.

다른 세션에 이를 알릴 수 있습니다.

세션 A는 더 이상 무관한 요청 파싱 문제를 계속 조사할 필요가 없습니다.

세션 C는 배포가 새 키를 가져왔는지 여부에 집중할 수 있습니다.

이 시스템은 완전히 관리되는 멀티 에이전트 팀을 자동으로 생성하지 않습니다.

개발자는 여전히 독립 세션을 시작하고 안내합니다.

메시징은 단지 이러한 세션 간에 유용한 발견 사항을 전달하는 비용을 낮출 뿐입니다.

세션 간 메시징은 에이전트 팀과 동일하지 않습니다

Claude Code는 이제 여러 에이전트 또는 세션을 처리하는 여러 가지 방법을 제공합니다.

이들은 서로 다른 문제를 해결합니다.

기능 가장 적합한 시나리오
세션 간 메시징 개발자가 직접 시작하고 안내하는 독립 세션
복원 동일한 대화 및 해당 컨텍스트 계속
에이전트 팀 Claude가 생성하고 감독하는 조정된 에이전트
에이전트 뷰 한 위치에서 여러 세션 모니터링 및 안내
원격 제어 다른 기기에서 세션 직접 제어
채널 CI 또는 채팅 메시지와 같은 외부 이벤트를 세션으로 전송

이 구분은 "여러 Claude 인스턴스가 서로 대화하는 것"이 몇 가지 다른 아키텍처를 설명할 수 있기 때문에 중요합니다.

세션 간 메시징은 구체적으로 독립적인 Claude Code 세션 간의 경량 통신 계층을 의미합니다.

대규모 프로젝트에 대한 이 기능의 변화

AIBase 기사에 따르면, 이 업데이트는 대규모 프로젝트에서 인간의 조정 부담을 줄일 수 있습니다.

이것이 가장 중요한 실질적 의미입니다.

개발자는 프로젝트를 여러 독립 워크플로로 나눌 수 있습니다:

인증
결제
프론트엔드
데이터베이스 마이그레이션
테스트
문서

각 세션은 한 영역에 집중할 수 있습니다.

어떤 결정이나 변경 사항이 다른 영역에 영향을 미칠 때, 관련 정보는 세션 간에 직접 전달될 수 있습니다.

이로 인해 다음을 줄일 수 있습니다:

  • 터미널 간 복사 및 붙여넣기
  • 반복적인 설명
  • 지연된 종속성 경고
  • 중복 조사
  • 지속적인 상태 확인

그러나 통합 작업을 제거하지는 않습니다.

독립 세션은 여전히 다음을 수행할 수 있습니다:

  • 충돌하는 편집 생성
  • 메시지 오해
  • 오래된 저장소 상태 사용
  • 다른 기술적 결론 도출
  • 잘못된 발견 사항을 다른 세션에 전달

개발자는 여전히 테스트, 코드 검토, 버전 관리 및 적절한 권한 경계가 필요합니다.

세션 간 메시징 모범 사례

실제 사용에서 몇 가지 습관이 이 기능을 더 안정적으로 만들 수 있습니다.

메시지 초점 유지

유용한 메시지는 다음을 명시해야 합니다:

  • 무엇이 변경되었는지
  • 왜 중요한지
  • 어떤 구성 요소가 영향을 받는지
  • 다른 세션이 무엇을 검증해야 하는지

예시:

데이터베이스 마이그레이션이 `billing_customer_id`를 `customer_id`로 이름을 변경했습니다.
귀하의 브랜치에는 여전히 이전 필드를 참조하는 두 개의 쿼리가 있습니다.
통합 테스트를 수행하기 전에 이러한 쿼리를 업데이트하세요.

이것은 다음보다 훨씬 낫습니다:

데이터베이스 관련된 것을 변경했습니다. 확인해 보세요.

메시지를 공유 메모리로 취급하지 마세요

수신 세션은 보낸 사람의 전체 추론 과정을 상속하지 않습니다.

발견 사항이 파일, 커밋, 로그 또는 테스트 결과에 의존하는 경우 명시적으로 식별하세요.

병렬 코드 변경에 워크트리 사용

여러 세션이 동일한 저장소를 적극적으로 편집할 때, 격리된 Git 워크트리는 파일 충돌을 줄일 수 있습니다.

세션 간 메시징은 브랜치를 조정할 수 있고, Git은 여전히 코드 기록과 병합을 처리합니다.

고위험 작업은 인간 승인 유지

에이전트 간 메시징은 작업 조정에 유용합니다.

다음 메커니즘을 우회하는 수단이 되어서는 안 됩니다:

  • 배포 승인
  • 프로덕션 환경 접근 제어
  • 파괴적 명령
  • 보안 검토
  • 재무 작업

Anthropic의 권한 설계는 이미 메시지가 사용자 승인을 대체할 수 없도록 보장합니다. 팀은 더 넓은 워크플로우에서 이러한 격리를 유지해야 합니다.

최소 버전 이상으로 업데이트

v2.1.224에서 이 기능이 도입되었지만, 이후 버전에서 메시지 처리 동작이 수정되고 크로스 머신 통신이 개선되었습니다.

엔터프라이즈 배포에서 버전 고정이 필요하지 않는 한, 최신 지원 버전을 사용하는 것이 더 안전한 선택입니다.

자주 묻는 질문

Claude Code 세션 간 메시징이란 무엇인가요?

세션 간 메시징은 하나의 독립적인 Claude Code 세션이 다른 세션에 텍스트 메시지를 보낼 수 있게 합니다. 병렬 작업 세션 간 조정, 예를 들어 발견 사항 전달, 작업 상태 보고 또는 다른 세션에 곧 발생할 파괴적 변경 사항을 경고하는 데 사용됩니다.

어떤 Claude Code 버전에서 세션 간 메시징이 도입되었나요?

이 기능은 Claude Code v2.1.224에서 도입되었으며, 2026년 8월 7일에 출시되었습니다. Anthropic의 현재 문서는 v2.1.224 이상을 요구합니다.

세션 간 메시징은 전체 Claude 대화를 공유하나요?

아니요. 수신 세션은 메시지 텍스트, 보낸 사람 ID, 그리고 일반적으로 회신 주소만 받습니다—보낸 사람의 대화 기록이나 파일은 받지 않습니다. 전체 대화 컨텍스트를 이어가야 하는 경우 세션 복원 기능을 사용하세요.

Claude Code 세션은 서로 다른 컴퓨터에서 서로 메시지를 보낼 수 있나요?

네, 지원되는 세션은 Anthropic의 원격 제어 인프라를 통해 크로스 머신 통신이 가능합니다. Anthropic은 다른 머신의 세션과 이름으로 새 대화를 시작하려면 v2.1.225 이상이 필요하다고 밝혔습니다. v2.1.224의 크로스 머신 동작은 더 제한적입니다.

세션 간 메시징은 Windows를 지원하나요?

macOS와 Linux를 지원하며, WSL 2에서의 Linux를 포함합니다. Anthropic의 현재 문서에 따르면 이 기능은 기본 Windows에서는 사용할 수 없습니다.

같은 머신에서의 메시지는 Anthropic 서버를 거치나요?

아니요. Anthropic은 같은 머신의 세션 간에 전송되는 메시지가 세션별 로컬 소켓을 사용하며 Anthropic 서버를 거치지 않는다고 밝혔습니다.

한 Claude 세션이 다른 세션의 권한 요청을 승인할 수 있나요?

아니요. 수신되는 세션 간 메시지는 결코 사용자 동의로 간주되지 않습니다. 또한 다른 세션이 보호된 권한이나 구성 설정을 변경하도록 강제할 수 없습니다.

Claude Code를 어떻게 업데이트하나요?

네이티브 설치의 경우 claude update를 실행한 다음 Claude Code를 다시 시작하세요. claude --version으로 설치된 버전을 확인하고 claude doctor로 업데이트 상태를 진단할 수 있습니다.

관련 도구

  • Claude Code: 코드베이스 탐색, 구현, 디버깅, 테스트 및 장기 소프트웨어 작업을 위한 Anthropic의 에이전트 코딩 환경.
  • Claude Code 세션 간 메시징: 세션 발견, 전달, 크로스 머신 메시징, 인바운드 제어 및 제한에 대한 Anthropic 공식 가이드.
  • Claude Code 에이전트 팀: Claude가 생성하고 감독하는 팀을 위한 Anthropic의 조정된 다중 에이전트 작업 워크플로우.
  • Git Worktree: 하나의 저장소에서 여러 작업 트리를 유지하기 위한 Git 공식 메커니즘으로, 병렬 Claude Code 세션에 적합합니다.

[Claude Code 원격 제어](https://code.claude.com/docs/en/remote-control): Anthropic이 다른 기기에서 Claude Code 세션을 조작하기 위해 제공하는 기능입니다.
- [Claude Code 변경 로그](https://code.claude.com/docs/en/changelog): Claude Code 기능, 수정 사항 및 릴리스 날짜에 대한 공식 버전 기록입니다.

## 관련 링크

- [세션 간 메시징 문서](https://code.claude.com/docs/en/cross-session-messaging): 세션이 서로를 발견하고 메시지를 보내는 방법에 대한 권위 있는 설명입니다.
- [Claude Code 변경 로그](https://code.claude.com/docs/en/changelog): v2.1.224가 2026년 8월 7일에 출시되었으며 세션 간 `SendMessage` 기능이 추가되었음을 확인합니다.
- [Claude Code 설치 및 업데이트](https://code.claude.com/docs/en/setup): 공식 설치, 업데이트 채널, 패키지 관리자 및 `claude update` 가이드입니다.
- [Claude Code CLI 참조](https://code.claude.com/docs/en/cli-reference): `claude`, `claude update`, `claude install`, `claude agents` 등 명령어에 대한 공식 참조입니다.
- [Claude Code 설정](https://code.claude.com/docs/en/settings): 구성 및 조직 수준 제어를 포함한 공식 설정 참조입니다.
- [Git Worktree 문서](https://git-scm.com/docs/git-worktree): 병렬 개발을 지원하기 위해 격리된 작업 트리를 생성하는 방법에 대한 Git 공식 가이드입니다.
- [Claude Code 문서](https://code.claude.com/docs/en/overview): Claude Code 워크플로우와 기능에 대한 Anthropic의 주요 문서 허브입니다.

## 요약

Claude Code v2.1.224는 독립적인 Claude Code 세션이 서로를 발견하고 텍스트 메시지를 보낼 수 있는 세션 간 메시징 기능을 도입했습니다. 이 기능은 병렬 작업을 위해 설계되었습니다: 발견 결과 전달, 작업 트리 조정, 장기 실행 작업의 업데이트 수신, 그리고 개발자가 여러 터미널 간에 정보를 수동으로 전달해야 하는 필요성 감소.

이 구현은 의도적으로 기능을 제한적으로 유지합니다. 메시지에는 전체 대화 기록이나 파일이 포함되지 않으며, 한 세션이 다른 세션을 위해 권한을 승인할 수 없고, 수신 메시지는 수락, 보류 또는 거부될 수 있습니다. 같은 머신의 메시지는 각 세션의 소켓을 통해 로컬로 전송됩니다.

이후 버전에서 원래 기능이 개선되었습니다. 특히 v2.1.225는 머신 간 연결 시작을 개선하고 헤드리스 세션에서의 메시지 처리 시나리오를 수정했습니다.

**진정한 업그레이드는 두 개의 Claude 창이 "대화"할 수 있다는 것뿐만 아니라, 독립적인 코딩 에이전트가 이제 개발자가 각 병렬 작업 사이의 메시지 버스 역할을 하지 않아도 서로의 작업을 조정할 수 있다는 점입니다.**
Claude Code 2.1.224 新增跨会话消息传递,支持并行开发工作流