클로드 코드 세션 간 메시지는 8월 7일 v2.1.224 부터 있었던 기능인데, 같은 기기 안에서는 세션마다 `~/.claude/sessions/<pid>.json` 에 이름·작업 폴더·소켓 경로를 적어 두고 유닉스 소켓으로 JSON 한 줄씩 주고받는 구조라는 것이 뜯어 보니 드러났고, 9월 21일 열린 claude-uds-bridge 는 그 등록 파일에 코덱스 작업을 세션처럼 적어 넣어 ListAgents 에 뜨게 하고 SendMessage 로 답도 받게 해요. 규약 자체는 8월 16일 PeterSR 이 v2.1.233 실행 파일에서 읽어 내 Go 라이브러리로 정리한 것인데, 저자 스스로 '공개 인터페이스가 아니라 어느 릴리스에서든 바뀔 수 있다' 고 적어 뒀고, 코덱스 쪽도 데스크톱 앱의 내부 IPC 로 메시지를 밀어 넣기 때문에 CLI 만 쓰는 코덱스에는 붙지 않아요. 같은 규약 위에 파이(Pi)·오픈코드용 브리지도 9월 들어 잇달아 나왔지만 별은 저장소마다 0~6개예요.
- ListAgents
- 클로드 코드가 지금 닿을 수 있는 세션·에이전트 목록을 뽑는 도구 이름
- SendMessage
- 클로드 코드가 다른 세션·에이전트에 글을 보내는 도구 이름
- 유닉스 소켓
- 같은 컴퓨터 안의 프로세스끼리 파일 경로를 주소 삼아 데이터를 주고받는 통로
- IPC
- 프로세스 간 통신(Inter-Process Communication). 한 컴퓨터 안의 프로그램끼리 데이터를 주고받는 방식
- crossSessionInbound
- 다른 세션에서 온 메시지를 어떻게 할지 정하는 클로드 코드 설정값. accept(전달)·hold(보류)·refuse(폐기)
공식 문서가 열어 준 통로는 훅·스크립트가 자기 세션 소켓에 글을 넣는 것까지이고, 남의 에이전트를 동료 세션으로 등록하는 이 방식은 양쪽 다 문서에 없는 내부 구조라 클로드 코드나 코덱스 앱이 판올림되면 예고 없이 끊길 수 있어요. 그래도 같은 OS 계정의 프로세스라면 누구나 세션 소켓에 글을 밀어 넣을 수 있고, 권한을 묻는 보통 세션은 그 글을 승인 없이 프롬프트로 받아 사용량까지 잡히니, 한 기기에서 여러 도구를 돌린다면 crossSessionInbound 를 hold 로 두고 받은 글을 눈으로 확인한 뒤 넘기는 편이 안전해요.
- 규약을 읽어 낸 원본 v2.1.233 실행 파일에서 등록 파일 `<config>/sessions/<pid>.json`, 소켓 `<base>/cc-socks/<pid>.sock`, 토큰 키 파일, 메시지·영수증 JSON 형식을 읽어 낸 Go 라이브러리로, '공개 인터페이스가 아니라 어느 릴리스에서든 바뀔 수 있다' 고 적어 뒀고 8월 18일 이후 갱신이 없어요. GitHub
- 공식 문서가 여는 범위 앤트로픽 문서는 세션이 디스크의 파일에 자기를 등록하고 세션마다 받은편지함 소켓을 연다고만 적고 파일 형식은 주지 않으며, 훅·스크립트가 자기 세션 소켓에 글을 넣는 통로만 정식으로 열어 두었고, 출처를 검증하지 못한 글은 권한을 묻는 세션에는 그대로 전달되고 bypass 세션에서만 승인 대기로 잡혀요. Anthropic
- 같은 규약 위의 다른 브리지 9월 11일 열린 codex-peer-bridge 는 파이썬으로 같은 일을 하는 또 다른 코덱스 브리지이고, 파이(Pi)용(9월 8일)·오픈코드용(9월 18일) 저장소도 있어서 한 달 새 넷이 나왔지만 별은 0~3개, 열린 이슈는 최대 8건이에요. GitHub