Crear PRs con gh CLI
Claude Code usa el gh (GitHub CLI) para crear PR directamente desde la terminal. Analiza los commits, genera el título y la descripción, y abre el PR con un solo comando. Puedes pedir: "crea un PR con estos cambios" y lo hace todo.
# Claude gera e executa algo como: gh pr create \ --title "feat(auth): add JWT refresh token rotation" \ --body "## Summary - Add automatic JWT refresh token rotation - Implement token blacklist for revoked tokens - Add tests for token refresh flow ## Test plan - [ ] Run auth test suite - [ ] Manual test with expired tokens"
En 1 frase: Claude usa gh pr create para abrir PRs con título y descripción generados automáticamente.
Revisión automatizada
Claude puede actuar como revisor de código: lee el diff del PR, identifica problemas de lógica, seguridad, rendimiento y estilo, y comenta directamente. Puedes pedirle "revisa el PR #42" y usa gh api para buscar los cambios y publicar comentarios estructurados.
En 1 frase: Claude lee el diff de un PR y publica comentarios de revisión mediante la API de gh.
CI verifica la integración
Antes de hacer merge, Claude verifica si pasaron los checks de CI usando gh pr checks. Si alguno falla, lee el registro del error, identifica el problema e intenta corregirlo. Si no puede, informa lo que encontró y sugiere el siguiente paso.
# Verificar status dos checks gh pr checks 42 # Ver log de uma check que falhou gh run view <run-id> --log-failed
En 1 frase: Claude verifica las comprobaciones de CI e intenta corregir los fallos antes del merge.
Cómo responder a los comentarios
Cuando los revisores humanos dejan comentarios en el PR, puedes pedirle a Claude: "lee los comentarios del PR #42 y haz los cambios solicitados". Usa gh api repos/.../pulls/42/comments para leer, entender cada solicitud, hacer los cambios y crear un commit con un mensaje que haga referencia a los comentarios.
En 1 frase: Claude lee los comentarios de revisión e implementa automáticamente los cambios solicitados.
Squash y rebase
Para mantener limpio el historial, usa squash merge: todos los commits del PR se convierten en un solo commit en main. Claude también puede hacer rebase antes del merge para evitar merge commits. Configura GitHub con "Squash and merge" como opción predeterminada y el historial queda lineal y legible.
En 1 frase: squash merge mantiene el historial limpio con un commit por PR.
Best practices
Los PR que hacen merge rápido siguen una receta: pequeños (menos de 400 líneas), enfocados (un único cambio lógico), bien descritos (título claro + body con contexto), y con las pruebas aprobadas. Claude sigue estas reglas de forma natural cuando le pides que cree PRs.
PR que faz merge rapido: [ ] Menos de 400 linhas de diff [ ] Uma mudanca logica por PR [ ] Titulo semantico (feat/fix/refactor) [ ] Body com Summary + Test Plan [ ] Todos os CI checks passando [ ] Sem segredos no diff [ ] Reviewer atribuido
En 1 frase: Los PR pequeños, enfocados y bien descritos, con las pruebas aprobadas, hacen merge en minutos.
🧾 Resumen del módulo
Siguiente módulo:
4.6 — CI/CD y GitHub Actions: automatiza deploy, pruebas y seguridad.