Claude Code 인스턴스 간 통신을 위한 오픈소스 도구 'claude-whisper' 공개

실용적 조언

여러 Claude Code 인스턴스를 동시에 띄워 작업할 때 claude-whisper를 설치하여 컨텍스트를 공유하면 수동 복사 붙여넣기 시간을 줄일 수 있다.
Bash와 jq가 설치된 환경이라면 어디서든 즉시 적용 가능하다.

Claude Code 인스턴스 간의 독립성으로 인한 협업 한계를 지적했다. 프론트엔드와 백엔드 등 여러 역할을 수행하는 인스턴스들이 서로의 변경 사항이나 의도를 알 수 없어 수동으로 정보를 전달해야 하는 불편함이 존재했다.

파일 시스템을 메시지 버스로 활용하는 아키텍처를 채택했다. 별도의 데몬이나 데이터베이스 없이 로컬 파일 시스템에 메시지를 쓰고, UserPromptSubmit 훅이 실행될 때마다 수신된 메시지를 확인하여 사용자에게 보여주는 방식으로 작동한다.

bash

whisper-send backend "I refactored auth, check your imports"

특정 인스턴스(backend)로 메시지를 전송하는 명령어 예시

토큰 비용 최적화와 경량 구현에 집중했다. 메시지함이 비어 있을 때는 훅이 즉시 종료되어 추가적인 LLM 토큰을 소비하지 않으며, 약 240줄의 Bash와 jq만으로 작성되어 별도의 런타임 의존성이 없다.

데이터 무결성과 보안을 위한 설계를 포함했다. 원자적 쓰기(Atomic writes)를 통해 파일 손상을 방지하고, Unix 권한 설정을 활용해 인스턴스 간의 안전한 메시지 교환을 보장하며 입력값 검증 절차를 거친다.

메시지 버스(Message Bus): — 서로 다른 소프트웨어 구성 요소 간에 데이터를 주고받기 위한 통신 인프라이다. 이 도구에서는 별도의 서버 대신 로컬 파일 시스템을 메시지 버스로 활용하여 인스턴스 간 정보를 교환한다.
이벤트 루프(Event Loop): — 프로그램의 실행 흐름을 제어하며 발생하는 이벤트를 대기하고 처리하는 반복 구조이다. 여기서는 사용자가 프롬프트를 제출할 때 실행되는 훅을 이벤트 루프처럼 활용해 메시지를 확인한다.
원자적 쓰기(Atomic Write): — 데이터 쓰기 작업이 완전히 성공하거나 아예 수행되지 않음을 보장하는 방식이다. 파일 시스템 기반 통신에서 발생할 수 있는 데이터 손상이나 부분적인 읽기 오류를 방지하기 위해 사용된다.
모델 컨텍스트 프로토콜(MCP): — Model Context Protocol의 약자로, AI 모델이 외부 도구나 데이터 소스에 표준화된 방식으로 접근할 수 있게 하는 프로토콜이다. 기존 해결책들이 이 방식을 사용했으나 데몬 실행 등의 제약이 있었다.

claude-whisper추천링크

Claude Code 인스턴스 간 메시지 교환 및 협업 지원

Claude Code중립

Anthropic의 공식 CLI 코딩 에이전트