git-guardrails-claude-code (Matt Pocock)

AI 코딩 도구가 `git push`나 `reset --hard`처럼 되돌리기 어려운 git 명령을 실행하기 직전에 자동으로 막아 주는 작은 안전장치. 실수로 코드나 작업 내역이 날아가는 사고를 예방한다.

A lightweight Claude Code hook that blocks risky git commands like git push or reset --hard before they wipe your work.

#hook#claude-code#pretooluse#git#guardrail#mattpocock

한 줄

AI가 실행하려는 명령을 가로채 위험한 git 명령이면 막아 주는 8줄짜리 bash 스크립트. 내부적으로는 명령 텍스트(tool_input.command)를 받아 위험 패턴과 정규식으로 비교하고, 일치하면 종료 코드 2와 경고 메시지로 실행을 거부한다.

EN: An 8-line bash script that intercepts the command your AI is about to run and refuses it if it matches a dangerous git pattern.

차단 패턴 (기본)

패턴	의미
`git push`	모든 push (force push(강제로 원격 기록 덮어쓰기) 포함)
`git reset --hard`	작업 트리 강제 폐기
`git clean -f` / `git clean -fd`	추적 안 된 파일 강제 삭제
`git branch -D`	머지 안 된 브랜치 강제 삭제
`git checkout \.` / `git restore \.`	모든 변경사항 폐기
`push --force`, `reset --hard`	위 패턴의 부분 매칭 (이중 방어)

설치

1) 스크립트 복사 (글로벌 또는 프로젝트)

# 글로벌
curl -fsSL https://raw.githubusercontent.com/mattpocock/skills/main/skills/misc/git-guardrails-claude-code/scripts/block-dangerous-git.sh \
  -o ~/.claude/hooks/block-dangerous-git.sh
chmod +x ~/.claude/hooks/block-dangerous-git.sh

# 프로젝트
mkdir -p .claude/hooks
curl -fsSL https://raw.githubusercontent.com/mattpocock/skills/main/skills/misc/git-guardrails-claude-code/scripts/block-dangerous-git.sh \
  -o .claude/hooks/block-dangerous-git.sh
chmod +x .claude/hooks/block-dangerous-git.sh

2) settings.json에 등록

글로벌 (~/.claude/settings.json):

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/block-dangerous-git.sh", "timeout": 5 }
        ]
      }
    ]
  }
}

프로젝트 (.claude/settings.json):

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-dangerous-git.sh" }
        ]
      }
    ]
  }
}

3) 동작 확인

echo '{"tool_input":{"command":"git push origin main"}}' \
  | ~/.claude/hooks/block-dangerous-git.sh
# → exit 2 + "BLOCKED: ... matches dangerous pattern 'git push'"

패턴 커스터마이즈

스크립트 안 DANGEROUS_PATTERNS 배열만 수정. ERE 정규식이라 점은 \.처럼 이스케이프.

DANGEROUS_PATTERNS=(
  "git push"
  "git reset --hard"
  "git clean -fd"
  "git clean -f"
  "git branch -D"
  "git checkout \."
  "git restore \."
  "push --force"
  "reset --hard"
  # 추가 예: hook 우회 차단
  "--no-verify"
  "--no-gpg-sign"
)

함정 (실전에서 발견)

grep 옵션 충돌: 패턴이 -로 시작하면(--no-verify, --no-gpg-sign) grep -qE가 패턴을 자기 옵션으로 오인. 추가 시 반드시 grep -qE -- "$pattern"로 --를 끼워 옵션 종결을 명시.
jq 필수: 없으면 빈 COMMAND로 모든 명령이 통과(fail-open). macOS는 brew install jq.
이중 등록 가능: 다른 Bash hook과 양립. 어느 한 쪽이 먼저 exit 2면 실행 차단.
npx block-no-verify@1.1.2 대체용: npm 캐시 verify가 매 Bash 호출마다 일어나 CPU 폭주 사례 있음(관측치 ~165% CPU). 이 hook은 bash 한 줄 수 ms로 끝나 폭주 없음.

같이 보면 좋은

본 컬렉션 claude-code-hooks — 보호 브랜치/ssh/WebSearch 등 추가 hook 모음

## 한 줄 AI가 실행하려는 명령을 가로채 위험한 git 명령이면 막아 주는 8줄짜리 bash 스크립트. 내부적으로는 명령 텍스트(`tool_input.command`)를 받아 위험 패턴과 정규식으로 비교하고, 일치하면 종료 코드 2와 경고 메시지로 실행을 거부한다. *EN: An 8-line bash script that intercepts the command your AI is about to run and refuses it if it matches a dangerous git pattern.* ## 차단 패턴 (기본) | 패턴 | 의미 | |---|---| | `git push` | 모든 push (force push(강제로 원격 기록 덮어쓰기) 포함) | | `git reset --hard` | 작업 트리 강제 폐기 | | `git clean -f` / `git clean -fd` | 추적 안 된 파일 강제 삭제 | | `git branch -D` | 머지 안 된 브랜치 강제 삭제 | | `git checkout \.` / `git restore \.` | 모든 변경사항 폐기 | | `push --force`, `reset --hard` | 위 패턴의 부분 매칭 (이중 방어) | ## 설치 ### 1) 스크립트 복사 (글로벌 또는 프로젝트) ```bash # 글로벌 curl -fsSL https://raw.githubusercontent.com/mattpocock/skills/main/skills/misc/git-guardrails-claude-code/scripts/block-dangerous-git.sh \ -o ~/.claude/hooks/block-dangerous-git.sh chmod +x ~/.claude/hooks/block-dangerous-git.sh # 프로젝트 mkdir -p .claude/hooks curl -fsSL https://raw.githubusercontent.com/mattpocock/skills/main/skills/misc/git-guardrails-claude-code/scripts/block-dangerous-git.sh \ -o .claude/hooks/block-dangerous-git.sh chmod +x .claude/hooks/block-dangerous-git.sh ``` ### 2) settings.json에 등록 **글로벌** (`~/.claude/settings.json`): ```json { "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "~/.claude/hooks/block-dangerous-git.sh", "timeout": 5 } ] } ] } } ``` **프로젝트** (`.claude/settings.json`): ```json { "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-dangerous-git.sh" } ] } ] } } ``` ### 3) 동작 확인 ```bash echo '{"tool_input":{"command":"git push origin main"}}' \ | ~/.claude/hooks/block-dangerous-git.sh # → exit 2 + "BLOCKED: ... matches dangerous pattern 'git push'" ``` ## 패턴 커스터마이즈 스크립트 안 `DANGEROUS_PATTERNS` 배열만 수정. ERE 정규식이라 점은 `\.`처럼 이스케이프. ```bash DANGEROUS_PATTERNS=( "git push" "git reset --hard" "git clean -fd" "git clean -f" "git branch -D" "git checkout \." "git restore \." "push --force" "reset --hard" # 추가 예: hook 우회 차단 "--no-verify" "--no-gpg-sign" ) ``` ## 함정 (실전에서 발견) - **grep 옵션 충돌**: 패턴이 `-`로 시작하면(`--no-verify`, `--no-gpg-sign`) `grep -qE`가 패턴을 자기 옵션으로 오인. 추가 시 반드시 `grep -qE -- "$pattern"`로 `--`를 끼워 옵션 종결을 명시. - **jq 필수**: 없으면 빈 `COMMAND`로 모든 명령이 통과(fail-open). macOS는 `brew install jq`. - **이중 등록 가능**: 다른 Bash hook과 양립. 어느 한 쪽이 먼저 exit 2면 실행 차단. - **`npx block-no-verify@1.1.2` 대체용**: npm 캐시 verify가 매 Bash 호출마다 일어나 CPU 폭주 사례 있음(관측치 ~165% CPU). 이 hook은 bash 한 줄 수 ms로 끝나 폭주 없음. ## 같이 보면 좋은 - 본 컬렉션 `claude-code-hooks` — 보호 브랜치/ssh/WebSearch 등 추가 hook 모음

사용법

한 줄