Revisión de código en Claude Code: /code-review, skills y effort
Cómo funciona el comando /code-review integrado: apúntelo a una rama o PR, lea hallazgos clasificados con prueba e impacto, ajuste el effort y --max-findings, y ponga la revisión en cada pull request.
En corto
- La revisión viene integrada — /code-review (o su alias /review) examina los commits que su rama lleva por delante de upstream más los cambios sin confirmar, y corre en segundo plano.
- Los hallazgos llegan clasificados — Important, Nit, Pre-existing — cada uno con prueba concreta, impacto y un arreglo que puede aplicar con --fix.
- La profundidad es un dial: el effort low, medium, high y max se recuerda entre sesiones, ultra escala a una ultrarevisión en la nube y --max-findings (v2.1.288+) limita o amplía el informe.
- En GitHub, la app de Claude revisa las PR según su disparador y comenta en línea; su check run siempre cierra neutral, así que nunca bloquea un merge.
Introducing Code Review
Canal: Anthropic · Claude0:45
Anthropic's NEW Claude Code Review Agent
Canal: Patrick Ellis29:56
Claude Code release notes — v2.1.288
Notas de versión: github.com/anthropics/claude-code
Review pull requests with Claude Code — official docs
Documentación: code.claude.com/docs
Los hechos de esta página están cotejados con la documentación oficial de code review y el changelog v2.1.288; los fotogramas vienen de los dos vídeos de arriba, verificados uno a uno. El comportamiento descrito corresponde a Claude Code v2.1.288 (octubre de 2026).
Las capturas son fotogramas de «Introducing Code Review» de Anthropic y de «Anthropic's NEW Claude Code Review Agent» de Patrick Ellis, usados con atribución y enlazados al minuto de origen en cada paso.
La revisión de código, paso a paso
Lanzar la revisión
- 1
Actualice Claude Code y lance el comando
La revisión viene integrada — no hay plugin que instalar. Actualice a v2.1.288 o superior para tener los flags nuevos, escriba /code-review (la forma antigua /review hoy es un alias) y pulse enter. La revisión arranca en segundo plano y usted sigue trabajando.
Anthropic anunció el revisor integrado con su propia tarjeta de título.Ver en 0:07 - 2
Apunte la revisión al diff correcto
Sin argumentos, /code-review revisa los commits que su rama lleva por delante de upstream más sus cambios sin confirmar. Para apuntar a otra cosa, pásele una ruta de archivo, un número de PR, una rama o un rango como main...my-feature.
Elija el repo y describa la tarea antes de que arranque la sesión de revisión.Ver en 0:08 - 3
Déjelo correr en segundo plano
La revisión es un agente propio: su prompt queda libre mientras lee el código. Vuelva a ejecutar /code-review para traer al primer plano una revisión en curso, o fuerce el primer plano con el modo print o CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1.
El estado Starting Claude Code significa que la revisión ya va rodando.Ver en 0:12 - 4
Lea hallazgos clasificados con prueba e impacto
Cada hallazgo va marcado Important, Nit o Pre-existing y muestra prueba concreta, impacto y arreglo propuesto — en la demo oficial se atrapa un bug de IDOR calificado CVSS 9.1 Critical en un pull request real.
Prueba, impacto y arreglo de un hallazgo, tal como los publica el bot.Ver en 0:23
Convertir hallazgos en arreglos
- 5
Lleve los hallazgos al pull request
Añade --comment para publicar cada hallazgo como comentario en línea en la PR de GitHub (las MR de GitLab van por glab desde v2.1.257). La app de GitHub de Claude deja los hallazgos igual cuando la revisión corre en github.com.
El bot de Claude comenta bajo el diff, con botón de resolver por hilo.Ver en 0:18 - 6
Aplique los arreglos con --fix o con un pegado
Ejecuta /code-review --fix y los hallazgos aceptados se aplican a su árbol de trabajo. O pega una sugerencia de vuelta en su sesión — la demo edita el archivo y va marcando los todos sin que la empuje.
La sesión recorre la lista de arreglos todo por todo mientras miras.Ver en 0:14 - 7
Revise otra vez hasta que el diff converja
Repetir /code-review tras los arreglos re-revisa lo que cambió, así que la segunda pasada es barata — a las re-revisiones se les pide converger, no reabrir discusiones. Cuando todas las tareas estén marcadas, empuje y abra el PR desde la misma sesión.
Todas las tareas completas y la sesión lista para crear el PR.Ver en 0:24 - 8
Limite o amplíe con --max-findings
Nuevo en v2.1.288: /code-review --max-findings 5 o --max-findings all anula el límite habitual, y su elección se reutiliza en revisiones siguientes hasta que pase --max-findings default para restaurarlo.
Un hallazgo crítico publicado con severidad, prueba y arreglo propuesto.Ver en 0:20
Ajustar profundidad, automatización y reglas
- 9
Suba el effort al máximo, o vaya a ultra
Las revisiones aceptan effort low, medium, high y max — y recuerdan su última elección entre sesiones: escríbalo una vez. /code-review ultra escala a una ultrarevisión en la nube; combínelo con /code-review ultra --fix, o contrólelo desde CI con claude ultrareview.
La profundidad de revisión es un dial, justo al lado del selector de modelo.Ver en 0:04 - 10
Instale la app de GitHub de Claude para cada PR
Un Owner puede activar Code Review en los ajustes de administración, lo que instala la app de GitHub de Claude. Elija un disparador por repo — una vez tras crear la PR, tras cada push o manual — y luego comente @claude review en cualquier PR abierta.
Un clic en Setup autoriza a la app de GitHub de Claude a leer código.Ver en 0:02 - 11
Enséñele sus reglas de la casa
Cada CLAUDE.md de la ruta se respeta y las violaciones nuevas se marcan como nits. La revisión alojada además lee un REVIEW.md en la raíz del repo — redefinir severidades, limitar nits, omitir rutas o ramas, fijar la barra de verificación — y skillOverrides puede reservar la skill a ejecuciones manuales.
Una rúbrica de revisión de seguridad en markdown, sacada del repo de Anthropic.Ver en 18:30
/code-review vs /review vs /security-review vs /simplify vs ultra
Claude Code trae una pequeña familia de comandos de revisión y es fácil confundirlos. Esto es cuándo toca cada uno.
- 1/code-review — la cacería de bugs por defecto. Revisa los commits que la rama lleva por delante de upstream más los cambios sin confirmar, clasifica hallazgos por severidad y corre en segundo plano mientras sigue trabajando.
- 2/review — el mismo comando. Desde v2.1.223 /review es un alias de /code-review; antes era una revisión de PR aparte, de una pasada y de solo lectura — por eso los tutoriales antiguos la describen de otra manera.
- 3/security-review — la pasada enfocada en seguridad, construida sobre el playbook open source de Anthropic. Solo caza vulnerabilidades — en la demo de Patrick Ellis atrapó una falsa API key plantada — y también viene con Claude Code.
- 4/simplify — limpieza, no cacería de bugs. Aplica refactors directos y formateo sin juzgar la corrección. Si tiene un guion viejo que usaba /simplify para buscar bugs, apúntelo a /code-review --fix.
- 5ultra — la escalada a la nube. /code-review ultra manda todo el diff de la rama contra la rama por defecto a una revisión en la nube más profunda; encadénelo con --fix para aplicar el resultado en local, o pilotéelo desde CI con claude ultrareview.
El reparto práctico: /code-review es su bucle interno por defecto mientras programas, /security-review brilla en autenticación, pagos y todo lo que toca tokens, y ultra va para las migraciones arriesgadas que si no le pediría a un compañero que revisara. La limpieza puramente estilística es trabajo de /simplify — que no es una revisión en absoluto.
¿La revisión calla, habla demasiado o no aparece en GitHub? Primeros auxilios
Casi todo problema de revisión de código se arregla con una línea. Repase esta lista antes de tocar los ajustes.
- 1«Unknown command» o un comportamiento que coincide con tutoriales viejos — actualice Claude Code. --max-findings pide v2.1.288+, el alias /review llegó con v2.1.223 y --comment en MR de GitLab pide v2.1.257+.
- 2La revisión termina y «no encuentra nada» — el límite por defecto mantiene informes cortos. Repita con --max-findings all para levantarlo y esté atento a los marcadores Nit y Pre-existing, no espere solo al Critical.
- 3Se esfumó al segundo plano — es a propósito. Vuelva a ejecutar /code-review para reconectar con la revisión en curso, o pon CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 si la quiere siempre en primer plano.
- 4Parece que ignora sus reglas — el /code-review local sigue CLAUDE.md pero jamás lee REVIEW.md, que pertenece a la revisión alojada de GitHub. Las listas específicas del repo van en REVIEW.md; el estilo personal o de proyecto, en CLAUDE.md.
- 5Los pull requests se quedan sin revisión en GitHub — revise el disparador del repo (una vez tras crear la PR, cada push, manual), confirme que quien comenta tiene acceso write o superior, y recuerda que los PR de fork solo se revisan tras un comentario explícito de @claude review.
Una trampa más: el check run siempre se llama Claude Code Review y siempre cierra con conclusión neutral, así que la protección de rama nunca bloqueará un merge por su culpa. ¿Quiere bloquear? Parsee la línea de resumen bughunter-severity del check run en su propio job de CI y haga fallar el build ante hallazgos Important.