Agentes de code review: qué son y cómo se usan

Los agentes de code review son sistemas de IA que revisan cambios de código para señalar posibles fallos. En Claude Code Review para GitHub, varios agentes leen cada cambio junto al código que lo rodea y comentan en las líneas afectadas. Sus avisos no aprueban ni bloquean la pull request (PR): la decisión de hacer merge queda en manos del equipo.

En Claude Code puedes recibir una revisión sobre una PR de GitHub o ejecutar /code-review en tu sesión de trabajo. El servicio sobre GitHub informa en la PR; el comando local informa en la conversación. Son dos formas de incorporar la revisión al trabajo con una rama.

Qué revisan los agentes en una pull request

La documentación de Code Review describe una revisión que busca errores de lógica, vulnerabilidades de seguridad y fallos en casos límite. Habla de Several agents (varios agentes), que examinan los cambios junto con el código de su entorno.

Como ejemplo hipotético, imagina una rama que añade aplicar_descuento(total, cupon) a una tienda online. La función aplica el descuento sin comprobar si el cupón ha caducado. Antes de señalarlo como un error, hay que comprobar si el código que llama a la función ya valida la caducidad.

Ese contexto cambia la interpretación del diff. Si la validación tampoco existe en el código que la llama, el aviso tendría fundamento. Si ya existe, su ausencia dentro de la función no basta para demostrar un fallo. La revisión sirve para localizar posibles problemas que después debes contrastar con el código.

Cómo usar /code-review en tu sesión

Para revisar la rama antes de abrir la PR, puedes escribir /code-review en el prompt de Claude Code, dentro de la sesión donde trabajas. Según la documentación de la revisión local, el comando revisa los cambios de tu rama, busca errores de funcionamiento e informa de los hallazgos en la conversación.

En el ejemplo del descuento, el flujo sería:

1. Preparas los cambios de la función en tu rama.
2. Escribes /code-review en la sesión de Claude Code.
3. Contrastas cada hallazgo con el código, incluida la posible validación previa del cupón.
4. Corriges los fallos confirmados antes de abrir la PR.

Cuando la revisión informa mediante la herramienta de hallazgos, el límite documentado es 32 hallazgos. Esa condición importa: no es un límite general de todos los informes de /code-review. Tampoco permite deducir cuántos errores contiene una rama ni garantiza que dividirla haga aflorar todos sus fallos.

Cómo orientar la revisión con REVIEW.md

Para la revisión de PR en GitHub, REVIEW.md permite expresar los criterios del equipo. La guía de personalización lo define como un archivo de instrucciones exclusivas para revisiones: indica qué señalar, con qué severidad y qué omitir.

En la tienda del ejemplo, puedes pedir que se prioricen los descuentos con cupones caducados y se omitan los comentarios de formato. Esta plantilla propone instrucciones para ese caso; sus encabezados no representan un formato obligatorio:

# Instrucciones de revisión

## Prioridad alta
- Señalar descuentos aplicados con cupones caducados.

## Omitir
- Comentarios de estilo y formato.
- Archivos generados en build/.

Estas instrucciones expresan qué quiere revisar el equipo. No garantizan que el agente detecte todos los incumplimientos. El uso de REVIEW.md descrito aquí corresponde al servicio de revisión de PR en GitHub.

Cómo interpretar los avisos y cuál es su límite

Si el agente señala la falta de validación del cupón, comprueba el recorrido del código antes de corregirlo. Puedes resolver el hallazgo, descartarlo con un motivo o trasladarlo a otra tarea. Una revisión sin comentarios tampoco certifica que la función sea correcta: el agente puede pasar por alto errores.

En Claude Code Review para GitHub, los comentarios no sustituyen la aprobación humana ni impiden por sí solos el merge. La revisión humana y las comprobaciones del proyecto siguen siendo necesarias para evaluar el cambio.

El alcance de esta explicación es Claude Code Review sobre PR de GitHub y el uso básico de /code-review en una sesión, según la documentación del 11/11/2026, sin fijar una versión concreta de Claude Code. No cubre la configuración del servicio en una organización ni otras herramientas de revisión. El límite de 32 hallazgos se aplica únicamente cuando el comando informa mediante la herramienta de hallazgos.

Fuentes y proceso