Claude DB: revisa, arregla y arma tu base de datos sin que se te caiga
Por fuera tu app funciona; por dentro la base de datos puede estar hecha un desastre, hasta que borras un usuario y se cae todo. Esta herramienta gratis le conecta a Claude tu base de datos, te dice qué tan bien está armada y si va a aguantar, te lo explica en español y te lo arregla pidiéndote permiso.
De un vistazo
El problema: por dentro está hecha un desastre
Instalación copy-paste como plugin de Claude Code
Revisar: dos calificaciones de tu base de datos
Entender: te explica qué está mal en español
Arreglar: lo corrige pidiéndote permiso
Desde cero: te arma la base de datos
el problema · instalar · revisar · entender · arreglar · desde cero · los 10 comandos
No necesitas saber de bases de datos: tú le hablas normal y Claude DB hace el trabajo
La instalas una vez como plugin de Claude Code (copy-paste), le conectas tu base de datos o le pasas tu esquema, y le pides en español: «revísamela», «explícame qué está mal», «arréglalo». Es de solo lectura por defecto: únicamente toca algo cuando tú le das permiso. Y si apenas vas empezando, te la arma desde cero.
00 el problema
Por dentro está hecha un desastre
Me llegaron estos comentarios sobre bases de datos: «si por borrar un usuario se te rompe la base de datos, está mal diseñada». Y tienen razón. A todos los que hacemos apps con Claude nos pasa: por fuera la app se ve bien y funciona, pero por dentro la base de datos está hecha un desastre… hasta que borras un usuario o mueves algo y ¡pum!, se te cae todo. Una cosa es que se vea bonita y otra que no se caiga cuando ya tengas muchos usuarios.
El nombre técnico de «que tus datos estén bien amarrados entre sí para que nada se rompa» es integridad referencial. Claude DB te lo explica con su nombre y en cristiano, para que de paso aprendas.
01 instalación
Instálala en tres comandos
Claude DB se instala como plugin de Claude Code en tres comandos: lo agregas, lo instalas y recargas. Copia y pega cada uno dentro de Claude Code, en orden.
1. Agrega el marketplace
/plugin marketplace add Hainrixz/claude-db2. Instala Claude DB
/plugin install claude-db@claude-db3. Recarga los plugins
/reload-plugins¿Usas otro agente? (Cursor, Codex, Gemini CLI, Windsurf)
npx skills add Hainrixz/claude-dbNo necesitas instalar nada más: trabaja sin conexión solo con tus archivos. Si quieres que revise tu base de datos real, le pasas la conexión y la lee de forma segura, sin tocarla.
02 revisar
Revisar: las dos calificaciones
Este es el corazón de la herramienta. Le conectas tu base de datos (o le pasas el archivo de tu esquema) y la revisa enterita, de pies a cabeza. Te suelta dos calificaciones separadas, y nunca las mezcla:
Diseño & Integridad
Qué tan bien armada está: si los datos están bien amarrados, las llaves bien puestas y los nombres claros.
Performance & Escala
Si va a aguantar cuando tengas muchos usuarios, o si esa consulta que hoy tarda 50 ms se va a 30 segundos.
No le mueve nada
Revisar es solo lectura: ve tu base de datos pero no le toca nada. Tú decides después qué arreglar.
El comando para revisar
/claude-db:audit "$DATABASE_URL"Cada calificación va de 0 a 100 con su letra (A–F). Una cosa es que tu base de datos se vea bonita y otra que aguante el día que tengas mil usuarios; por eso son dos notas y no una.
Díselo a Claude (revisar)
Si prefieres hablarle normal en vez de usar el comando.
Revísame mi base de datos con Claude DB. Conéctate a mi base de datos (o usa mi archivo de esquema) y dame las dos calificaciones: qué tan bien está armada y si va a aguantar cuando tenga muchos usuarios. Lístame los problemas del más grave al más leve.
03 entender
Entender: te lo explica en español
Una calificación sin explicación no sirve de mucho. El mismo agente te dice qué está mal y por qué, en español simple y sin chorros técnicos, para que tú también aprendas de bases de datos. Si borras un usuario y truena todo, te explica qué te faltaba, cómo se llama y por qué pasó.
El comando para que te explique
/claude-db:explainAquí es donde aprendes: cada problema viene con su nombre real —integridad referencial, índices, normalización— explicado como si te lo contara un amigo, no un manual.
Díselo a Claude (entender)
Para que te explique sin tecnicismos.
Explícame en español simple, sin tecnicismos, qué está mal en mi base de datos y por qué. Si borro un usuario, ¿qué se rompería, cómo se llama ese problema y cómo lo evito?
04 arreglar
Arreglar: con tu permiso en cada cambio
Y no solo te dice qué está mal: te lo arregla. Pero con una regla de oro: te pide permiso en cada cambio para que tú tengas el control de tu base de datos. Nada se aplica solo.
El comando para arreglar
/claude-db:fixLos cambios que pueden borrar datos se marcan como peligrosos y nunca se aplican solos. Siempre ves antes qué va a cambiar y tú das el OK.
¿No sabes por dónde empezar? El comando /claude-db:next te dice cuál es el arreglo que más te conviene hacer primero, y /claude-db:score recalcula tus dos calificaciones cuando ya hiciste cambios.
Díselo a Claude (arreglar)
Que lo corrija, pero contigo al mando.
Arréglame los problemas que encontraste, pero pídeme permiso antes de cada cambio y explícame en una línea qué vas a hacer y por qué. No borres nada sin confirmarme primero.
05 desde cero
Desde cero: te arma la base de datos
¿Apenas vas empezando y ni siquiera tienes base de datos todavía? Claude DB te acompaña desde cero: te hace las preguntas correctas sobre tu app y arma el diseño contigo, para que no te arriesgues desde el inicio. Es como tener a un lado a alguien que ya sabe.
El comando para empezar de cero
/claude-db:startCon /claude-db:start arrancas sin tener nada; con /claude-db:design le describes tu app y te recomienda qué motor usar (Postgres, Mongo, etc.) y te dibuja el primer diseño.
Díselo a Claude (desde cero)
Cuando todavía no tienes nada armado.
Voy a hacer una app de [describe tu app]. Ayúdame a armar la base de datos desde cero: hazme las preguntas que necesites, recomiéndame qué motor usar y propón el diseño para que no se me caiga cuando crezca.
06 referencia
Los 10 comandos de Claude DB
Estos son los 10 comandos de Claude DB. No tienes que aprendértelos: con revisar, entender y arreglar te alcanza para el 90%. El resto están ahí para cuando los necesites.
/claude-db:startTe arma la base de datos desde cero con preguntas, sin que tengas archivos todavía.
/claude-db:designLe describes tu app y te recomienda qué motor usar y te dibuja el primer diseño.
/claude-db:auditRevisa tu base de datos y te da las dos calificaciones con la lista de qué arreglar.
/claude-db:explainTe explica en español simple qué está mal y por qué, para que aprendas.
/claude-db:migrateRevisa o crea los cambios (migraciones) de forma segura y reversible.
/claude-db:fixArregla los problemas pidiéndote permiso en cada cambio.
/claude-db:nextTe dice cuál es el arreglo que más te conviene hacer primero.
/claude-db:scoreVuelve a calcular las dos calificaciones cuando ya hiciste cambios.
/claude-db:seedTe llena la base de datos con datos de prueba bien hechos.
/claude-db:checklistTe da la lista de qué revisar antes de lanzar a producción.
Si quieres una guía más a detalle de esta herramienta, cuéntame para qué estás haciendo tu base de datos y qué app estás armando, y te paso lo que sigue. Y si te sirvió, sígueme y compártelo con alguien que lo necesite.
Cierre de la guía
No tienes que arreglar todo de un jalón. Instálala, córrele un /claude-db:audit, mira tus dos calificaciones y arregla lo más grave primero. Claude DB es gratis y de código abierto; el repo vive en github.com/Hainrixz/claude-db. Esta guía vive en la bóveda de tododeia.
El repo y la documentación
Guías que se conectan con esta
Guía hecha por la comunidad, actualizada al 17 de junio de 2026. Claude DB es una herramienta open-source (MIT) hecha para la comunidad; revisa el repo para lo más reciente, porque los comandos pueden cambiar.