Fundamentos de la Integración con GitHub

8 ejemplos para empezar con la Integración con GitHub y CI - 5 básicos y 3 intermedios.

Prerrequisitos

• Instala la CLI de gh (la herramienta oficial de línea de comandos de GitHub) - brew install gh en macOS, o consulta la documentación de instalación de GitHub para tu plataforma.
• Autentícala una vez por máquina con gh auth login, siguiendo las indicaciones interactivas para conectar tu cuenta de GitHub.
• Ejecuta Claude Code dentro de un repositorio git que tenga un remoto de GitHub configurado, para que los comandos gh y git se resuelvan correctamente.
• No se requiere una configuración especial de Claude Code: Claude Code simplemente ejecuta comandos gh y git de la misma manera que tú los escribirías.

Ejemplos Básicos

1. Comprobar si la CLI de gh está Conectada

Confirma que gh está instalado y autenticado antes de pedirle a Claude Code que lo use.

gh auth status

• Imprime la cuenta autenticada y los alcances del token para el host actual.
• Ejecuta esto una vez después de gh auth login y cada vez que los comandos de GitHub de una sesión fallen inesperadamente.
• Un token faltante o expirado es la razón más común por la que una sesión de Claude Code no puede abrir o comentar una PR.

2. Ver las PRs del Repositorio Actual

Lista las pull requests abiertas antes de pedirle a Claude Code que actúe sobre una de ellas.

gh pr list

• Muestra el título, la rama y el estado de cada PR abierta en el repositorio actual.
• Contexto útil para darle a Claude Code antes de señalarle un número de PR específico.
• Añade --state all para incluir las PRs fusionadas y cerradas en la lista.

3. Abrir una Pull Request desde una Sesión

Pídele a Claude Code que confirme los cambios preparados y abra una PR en un solo paso.

git add -A
git commit -m "Añadir limitación de tasa al endpoint de búsqueda"
gh pr create --title "Añadir limitación de tasa al endpoint de búsqueda" --body "Soluciona #482"

• gh pr create abre la PR contra la rama base predeterminada del repositorio a menos que pases --base.
• --title y --body omiten la indicación interactiva para que el comando se ejecute limpiamente dentro de una sesión.
• Claude Code ejecuta esta secuencia exacta cuando le pides que "confirme esto y abra una PR".

4. Ver los Detalles de una PR Específica

Obtén el contexto completo de una PR antes de pedirle a Claude Code que la revise o actualice.

gh pr view 482

• Imprime el título, la descripción, los controles de estado y el estado de la revisión para la PR #482.
• Añade --comments para incluir el hilo de comentarios de revisión en la salida.
• Claude Code lee esta salida para entender qué contiene ya una PR antes de realizar cambios.

5. Descargar la Rama de una PR Localmente

Descarga la rama de una PR en tu directorio de trabajo para que Claude Code pueda editar sus archivos directamente.

gh pr checkout 482

• Obtiene la rama de la PR y cambia tu directorio de trabajo local a ella.
• Requerido antes de que Claude Code pueda enviar un commit de seguimiento a esa PR exacta.
• Ejecuta git status después para confirmar que estás en la rama esperada antes de hacer cambios.

Ejemplos Intermedios

6. Leer Comentarios de Revisión y Enviar una Corrección

Obtén los comentarios de revisión de una PR, luego pídele a Claude Code que los aborde y envíe un commit de seguimiento.

gh pr view 482 --comments
# Pídele a Claude Code: "Aborda los comentarios de revisión en la PR #482 y envía una corrección."
git add -A
git commit -m "Aborda la retroalimentación de revisión: valida los límites de la ventana de limitación de tasa"
git push

• gh pr view --comments muestra la redacción exacta del revisor para que Claude Code pueda abordar cada punto específicamente.
• El commit de seguimiento se aplica a la misma rama, por lo que aparece directamente en la PR existente; no se crea una nueva PR.
• Los mensajes de commit que hacen referencia a lo que cambió (no solo "abordar retroalimentación") facilitan la lectura del historial de la PR más tarde.

Relacionado: Responder Automáticamente a los Comentarios de Revisión de PR - el flujo de trabajo completo que este ejemplo previsualiza.

7. Ejecutar Claude Code sin Interfaz Gráfica contra una PR

Invoca Claude Code de forma no interactiva para resumir una PR, útil como primer paso hacia la automatización de CI.

claude -p "Resume los cambios en la PR #482 y señala cualquier riesgo obvio." --output-format text

• -p (modo de impresión) ejecuta una indicación y sale, sin abrir el REPL interactivo.
• Esta es la misma forma de invocación que un trabajo de GitHub Actions utiliza para ejecutar Claude Code sin interfaz gráfica en cada PR.
• Útil para probar una indicación de revisión localmente antes de integrarla en CI.

Relacionado: Explicación del Modo sin Interfaz Gráfica: Ejecutar Claude Code sin Terminal - cómo funciona este modo en profundidad.

8. Dejar un Comentario de Revisión a través de gh

Publica un comentario directamente en una PR desde la línea de comandos, la misma llamada que haría un trabajo de CI.

gh pr comment 482 --body "En general se ve bien - una sugerencia: considera almacenar en caché la búsqueda de la ventana de limitación de tasa."

• gh pr comment publica un comentario de nivel superior en el hilo de conversación de la PR.
• Este es el comando exacto que ejecuta un trabajo de revisión automatizado para dejar comentarios sin que un humano los escriba.
• Combina con la salida del modo sin interfaz gráfica (ejemplo 7) para publicar la propia revisión de Claude Code como un comentario de PR.

Relacionado: Ejecutar Claude Code como un Bot de Revisión de Código Automatizado en CI - integrando esto en un trabajo de CI real.

Versiones de la Pila: Escrito contra 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.