r/ClaudeAI•7일 전•31•14

Claude Code의 세션 간 메시징은 JSON 파일과 Unix 소켓으로 이루어짐

Claude Code's cross-session messaging is a JSON file and a Unix socket

핵심 요약

Claude Code의 세션 간 메시징 기능이 JSON 파일과 Unix 소켓을 통해 작동하는 원리를 분석하고 이를 활용한 브리지 도구를 소개함.

세션 간 메시징 — JSON 파일과 Unix 소켓을 사용하여 세션끼리 통신함
작동 원리 — ~/.claude/sessions/ 디렉토리의 JSON 파일을 통해 세션을 식별하고 소켓으로 데이터를 전송함
오픈 소스 도구 — Codex 작업을 다른 세션과 연결할 수 있는 브리지 도구를 공개함

Claude Code 세션끼리 서로 메시지를 주고받을 수 있다는 거 알고 있었냐? 2.1.224 버전에서 추가됐고 https://code.claude.com/docs/en/cross-session-messaging에 제대로 문서화까지 되어 있는데, 릴리즈 노트에 한 줄 띡 적혀있고 별다른 공지도 없어서 쓰는 사람이 거의 없더라. 그래서 내가 이거 뜯어보고 반대편에 Codex 작업을 붙여버렸다.

디렉터리에서 세션을 찾는다. 각 세션은 ~/.claude/sessions/<pid>.json 파일을 생성한다:

{
"pid": 58617,
"cwd": "/Users/leon",
"name": "leon-c0",
"messagingSocketPath": "/tmp/cc-socks/58617.sock",
"procStart": "Mon Sep 21 16:13:34 2026",
"peerProtocol": 1,
"status": "busy"
}

ListAgents가 저 폴더를 읽어오는 방식이다. 데몬이나 서비스 같은 거 따로 안 쓴다.

전송 방식은 세션당 Unix 소켓 하나씩, 모드 0600, 줄바꿈으로 구분된 JSON을 사용한다:

{"msgV":1,"type":"user","msg_id":"<uuid>",
"from":"uds:/tmp/cc-socks/1234.sock",
"session_id":"<recipient>",
"message":{"role":"user","content":"..."}}

제어 프레임은 수신 확인이랑 유휴 상태 알림을 처리한다.

플러그인이 실행 중인 Codex 작업을 해당 레지스트리에 등록하면, /list-agents에 뜨고 다른 세션이랑 똑같이 응답한다 — https://github.com/LeonKohli/claude-uds-bridge

MIT 라이선스고, macOS랑 Linux 지원한다. 초기 전송 작업은 PeterSR이 해줬다: https://github.com/PeterSR/claude-code-socket-transport

원문

커뮤니티 목록

r/ClaudeAI•7일 전•31•14

Claude Code의 세션 간 메시징은 JSON 파일과 Unix 소켓으로 이루어짐

Claude Code's cross-session messaging is a JSON file and a Unix socket

핵심 요약

Claude Code의 세션 간 메시징 기능이 JSON 파일과 Unix 소켓을 통해 작동하는 원리를 분석하고 이를 활용한 브리지 도구를 소개함.

세션 간 메시징 — JSON 파일과 Unix 소켓을 사용하여 세션끼리 통신함
작동 원리 — ~/.claude/sessions/ 디렉토리의 JSON 파일을 통해 세션을 식별하고 소켓으로 데이터를 전송함
오픈 소스 도구 — Codex 작업을 다른 세션과 연결할 수 있는 브리지 도구를 공개함

디렉터리에서 세션을 찾는다. 각 세션은 ~/.claude/sessions/<pid>.json 파일을 생성한다:

{
"pid": 58617,
"cwd": "/Users/leon",
"name": "leon-c0",
"messagingSocketPath": "/tmp/cc-socks/58617.sock",
"procStart": "Mon Sep 21 16:13:34 2026",
"peerProtocol": 1,
"status": "busy"
}

ListAgents가 저 폴더를 읽어오는 방식이다. 데몬이나 서비스 같은 거 따로 안 쓴다.

전송 방식은 세션당 Unix 소켓 하나씩, 모드 0600, 줄바꿈으로 구분된 JSON을 사용한다:

{"msgV":1,"type":"user","msg_id":"<uuid>",
"from":"uds:/tmp/cc-socks/1234.sock",
"session_id":"<recipient>",
"message":{"role":"user","content":"..."}}

제어 프레임은 수신 확인이랑 유휴 상태 알림을 처리한다.

MIT 라이선스고, macOS랑 Linux 지원한다. 초기 전송 작업은 PeterSR이 해줬다: https://github.com/PeterSR/claude-code-socket-transport

주요 댓글

r/claudeai

Claude Code의 세션 간 메시징 구현 방식에 대해 사용자들은 투박하다는 반응과 함께, 세션 탐색 및 관리의 기술적 난제에 대한 심도 있는 논의를 나누고 있습니다.

한두 주 전쯤에 핸드오프(handoff)하려고 새 에이전트를 시작했다가 다른 채팅으로 돌아갔는데, 그 에이전트가 이미 나한테 연락을 해왔길래 알게 됐음.

맞음, 나도 정확히 그렇게 알게 됐어. 좀 멋져 보여서 어떻게 작동하는지 궁금해가지고 파고들었지.

CLI 대신 플러그인을 통해 Codex와 통신하게 하면 어떤 장점이 있는 거야? 멋진 프로젝트네!

나도 세션 두 개를 연결해 본 적 있는데, 서로 다른 소리를 하는 것 같아서 지들끼리 정리 좀 하라고 시켰거든. 잘 작동하더라.

바뀌었는지는 모르겠는데, 처음에는 Claude 세션이 활성화되어 있을 때만 채팅이 가능하다는 점이 마음에 안 들었음. 나는 메모리 아끼려고 습관적으로 /exit 치고 다 꺼버려서 이게 나한테는 전혀 안 맞았거든. 그래서 결국 프로젝트 디렉토리 안에서 claude -p를 사용하는 스킬이랑 MCP 서버를 직접 만들었음. 이렇게 하면 메모리, 프로젝트, 그리고 전역 Claude가 필요할 때 로드되니까. 예를 들어, 프로젝트 A에서 작업하다가 프로젝트 B의 정보가 필요하면, 그냥 프로젝트 A 대화창에서 Claude한테 "프로젝트 B한테 XYZ에 대해 물어봐"라고 시키면 둘이서 알아서 대화를 주고받음. 프로젝트 A에는 읽기 권한만 주고 다른 건 거의 다 막아놔서 딴짓 못 하게 했고, 대신 프로젝트 내에서 작업 request를 제출할 수는 있게 해둠. 사실 request는 그냥 필요한 내용을 적은 .md 파일이고, 그 디렉토리에서 Claude랑 같이 작업하면서 해결하는 방식임. 엄청 편하긴 한데, 내 사용 환경인 멀티 컴퓨터, 리눅스, 그리고 claude cli만 쓰는 환경에 맞춰서 세팅한 거라 좀 특수하긴 함.

task chips 쓰기 시작하면서 세션끼리 통신하는 게 필수적이게 됐음. 일일이 수동으로 메시지 전달하는 건 절대 못 할 짓이었거든. 이제는 세션이 다른 세션이랑 충돌하는 걸 감지하고 업데이트를 브로드캐스트할 수 있음. 차이가 엄청나네.

진짜 엄청 투박하네. 내가 만든 건 그냥 간단한 파이썬 스크립트였는데.

좀 투박함. 프로토콜이 워낙 작아서 스크립트 하나로도 해피 패스는 커버 가능함.

이거 해킹해서 확장하는 거 진짜 재밌네. 내 gemma4 '집 요정' 에이전트도 루프에 추가했고, 심지어 계정 간 브리지까지 만들어서 파트너의 메인 어시스턴트랑 내 어시스턴트가 직접 대화하게도 해봤음 (예: '야, 왜 imessage 채널은 이미지 아닌 첨부파일 지원 안 함?')

-1

좋은 글이네. 디렉토리를 이용한 디스커버리 설계는 아주 적절한 선택이야. CCC를 위해 비슷한 걸 만들어봤는데, 진짜 어려운 건 ~/.claude/sessions/<pid>.json을 읽는 게 아니라, 수동으로 실행됐거나 다른 도구의 통제 밖에서 서브 프로세스로 생성돼서 파일을 아예 안 만든 세션들을 찾아내는 거더라고. 우리는 결국 모든 런처가 스스로 등록하게 강제하는 대신, 프로세스 계층 구조를 역추적해서 부모/자식 관계를 사후에 복구하는 방식을 썼어. CCC(https://github.com/amirfish1/claude-command-center)도 그런 식으로 실행된 세션을 제어하려고 비슷한 세션당 소켓 모델을 사용 중이야. 너도 수동으로 실행된 세션들에서 디스커버리 공백 문제를 겪었어, 아니면 네 브릿지를 거친 것들만 다룬 거야?

한 번도 안 그랬음. Claude Code는 직접 시작한 세션을 스스로 등록하고, 플러그인은 Codex 쪽을 등록하니까 내가 다루는 모든 피어는 각자 자기 기록을 남겼음. 너는 여러 런타임을 다루고 있는데, 그중 대부분은 레지스트리가 없으니 그건 또 다른 문제임.

원문r/ClaudeAI