Claude Code 병렬 세션 관리를 위한 PM/Worker 패턴과 c9watch 도구

실용적 조언

여러 기능을 동시에 개발할 때 하나의 세션을 관리자로 지정하고 작업을 분배하는 방식을 시도해 볼 것
세션 상태 모니터링과 제어를 위해 오픈소스 도구인 c9watch를 활용 가능

섹션별 상세

작성자는 3~5개의 Claude Code 세션을 동시에 운영하면서 각 세션의 상태를 추적하고 관리하는 데 과도한 인지 에너지가 소모되는 문제를 발견했다. 자동 모드가 승인 절차의 번거로움은 해결했으나, 사용자가 각 세션의 진행 상황을 기억하고 조율하는 '미들웨어' 역할을 수행하게 되면서 설계나 UX 같은 본질적인 고민에 집중하지 못하는 부작용이 발생했다.

이 문제를 해결하기 위해 하나의 Claude 세션을 프로젝트 매니저(PM)로 설정하고, PM이 다른 Claude Code 세션들을 워커(Worker)로 생성하여 관리하는 패턴을 도입했다. PM은 전체적인 진행 상황을 추적하고 작업을 큐에 넣으며 워커 세션의 출력을 확인하는 역할을 수행하며, 사용자는 오직 PM과만 소통하여 인지 부하를 획기적으로 줄였다.

PM 에이전트가 호스트의 모든 세션 정보와 대화 내역, 비용 등을 읽고 제어할 수 있도록 c9watch라는 CLI 및 대시보드 도구를 개발했다. 이 도구는 Tauri로 구축되었으며 spawn-worker 명령과 인박스 기능을 통해 PM이 워커 세션을 생성하고 결과를 수집할 수 있는 인프라를 제공하여 에이전트 간 협업을 가능하게 한다.

실제 적용 결과 단순 작업에는 서브에이전트가 적합하지만, 복잡한 다중 기능 개발에는 PM/Worker 패턴이 기존 대비 4배 이상의 생산성 향상을 가져왔다. 다만 UI/UX 결정과 같이 사용자의 직접적인 판단이 필요한 루프에서는 PM을 거치는 것이 오히려 비효율적일 수 있다는 한계점도 명시했다.

용어 해설

문맥 전환(Context Switching): — 하나의 작업에서 다른 작업으로 전환할 때 발생하는 인지적 비용을 의미합니다. 이 글에서는 여러 Claude Code 세션을 동시에 관리하며 발생하는 정신적 피로와 효율성 저하를 지칭합니다.
서브에이전트(Subagent): — 단일 세션 내에서 특정 작업을 수행하기 위해 생성되는 하위 에이전트입니다. 메인 세션과 컨텍스트를 공유하지만, 본문의 PM/Worker 패턴과는 독립된 세션 여부에서 차이가 있습니다.
도그푸딩(Dogfooding): — 자신이 만든 제품이나 서비스를 직접 사용하며 결함을 찾고 성능을 검증하는 과정입니다. 작성자는 c9watch를 사용하여 c9watch 자체의 기능을 개발하는 방식으로 이를 실천했습니다.

언급된 도구

c9watch추천링크

Claude Code 세션 모니터링, CLI 기반 세션 관리 및 워커 생성 도구

Tauri중립

c9watch 도구 구축에 사용된 프레임워크

언급된 리소스

GitHubc9watch GitHub Repository