//
Busca en todas las páginas de la documentación
Una vez que Claude Code ha realizado un conjunto de cambios en una sesión de trabajo, puede confirmarlos y abrir una solicitud de extracción (Pull Request) en GitHub sin salir de esa sesión, utilizando la CLI de gh.
Abrir una PR desde una sesión significa que Claude Code ejecuta los mismos comandos git y gh que un desarrollador escribiría manualmente.
No existe una "función de PR de Claude Code" separada; la CLI de gh es la herramienta oficial de línea de comandos de GitHub, y Claude Code simplemente la invoca.
Esto significa que cualquier cosa que puedas hacer con gh pr create tú mismo, Claude Code puede hacerlo como parte de la finalización de una tarea que le hayas solicitado.
También significa que la PR resultante se ve completamente normal para tu equipo: el mismo formato de título, el mismo cuerpo, las mismas comprobaciones ejecutándose en ella.
El único requisito previo es que gh esté instalado y autenticado en el entorno en el que se ejecuta la sesión.
Tarjeta de receta de referencia rápida: lista para copiar y pegar.
git add -A
git commit -m "Add rate limiting to the search endpoint"
git push -u origin HEAD
gh pr create --title "Add rate limiting to the search endpoint" \
--body "Adds a sliding-window rate limiter to the search endpoint. Fixes #482."Cuándo usarlo:
#!/usr/bin/env bash
set -euo pipefail
# 1. Confirma que hay algo para confirmar.
git status --short
# 2. Prepara y confirma el cambio.
git add -A
git commit -m "Add rate limiting to the search endpoint
Adds a token-bucket limiter in middleware/rate-limit.py, applied to
the /api/search route. Limit is 60 requests/minute per API key."
# 3. Envía la rama actual, creándola en el remoto si es necesario.
git push -u
Lo que esto demuestra:
$(cat <<'EOF' ... EOF)) para pasar un cuerpo de PR de varios párrafos sin problemas de escape.push con -u para que la rama sea rastreada en el remoto antes de que se ejecute gh pr create.gh pr view --json url en lugar de asumir que el comando se ejecutó correctamente.Fixes #482) para que GitHub vincule y cierre automáticamente la incidencia al fusionar.gh pr create lee la información de seguimiento de la rama actual para determinar contra qué hacer push, y la rama predeterminada del repositorio (normalmente main) como base de la PR a menos que se pase --base explícitamente.git push -u origin HEAD lo maneja en un solo paso, tanto haciendo push como configurando el seguimiento.--title y --body son opcionales; omitirlos hace que gh entre en un prompt interactivo, por lo que el uso impulsado por la sesión casi siempre los proporciona explícitamente.gh pr create imprime la URL de la nueva PR en stdout, lo cual es útil para que una sesión te informe.gh se autentica utilizando el token almacenado por gh auth login, la misma credencial utilizada para cualquier otro subcomando de gh.| Bandera | Propósito |
|---|---|
--title | Establece el título de la PR directamente, omitiendo el prompt interactivo. |
--body | Establece la descripción de la PR; admite texto de varias líneas a través de un heredoc o --body-file. |
--base | Anula la rama base predeterminada (por ejemplo, --base develop). |
--draft | Abre la PR como borrador, útil para trabajos aún en progreso. |
--reviewer | Solicita un revisor o equipo específico por nombre de usuario/identificador. |
--fill | Rellena automáticamente el título y el cuerpo del historial de confirmaciones de la rama en lugar de especificarlos. |
# --fill ahorra escritura cuando la rama tiene una confirmación limpia cuyo mensaje
# ya se lee como un buen título y cuerpo de PR.
git add -A
git commit -m "Add rate limiting to the search endpoint"
git push -u origin HEAD
gh pr create --fillpush antes de gh pr create. gh pr create necesita que la rama exista primero en el remoto; si omites git push -u origin HEAD, el comando fallará pidiéndote que hagas push. Solución: haz siempre push con -u inmediatamente antes de crear la PR, o deja que el prompt de --fill lo haga por ti.main contra main no tiene sentido; gh pr create dará un error o se comportará de forma inesperada. Solución: crea y haz checkout de una rama de características (git checkout -b <nombre-de-rama>) antes de realizar cambios.gh caducado o faltante. Los comandos fallan silenciosamente con un error de autenticación si gh auth login nunca se ejecutó o el token caducó. Solución: ejecuta gh auth status primero; vuelve a autenticarte con gh auth login si informa que no has iniciado sesión.--body como una cadena simple entre comillas puede fallar con comillas o backticks incrustados. Solución: usa un heredoc (como en el Ejemplo de trabajo) o escribe el cuerpo en un archivo y pasa --body-file.gh pr create abre contra la rama que pretendías. Si no estás en la rama que crees que estás, la PR terminará con un diff incorrecto. Solución: ejecuta git status o git branch --show-current inmediatamente antes de crear la PR para confirmar.Fixes #<número> o Refs #<número> en el cuerpo, y confirma el número de incidencia antes de ejecutar el comando.| Alternativa | Usar cuando | No usar cuando |
|---|---|---|
| Abrir la PR manualmente en la interfaz web de GitHub | Quieres revisar el diff visualmente antes de escribir la descripción | Ya estás en una sesión de Claude Code y quieres evitar cambiar de contexto |
gh pr create --fill | La rama tiene un mensaje de confirmación limpio y bien escrito | El cambio abarca varias confirmaciones y necesita un resumen escrito a mano |
| Un flujo de trabajo de GitHub Actions que abre PRs en un horario (por ejemplo, actualizaciones de dependencias) | La PR está completamente automatizada y no necesita un juicio impulsado por la sesión | El cuerpo de la PR necesita describir el razonamiento específico del trabajo de esta sesión |
git push más un paso de CI separado que abre la PR | La pipeline de tu equipo ya se encarga de la creación de PR como política | Quieres que la PR se abra inmediatamente, en el mismo paso que la confirmación |
No, puedes preguntar en lenguaje sencillo ("confirma esto y abre una PR"), y Claude Code ejecuta los comandos git y gh equivalentes por sí mismo; conocer los comandos subyacentes solo te ayuda a comprender y verificar lo que hizo.
La rama predeterminada configurada del repositorio, normalmente main o master, a menos que pases --base para apuntar a otra cosa.
Sí, agrega --draft a gh pr create; las PR en borrador no solicitan revisiones automáticamente y señalan que el trabajo aún está en progreso.
gh pr create te informará que ya existe una PR para esa rama y no creará una duplicada; usa gh pr view para ver la existente en su lugar.
Abrir la PR activa los flujos de trabajo de GitHub Actions que estén configurados para ejecutarse en eventos pull_request en el repositorio; gh por sí mismo no ejecuta comprobaciones directamente.
Sí, con --reviewer <nombre_de_usuario> (o un identificador de equipo); puedes pasarlo varias veces para más de un revisor.
gh pr create tiene un modo interactivo que muestra una vista previa y pide confirmación cuando omites --title/--body; el uso con scripts omite esa vista previa al proporcionar ambas banderas directamente.
Usa un heredoc para el argumento de la bandera -m, la misma técnica que se muestra para --body en el Ejemplo de trabajo, para que los saltos de línea se conserven correctamente.
No, son independientes; --title establece el título de la PR explícitamente independientemente de lo que digan los mensajes de confirmación, a menos que uses --fill, que deriva ambos del historial de confirmaciones.
Sí, gh pr create admite --repo para apuntar a un repositorio específico, que es como se abre una PR desde un fork de vuelta al proyecto upstream.
Verifica la URL impresa por el comando, o ejecuta gh pr view inmediatamente después, lo que imprime los detalles de la PR asociada a la rama actual si existe una.
Solo la CLI de gh, autenticada una vez a través de gh auth login, y un repositorio git con un remoto de GitHub configurado; no se requiere ninguna configuración adicional de Claude Code.
gh antes de usarla en una sesión.Versiones de la pila: Escrito con la línea de modelos de 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.