Casos de uso · Ingeniería

Revisión de código con IA en cada pull request con Claude Code y Codex

Tanto Claude Code como Codex pueden revisar una pull request y dejar comentarios en línea en GitHub. Puedes lanzar tú la revisión, hacer que empiece sola o darle a un empleado de IA el trabajo de revisar todo lo que llegue al tablero. Esta página recoge los comandos de cada opción, las reglas de revisión que vale la pena dejar por escrito, lo que los revisores no harán y cómo convertir la revisión en un trabajo fijo en lugar de algo que tienes que acordarte de pedir.

Tres formas de tener revisión con IA en una pull request

OpciónCómo empiezaDónde se ejecutaIdeal para
/code-review de Claude CodeLo ejecutas tú, con un número de PR; --comment publica comentarios en líneaTu propia sesión de Claude Code, con cualquier planRevisar tu rama o una PR antes de hacer merge
Claude Code Review (gestionado)Un Owner de la organización lo activa para los repositorios; cualquiera puede comentar @claude reviewEl servicio de AnthropicEquipos con planes de Claude que quieren revisiones bajo demanda
Revisión de código de Codex@codex review en un comentario de la PR, o Automatic review en los ajustes de CodexLa nube de OpenAIEquipos con planes de ChatGPT; señala problemas P0 y P1 en GitHub
Un empleado de IAUna issue de revisión en el tablero, o cada PR que se le asignaTu propio Claude Code o Codex, con un heartbeatUn trabajo fijo: cada PR revisada, seguimientos registrados

Cómo revisar una pull request con Claude Code o Codex

  1. Claude Code: ejecuta /code-review

    En una sesión de Claude Code, /code-review busca bugs en los cambios de tu rama; pásale un número de PR para revisar esa pull request y --comment para publicar lo que encuentre en GitHub como comentarios en línea. --fix, en cambio, aplica los arreglos a tu working tree. /review es un alias.

    # Claude Code: revisa una pull request y publica comentarios en línea
    /code-review 142 --comment
    
    # Codex: pide una revisión en un comentario de la PR en GitHub
    @codex review
    @codex review for issues in the database migration
  2. Codex: menciona @codex review

    En un comentario de la pull request, escribe @codex review; Codex reacciona con 👀 y publica una revisión. Añade un foco detrás si quieres uno. Para revisar sin pedirlo, activa Automatic review en los ajustes de Codex y elige el disparador.

  3. Deja tus reglas de revisión por escrito

    Codex lee una sección ## Code Review Rules del AGENTS.md más cercano al código. Para Claude Code, pon las mismas reglas en CLAUDE.md. Las reglas hacen que las revisiones sean coherentes y las apartan de los temas que ya cubre tu linter.

    ## Code Review Rules
    - Señala los tests que faltan en ramas nuevas de billing/ y auth/.
    - Toda migración SQL necesita un rollback; dilo si no lo tiene.
    - No comentes el formato; de eso se encarga el linter.
    - No apruebes nada ni pidas cambios en nada: solo comenta.

Fuente: documentación de Claude Code, revisión local con /code-review

Lo que la revisión con IA no hará

  • Aprobar o bloquear: el Code Review gestionado de Claude nunca aprueba ni bloquea una pull request, y un buen brief de revisión le dice a un empleado que solo comente.
  • Sustituir a la persona responsable del cambio: detecta bugs y tests que faltan; las decisiones de producto y de diseño siguen siendo de personas.
  • Verlo todo: Codex en GitHub solo señala problemas P0 y P1 para mantener los comentarios enfocados. Pide un foco concreto cuando lo necesites.
  • Salir gratis: las revisiones consumen el uso de tu plan. Revisa bajo demanda, o al marcar la PR como lista para revisión, en lugar de en cada push.

Paso a paso con Claude Code y Codex

Los comandos integrados, las herramientas que conectar y el horario de cada agente: Claude Code para revisión de código y Codex para revisión de código.

Con Crewmark

Haz que la revisión sea el trabajo de alguien

Los comandos revisan cuando alguien se acuerda de ejecutarlos. Un empleado de IA revisa porque es su trabajo: Crewmark convierte tu Claude Code o Codex en un ingeniero que se despierta con un heartbeat, toma las pull requests que esperan revisión y las comenta.

  1. Empieza por el rol

    El ingeniero de software de IA, con tus reglas de revisión en su brief.

  2. Lleva las revisiones al tablero

    Asígnale issues de revisión, o añade una issue recurrente para revisar cada pull request abierta marcada como lista.

  3. Más trabajos de ingeniería

    Consulta Claude Code para ingeniería y triaje de errores de Sentry.

Preguntas frecuentes

¿Cómo reviso una pull request con Claude Code?

Ejecuta /code-review <PR number> --comment en una sesión de Claude Code para publicar lo que encuentre como comentarios en línea en GitHub. Sin --comment informa en la sesión; --fix aplica los arreglos en local.

¿/review es lo mismo que /code-review en Claude Code?

La documentación de Claude Code indica que /review es un alias de /code-review.

¿Cómo hago que Codex revise una pull request?

Comenta @codex review en la pull request, o activa Automatic review en los ajustes de Codex para que las revisiones empiecen con el disparador que elijas. La revisión de código tiene que estar activada para el repositorio.

¿Puedo darle al revisor de IA las reglas de nuestro equipo?

Sí. Codex lee una sección ## Code Review Rules en AGENTS.md; para Claude Code, pon las mismas reglas en CLAUDE.md.

¿La IA aprobará o hará merge de las pull requests?

El Code Review gestionado de Claude nunca aprueba ni bloquea, y el merge debería seguir en manos de personas. El brief de un empleado de IA debería decirle que solo comente.

Comprobado con la documentación de revisión de código de Claude Code y la de Codex de OpenAI el 10 de noviembre de 2026.

Cada pull request revisada, sin que nadie tenga que acordarse de pedirlo.

Crewmark convierte sesiones de Claude Code y Codex en empleados de IA con roles, objetivos, horario laboral y un heartbeat.