TL;DR Actívalo con
/plugin enable cc-plugin-you-should-know@builtin. Cuando aparezca una nota encima del prompt, pulsa 1 para leer la explicación completa, o 2 si ya lo sabías, y no te volverá a sacar ese tema.
You should know es un mod integrado en Claude Code desde la v2.1.287, apagado por defecto. Mientras Claude trabaja en una tarea larga, un segundo agente revisa la conversación cada 6 pasos y, si encuentra algo que se te puede escapar, te deja una nota encima del prompt. Claude no se para: sigue trabajando mientras tú lees.
Lo que me avisó
Lo probé en un proyecto de prueba: una sincronización de precios contra la API de un proveedor que permite 10 peticiones por segundo y bloquea la clave una hora si te pasas. Le pedí a Claude reintentos, un comando para lanzarla y tests. Claude añadió un freno de unas 8 peticiones por segundo y los tests pasaron. A los 6 pasos salió esto:
✦ Heads up · El límite de 10 peticiones por segundo solo se respeta dentro de una ejecución.
Si dos sincronizaciones coinciden, juntas lo superan y el proveedor bloquea la clave.
1: Learn more 2: Knew this already 0: Dismiss
Pulsé 1:
Dos sincronizaciones a la vez pueden bloquear la clave
- El proveedor permite 10 peticiones por segundo por clave, reintentos incluidos. Si lo
superas, bloquea la clave una hora y la tienda muestra precios viejos.
- El agente principal frena cada ejecución a unas 8 peticiones por segundo. Ese freno
vive dentro del proceso, así que dos procesos no saben el uno del otro.
- Con 200 SKUs, una ejecución dura unos 25 segundos o más si hay reintentos. Si un cron
la lanza a menudo, o alguien la lanza a mano mientras otra está en marcha, juntas
pasan de 16 peticiones por segundo.
- Asegúrate de que nunca corran dos a la vez, por ejemplo con un candado de archivo
(flock) en el cron.
1: Understood 2: Chat in main session 0: Dismiss
Es verdad: el freno es una clase dentro del proceso. Ningún test lo iba a detectar. En otra ejecución de la misma tarea avisó de algo distinto: Claude se había inventado una función list_skus() en el cliente del proveedor, que la API real quizá no tenga, y los tests pasaban porque solo hablan con el cliente simulado.
Las notas salen en el idioma en el que escribes. Con la etiqueta Heads up te avisa de una decisión que Claude ha tomado en esta sesión. Con You should know, de cómo funciona algo que importa para tu trabajo. Si nada supera el listón, no dice nada.
Actívalo
1. Comprueba la versión
claude --version
Necesitas la 2.1.287 o posterior.
2. Activa el mod
Dentro de una sesión:
/plugin enable cc-plugin-you-should-know@builtin
O desde la terminal, y lo tienes en la siguiente sesión:
claude plugin enable cc-plugin-you-should-know@builtin
Para apagarlo, lo mismo con disable. Es uno de los mods que trae Claude Code de serie, como /diff.
Qué hacer con cada nota
| Tecla | En la nota | Después de Learn more |
|---|---|---|
| 1 | Learn more: pide la explicación completa | Understood: la cierra |
| 2 | Knew this already: no te vuelve a ofrecer ese tema | Chat in main session: te pone la nota en el prompt para hablarlo con Claude |
| 0 | Dismiss: la cierra por ahora | Dismiss |
Si sigues enviando prompts sin contestarla, la nota desaparece sola al segundo. Y si las ignoras así varias veces seguidas, el mod se salta revisiones: primero una, luego dos, cuatro, y hasta dieciséis.
Cuánto cuesta
claude plugin details cc-plugin-you-should-know@builtin da 0 tokens fijos por sesión: no añade nada al contexto de Claude. Lo que gasta son las revisiones. Cada una es una petición extra a tu modelo de sesión con la conversación entera, que la API sirve casi toda desde la caché de prompts, y se cobra a tu plan como el resto de la sesión. Hay como mucho una cada 6 pasos de un turno, y una más cada vez que pulsas Learn more. En mis pruebas, cada revisión tardó entre 7 y 12 segundos en segundo plano.
Por eso solo aparece en tareas largas: un turno de menos de 6 pasos no llega a revisarse.
Si no te sale
- Turnos cortos. Lo dicho: con menos de 6 pasos no hay revisión.
- Dónde lo usas. Solo se dibuja en la terminal y en la pestaña Code de Desktop. En el panel de VS Code y en
claude -pno ves nada. - Tu cuenta. Es para sesiones con tu cuenta de Claude y la telemetría activada, y no está disponible en organizaciones con HIPAA o retención cero de datos. Si en
/pluginno lo ves en Installed, con Show disabled, no está disponible para ti. - Para ver si revisa. Arranca con
CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG=1y cada revisión deja una línea comodebug · check 1 · step 6 · shown · 11.5s. Esta variable no está documentada: sale del binario de la v2.1.293.
Documentación oficial: Mods built into Claude Code
Requisitos
- Claude Code v2.1.287 o posterior. Probado en la v2.1.293 con Opus 5.5 el 12 de octubre de 2026.