다중 창 클로드 코드 설정: 역할 분리 및 실행 훅

설정 상세

r/ClaudeAI의 한 개발자가 Claude Code가 세션 중에 목표를 벗어나고 컨텍스트를 잃는 문제를 해결하기 위한 구성을 설명합니다. 이 솔루션은 iTerm2에서 2×2 그리드를 사용하며, 각 창은 고정된 역할이 할당된 별도의 Claude Code 인스턴스를 실행합니다.

• IMPL: 자동 수락이 활성화된 Sonnet 모델을 사용합니다. 역할은 코드 작성과 테스트 실행입니다.
• AUDIT: 읽기 전용 모드의 Opus 모델을 사용합니다. IMPL의 출력을 검토하지만 코드 자체를 생성하지는 않습니다.
• PLAN: 아키텍처 논의를 위해 낮은 노력 설정으로 실행됩니다. 쓰기 제한은 없지만, 낮은 노력 설정으로 인해 구현에 깊이 들어가지 않습니다.
• PROMPT: 프롬프트 개선을 별도로 처리합니다.

각 창은 $ITERM_PROFILE 환경 변수에서 자동으로 역할을 선택합니다. cc를 입력하면 올바른 모델과 권한 플래그로 인스턴스가 시작됩니다.

훅 시스템 및 세션 관리

이 설정은 실행 시점에 적용되는 두 단계 훅 시스템을 포함합니다.

• PreToolUse 훅: .env 파일 편집이나 git push 명령과 같은 작업이 실행되기 전에 차단합니다.
• PostToolUse 훅: 연속 세 번의 도구 실패 후 세션을 중단하는 회로 차단기를 구현하여 상황이 악화되는 것을 방지합니다.

SESSION_LOG—일반 마크다운 파일—은 IMPL이 매일 끝날 때 완료된 작업, 결정 사항, 다음 단계로 업데이트합니다. 새 세션을 시작할 때 이 로그의 마지막 60줄을 읽어, 전체 프로젝트를 다시 설명하는 데서 오는 콜드 스타트를 줄이고 중단한 부분부터 이어갈 수 있습니다.

훅 스크립트와 게이트/배포 워크플로를 포함한 전체 안내는 링크된 가이드와 저장소에서 확인할 수 있습니다.