01 Para qué sirve
Muchas aplicaciones hechas con ayuda de IA funcionan bien en la demo y fallan al crecer: borras un cliente y quedan pedidos huérfanos, una consulta que tardaba nada empieza a tardar segundos, o los importes se guardan como números de coma flotante y aparecen céntimos fantasma. Casi siempre el origen está en el diseño de la base de datos, que nadie revisó.
Claude DB pone a Claude a hacer de administrador de bases de datos sénior. Lee tus archivos de esquema (SQL, Prisma, modelos de un ORM, migraciones) o, si quieres, se conecta a la base de datos en modo solo lectura, y devuelve una lista priorizada de problemas con la evidencia y un comando para comprobar cada uno.
Diseño e integridad
Normalización, claves primarias, claves foráneas y qué ocurre al borrar, tipos de datos, restricciones, nombres, seguridad y datos personales.
Rendimiento y escala
Índices que faltan o sobran, consultas problemáticas, concurrencia, pool de conexiones, particionado y seguridad de las migraciones.
Varios paradigmas
Relacional (Postgres, MySQL, SQLite, SQL Server), documentos (MongoDB, Firestore), clave-valor, vectorial, series temporales y grafos.
Honesto por diseño
No inventa latencias, número de filas ni precios. Si una comprobación necesita la base de datos en vivo, lo dice en lugar de darla por buena.
02 Instalación
-
1
Abre Claude Code en tu proyecto
Entra en la carpeta de la aplicación que quieres revisar y arranca Claude Code.
-
2
Añade el marketplace del plugin
Escribe el primer comando del bloque inferior dentro de Claude Code.
-
3
Instala y recarga
Instala el plugin y recarga los plugins para que los comandos /claude-db: estén disponibles sin reiniciar.
/plugin marketplace add Hainrixz/claude-db
/plugin install claude-db@claude-db
/reload-pluginsnpx skills add Hainrixz/claude-db03 Auditar: las dos notas
El comando principal es /claude-db:audit. Le pasas una ruta a tus archivos o una variable con la cadena de conexión. Devuelve dos puntuaciones de 0 a 100 con letra de la A a la F, y nunca las promedia: un esquema puede estar impecablemente modelado y hundirse con carga, o ser rapidísimo y corromper datos en silencio. Un fallo crítico, como una tabla sin clave primaria o datos personales sin control de acceso por filas, deja la nota de ese eje en F aunque el resto esté bien.
/claude-db:audit "prisma/schema.prisma"
/claude-db:audit "database/migrations"
/claude-db:audit "$DATABASE_URL"| Nivel de datos | Qué necesita | Qué añade |
|---|---|---|
| 0 (por defecto) | Nada | Auditoría completa a partir de archivos o descripción |
| 1 | Una conexión de solo lectura o un MCP de base de datos | Índices reales, estado de seguridad por filas, versión del motor |
| 2 | Estadísticas de ejecución del motor | Planes de consulta reales, índices sin uso, filas muertas, particiones calientes |
04 Entender y priorizar
Una nota sin explicación no sirve de mucho. /claude-db:explain toma un archivo, una tabla o un hallazgo concreto y te cuenta qué pasa, cómo se llama el concepto (integridad referencial, índice compuesto, normalización…) y por qué importa. También acepta una consulta concreta para responder a «¿por qué va lenta esta query?».
Si la lista es larga, /claude-db:next te dice cuál es el arreglo con más impacto, y /claude-db:score recalcula las notas después de tus cambios.
Con Claude DB, explícame los tres hallazgos más graves de la auditoría como si se los contaras a alguien que sabe programar pero no es experto en bases de datos. Para cada uno: qué puede pasar en producción con un ejemplo de nuestro dominio [p. ej. pedidos y clientes], cómo se llama el problema y cuánto esfuerzo supone corregirlo.05 Reparar con control
Las órdenes de auditoría, explicación, puntuación, prioridad y lista de comprobación son de solo lectura. Solo /claude-db:fix escribe, y Claude no puede lanzarlo por su cuenta. Genera archivos de migración reversibles y pensados para no bloquear tablas (índices concurrentes, restricciones que se validan en dos pasos, cambios de columna en fases), te enseña el diff y espera tu confirmación en cada cambio. Se niega a trabajar si tienes cambios sin confirmar en git, y las operaciones destructivas solo se proponen como aviso.
/claude-db:fix "database/migrations" --category keys --dry-run
/claude-db:fix "database/migrations" --category indexing- ✓Haz commit de tu trabajo antes de ejecutar el fixer.
- ✓Empieza con --dry-run para ver los cambios sin escribir nada.
- ✓Lee cada migración generada: tú respondes de lo que llega a producción.
- ✓Prueba las migraciones en local o en preproducción con datos realistas.
- ✓Ten una copia de seguridad reciente antes de aplicarlas en producción.
06 Si todavía no tienes base de datos
/claude-db:start es un asistente sin jerga: te hace siete preguntas sencillas sobre tu aplicación y te recomienda qué construir. /claude-db:design va más directo: le describes el producto y, opcionalmente, la escala esperada, y te propone motor, primer esquema y diagrama. Después, /claude-db:seed genera datos de prueba que respetan las relaciones, y /claude-db:checklist te da una tabla de «listo o no listo» antes de salir a producción.
/claude-db:design "Aplicación de reservas para una cadena de 4 clínicas de fisioterapia: pacientes, profesionales, salas, citas, bonos de sesiones y facturas. Necesitamos historial de cambios en las citas y poder borrar los datos de un paciente si lo pide (RGPD)." --scale medium07 Los diez comandos
| Comando | Para qué |
|---|---|
| /claude-db:start | Asistente guiado para empezar sin archivos |
| /claude-db:design | Recomienda motor y propone esquema y diagrama |
| /claude-db:audit | Dos notas y lista priorizada de problemas |
| /claude-db:explain | Explica un hallazgo, una tabla o una consulta lenta |
| /claude-db:migrate | Revisa una migración o genera una a partir de dos esquemas |
| /claude-db:fix | Corrige con vista previa y confirmación por cambio |
| /claude-db:next | El siguiente arreglo con más impacto |
| /claude-db:score | Recalcula las notas |
| /claude-db:seed | Datos de prueba coherentes con las relaciones |
| /claude-db:checklist | Revisión de preparación para producción |
Preguntas frecuentes
No directamente. Genera archivos de migración y solo los escribe tras tu confirmación en cada cambio. Aplicarlos a la base de datos sigue siendo decisión tuya, con tu herramienta habitual.
Sí. Lee archivos de migraciones, esquemas SQL y modelos de ORM. Con archivos generados el análisis es más fiable que si solo tiene el código fuente, y con una conexión de solo lectura mejora todavía más.
No. Detecta el paradigma y cambia los criterios de puntuación, de modo que una base de documentos se evalúa por patrones de acceso, crecimiento de documentos o clave de fragmentación.
El plugin es de código abierto con licencia MIT. Solo consumes el uso de tu plan de Claude durante el análisis.
Cada hallazgo indica su nivel de confianza y cómo verificarlo. Úsalas como guía para priorizar, no como certificado: los cambios importantes conviene revisarlos con alguien que conozca el sistema.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.