AI 도서관 · Claude · 하네스 설정 · 에이전트끼리 소통

내가 띄운 세션끼리 소식 주고받기

터미널 두 개를 오가며 복사해 나르던 것을 그만두는 방법

내용

📌 무엇인가
터미널 여러 개에 클로드를 각각 띄워 놓고 일할 때,
한쪽이 알아낸 것을 다른 쪽에 넘길 수 있습니다.
내가 복사해서 옮기지 않아도 됩니다.

팀 기능과 다릅니다 — 이건 내가 직접 띄운 세션들이고,
켤 것이 없습니다. 조건만 맞으면 이미 켜져 있습니다.

[ 확인 ]
  /list-agents      (또는 /peers)

맨 윗줄이 이 세션의 이름입니다 — 다른 세션이 나를 부를 때 쓰는 이름.
아래는 말을 걸 수 있는 상대 목록입니다.

[ 시키는 법 — 그냥 말로 ]
  "다른 터미널에서 돌던 세션에 마이그레이션 끝났는지 물어봐줘"
  "우리가 방금 한 걸 결제 API 쪽 세션에 설명해줘"

이름을 직접 찍으려면 @ 를 치고 앞글자를 넣으면 목록이 뜹니다.
  "@api-worker 한테 스키마 작업 끝났다고 알려줘"

📌 무엇이 넘어가고 무엇이 안 넘어가나
넘어감 — 글자. 클로드가 직접 쓴 메시지 한 덩이
안 넘어감 — 대화 내역, 파일, 맥락

대화를 통째로 옮기고 싶으면 메시지가 아니라
그 세션을 이어받아야 합니다.

📌 다 끝나면 알려달라고 하기
  "마이그레이션 세션 다 끝나면 알려줘"

한 번만 알려주고 끝납니다. 서로 계속 확인하지 않으므로
지켜보는 동안 토큰이 나가지 않습니다.
12시간 안에 소식이 없으면 기다리기를 그만둡니다.

📌 이름 붙여두면 편합니다
  claude --name api-worker
  또는 세션 안에서  /rename api-worker

⚠️ 같은 컴퓨터 안에서만 서로를 찾습니다
   파일로 서로를 등록하는 방식이라 그렇습니다.
   컨테이너 안과 밖은 서로 못 봅니다.
   WSL 안과 윈도우 네이티브도 서로 못 봅니다.

⚠️ 무한 반복은 알아서 멈춥니다
   같은 메시지가 짧은 시간에 되풀이되면 버립니다.
   두 세션이 답장만 주고받는 고리는 저절로 끊깁니다.

⚠️ 받는 쪽을 막아둘 수 있습니다
   crossSessionInbound 를 refuse 로 두면 받지 않고,
   hold 로 두면 내가 승인할 때만 전달됩니다.

궁금한 점: {{INPUT}}

{{INPUT}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.

근거

유형
공식 기능·명령 — 해당 제품에서 실제로 동작합니다
사용 환경
Claude Code v2.1.224 이상 (윈도우 네이티브는 v2.1.234 이상). 켤 것 없이 켜져 있습니다
사용 조건
같은 컴퓨터 세션끼리는 모든 제공자에서 됩니다. 다른 기기·웹 세션은 Remote Control 연결이 필요합니다
주의
넘어가는 것은 글자뿐입니다. 대화 내역과 파일은 넘어가지 않습니다.
공식 출처
https://code.claude.com/docs/en/cross-session-messaging
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기