Claude Code, 세션 간 통신 구조 공개
Claude Code's cross-session messaging is a JSON file and a Unix socket
핵심 내용
Claude Code 2.1.224부터 세션 간 통신이 JSON 파일과 Unix 소켓을 통해 지원되며, 이를 활용한 오픈소스 브리지 프로젝트가 공개됐다.
자세히 보기
Claude Code 2.1.224 버전부터 세션 간 상호 통신 기능이 공식적으로 지원되지만, 별도의 공지 없이 변경 로그에만 기록되어 인지도가 낮다. 해당 기능의 내부 구조를 분석한 결과, 세션 등록은 ~/.claude/sessions/ 디렉터리의 JSON 파일을 통해 이루어지며 데몬이나 별도 서비스 없이 동작한다.
통신 아키텍처
각 세션은 고유한 PID를 가진 JSON 파일을 생성하여 현재 상태, 작업 디렉터리, Unix 소켓 경로 등을 등록한다. 실제 데이터 전송은 세션당 하나의 Unix 소켓(권한 0600)을 통해 이루어지며, 줄바꿈으로 구분된 JSON(Newline-delimited JSON) 형식을 사용한다. 제어 프레임은 전달 확인 및 유휴 상태 알림을 처리한다.
외부 도구 연동
이러한 구조를 활용하여 OpenAI Codex 작업을 Claude Code 세션처럼 등록하고 응답하게 하는 오픈소스 프로젝트 claude-uds-bridge가 공개됐다. 이 브리지는 macOS와 Linux를 지원하며, /list-agents 명령어에서 다른 세션과 동일하게 표시되어 상호작용할 수 있게 한다.
이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.