Git ガードレールのセットアップ は何をしますか?
危険な Git コマンドが Claude によって実行される前に、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 で終了し、BLOCKED メッセージを stderr に出力する必要があります。