Hace poco, mientras rehacíamos el sitio de Zygnus con Claude Code, levantamos una vista previa local conectada por túnel a la base de datos de producción. Era la forma rápida de ver el contenido real. Funcionó, y también nos enseñó algo: cada vez que abríamos una nota del blog para revisarla, el contador de visitas en producción subía. Nada grave, pero era una escritura real en la base de todos los días, hecha desde una laptop.
Con un agente que ejecuta comandos, ese tipo de accidente puede ser bastante peor. Claude Code respeta lo que pongas en CLAUDE.md, pero esas instrucciones son una guía para el modelo. Si un paso no se puede saltar nunca, conviene que lo vigile algo que no dependa del modelo. Para eso están los hooks.
Qué es un hook
Un hook es un comando tuyo que Claude Code ejecuta en momentos fijos. El que usamos para proteger producción es PreToolUse: corre antes de que Claude use una herramienta, como ejecutar un comando de terminal o editar un archivo. El hook recibe por la entrada estándar un JSON con la herramienta y sus parámetros. Si tu script termina con código 2, la acción se bloquea y lo que escribas en la salida de error le llega a Claude como explicación.
1. Registrar el hook
En la raíz del proyecto, dentro de .claude/settings.json:
{
"permissions": {
"deny": ["Read(./.env)", "Read(./.env.*)"]
},
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{ "type": "command", "command": ".claude/hooks/no-produccion.sh" }
]
},
{
"matcher": "Edit|Write",
"hooks": [
{ "type": "command", "command": ".claude/hooks/no-env.sh" }
]
}
]
}
}
La regla de permissions.deny evita que lea el .env, donde viven las contraseñas. Los dos hooks cubren lo que una lista de permisos no alcanza a describir bien.
2. Bloquear comandos que tocan producción
.claude/hooks/no-produccion.sh (necesita jq y permiso de ejecución con chmod +x):
#!/usr/bin/env bash
cmd=$(jq -r '.tool_input.command // empty')
# Ajusta estos patrones a tus servidores y comandos
patrones='ssh .*@prod|rsync .*:/var/www|migrate.*--force|db:wipe|DROP (TABLE|DATABASE)|git push .*--force'
if echo "$cmd" | grep -Eiq "$patrones"; then
echo "Bloqueado: este comando toca producción. Pídele a una persona que lo corra." >&2
exit 2
fi
exit 0
No intentes adivinar todo lo peligroso. Pon los comandos que en tu equipo ya causaron un susto o que nadie debería correr sin revisar: el despliegue, las migraciones forzadas, el acceso a los servidores. La lista crece con el tiempo y está bien.
3. Proteger archivos de configuración
.claude/hooks/no-env.sh:
#!/usr/bin/env bash
ruta=$(jq -r '.tool_input.file_path // empty')
case "$ruta" in
*.env|*.env.*|*/config/database.php)
echo "Bloqueado: $ruta se edita a mano." >&2
exit 2 ;;
esac
exit 0
4. Probarlo antes de confiar en él
Un hook que nunca bloqueó nada puede estar mal escrito. Pruébalo desde la terminal mandándole el mismo JSON que recibiría:
echo '{"tool_input":{"command":"php artisan migrate --force"}}' \
| .claude/hooks/no-produccion.sh; echo "salida: $?"
Si imprime el mensaje y la salida es 2, está funcionando. Después pídele a Claude, dentro de una sesión, algo que choque con la regla y fíjate en que se detenga y explique por qué.
Lo que un hook no resuelve
El hook es la segunda línea de defensa. La primera es que el entorno local no pueda dañar producción aunque quiera: una base de datos de pruebas con datos de muestra, o un usuario de solo lectura si de verdad necesitas ver datos reales. En nuestro caso, lo de las visitas se arregla mejor apagando el contador cuando la aplicación no corre en producción que con cualquier hook.
Guarda .claude/settings.json y la carpeta de hooks en el repositorio. Así todo el equipo trabaja con las mismas reglas y los cambios a esas reglas pasan por revisión igual que el código.
¿Qué comando pondrías primero en tu lista? Si quieres, mándame el tuyo y lo comparamos con el nuestro.