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

00

El problema: por dentro está hecha un desastre

01

Instalación copy-paste como plugin de Claude Code

02

Revisar: dos calificaciones de tu base de datos

03

Entender: te explica qué está mal en español

04

Arreglar: lo corrige pidiéndote permiso

05

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.

Gratis y open-source (MIT)Plugin de Claude CodePostgres, Supabase, Mongo, Redis y másTe pide permiso antes de tocar nada

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-db

2. Instala Claude DB

/plugin install claude-db@claude-db

3. Recarga los plugins

/reload-plugins

¿Usas otro agente? (Cursor, Codex, Gemini CLI, Windsurf)

npx skills add Hainrixz/claude-db

No 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:explain

Aquí 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:fix

Los 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:start

Con /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:start

Te arma la base de datos desde cero con preguntas, sin que tengas archivos todavía.

/claude-db:design

Le describes tu app y te recomienda qué motor usar y te dibuja el primer diseño.

/claude-db:audit

Revisa tu base de datos y te da las dos calificaciones con la lista de qué arreglar.

/claude-db:explain

Te explica en español simple qué está mal y por qué, para que aprendas.

/claude-db:migrate

Revisa o crea los cambios (migraciones) de forma segura y reversible.

/claude-db:fix

Arregla los problemas pidiéndote permiso en cada cambio.

/claude-db:next

Te dice cuál es el arreglo que más te conviene hacer primero.

/claude-db:score

Vuelve a calcular las dos calificaciones cuando ya hiciste cambios.

/claude-db:seed

Te llena la base de datos con datos de prueba bien hechos.

/claude-db:checklist

Te 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.

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.