/code-review es el comando de Claude Code que revisa los cambios de tu rama antes de que abras un pull request: busca errores de correctitud, informa lo que encuentra en la conversación y, si se lo pides, aplica los arreglos. Funciona en cualquier plan, corre en segundo plano y se controla con un nivel de esfuerzo, unas pocas banderas y un objetivo (rama, PR, rango o carpeta). Esta guía resume lo que dice la documentación oficial.
Qué es y qué cambió
Según la documentación oficial, Claude revisa los cambios de tu rama, busca fallos de correctitud y reporta el resultado en tu conversación (la frase textual: «looks for correctness bugs»). Dependiendo del modelo y del nivel de esfuerzo, la revisión también puede cubrir reutilización de código, simplificaciones y mejoras de eficiencia.
Es una habilidad incluida en Claude Code (una skill integrada, sin archivo SKILL.md en disco) que se ejecuta como un subagente en segundo plano con su propia ventana de contexto, así que no llena tu conversación. Tiene un alias, /review. La documentación indica que antes de la versión 2.1.223 /review era otro comando, un revisor de PR de una sola pasada y solo lectura, y que el comando se llamaba /simplify antes de la 2.1.147, cuando aplicaba arreglos por defecto. Si tenías scripts con /simplify para buscar errores, la guía oficial recomienda pasar a /code-review --fix.
Las notas de versión también tocan este comando en las versiones 2.1.328 y 2.1.329, pero el registro de cambios de GitHub no trae fechas, así que no puedo decirte el día exacto. Lo que describen: la 2.1.328 enfoca el informe en errores y violaciones de CLAUDE.md, y la 2.1.329 hace que, sin objetivo, revise la rama completa frente a la rama por defecto. Ojo: la página de documentación aún describe el objetivo por defecto de otra forma (lo vemos abajo), así que comprueba tu versión con claude --version.
Requisitos
- Claude Code instalado y una sesión iniciada dentro de un repositorio git (la revisión se apoya en el historial y en los cambios sin confirmar).
- Cualquier plan: la revisión local corre en tu propia sesión y cuenta contra tu uso del plan o contra la facturación de la API, igual que el resto de la sesión.
- Para
--commenten GitLab hace falta la herramientaglab, y esa bandera requiere la versión 2.1.257 o superior según la documentación.
Paso a paso
1. Revisar la rama actual
Dentro de la sesión de Claude Code, escribe el comando sin argumentos:
/code-review
Sin objetivo, la documentación dice que revisa los commits de tu rama por delante de su upstream más tus cambios sin confirmar. Si la rama no tiene upstream, compara contra main o contra el commit anterior. Mientras trabaja, puedes seguir conversando: corre en segundo plano.
2. Elegir qué revisar
Puedes pasar un objetivo al final. Estos son los ejemplos de la documentación:
/code-review 1234
/code-review main...mi-rama
/code-review HEAD~15..HEAD
/code-review src/auth
En orden: un pull request por número, una comparación entre ramas, un rango de commits y una carpeta. Para un solo commit se usa el rango abc1234^..abc1234. La documentación muestra un número de PR para el comando local; las URL pegadas aparecen documentadas solo para el modo ultra y para merge requests de GitLab.
3. Ajustar el esfuerzo
El primer argumento puede ser un nivel: low, medium, high, xhigh, max o ultra. En low la revisión reporta solo los hallazgos de los que está más segura; de medium a max amplía la cobertura. Si no escribes nivel, reutiliza el último que tecleaste (verás un aviso del tipo «reutilizando high»). Ultra no usa ni actualiza esa memoria.
/code-review high
/code-review xhigh src/auth
4. Aplicar arreglos o comentar en el PR
| Bandera | Qué hace |
|---|---|
--fix | Aplica los hallazgos a tu árbol de trabajo tras revisar. Los cambios pasan por tu modo de permisos. |
--comment | Publica los hallazgos como comentarios en línea en un PR de GitHub, o como una nota única en un MR de GitLab. |
--max-findings n|all|default | Limita cuántos hallazgos se reportan (o todos con all). Con la herramienta de hallazgos el tope es 32; requiere 2.1.288 o superior. |
Un detalle importante: los cambios que --fix hace en segundo plano quedan fuera de los puntos de control de /rewind, así que si no te convencen tendrás que revertirlos con git. Revisa antes el estado de tu árbol con un commit limpio. Para entender los modos de aprobación que aplican a esas ediciones, mira permisos y modos en Claude Code.
Cómo interpretar el resultado
En la terminal y en ejecuciones no interactivas con -p, el informe llega como texto en la respuesta. En la app de escritorio, la documentación indica que se muestra con una herramienta de hallazgos que incluye ubicación del archivo, un resumen de una frase y, opcionalmente, una categoría como correctitud o cobertura de pruebas. Para el comando local no encontré etiquetas de severidad en la documentación; los niveles de severidad aparecen en el servicio gestionado de Code Review para GitHub, que es un producto distinto.
La revisión sigue tu CLAUDE.md, también en ejecuciones con -p. Eso significa que las reglas de tu proyecto influyen en lo que marca. Si aún no tienes uno, empieza con el ejemplo comentado de CLAUDE.md. El archivo REVIEW.md no lo lee este comando: solo configura el servicio gestionado.
Costos, seguridad y la variante ultra
La revisión local no tiene un precio propio: consume tu plan o tu API como cualquier otra tarea, así que un nivel alto sobre una rama grande gastará más. La variante /code-review ultra es otra cosa: corre en un entorno en la nube, tarda aproximadamente de 15 a 25 minutos y requiere iniciar sesión en claude.ai. No está disponible en Bedrock, Google Cloud ni Foundry, ni con retención cero de datos; en esos casos cae a una revisión local. Según la documentación, las cuentas Pro y Max tienen tres ejecuciones gratuitas de una sola vez y después suele costar entre 5 y 25 dólares en créditos de uso. Es una vista previa de investigación y puede cambiar.
Sobre seguridad: --fix escribe en tu repositorio, así que úsalo en una rama aparte. Y si automatizas revisiones, puedes impedir que Claude las lance por su cuenta con la opción skillOverrides en user-invocable-only, según la documentación. Para automatizar acciones alrededor de tus flujos, mira también los hooks de Claude Code.
Qué significa para quien programa
Antes de pedir revisión humana, una pasada con /code-review sobre tu propia rama atrapa errores obvios y te ahorra idas y vueltas. No sustituye a una persona: la documentación habla de errores de correctitud, no de decisiones de diseño. Un flujo razonable es revisar en medium, corregir lo importante a mano, y reservar xhigh o ultra para cambios delicados. Como el comando no pasa ninguno de estos pasos por ti, tú decides qué hallazgos tienen sentido.
Preguntas frecuentes
¿En qué se diferencia /code-review de /simplify?
Según la documentación, /simplify revisa solo limpieza (reutilización, simplificación, eficiencia) y aplica sus arreglos; /code-review busca errores de correctitud y puede, según modelo y esfuerzo, sumar esas mejoras.
¿Puedo revisar un PR de otra persona?
Sí, pasando su número: /code-review 1234. Con --comment puede publicar los hallazgos en GitHub, pero revisa antes qué va a escribir: es un mensaje público.
¿Cuánto cuesta?
La revisión local cuenta contra tu plan o tu facturación de API como el resto de la sesión. Solo la variante ultra tiene precio propio, tras tres ejecuciones gratuitas por cuenta en Pro y Max.
Fuentes
- Revisar localmente con /code-review (documentación oficial)
- Ultrareview (documentación oficial)
- Referencia de comandos de Claude Code
- CHANGELOG.md de Claude Code en GitHub
Última revisión: 20 de noviembre de 2026. Este artículo fue preparado con ayuda de IA; consulta cómo usamos la IA. Los comandos vienen de la documentación oficial y no se ejecutaron para esta guía.
