![Imagen de portada de [Claude Code #9] /code-review, de low a ultra](/assets/images/posts/3a3c5139-78d7-4952-be11-c771eeb272d4/claude-code-review-effort-levels.jpg)
A veces da reparo hacer commit directamente del código generado por IA. Antes de llamar a un revisor humano, hace falta un filtro inicial.
/code-review de Claude Code cumple esa función. Inspecciona los cambios de la rama actual y encuentra errores y oportunidades de limpieza.
En este artículo se repasan paso a paso los niveles, desde la intensidad ajustable en local hasta la inspección exhaustiva ultra en la nube.
Los niveles de effort tratados en Claude Code, parte 8 también se aplican a la intensidad de la revisión.
El comportamiento predeterminado inspecciona los cambios de mi rama
La revisión comienza al introducir /code-review en la sesión.
Según Documentación oficial, el objetivo predeterminado son los commits de la rama que están por delante de upstream y los cambios aún no confirmados. Informa de errores de corrección y oportunidades de reutilización, simplificación y mejora de la eficiencia.
También se pueden especificar otros objetivos: rutas de archivos, números de PR, nombres de ramas y rangos como main...my-feature.
De forma predeterminada, la revisión se ejecuta como un subagente en segundo plano dentro de su propio contexto. No ocupa la conversación y, al terminar, solo devuelve los resultados.
Niveles: confianza o cobertura
Añadir un nivel de effort, como /code-review high, cambia la intensidad de la revisión.
- low·medium: solo informa de los hallazgos con mayor confianza. Menos falsos positivos
- high·xhigh·max: amplía la cobertura. También puede incluir hallazgos menos seguros
Si se omite el nivel, se reutiliza el último nivel introducido manualmente. La interfaz también muestra un aviso como «Se reutiliza el nivel high introducido la última vez».
¿Solo buscar problemas o también corregirlos?
--fix: aplica directamente los hallazgos al árbol de trabajo cuando termina la revisión--comment: publica los hallazgos como comentarios en línea del PR
--fix tiene una salvedad. Las modificaciones de la revisión en segundo plano se realizan fuera del punto de control de la sesión, por lo que no se pueden revertir con /rewind. Si no convencen, hay que revertirlas con git.
ultra: revisión multiagente en la nube
/code-review ultra opera a una escala diferente. Es un ultrareview en el que varios agentes investigan en paralelo desde la nube.
El alcance también cambia. Compara la rama actual con la rama predeterminada del repositorio e incluye los cambios sin commit. También se puede cambiar la rama base de comparación, como en /code-review ultra develop.
Documentación oficial de ultrareview requiere autenticación con una cuenta de claude.ai. Pro·Max permite probarlo gratis 3 veces; después, cada revisión consume aproximadamente entre 5 y 25 dólares en créditos de uso.
Si el objetivo es un PR de github.com, el diálogo previo a la ejecución muestra la opción de publicar el resultado como comentario en mi cuenta. Al añadir --post, esa opción queda preseleccionada, pero aun así se vuelve a preguntar si se desea publicar (v2.1.227 o posterior).
Para los commits diarios bastan los niveles locales, mientras que ultra encaja en momentos importantes, como la comprobación final antes de una versión. En entornos donde ultra no está disponible, como Bedrock, el comando cambia silenciosamente a una revisión local.
Diferencias con los comandos relacionados
Hay otros dos comandos con nombres parecidos.
/simplify: comando exclusivo de limpieza que solo ordena y simplifica, y aplica las correcciones, sin buscar errores/security-review: inspecciona exclusivamente las vulnerabilidades de seguridad de los cambios
Usa /code-review para buscar errores y /simplify para pulir el código.
Ajustar los criterios de revisión
Las revisiones locales siguen las reglas del proyecto en CLAUDE.md, como cualquier otra sesión. Si escribes las convenciones del equipo en CLAUDE.md, también se reflejan en las revisiones.
También existe Code Review administrado para añadir revisiones automáticas a los PR de GitHub, exclusivo de Team·Enterprise. Allí los criterios se ajustan mediante el archivo específico REVIEW.md, pero el /code-review local no lee ese archivo.
Resumen
Como hábito antes del commit, /code-review es suficiente. Usa low·medium si priorizas la confianza y high o superior para revisar de forma más amplia.
Para delegar también las correcciones, usa --fix; para una revisión exhaustiva antes de publicar, sube a ultra.
En el próximo artículo veremos un conjunto de comandos de diagnóstico para consultar el estado de la sesión, incluidos /doctor, /context y /usage.
Fuentes y criterios de verificación
- Documentación oficial de Claude Code — Code Review (Anthropic, comprobado el 2026-08-14)
- Documentación oficial de Claude Code — Ultrareview (Anthropic, comprobado el 2026-08-14)
Seguir leyendo
Serie de Claude Code
- Artículo anterior: [Claude Code #2] /plan, modo de planificación: acordar el diseño antes de modificar
- Artículo anterior: [Claude Code #1] /init, empezar generando CLAUDE.md automáticamente