Claude Code 세션 10개에서 훅 7개가 도구 호출마다 318 ms 를 썼습니다. 프로세스 하나로 합쳐 89 ms 로 줄였습니다

강명석·2026년 11월 11일

저는 한 컴퓨터에서 Claude Code 세션을 동시에 열 개 넘게 돌립니다. 세션마다 몇 초에 한 번씩 셸 명령을 실행하고, 그 명령은 모두 claude-bulkhead 의 PreToolUse 훅을 거칩니다. claude-bulkhead 는 세션끼리 서로의 개발 서버를 끄거나, 포트를 가져가거나, 아직 끝나지 않은 수정 사항을 커밋하지 않게 막으려고 만든 플러그인입니다. 이 글은 그 훅이 드는 비용, 세션 수가 늘수록 비용이 커진 이유, 0.3.0 에서 무엇을 바꿨는지를 정리합니다.

시간이 어디에 쓰였는가

0.2 까지 bulkhead 는 Bash 훅을 일곱 개 따로 등록했습니다. kill-guard, wait-guard, memory-guard, port-guard, checkout-guard, disk-guard, basics 입니다. Claude Code 는 도구 호출 하나에 걸리는 훅을 모두 동시에 실행하고, 훅마다 프로세스를 하나씩 띄워 입력을 표준 입력으로 넘깁니다. 다른 일이 없는 컴퓨터에서는 싸 보입니다. 가드가 나란히 돌고 대부분 명령 글자만 보므로, MacBook Pro(M5 Pro, Node 24)에서 호출 한 번에 47 ms 가 걸렸습니다.

문제는 다른 숫자였습니다. 이 컴퓨터에서 Node 를 띄우는 데만 32 ms 가 걸리므로, 가드마다 입력을 한 글자도 읽기 전에 비용 대부분을 이미 쓴 셈입니다. 가드가 일곱 개면 셸 명령 하나에 Node 프로세스가 일곱 개 뜹니다. 여러 에이전트가 시험과 빌드를 돌리면 세션 열 개가 같은 순간에 도구를 부르는 일이 잦고, 그때는 Node 프로세스 일흔 개가 한꺼번에 떠서 같은 코어를 두고 다툽니다. 그 결과 세션마다 훅을 318 ms 동안 기다렸고, 세션이 스무 개면 611 ms 였습니다.

프로세스 하나, 싼 검사부터

0.3.0 에서는 Claude Code 가 Bash 와 PowerShell 에 훅 src/bash-guards.js 하나만 띄우고, 그 프로세스가 가드를 차례로 실행합니다. 순서는 일부러 정했습니다. 명령 글자만 분석하는 가드가 먼저 돌고, git, 메모리 상태, 프로세스 목록, 포트를 읽을 수 있는 가드는 뒤에 돕니다. 뒤쪽 가드도 글자가 무언가와 맞았을 때만 그 일을 합니다. port-guard 는 프로세스 목록을 읽기 전에 그 포트에 TCP 연결부터 해 보고, checkout-guard 는 다른 세션이 살아 있을 때만 git 을 실행하며, basics 는 git reset --hard 와 git clean 에만 git status 를 실행합니다. 첫 차단에서 바로 멈추므로 막힌 명령은 그 뒤의 가드 비용을 내지 않습니다.

측정 스크립트는 저장소에 들어 있어 각자의 컴퓨터에서 돌려 볼 수 있습니다.

node scripts/bench-hooks.js 9 --sessions 10

제 컴퓨터에서 잰 결과입니다.

가드마다 프로세스 하나(0.2)프로세스 하나(0.3)
도구 호출 한 번, 통과47 ms76 ms
세션 10개 동시318 ms89 ms
세션 20개 동시611 ms109 ms

첫 줄은 오히려 나빠졌고, 이는 예상한 결과입니다. 다른 일이 없을 때는 가드를 차례로 돌리는 쪽이 나란히 돌리는 쪽보다 느립니다. 그래도 이 변경을 유지한 것은 bulkhead 를 세션 하나만 쉬는 상태로 쓰는 사람은 없기 때문입니다. bulkhead 는 둘째 줄과 셋째 줄 같은 상황을 위해 있고, 거기서는 호출마다 프로세스를 일곱 개가 아니라 하나만 띄우는 것이 훅을 방해되지 않게 합니다. 차단 기록을 이벤트 로그에 쓰는 비용은 두 방식 모두 잴 수 있을 만큼 나오지 않았습니다.

0.3.0 의 다른 변경

훅을 하나로 합치면서 모든 가드의 판단을 한곳에서 볼 수 있게 되었고, 덕분에 두 기능을 쉽게 넣었습니다. bulkhead explain -- <명령> 은 지금 컴퓨터의 세션, 프로세스, 포트, git 상태를 기준으로 명령을 모든 가드에 넣어 보고, 각 가드가 무엇을 왜 말하는지 보여 줍니다. 명령은 실행하지 않습니다. 또 모든 차단 메시지 끝에 짧은 코드가 붙고, 사용자가 자기 터미널에서 bulkhead allow <코드> 를 실행하면 같은 명령이 10분 안에 한 번 통과합니다. basics 의 규칙 하나가 에이전트가 bulkhead allow 를 직접 실행하지 못하게 막으므로 승인은 사람에게 남습니다.

kill-guard 는 이제 프로세스가 어느 세션 것인지도 봅니다. kill <pid> 와 pkill -f <패턴> 은 자기 세션의 프로세스에만 닿으면 통과하고, 살아 있는 다른 세션의 프로세스에 닿으면 막힙니다. 다른 세션이 살아 있는 동안에는 pkill -u, kill -1, docker system prune, adb kill-server 처럼 넓게 끄는 명령도 막습니다. 같은 가드를 bulkhead setup <에이전트> --write 로 Codex, Gemini CLI, Copilot CLI, Cursor, Windsurf 와 그 밖의 에이전트 다섯 종에도 등록할 수 있습니다. 전체 목록은 변경 기록에 있습니다.

써 보는 방법

bulkhead 는 의존성이 없고 컴퓨터 밖으로 아무것도 보내지 않습니다. scan 은 지난 대화 기록을 읽기만 하므로, 무엇을 켜기 전에 자기 기록에서 bulkhead 가 무엇을 막았을지 먼저 볼 수 있습니다.

npx claude-bulkhead scan 30d

Claude Code 플러그인으로 설치하는 방법입니다.

/plugin marketplace add dooly6276/claude-bulkhead
/plugin install bulkhead@bulkhead

코드, 측정 스크립트, 실제 세션을 찍은 18초 영상은 GitHub 에 있습니다. 코드와 시험의 대부분은 Claude Code 와 함께 썼고, 이 글의 변경은 모두 제가 검토하고 직접 측정했습니다.

0개의 댓글