Claude AI para ISPs en Ecuador: De lo Básico a lo Avanzado

Lección 5.3 — Hooks, Comandos y Personalización Avanzada

Módulo 5: Claude Code & Automatización

📚 Conceptos básicos

Usa las flechas o los puntos para navegar entre diapositivas

Módulo 5 · Lección 5.3

Hooks y
Comandos

Personalización avanzada para adaptar Claude Code a la operación de tu ISP

🎓 Claude AI para ISPs en Ecuador

Hooks

¿Qué son los Hooks de Claude Code?

Los hooks son scripts que se ejecutan automáticamente antes o después de acciones específicas de Claude Code.

🪝

Pre-Commit Hooks

Se ejecutan antes de cada commit: validan código, ejecutan linters, verifican estándares y previenen errores en producción.

✅

Post-Commit Hooks

Se ejecutan después del commit: notifican al equipo, actualizan dashboards, disparan pipelines de despliegue automático.

⚙️

Custom Hooks

Crea hooks personalizados para tu ISP: verificar configuraciones de red, validar cambios en firewalls, auditar modificaciones.

Slash Commands

Comandos Personalizados (Slash Commands)

⚡

/diagnostico — Diagnóstico de Red

Crea un comando que ejecute automáticamente ping, traceroute y verificación de servicios en los nodos de tu red ISP.

📊

/reporte — Generar Reporte

Un comando que recopile métricas de tráfico, estado de equipos y alertas activas, y genere un reporte ejecutivo automático.

🔧

/backup — Verificar Backups

Comando que revise el estado de backups de configuraciones de routers, switches y servidores, alertando sobre backups antiguos.

Configuración

Configuración de Claude Code para tu ISP

Personaliza el comportamiento de Claude Code con archivos de configuración

CLAUDE.md — Contexto del Proyecto

Define las reglas de tu ISP: topología de red, convenciones de nombres, estándares de configuración y políticas internas.

.claude/settings.json — Preferencias

Configura modelos preferidos, permisos de ejecución, directorios protegidos y límites de acción automatizada.

.claude/commands/ — Comandos Custom

Carpeta donde defines tus slash commands personalizados con plantillas de prompts específicas para tu operación.

Hooks Directory — Automatización

Scripts que se ejecutan en momentos clave: pre-tool-use, post-tool-use, pre-commit y notificaciones automáticas.

Ejemplo Real

Hooks en Acción: ISP

Cómo un ISP usa hooks para proteger su infraestructura

🛡️

Pre-Tool-Use

Antes de ejecutar comandos en servidores, el hook verifica que no se modifiquen archivos críticos de routing sin aprobación.

📝

Post-Tool-Use

Después de cada cambio, se genera un log automático con timestamp, usuario y descripción del cambio para auditoría.

🔔

Notificación

Un hook envía alertas por Telegram o Slack cuando Claude Code modifica configuraciones de red en horario no laboral.

Personalización

Tres Niveles de Personalización

👤

Usuario

Modelo preferido (Opus/Sonnet)
Atajos de teclado
Formato de salida
Idioma y región

📁

Proyecto

CLAUDE.md con contexto ISP
Comandos del equipo técnico
Hooks de validación
Permisos por directorio

🏢

Organización

Políticas de seguridad
Modelos permitidos
Límites de uso
Integraciones aprobadas

Mejores Prácticas

Tips de Personalización

Maximiza el valor de Claude Code en tu equipo técnico

📋

Documenta tu CLAUDE.md

Incluye la topología de red, IPs de gestión, credenciales de acceso (referenciadas, no hardcodeadas) y procedimientos estándar del ISP.

🔒

Hooks de Seguridad Primero

Implementa hooks que bloqueen acciones destructivas: borrar configuraciones, modificar ACLs o reiniciar servicios críticos sin confirmación.

👥

Comparte Comandos con el Equipo

Crea un repositorio compartido de slash commands para que todo el equipo técnico use los mismos estándares y procedimientos.

Productividad

Personalización en Números

60%

Menos errores en producción con hooks de validación pre-commit

Más rápido ejecutando tareas repetitivas con slash commands

100%

Auditable: cada acción de Claude Code queda registrada con hooks

📊 Basado en equipos de DevOps usando Claude Code en producción — 2025

Repaso

Puntos Clave de esta Lección

✅

Hooks automatizan validaciones y notificaciones antes y después de cada acción de Claude Code.

✅

Slash commands personalizados aceleran tareas repetitivas: diagnósticos, reportes y verificaciones.

✅

CLAUDE.md y archivos de configuración adaptan Claude Code al contexto específico de tu ISP.

✅

Tres niveles de personalización: usuario, proyecto y organización para máximo control.

📘 Guía de Estudio (PDF)

Guía completa de esta lección 5.3 – Hooks, Comandos y Personalización con ejemplos prácticos.

💡 Tips y Conceptos Clave

💡 Tip: Empieza con un CLAUDE.md Básico

No necesitas documentar todo desde el día uno. Comienza con un CLAUDE.md que incluya: nombre del ISP, topología básica de red, herramientas que usas (Mikrotik, Ubiquiti, etc.) y convenciones de tu equipo. Itera y mejora con el tiempo.

⚠️ Importante: Nunca Hardcodees Credenciales

En tu CLAUDE.md y archivos de configuración, nunca incluyas contraseñas o claves API directamente. Usa variables de entorno o referencia a un gestor de secretos. Claude Code respeta las variables de entorno del sistema.

🧠 ¿Sabías Que?: Hooks son Scripts Normales

Los hooks de Claude Code son scripts bash o Python normales. Si ya tienes scripts de validación o notificación en tu ISP, puedes reutilizarlos como hooks sin modificación. Solo necesitas colocarlos en el directorio correcto.

✏️ Ejercicios Prácticos

Crea tu CLAUDE.md

Escribe un archivo CLAUDE.md para tu ISP que incluya: descripción de la red, equipos principales (marca y modelo), convenciones de nombres para interfaces y VLANs, y los 5 procedimientos más comunes de tu equipo técnico.

Tu Primer Slash Command

Crea un slash command /estado-red que le pida a Claude Code verificar: ping a los 3 routers principales, estado de interfaces WAN, y uso de CPU/memoria. Documenta el prompt en un archivo .md en la carpeta .claude/commands/.

Hook de Seguridad

Diseña (en papel o pseudocódigo) un hook pre-tool-use que bloquee cualquier intento de eliminar archivos de configuración o ejecutar comandos de reinicio en servidores de producción. Identifica los patrones que debe detectar.

🎬 Video Complementario

Refuerza los conceptos de esta lección con este video explicativo.

📚 Recursos Complementarios

📖 Claude Code Hooks — Documentación

Guía oficial sobre hooks en Claude Code: tipos, configuración y ejemplos de implementación.

⚡ Slash Commands — Claude Code

Cómo crear y gestionar comandos personalizados para acelerar tu flujo de trabajo.

📋 CLAUDE.md Best Practices

Mejores prácticas para escribir un CLAUDE.md efectivo que maximice la utilidad de Claude Code.

🔧 Claude Code Settings

Referencia completa de opciones de configuración: permisos, modelos y personalización.

🎯

Resumen Final — Lección 5.3

La personalización es lo que convierte a Claude Code de una herramienta genérica en el asistente perfecto para tu ISP. Con hooks, slash commands y un buen CLAUDE.md, tu equipo técnico trabaja más rápido, con menos errores y con total trazabilidad de cada acción.

✅ Hooks pre/post acción ✅ Slash commands custom ✅ CLAUDE.md para ISPs