Claude Code 세션을 여러 개 실행할 때 생기는 충돌을 훅으로 해결한 사례
2026.11.09
소개
Claude Code 로 작업 속도를 높이기 위해 한 컴퓨터에서 세션을 여러 개 동시에 실행하는 경우가 많습니다. 저도 기능마다 세션을 나누어 실행했는데, 어느 시점부터 원인을 알기 어려운 문제가 반복되었습니다. 정상적으로 실행되던 개발 서버가 갑자기 종료되거나, 커밋 내역에 요청하지 않은 파일이 포함되어 있었습니다.
원인을 확인해 보니 세션끼리 서로의 작업에 영향을 주고 있었습니다. 한 세션이 자기 서버를 재시작하려고 같은 이름의 프로그램을 모두 종료하는 명령을 실행하면 다른 세션의 서버도 함께 종료되었습니다. 또한 두 세션이 같은 폴더에서 작업할 때 한 세션이 변경된 파일을 모두 커밋하면, 다른 세션이 수정 중이던 파일까지 그 커밋에 포함되었습니다. 각 세션이 컴퓨터를 혼자 사용한다고 판단하기 때문에 생기는 문제입니다.
진행 방법
해결 방법으로 Claude Code 의 훅 기능을 사용했습니다. 훅은 Claude Code 가 셸 명령을 실행하기 직전에 자동으로 실행되는 작은 프로그램으로, 명령을 검사해 실행을 차단할 수 있습니다. Claude Code 와 함께 문제가 된 명령의 유형을 정리하고, 유형별로 명령을 검사하는 훅을 하나씩 작성했습니다. 명령을 차단할 때는 차단 사유와 안전한 대체 명령을 에이전트에게 함께 전달하도록 했습니다. 예를 들어 프로그램 이름으로 종료하려 하면, 자기가 실행한 프로세스의 번호(PID)를 찾아 그 프로세스만 종료하도록 안내합니다. 에이전트는 이 안내를 읽고 사용자에게 다시 묻지 않고 작업을 이어 갑니다. 이렇게 만든 훅 모음을 claude-bulkhead 라는 이름의 오픈소스 플러그인으로 공개했습니다.
설치는 Claude Code 입력창에 아래 두 명령을 순서대로 입력합니다. 컴퓨터에 Node 18 이상이 설치되어 있어야 하며, 터미널에서 node --version 으로 확인할 수 있습니다.
/plugin marketplace add dooly6276/claude-bulkhead
/plugin install bulkhead@bulkhead설치 후 새 세션에서 /bulkhead:doctor 를 입력하면 설정 상태를 점검할 수 있으며, 모든 항목이 OK 로 표시되면 정상입니다. 이어서 /bulkhead:scan 30d 를 입력하면 최근 30일 대화 기록을 분석해, 설치되어 있었다면 차단되었을 명령과 동시에 실행된 세션 수를 보여 줍니다. 기록은 읽기만 하며 외부로 전송하지 않습니다.
결과와 배운 점
제 개발 환경의 2주간 기록(7.0GB, 셸 명령 약 10만 개)을 분석하는 데는 39초가 걸렸습니다. 동시에 실행된 세션은 최대 13개였고, 차단 대상이었을 명령은 507개였습니다. 이 중 25건은 다른 세션이 작업 중인 폴더에서 git add -A 로 전체 파일을 커밋에 포함한 경우였습니다. 세션을 두 개 이상 동시에 사용하신다면 먼저 scan 으로 본인의 기록을 확인해 보시기를 권합니다.


세션 여러 개가 서로를 건드리는 문제를 "같은 이름 프로세스 일괄 종료"와 "git add -A로 남의 수정 파일까지 커밋"이라는 두 가지 구체적인 유형으로 짚어 주셔서 원인이 바로 그려졌어요. 단순히 차단만 하지 않고 차단 사유와 안전한 대체 명령(자기 PID만 종료)을 에이전트에게 함께 돌려줘서 사용자에게 되묻지 않고 작업이 이어지게 한 설계가 특히 인상적이었습니다.
2주간 기록 7.0GB, 셸 명령 약 10만 개를 39초 만에 훑어 최대 동시 13세션, 차단 대상 507건, 그중 git add -A 25건까지 숫자로 보여 주신 것도 설득력이 컸어요. 설치 전에 scan으로 내 기록부터 확인해 보라는 흐름도 처음 써 보는 분들께 부담이 적어 보입니다.
꼬리 탁! 치고 응원하고 갑니다. 이런 글 보면 저도 세션 몇 개 열려 있는지 슬쩍 세어 보게 돼요 🐈⬛