La mayoría de apps con problemas de datos no fallan por el código sino por una base de datos mal diseñada desde el principio — sin restricciones, sin índices, sin integridad referencial. Claude DB es una herramienta open-source que conecta Claude Code directamente a tu base de datos para auditarla, explicar los problemas en español simple y aplicar correcciones solo con tu permiso explícito. Útil tanto para founders que están solos manejando su stack como para equipos pequeños sin un DBA dedicado.
Una app puede parecer funcional durante meses y tener la base de datos completamente rota por dentro. El problema clásico: borras un usuario y el sistema se cae porque hay tablas relacionadas que nadie limpió, registros huérfanos, claves foráneas que no existen o índices que nunca se crearon. Eso es un problema de integridad referencial, y es más común de lo que parece en proyectos que arrancaron rápido.
Claude DB resuelve esto conectando Claude Code a tu base de datos con un flujo de trabajo basado en permisos: primero lee, luego explica, y solo modifica cuando el usuario lo autoriza explícitamente. Es open-source (MIT), no requiere instalación offline y soporta Postgres, Supabase, MongoDB y Redis.
Dentro de Claude Code, tres comandos:
/plugin marketplace add Hainrixz/claude-db
/plugin install claude-db@claude-db
/reload-plugins
Si usás otro agente (no Claude Code), la alternativa es:
npx skills add Hainrixz/claude-db
| Comando | Para qué sirve |
|---|---|
/claude-db:audit |
Revisa toda la base con doble calificación (ver abajo) |
/claude-db:explain |
Explica los problemas en español sin jerga |
/claude-db:fix |
Aplica correcciones con permiso por cada cambio |
/claude-db:next |
Lista reparaciones ordenadas por prioridad |
/claude-db:score |
Recalcula las calificaciones después de cambios |
/claude-db:migrate |
Gestiona migraciones de forma segura y reversible |
/claude-db:seed |
Puebla la base con datos de prueba |
/claude-db:checklist |
Verifica si la base está lista para producción |
/claude-db:start |
Diseña una base desde cero con preguntas guiadas |
/claude-db:design |
Analiza la descripción de tu app y recomienda un motor |
El comando /claude-db:audit "$DATABASE_URL" devuelve dos notas separadas, cada una en escala 0-100 con letra (A-F):
Diseño e Integridad: Evalúa la calidad estructural. Relaciones entre tablas, existencia de claves foráneas, restricciones de unicidad, normalización básica. Una base con calificación D aquí es una bomba de tiempo: cualquier operación sobre datos relacionados puede romper consistencia.
Performance y Escala: Evalúa capacidad bajo carga. Índices en columnas de búsqueda frecuente, consultas que van a full scan en tablas grandes, configuración del motor para el volumen esperado. Una base puede tener diseño perfecto (A en integridad) y desempeño pésimo (D en performance) si nunca se pensó en cómo va a crecer.
Tener dos notas separadas importa porque el diagnóstico y la solución son distintos. Problemas de diseño requieren migraciones y posible restructuración de datos. Problemas de performance generalmente se resuelven con índices y configuración, sin tocar los datos.
Revísame mi base de datos en $DATABASE_URL.
Dame las dos calificaciones (diseño e integridad, performance y escala).
Lístame los problemas del más grave al más leve.
El resultado es una lista priorizada. Podés pedirle que se quede en los top 3 problemas si la base tiene muchas issues y querés atacar lo más crítico primero.
Explícame en español simple qué está mal y por qué.
¿Qué se rompería si borro un usuario?
¿Qué pasa si dos personas editan el mismo registro al mismo tiempo?
Esta es la parte más útil para founders no especializados en bases de datos. En lugar de obtener un error técnico, obtenés una explicación de consecuencias reales en términos de negocio.
Arréglame los problemas que encontraste.
Pídeme permiso antes de cada cambio.
No borres ningún dato sin confirmarme primero.
El flujo de permisos es la parte más importante de la herramienta. Cada modificación requiere confirmación explícita. Los cambios que implican eliminar datos se marcan como peligrosos y requieren una confirmación adicional. Nada se ejecuta automáticamente.
Voy a hacer una app de [descripción de tu producto].
Ayúdame a armar la base de datos desde cero.
No soy experto en bases de datos, explicame las opciones.
El comando /claude-db:start guía con preguntas: tipo de datos, volumen esperado, relaciones principales, requisitos de consistencia. Al final recomienda un motor (Postgres para la mayoría de los casos, MongoDB si el esquema es muy variable, Redis para caché o sesiones) y genera el esquema inicial.
Lo que no reemplaza: un DBA experimentado para sistemas con millones de registros, requisitos de compliance (PCI, HIPAA) o arquitecturas distribuidas complejas. Para proyectos de 0 a escala media, cubre la mayor parte del trabajo de diagnóstico.
El código fuente y la documentación completa están en github.com/Hainrixz/claude-db. Hay versiones de la documentación en español e inglés. Los comandos pueden cambiar entre versiones, conviene verificar contra el repositorio si algo no funciona como se describe aquí.