Cómo Claude Code se integra en tu flujo de trabajo de GitHub Pull Request
Un pull request es la unidad de trabajo en torno a la cual la mayoría de los equipos ya se organizan: una rama, un diff, una revisión y una fusión.
//
Busca en todas las páginas de la documentación
Un pull request es la unidad de trabajo en torno a la cual la mayoría de los equipos ya se organizan: una rama, un diff, una revisión y una fusión.
Claude Code no introduce un flujo de trabajo nuevo junto a ese.
En su lugar, se integra en el ciclo de vida del pull request que ya ejecutas, en tres puntos específicos: al abrir un PR, al revisar un PR y al enviar commits de seguimiento que abordan los comentarios de la revisión.
Comprender exactamente dónde se encuentran esos tres puntos de contacto es lo que hará que el resto de los artículos de esta sección tengan sentido.
gh o un trabajo de CI.gh, modo sin supervisión (headless), revisión automatizada, commit de seguimiento.gh, modo sin supervisión, revisión automatizada de CI, GitHub Actions.Un pull request típico pasa por un pequeño número de etapas reconocibles: se crea una rama, se confirman los cambios, se abre un PR contra una rama base, los revisores dejan comentarios, el autor envía commits de seguimiento y, finalmente, el PR se fusiona.
Claude Code puede intervenir en tres de esas etapas.
Abrir un PR. Después de que Claude Code realiza cambios en una sesión de trabajo, puede confirmar esos cambios y abrir un pull request directamente, utilizando el comando pr create de la CLI de gh desde dentro de la misma sesión.
Revisar un PR. Claude Code también se puede ejecutar contra un PR existente para dejar comentarios de revisión, ya sea interactivamente a petición de un desarrollador o automáticamente como parte de un trabajo de CI que se activa cada vez que se abre o actualiza un PR.
Responder a los comentarios de revisión. Una vez que un humano (o una revisión automatizada) deja comentarios en un PR, Claude Code puede leer esos comentarios, realizar los cambios de código correspondientes y enviar un commit de seguimiento a la misma rama.
La forma más sencilla de visualizar esto: dondequiera que una persona normalmente escribiría un comando git o gh a mano, Claude Code puede ejecutar ese mismo comando en su nombre, desde dentro de una sesión que ya tiene abierta.
Los tres puntos de contacto difieren en quién los inicia y dónde se ejecuta Claude Code.
Abrir un PR y responder a los comentarios de revisión suelen ser iniciados por una persona que trabaja con Claude Code de forma interactiva en una terminal. El desarrollador le pide a Claude Code que confirme y abra un PR, o que aborde los comentarios de un PR específico, y la sesión ejecuta los comandos gh necesarios como parte de la respuesta a esa solicitud.
La revisión automatizada es diferente: normalmente la activa GitHub, a través de un flujo de trabajo de GitHub Actions que se dispara cada vez que se abre o actualiza un pull request. En ese contexto, no hay una persona observando la sesión en tiempo real, por lo que se ejecuta en modo sin supervisión (headless), invocando Claude Code de forma no interactiva en lugar de a través de su REPL de terminal normal.
# Interactivo: un desarrollador le pide a Claude Code que abra un PR desde la sesión actual.
# Claude Code ejecuta el comando gh subyacente como parte de la respuesta a la solicitud.
gh pr create --title "Añadir limitación de tasa al endpoint de búsqueda" --body "Soluciona #482"Ese mismo comando gh pr create es exactamente lo que un trabajo de GitHub Actions también podría ejecutar; la diferencia no es el comando, sino si hay un humano presente para escribir la solicitud o si la solicitud provino de un disparador de CI y una indicación de script.
Este es el cambio mental clave: abrir, revisar y responder a los PR no son tres integraciones separadas. Son la misma capacidad subyacente (una sesión de Claude Code que puede ejecutar comandos gh y git) invocada desde dos contextos diferentes: una sesión de terminal interactiva y un trabajo de CI sin supervisión.
Una vez que un equipo tiene Claude Code abriendo PRs de forma interactiva, el siguiente paso natural suele ser automatizar el lado de la revisión: un trabajo de GitHub Actions que ejecuta Claude Code sin supervisión en cada PR y deja comentarios sin que nadie necesite solicitarlo.
Esa revisión automatizada no reemplaza el proceso de revisión existente de un equipo. Se ejecuta junto con los revisores humanos requeridos y cualquier regla de protección de ramas ya configurada en el repositorio; añade una señal, no elimina una puerta de acceso.
Los tres puntos de contacto también se componen a lo largo de la vida de un solo PR. Una sesión podría abrir el PR, y luego horas o días después, una vez que un humano o la revisión automatizada dejan comentarios, una sesión separada (interactiva o sin supervisión) retoma el PR para enviar un commit de seguimiento que aborde esa retroalimentación. Nada requiere que la misma sesión maneje todas las etapas.
| Punto de Contacto | Típicamente Iniciado Por | Modo Típico |
|---|---|---|
| Abrir un PR | Un desarrollador, en medio de una sesión | Interactivo |
| Revisar un PR | Un disparador de CI, o una solicitud de desarrollador | Sin supervisión (CI) o interactivo |
| Responder a comentarios | Un desarrollador, después de que los revisores opinen | Interactivo, a veces sin supervisión |
Un equipo que adopta los tres puntos de contacto termina teniendo Claude Code presente en casi todos los pasos de la vida de un PR, excepto en la decisión real de fusión, que sigue siendo una decisión humana, aplicada de la misma manera que siempre a través de la protección de ramas y la configuración de aprobaciones requeridas de GitHub.
gh que un desarrollador escribiría a mano; no hay una herramienta separada para abrir y otra para revisar.Necesita lo que la propia CLI de gh necesita: un repositorio al que la cuenta autenticada pueda enviar (push) y contra el cual pueda abrir PRs, igual que si una persona ejecutara los comandos a mano.
Claude Code puede ejecutar los comandos para abrir, revisar o comentar un PR, pero la fusión sigue pasando por las reglas de aprobación y protección de ramas que el repositorio ya aplica.
La capacidad subyacente es la misma; la diferencia es solo el disparador y el modo: un desarrollador que solicita una revisión se ejecuta interactivamente, mientras que un trabajo de CI lo ejecuta sin supervisión cada vez que se dispara un evento de PR.
No. Abrir un PR y responder a los comentarios de revisión funcionan bien desde una sesión interactiva usando la CLI de gh; GitHub Actions solo se vuelve necesario cuando quieres que el paso de revisión se ejecute automáticamente sin una persona presente.
A través de la CLI de gh, la propia herramienta oficial de línea de comandos de GitHub, que Claude Code ejecuta de la misma manera que un desarrollador la ejecutaría a mano desde una terminal.
Esa es una preocupación de configuración, no una propiedad inherente; un trabajo de CI puede configurarse para dejar un único comentario consolidado por actualización de PR en lugar de un comentario por línea, dependiendo de cómo estén escritos el prompt de revisión y el flujo de trabajo.
El flujo típico es realizar el cambio de código solicitado y enviar un commit de seguimiento; eso es lo que realmente aborda la retroalimentación en lugar de simplemente responder a ella.
No, cualquier modelo de la línea actual puede ejecutar estos comandos gh y git; la elección del modelo afecta la calidad de la revisión o los cambios de código, no si la integración de GitHub en sí funciona.
Nada cambia en esa regla; el comentario de revisión o el commit de seguimiento de Claude Code aún necesita la aprobación humana requerida antes de que el PR pueda fusionarse, exactamente como si una persona hubiera realizado esos mismos cambios.
No en el resultado; es el mismo comando gh pr create que produce el mismo tipo de pull request; la diferencia es solo que Claude Code escribió el comando como parte de completar una tarea que solicitaste.
Sí; un desarrollador podría abrir el PR interactivamente, luego una revisión sin supervisión activada por CI se ejecuta automáticamente una vez que se envía, y más tarde el desarrollador (o otra sesión) envía un commit de seguimiento que aborda los comentarios de esa revisión.
gh y repasa cómo abrir y revisar tu primer PR.Versiones de Stack: Escrito contra la línea de modelos Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.
Revisado por Chris St. John·Última actualización: 16 jul 2026