claude-bulkhead 0.4.0 공개: 빈 변수를 거친 rm -rf, .git 삭제, macOS pkill 오해석 차단

강명석·5일 전

Claude Code 와 같은 코딩 에이전트를 위한 오픈소스 훅 모음 claude-bulkhead 0.4.0 버전을 공개합니다. 이번 버전은 세션을 하나만 사용하는 경우에도 발생할 수 있는 삭제 사고를 실행 전에 차단합니다. 추가한 규칙은 모두 최근 Claude Code 이슈 트래커에 실제로 보고된 사고에서 출발했습니다.

첫째는 비어 있는 변수를 거친 삭제입니다. rm -rf $D/ 는 D 가 비어 있으면 rm -rf / 가 되고, rm -rf "$BUILD_DIR"/* 는 /* 가 됩니다. 따옴표로 감싸도 값이 비어 있으면 결과는 같습니다. 9월에는 Windows Git Bash 에서 rm -rf "$(cygpath -u 'C:\')" 가 드라이브 전체를 가리켜 약 600GB 가 삭제된 사례가 있었고(#95426), 이번 주에는 wsl -- bash -lc 안에서 설정한 변수가 바깥 셸에서 먼저 빈 값으로 펼쳐져 rsync --delete 가 / 를 대상으로 실행된 사례가 보고되었습니다(#109735). 0.4.0 의 rm-empty-var 규칙은 변수나 명령 치환 바로 뒤에 / 가 오는 재귀 삭제, 명령 치환만으로 이루어진 삭제 경로, 대상이 변수인 rsync --delete 를 차단하고, 대신 "${D:?}/" 처럼 값이 비면 셸이 멈추는 형태를 안내합니다. 같은 명령 안에서 D=$(mktemp -d) 처럼 비어 있을 수 없는 값을 먼저 넣은 경우는 통과합니다.

둘째는 .git 폴더 삭제입니다. 원격에 올리지 않은 12개월치 기록이 사라진 사례(#107274)를 바탕으로, 실제로 존재하는 .git 폴더를 지우는 rm -rf .git 과 find . -name .git -exec rm -rf 를 차단하고 git worktree remove 나 폴더 이동을 안내합니다. 아직 없는 .git 을 지우는 git clone ... && rm -rf x/.git 은 그대로 실행됩니다.

셋째는 macOS 의 pkill 인자 해석 차이입니다. 존재 여부만 확인하려던 pkill -f "gcloud.py compute" -u <사용자> --signal 0 이 macOS 에서는 --signal 과 0 을 추가 패턴으로 읽어, 다른 Claude Code 세션 전부와 열려 있던 앱에 종료 신호를 보낸 사례가 있었습니다(#109627). 이제 kill-guard 는 운영체제별 pkill 규칙대로 인자를 읽고, macOS 에서 긴 옵션이나 여러 패턴이 붙은 pkill 을 차단한 뒤 목록만 보여 주는 pgrep -f 를 안내합니다.

설치하지 않고도 지난 30일 동안의 Claude Code 기록을 바탕으로 어떤 명령이 차단되었을지 확인할 수 있습니다. 이 명령은 ~/.claude/projects 의 기록을 읽기만 하고 외부로 아무것도 보내지 않습니다.

npx -y claude-bulkhead scan --since 30d --share

특정 명령 하나의 판정은 npx -y claude-bulkhead explain -- '<명령>' 으로 실행 없이 확인할 수 있습니다. Claude Code 에서는 /plugin marketplace add dooly6276/claude-bulkhead 와 /plugin install bulkhead@bulkhead 로 설치하며, Codex, Gemini CLI, Copilot CLI, Cursor, opencode 에서도 같은 가드를 사용할 수 있습니다. 명령 문자열을 읽어 판단하는 방식이므로, 에이전트가 작성한 스크립트 파일 안의 명령까지는 확인하지 못합니다.

저장소: https://github.com/dooly6276/claude-bulkhead

0개의 댓글