Configurar guardrails de Git
Configura un hook PreToolUse que intercepta y bloquea comandos git peligrosos antes de que Claude los ejecute.
Qué se bloquea
git push(todas las variantes, incluyendo--force)git reset --hardgit clean -f/git clean -fdgit branch -Dgit checkout ./git restore .
Cuando se bloquea, Claude ve un mensaje indicándole que no tiene autoridad para acceder a estos comandos.
Pasos
1. Preguntar el ámbito
Pregunta al usuario: instalar para solo este proyecto (.claude/settings.json) o todos los proyectos (~/.claude/settings.json)?
2. Copiar el script del hook
El script incluido está en: scripts/block-dangerous-git.sh
Cópialo a la ubicación objetivo según el ámbito:
- Proyecto:
.claude/hooks/block-dangerous-git.sh - Global:
~/.claude/hooks/block-dangerous-git.sh
Hazlo ejecutable con chmod +x.
3. Añadir el hook a la configuración
Añade al archivo de configuración correspondiente:
Proyecto (.claude/settings.json):
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-dangerous-git.sh"
}
]
}
]
}
}
Global (~/.claude/settings.json):
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "~/.claude/hooks/block-dangerous-git.sh"
}
]
}
]
}
}
Si el archivo de configuración ya existe, fusiona el hook en el array hooks.PreToolUse existente — no sobrescribas otras configuraciones.
4. Preguntar sobre personalización
Pregunta al usuario si quiere añadir o eliminar algún patrón de la lista bloqueada. Edita el script copiado en consecuencia.
5. Verificar
Ejecuta una prueba rápida:
echo '{"tool_input":{"command":"git push origin main"}}' | <ruta-al-script>
Debe salir con código 2 e imprimir un mensaje de BLOQUEO a stderr.