Git 가드레일 설정
Claude가 실행하기 전에 위험한 Git 명령어를 가로채고 차단하는 PreToolUse 후크를 설정합니다.
차단되는 명령어
git push(모든 변형,--force포함)git reset --hardgit clean -f/git clean -fdgit branch -Dgit checkout ./git restore .
차단되면 Claude는 해당 명령어에 접근할 권한이 없다는 메시지를 확인합니다.
단계
1. 범위 확인
사용자에게 설치 범위를 물어보세요: 이 프로젝트만(.claude/settings.json)인지 모든 프로젝트(~/.claude/settings.json)인지.
2. 후크 스크립트 복사
번들 스크립트는 다음 위치에 있습니다: scripts/block-dangerous-git.sh
범위에 따라 대상 위치로 복사하세요:
- 프로젝트:
.claude/hooks/block-dangerous-git.sh - 전역:
~/.claude/hooks/block-dangerous-git.sh
chmod +x로 실행 권한을 부여하세요.
3. 설정에 후크 추가
해당 설정 파일에 추가하세요:
프로젝트 (.claude/settings.json):
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-dangerous-git.sh"
}
]
}
]
}
}
전역 (~/.claude/settings.json):
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/block-dangerous-git.sh"
}
]
}
]
}
}
설정 파일이 이미 존재하는 경우, 후크를 기존 hooks.PreToolUse 배열에 병합하고 다른 설정은 덮어쓰지 마세요.
4. 커스터마이즈 확인
사용자에게 차단 목록에 패턴을 추가하거나 제거할지 물어보세요. 복사된 스크립트를 그에 따라 편집하세요.
5. 확인
빠른 테스트를 실행하세요:
echo '{"tool_input":{"command":"git push origin main"}}' | <스크립트-경로>
종료 코드 2와 함께 stderr에 BLOCKED 메시지가 출력되어야 합니다.