멀티-에이전트 세션을 위한 Claude Code 허브 아키텍처 가이드

한 Reddit 사용자가 Claude Code를 단일 사용자 세션 이상으로 확장하기 위한 아키텍처를 공유했습니다. 이 시스템은 허브-앤-스포크 모델을 사용합니다: 중앙 허브(Docker Hub에서 자체 호스팅 또는 호스팅)와 네 가지 인터페이스 유형으로 구성됩니다.

아키텍처 개요

허브 – 중앙 조정 지점으로, Docker Hub에서 자체 호스팅 가능합니다.
원라인 MCP 클라이언트 – Model Context Protocol을 통한 경량 통합.
CLI – 허브에 대한 직접 명령줄 액세스.
Docker의 헤드리스 워커 – 추가 컨테이너를 생성할 수 있는 컨테이너화된 에이전트(에이전트가 에이전트를 호출).
소형 데스크탑 감독자 – 세션 모니터링 및 제어를 위한 GUI.

제공 기능

여러 사람이 동일한 Claude Code 세션에 접속하여 에이전트가 실시간으로 생각하는 것을 지켜볼 수 있습니다.
세션 간에 다른 저장소로 하위 작업을 라우팅할 수 있습니다.
컨테이너 내 헤드리스 Claude 인스턴스가 하위 컨테이너를 생성하여 재귀적 에이전트 워크플로우를 가능하게 합니다.
휴대폰 브라우저 탭에서 지켜보고 개입할 수 있습니다.

세부 사항

허브는 중심 구성 요소입니다. MCP 클라이언트는 단일 라인 통합입니다. 데스크탑 감독자는 모니터링을 위한 경량 UI를 제공합니다. 모든 워커는 Docker에서 헤드리스로 실행되며, 하위 작업을 오프로드하기 위해 추가 컨테이너를 생성할 수 있습니다. 이 시스템은 저장소 간 세션 라우팅을 지원하여, 복잡한 다중 저장소 작업을 분할하고 위임할 수 있습니다.

저장소 및 설명은 GitHub에서 확인 가능합니다: https://github.com/clawborrator

이는 본질적으로 다중 운영자 Claude Code를 위한 파이프라인 계층입니다. 이미 Claude Code를 사용 중이고 단일 사용자 세션의 한계에 부딪혔다면, 이 아키텍처는 확장을 위한 구체적인 패턴을 제공합니다.

📖 전체 출처 읽기: r/ClaudeAI