Skip to main content
/code-review es un comando que escribes en el prompt de Claude Code, en la sesión donde estás trabajando. Claude revisa los cambios de tu rama, busca bugs de corrección e informa lo que encontró en tu conversación. Según tu modelo y tu nivel de esfuerzo, la revisión también abarca limpiezas de reutilización, simplificación y eficiencia. El comando funciona en cualquier plan. La revisión se ejecuta en tu propia sesión, así que cuenta para el uso de tu plan o la facturación de la API de la misma manera que el resto de la sesión.
Para que cada pull request de un repositorio se revise automáticamente en GitHub, consulta Code Review, un servicio administrado que un Owner activa para tu organización.
/review es un alias de /code-review. Antes de la v2.1.223, /review era un comando independiente que ejecutaba una revisión de una sola pasada y de solo lectura de un pull request de GitHub.
1

Ejecuta /code-review

Ejecuta el comando:
Sin un objetivo, la revisión abarca los cambios de tu rama actual. Para apuntar la revisión a un pull request, otra rama, una ruta o un rango de commits, consulta Elige qué revisar.También puedes agregar flags:
  • --fix: también le pide a Claude que aplique los hallazgos a tu árbol de trabajo después de la revisión. Sus ediciones pasan por tu modo de permisos.
  • --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
2

Sigue trabajando

La revisión se ejecuta como un subagente en segundo plano con su propia ventana de contexto, así que no llena tu conversación. Los hallazgos llegan a tu conversación cuando la revisión termina.
3

Actúa sobre los hallazgos

Pídele a Claude que corrija lo que encontró la revisión. Con --fix o --comment, Claude aplica o publica los hallazgos como parte de la revisión, y es posible que se te pida aprobar sus ediciones.

​
Elige qué revisar

Para revisar algo distinto de tu rama actual, escribe un objetivo después del nivel de esfuerzo y de cualquier flag. Claude recibe ese texto como el objetivo de la revisión. Un objetivo puede ser un número de pull request, un nombre de rama, una ruta de archivo o un rango de revisiones de Git. Busca lo que quieres revisar en la primera columna y escribe lo que muestra la segunda columna: Sin un objetivo, /code-review revisa los commits de tu rama que van por delante de su rama upstream, además de tus cambios sin commit. Si la rama no tiene upstream, Claude compara con main, o con el commit anterior. Con ultra, Claude Code interpreta el objetivo de otra manera, como se describe en Texto después del nivel de esfuerzo y los flags.

​
Qué lee y edita la revisión

Revisa estos puntos antes de ejecutar una revisión, especialmente con --fix:
  • Ediciones: sin --fix, las instrucciones de la revisión le piden a Claude solo un informe. Con --fix, también le piden que aplique los hallazgos a tu árbol de trabajo. En cualquier caso, toda edición pasa por tu modo de permisos.
  • Retroceder: una revisión en segundo plano aplica sus ediciones de --fix fuera de los checkpoints de tu sesión. Después de una, /rewind restaura solo los archivos que Claude ya había editado en tu conversación. Las ediciones de la revisión en otros archivos se mantienen, así que usa git para revertirlas. Cuando la revisión se ejecuta en primer plano, edita tu árbol de trabajo durante tu propio turno, así que /rewind restaura sus ediciones como de costumbre.
  • Instrucciones: la revisión sigue tu CLAUDE.md, incluso en una ejecución no interactiva con -p. No lee REVIEW.md. Ese archivo configura el servicio Code Review administrado en pull requests de GitHub.

​
Cómo se informan los hallazgos

Claude informa los hallazgos como texto en la respuesta en ambas de estas ejecuciones:
  • En una sesión de terminal, donde /code-review ejecuta la revisión como un subagente bifurcado
  • En una ejecución con -p con salida de texto o JSON
En una aplicación host que solicita la lista de hallazgos, como la aplicación de escritorio, Claude informa los hallazgos de la revisión a través de la herramienta ReportFindings en su lugar. El informe aparece como una lista de hallazgos, y cada entrada muestra la ubicación del archivo, un resumen de una oración y una etiqueta de categoría como correctness cuando el hallazgo tiene una. Una solicitud del host aplica en todos los niveles de esfuerzo y requiere Claude Code v2.1.218 o posterior. Cuando Claude corrige hallazgos informados más adelante en la sesión, los informa de nuevo. Luego, Claude Code marca cada hallazgo en la lista actualizada como corregido, omitido o sin cambios necesarios.

​
Ajusta el esfuerzo y los argumentos

Además de --fix y --comment, el comando acepta estos flags:
  • --post: en una revisión en la nube con ultra de un pull request de github.com, preselecciona publicar los hallazgos finales en el PR en el diálogo de inicio. Consulta Publicar los hallazgos en el pull request. Requiere Claude Code v2.1.227 o posterior.
  • --max-findings <n>, --max-findings all o --max-findings default: informa hasta n hallazgos, o todos los hallazgos con all, en lugar del límite habitual de la revisión. Cuando la revisión informa a través de la herramienta de hallazgos, el límite es 32. Las revisiones posteriores reutilizan el valor que escribiste hasta que pases --max-findings default, pero un valor pasado en una ejecución no interactiva con -p no se recuerda. Requiere Claude Code v2.1.288 o posterior.
Pasa un nivel de esfuerzo para equilibrar cobertura y confianza. En low, la revisión informa los hallazgos de los que tiene más certeza, así 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 entre low y max que escribiste, incluso en una sesión anterior. Claude Code muestra un aviso como Reusing high effort, the level you typed last time. Estas reglas deciden qué nivel usa una ejecución:
  • Escribir un nivel: un nivel que escribes, como /code-review high, cambia lo que reutilizan las ejecuciones posteriores
  • Ejecuciones no interactivas: un nivel que pasas en una ejecución no interactiva con -p no actualiza el nivel recordado
  • ultra: la revisión no usa ni actualiza el nivel recordado
  • Nunca se escribió un nivel: la revisión usa el esfuerzo actual de la sesión
Antes de la v2.1.223, un /code-review sin nivel siempre usaba el esfuerzo actual de la sesión.

​
Publicar los hallazgos en un merge request de GitLab

Cuando pasas --comment para un merge request de GitLab, Claude Code publica los hallazgos a través de la CLI glab de GitLab. Requiere Claude Code v2.1.257 o posterior. Cuando glab no está instalado, Claude imprime los hallazgos en la terminal en su lugar. Pasa el merge request como su URL o como una referencia !123. Claude Code trata un número o un nombre de rama sin más como un merge request solo cuando el origin del checkout está en gitlab.com. En una instancia de GitLab autoadministrada, pasa la URL o la forma !123.

​
Texto después del nivel de esfuerzo y los flags

Después del nivel de esfuerzo y los flags, Claude Code lee el resto de la línea como el objetivo de la revisión. El argumento ultra cambia esa interpretación:
  • Con ultra: Claude Code lee una sola palabra como una rama base o un número de PR. Un texto más largo que no nombra una rama ni un PR se convierte en una nota adjunta a la revisión. /code-review ultra check my auth changes revisa tu rama actual, y Claude relaciona los hallazgos con tu nota.
  • Sin ultra: todo lo que queda es el objetivo de la revisión, incluso cuando empieza con el nombre de otro comando. /code-review /fix-issue 123 revisa con /fix-issue 123 como texto del objetivo en lugar de cargar /fix-issue como un segundo skill apilado. Antes de la v2.1.218, un comando apilado después de /code-review se expandía como su propio skill.

​
Ejecutar en primer plano

Para que la revisión se ejecute en primer plano, haz una de estas cosas:
  • Ejecútala en modo no interactivo, con el flag -p o el Agent SDK. Claude Code espera la revisión e incluye los hallazgos en la respuesta, excepto con ultra, que no espera la revisión en la nube.
  • Establece CLAUDE_CODE_DISABLE_BACKGROUND_TASKS en 1, lo que también desactiva todas las demás funciones de tareas en segundo plano
  • Ejecuta /code-review de nuevo mientras una revisión anterior sigue en curso
Antes de la v2.1.218, la revisión se ejecutaba dentro de tu conversación.

​
Deja que Claude inicie la revisión

Claude puede iniciar /code-review por su cuenta, sin que escribas el comando:
  • Cuando lo pides en lenguaje natural: pídele a Claude que revise tus cambios y puede ejecutar el skill
  • Desde una tarea programada: una tarea programada con /code-review como prompt ejecuta la revisión
Una tarea programada nunca inicia la revisión en la nube, así que programa /code-review sin el argumento ultra. Para evitar que tanto Claude como las tareas programadas inicien la revisión, manteniendo /code-review disponible para que lo escribas tú, agrega una entrada skillOverrides a un archivo de configuración como ~/.claude/settings.json:
Antes de la v2.1.246, Claude iniciaba /code-review por su cuenta solo donde un feature flag obtenido de Anthropic lo activaba. En sesiones que no obtienen feature flags, /code-review se ejecutaba solo cuando lo escribías, y un /code-review programado llegaba a Claude como texto plano.

​
Escalar a ultrareview

/code-review ultra --fix ejecuta el ultrareview más profundo en la nube y luego le pide a Claude que aplique sus hallazgos a tu árbol de trabajo cuando regresen a tu sesión. Ultrareview usa su propio alcance:
  • Qué compara: tu rama actual frente a la rama predeterminada del repositorio, además de los cambios sin commit y los cambios preparados (staged) en el árbol de trabajo
  • Archivos sensibles: para los cambios sin commit en archivos con nombres de credenciales o claves, como los archivos .env y *.tfvars, Claude Code sigue las reglas para subir un repositorio local a una sesión en la nube
  • Una base diferente: pasa un nombre de rama, como /code-review ultra develop, para comparar con una base diferente
Cuando el objetivo es un pull request de github.com, puedes hacer que Claude publique los hallazgos finales en el PR como un comentario desde tu cuenta de GitHub. Requiere Claude Code v2.1.227 o posterior.
Ultrareview requiere autenticación con una cuenta de claude.ai. No está disponible en Amazon Bedrock, Agent Platform de Google Cloud ni Microsoft Foundry, ni para organizaciones con Zero Data Retention habilitado o con la configuración HIPAA aplicada. En estos casos, /code-review ultra ejecuta una revisión local en tu sesión en su lugar. Las organizaciones que usan claves de cifrado administradas por el cliente (CMEK) no pueden ejecutar ultrareview. Para revisar tus cambios localmente, ejecuta /code-review.
Para ejecutar una revisión en la nube desde un script o un job de CI, usa el subcomando claude ultrareview, que espera los hallazgos y los imprime en stdout.

​
Modifica la revisión o construye sobre ella

/code-review es un skill incluido: sus instrucciones están integradas en Claude Code, así que no hay ningún archivo SKILL.md en disco que abrir o editar. Para darle a cada revisión reglas del proyecto que seguir, agrégalas a tu CLAUDE.md. Para ir más allá, empieza desde una de estas páginas:
  • Reemplazar el comando: un skill de proyecto o personal llamado code-review se ejecuta en lugar del incluido, y el alias /review sigue ejecutando la revisión incluida. Consulta Resolver skills que comparten nombre.
  • Crear tu propio revisor: escribe un subagente revisor o un skill de revisión
  • Usar un comando cercano: /simplify revisa solo para limpieza y aplica sus correcciones, y /verify ejecuta tu aplicación para confirmar que un cambio funciona
El comando se llamaba /simplify antes de la v2.1.147, cuando aplicaba correcciones de forma predeterminada. Si tenías scripts con /simplify para encontrar bugs, cámbialos a /code-review --fix.
  • Code Review: el servicio administrado que revisa cada pull request en GitHub para tu organización
  • Ultrareview: configuración, límites y costo de la revisión en la nube más profunda
  • Comandos: la referencia de una línea para /code-review, /review, /simplify y /verify
  • Skills: cómo funcionan los skills incluidos y cómo escribir los tuyos