Qué hace /checkup de Claude Code y cómo usarlo

Tu Claude Code se va llenando de cosas: skills que probaste y no usas, MCPs a medio configurar, un CLAUDE.md que ya no cabe en pantalla, hooks que lo dejan lento. Y ni te enteras.

/checkup es un comando nuevo de Claude Code (lo anunció Boris Cherny, el creador, el 9-jul-2026) que hace todo ese mantenimiento aburrido por ti. Lo escribes, él mira tu setup, te propone limpiezas y mejoras… y te pregunta antes de tocar nada. Aquí tienes qué hace y cómo usarlo.

Cómo usarlo

Tres pasos, y el primero es el que más se salta la gente:

1. Actualiza Claude Code a la última versión. /checkup es tan reciente que si no estás al día, probablemente ni te aparezca el comando. Actualiza primero (de hecho, /checkup también te actualiza solo — pero para eso primero tiene que existir en tu instalación).
2. Ejecuta /checkup. Lo escribes en tu sesión y él analiza tu setup: skills, MCPs, plugins, tu CLAUDE.md, tus hooks, tus permisos.
3. Revisa y confirma. No toca nada por su cuenta. Te lista lo que propone cambiar y tú apruebas lo que quieras, punto por punto. Si algo no te convence, lo dejas como está.

Qué te limpia y te mejora

Esto es lo que /checkup mira y te ofrece arreglar (y “algún extra más”):

• Limpia skills, MCPs y plugins que no usas — y con eso te libera contexto. Menos ruido cargado, más espacio para lo que importa.
• Quita lo repetido de tu CLAUDE.md local comparándolo con el CLAUDE.md commiteado. Deduplica para que no tengas la misma instrucción dos veces.
• Parte tu CLAUDE.md raíz gigante en varios CLAUDE.md anidados por carpeta + skills. En vez de un tocho, contexto que se carga solo donde hace falta.
• Apaga los hooks lentos — esos automatismos que se disparan solos y te ralentizan la sesión sin que lo notes.
• Te actualiza Claude Code a la última versión.
• Activa el auto mode por defecto, para que no tengas que ir dándole a todo a mano.
• Pre-aprueba comandos de solo lectura que sueles denegar. Los que solo miran (leer archivos, listar, buscar) dejan de pedirte permiso cada vez.

Todo esto no se ejecuta a lo loco: es una propuesta. /checkup te lo enseña y tú decides qué entra.

Antes de flipar: es nuevo

Sin humo:

• Es muy reciente. Si el comando no te aparece, no es que hagas nada mal: es que no estás en la última versión. Actualiza y vuelve a probar.
• No es magia. No reescribe tu proyecto ni “arregla cualquier cosa”. Hace el mantenimiento aburrido por ti — que ya es bastante.
• Los resultados dependen de tu setup. Cuanto más desordenado lo tengas, más notarás la limpieza. Si tu config ya está fina, propondrá poco.
• Nunca toca nada sin tu OK. Este es el punto que quita el miedo: confirma cada cambio contigo antes de aplicarlo.

Regla de oro

El mantenimiento de tu setup es la típica tarea que sabes que deberías hacer y nunca haces. /checkup la hace por ti y te pide permiso antes de tocar nada. Actualiza, ejecútalo cada par de semanas, y revisa lo que te propone. Eso es todo.

---

Sígueme para más trucos con Claude Code e IA → @pabloinpublic

Únete a la comunidad → pabloinpublic.com