Qué cambió en la versión 2.1.328
La entrada del registro de cambios realiza tres modificaciones al comando local, todas en la mayoría de los modelos:
- Alcance. La revisión ahora reporta "solo errores y violaciones de CLAUDE.md".
- Etiquetas. Cada hallazgo se marca como Important, Pre-existing o Nit.
- Salida. Cada resumen termina con una corrección sugerida. Una revisión sin nada que reportar ahora lo indica en una sola línea: Code review found no issues.
El calificador "en la mayoría de los modelos" aparece en ambas líneas. El registro de cambios no enumera qué modelos están excluidos. Si tu revisión aún incluye sugerencias de limpieza después de actualizar, el modelo que estás usando puede ser una de las excepciones.
El trabajo de limpieza no ha desaparecido. Se ha movido a un comando separado, y el registro de cambios lo nombra: ejecuta /simplify para limpiezas de reutilización, simplificación y eficiencia.
Por qué la documentación aún describe el alcance antiguo
El día del lanzamiento, la página de revisión local todavía abre con la descripción antigua: "Claude revisa los cambios en tu rama, busca errores de corrección y reporta lo que encontró en tu conversación. Dependiendo de tu modelo y nivel de esfuerzo, la revisión también cubre limpiezas de reutilización, simplificación y eficiencia".
La referencia de comandos tiene una línea coincidente: "Dependiendo de tu modelo y nivel de esfuerzo, la revisión también cubre oportunidades de limpieza".
El registro de cambios es la fuente más reciente. También es más específico, ya que nombra las dos categorías que permanecen. Cuando una nota de lanzamiento y una página de documentación no coinciden el mismo día, la lectura segura es que la página aún no se ha actualizado. Verifica tu versión instalada con claude --version y compárala con la 2.1.328.
Una entrada anterior del registro de cambios muestra cómo esto se ha movido antes. Un lanzamiento cambió la revisión "en esfuerzo medio para reportar también hallazgos de limpieza y convenciones de CLAUDE.md en modelos sin configuraciones de revisión ajustadas, incluyendo Opus 5.5 y Sonnet 5.5". El alcance de /code-review ha cambiado con los modelos y niveles de esfuerzo durante un tiempo. La versión 2.1.328 lo reduce en la mayoría de los modelos.
Qué significan Important, Pre-existing y Nit
El registro de cambios nombra las tres etiquetas sin definirlas para el comando local. El servicio gestionado Code Review en GitHub utiliza las mismas tres etiquetas, y su documentación las define:
- Important: "Un error que debe corregirse antes de fusionar (merge)"
- Nit: "Un problema menor, que vale la pena corregir pero no es bloqueante"
- Pre-existing: "Un error que existe en la base de código pero no fue introducido por este PR"
Pre-existing es la que más vale la pena leer con cuidado. Es un error real, pero tu cambio no lo causó. Eso es útil para decidir el alcance: puedes corregirlo ahora, o registrarlo y manejarlo por separado, sin tratarlo como un bloqueador para tu cambio. El registro de cambios describe las etiquetas como un cambio en el comando local, por lo que antes de este lanzamiento, un error heredado y un error introducido por ti podían aparecer juntos en la misma lista sin esa etiqueta.
Nit cubre problemas menores. En el servicio gestionado, los equipos pueden recalibrar qué cuenta como Nit o Important a través de un archivo exclusivo de revisión. El comando local lee un conjunto diferente de archivos, que se cubren a continuación.
Qué archivos lee la revisión local
Aquí es donde el cambio se conecta con tus instrucciones. La página de revisión local dice: "la revisión sigue tu CLAUDE.md, incluso en una ejecución -p no interactiva. No lee REVIEW.md".
Así que para /code-review en tu máquina, CLAUDE.md es el lugar documentado para las reglas del proyecto. La misma página lo dice directamente: "Para dar a cada revisión reglas de proyecto a seguir, añádelas a tu CLAUDE.md ".
Con el nuevo alcance, esto importa más. Una violación de CLAUDE.md es ahora una de las dos cosas que la revisión reporta en la mayoría de los modelos. Una convención que guardes solo en una wiki de equipo, una plantilla de pull request o en tu cabeza no es una de ellas.
La página de personalización del servicio gestionado traza la misma línea desde el otro lado: "El servicio lee tanto CLAUDE.md como REVIEW.md. El comando /code-review, que ejecutas dentro de una sesión de Claude Code en tu propia máquina, lee tus archivos CLAUDE.md y no REVIEW.md ". Su consejo: "Pon la guía que quieras aplicar en ambos lugares en CLAUDE.md, y reserva REVIEW.md para reglas específicas de la revisión de pull requests".
Para el servicio, la misma página describe cómo se aplica CLAUDE.md: "Un cambio que viole una de sus reglas se convierte en un hallazgo en el nivel de severidad que se ajuste al problema". También dice que el servicio lee el archivo raíz y los archivos CLAUDE.md en los directorios padres de cada archivo cambiado.
Cuándo /simplify es el comando correcto
/simplify es el equivalente para la limpieza. La referencia de comandos lo describe: "Revisa el código cambiado en busca de oportunidades de limpieza y aplica las correcciones". Cuatro agentes de revisión se ejecutan en paralelo, cubriendo la reutilización de helpers existentes, la simplificación, la eficiencia y si el cambio está en el nivel correcto de abstracción.
La misma entrada es explícita sobre el límite: "La revisión no busca errores de corrección. Usa /code-review para encontrar errores".
Hay un historial de nombres que puede confundir a los scripts. La página de revisión local dice: "El comando se llamaba /simplify antes de la v2.1.147, cuando aplicaba correcciones por defecto. Si tenías scripts con /simplify para encontrar errores, cambia a /code-review --fix ".
Así que la división ahora es clara:
/code-reviewencuentra errores y violaciones de CLAUDE.md, y los reporta./simplifyencuentra oportunidades de limpieza y aplica las correcciones.
Ejecútalos en cualquier orden. Un hábito razonable es /code-review primero, para que los problemas de corrección se solucionen antes de que la limpieza remodele el código.
Elegir qué revisar
Sin un objetivo, la página local dice: " /code-review revisa los commits de tu rama por delante de su rama upstream más tus cambios no confirmados". Si la rama no tiene upstream, compara contra main o el commit anterior.
Puedes apuntar a otro lugar escribiendo un objetivo después del nivel de esfuerzo y cualquier flag. Los objetivos documentados incluyen un número de pull request, una rama comparada con otra, un rango de commits y una ruta de archivo o directorio. Una ruta es útil cuando quieres que el nuevo alcance se aplique a un área, como un módulo cuyo CLAUDE.md tiene sus propias reglas.
Para publicar los resultados en lugar de leerlos en la terminal, --comment "publica los hallazgos en un pull request de GitHub como comentarios en línea, o en un merge request de GitLab como una sola nota". Esos comentarios llevan las mismas etiquetas, lo que hace que los de tipo Pre-existing sean fáciles de detectar en un hilo de pull request.
Cuándo Claude inicia la revisión por ti
No siempre escribes el comando tú mismo. La página local enumera dos formas en que Claude puede iniciarlo. La primera es cuando preguntas en lenguaje natural: "pídele a Claude que revise tus cambios y podrá ejecutar la habilidad". La segunda es una tarea programada con alcance de sesión cuyo prompt es /code-review.
Ambas ejecuciones usan el mismo alcance que un comando escrito, por lo que una revisión programada ahora también reporta errores y violaciones de CLAUDE.md. Si prefieres mantener el comando solo para uso manual, la página describe una entrada skillOverrides en un archivo de configuración que hace que la habilidad sea invocable solo por el usuario. Esto evita que Claude y las tareas programadas inicien la revisión mientras mantienen el comando disponible para ti.
Cambiar o reemplazar la revisión
/code-review es una habilidad integrada (bundled skill). La página explica lo que eso significa: "sus instrucciones están integradas en Claude Code, por lo que no hay un archivo SKILL.md en el disco para abrir o editar".
Si el nuevo alcance no se adapta a tu equipo, tienes opciones documentadas. La página dice que "una habilidad de proyecto o personal llamada code-review se ejecuta en lugar de la integrada, y el alias /review sigue ejecutando la revisión integrada". También puedes escribir un subagente revisor o una habilidad de revisión propia.
Antes de reemplazarla, considera la ruta más simple que señala la página primero: pon las reglas en CLAUDE.md. La revisión integrada ya sigue ese archivo, y con el alcance más estrecho, es más probable que una regla clara allí surja como un hallazgo que una larga lista de preferencias.
Escribir reglas que una revisión pueda verificar
Una violación de CLAUDE.md es más fácil de reportar cuando la regla es específica. Una línea que diga que un directorio nunca debe editarse a mano, que cada ruta de API necesita un middleware determinado, o que las pruebas no deben tocar una base de datos de producción, le da a la revisión algo concreto con qué comparar.
Las preferencias vagas, como mantener el código limpio, están más cerca de lo que maneja /simplify. Mantener esas fuera de CLAUDE.md también mantiene el archivo corto, lo que ayuda en cada tarea para la que Claude lo lee, no solo en las revisiones.
Cómo se ejecuta la revisión local
Algunos detalles de la documentación te ayudan a leer los resultados.
Se ejecuta en segundo plano. "En una sesión de terminal, la revisión se ejecuta como un subagente en segundo plano con su propia ventana de contexto, por lo que no llena tu conversación. Los hallazgos llegan a tu conversación cuando se completa la revisión".
Reporta a menos que pidas correcciones. Sin --fix, la página dice: "las instrucciones de la revisión le piden a Claude solo un reporte". Con --fix, las ediciones siguen pasando por tu modo de permiso.
Rewind tiene límites después de una corrección en segundo plano. La página dice que una revisión en segundo plano aplica sus ediciones de --fix fuera de los puntos de control (checkpoints) de tu sesión, y que /rewind restaura solo los archivos que Claude ya había editado en tu conversación. Su consejo para el resto es usar git.
El esfuerzo cambia la cobertura. "En low, la revisión reporta los hallazgos en los que tiene más confianza, por lo que ves menos falsos positivos. Desde medium hasta max, la revisión amplía la cobertura". Cuando no escribes un nivel, la revisión reutiliza el último nivel que escribiste, incluso de una sesión anterior.
La aplicación de escritorio muestra una lista. En una aplicación anfitriona que solicita resultados estructurados, como la aplicación de escritorio, la página dice que cada entrada "muestra la ubicación del archivo, un resumen de una frase y una etiqueta de categoría". Las correcciones también se rastrean: "Cuando Claude corrige los hallazgos reportados más tarde en la sesión, los reporta de nuevo. Claude Code marca entonces cada hallazgo en la lista de hallazgos actualizada como corregido, omitido o sin cambios necesarios". Esa lista de estado es útil mientras trabajas, y dura tanto como la sesión.
Los hallazgos tienen un límite. Puedes subirlo o bajarlo con --max-findings, y donde la revisión reporta a través de la herramienta de hallazgos, el límite documentado es 32.
Cómo difiere de Code Review y ultrareview
Tres herramientas de revisión comparten nombre, y el nuevo alcance se aplica solo a una de ellas.
/code-reviewse ejecuta localmente en tu sesión, lee CLAUDE.md, y ahora reporta errores y violaciones de CLAUDE.md en la mayoría de los modelos.- Code Review, el servicio gestionado, revisa pull requests en GitHub para tu organización y lee tanto CLAUDE.md como REVIEW.md.
- Ultrareview, iniciado con
/code-review ultra, ejecuta una revisión más profunda en la nube.
La página local dice que /review es un alias de /code-review, por lo que el cambio se aplica a ambos nombres.
Cubrimos la opción en la nube, incluyendo qué sube y dónde regresan los hallazgos, en nuestra guía sobre ultrareview en Claude Code.
Lo que la gente intenta primero
Buscar sugerencias de limpieza en /code-review. En la mayoría de los modelos, se han movido a /simplify.
Poner reglas de revisión en REVIEW.md para revisiones locales. El comando local no lo lee. Usa CLAUDE.md.
Tratar cada hallazgo como bloqueante. En el servicio, Nit se define como no bloqueante, y Pre-existing como no introducido por el cambio.
Confiar en la página de documentación por encima del registro de cambios hoy. La página todavía describe el alcance antiguo.
Usar /simplify para encontrar errores. No busca errores de corrección.
La solución: Haz que CLAUDE.md lleve tus reglas de revisión
Paso 1: Actualiza y verifica tu versión
Ejecuta claude --version. El nuevo alcance llegó en la 2.1.328.
Paso 2: Mueve las reglas relevantes para la revisión a CLAUDE.md
Las convenciones que solo viven en una wiki o una plantilla no están en los archivos que lee la revisión local.
Paso 3: Divide tu hábito de revisión
Ejecuta /code-review para errores y violaciones de reglas, luego /simplify para limpieza.
Paso 4: Registra los hallazgos Pre-existing que decidas posponer
Anota cuáles dejaste, por qué y dónde se encuentran.
Configurando esto en MemoryLake
CLAUDE.md es donde Claude Code lee las reglas del proyecto, y mantenerlo corto es parte de usarlo bien. Cierto contexto no pertenece allí: por qué existe una regla, qué errores Pre-existing elegiste posponer, qué áreas siguen produciendo el mismo hallazgo y qué decidiste después de una revisión.
MemoryLake es una capa de memoria para ese tipo de contexto de proyecto, como decisiones de revisión, problemas pospuestos y las razones detrás de tus reglas, mantenidos en un solo lugar que tú controlas y disponibles para los asistentes que conectes, como ChatGPT, Claude Code y Codex.
Tú mismo escribes las entradas, con tus propias palabras. No se lee nada de, ni se escribe en, ni se borra de tus archivos CLAUDE.md, tus sesiones de Claude Code, tus hallazgos de revisión, tus repositorios o el almacenamiento de cualquier proveedor. La revisión de Claude Code funciona de la manera que Anthropic describe.
Paso 1: Crea una clave de API
Inicia sesión y genera una clave desde el panel de control. Guárdala fuera de tus repositorios, como cualquier otra credencial.

Paso 2: Sube tus primeras memorias
Comienza con lo que escribiste en el Paso 4 de la solución: hallazgos pospuestos y las razones. Una decisión por entrada.

Paso 3: Conecta tu IA y agentes
Conecta Claude Code, Codex y los otros asistentes que uses. La próxima revisión o corrección puede partir de las mismas decisiones.

Qué cambia esto en la práctica
La primera diferencia es menos hallazgos repetidos. Un error Pre-existing pospuesto queda registrado con su motivo.
La segunda es un CLAUDE.md más ligero. Las reglas permanecen allí, y la historia detrás de ellas vive en otro lugar.
La tercera es la consistencia entre herramientas. Las mismas decisiones de revisión están disponibles en Claude Code y en otros asistentes.
Mejores prácticas para /code-review
Conoce tu versión. El cambio de alcance llegó en la 2.1.328.
Mantén las reglas en CLAUDE.md. Es el archivo que sigue la revisión local.
Usa REVIEW.md solo para el servicio gestionado. El comando local no lo lee.
Lee las etiquetas. Important debe corregirse antes de fusionar, Nit no es bloqueante y Pre-existing no fue introducido por tu cambio.
Ejecuta /simplify para limpieza. Aplica correcciones y no busca errores.
Elige el esfuerzo a propósito. Low favorece la confianza, niveles más altos amplían la cobertura.
Usa git después de correcciones en segundo plano. Rewind no restaura cada archivo que una revisión en segundo plano editó.
Conclusión
Claude Code 2.1.328, lanzado el 19 de noviembre de 2026, limita /code-review en la mayoría de los modelos a errores y violaciones de CLAUDE.md, marca cada hallazgo como Important, Pre-existing o Nit, y termina cada resumen con una corrección sugerida. La limpieza se movió a /simplify, que aplica correcciones y no busca errores de corrección. La página de documentación local todavía describe el alcance antiguo, así que verifica tu versión contra el registro de cambios.
La revisión local sigue CLAUDE.md y no lee REVIEW.md, que es el que utiliza el servicio gestionado. Con el nuevo alcance, tu CLAUDE.md es una de las dos cosas que la revisión verifica, por lo que las reglas que quieras aplicar localmente pertenecen allí. Mantén las razones y decisiones detrás de ellas en algún lugar que perdure más allá de una sola revisión.