Integrar Claude Code dentro de un repositorio de GitHub te permite ejecutar revisiones de código y tareas automatizadas sin abrir el editor. Aquí aprendes a invocarlo desde un pull request, leer sus comentarios y aprovechar su análisis sobre tu base de código real.

¿Cómo crear un pull request para invocar a Claude Code?

Para probar la integración necesitas un pull request abierto, y no tiene que ser complejo. Una modificación pequeña en el README basta para activar el flujo.

El proceso parte de crear una rama nueva con git checkout -b feat/cloud-code-usage. Sobre esa rama haces el cambio puntual, en este caso una línea agregada al archivo README del backend.

¿Qué pasos sigues en la terminal?

La secuencia es directa y replica el flujo estándar de Git:

• git checkout -b feat/cloud-code-usage para crear la rama.
• git add backend/README.md para preparar solo el archivo que te interesa.
• git commit -m "A simple modification to README file" con un mensaje claro.
• git push para subir la rama al remoto.

Una vez en GitHub, la interfaz te ofrece crear el pull request sobre el mismo repositorio con la descripción del cambio.

¿Por qué se necesita un pull request para usar Claude Code en GitHub? Porque la configuración inicial le da permisos de lectura y escritura sobre pull requests. Sin uno abierto, no hay contexto donde mencionarlo ni dejar comentarios.

¿Qué hace Claude Code automáticamente al abrir un PR?

Apenas creas el pull request, se dispara un job de GitHub Actions definido en el archivo de workflow. Ese job ejecuta una revisión automática del código que enviaste.

El análisis revisa code smells, posibles fallas de seguridad y prácticas de calidad. Es equivalente a tener un code review automatizado en cada cambio que subes a la rama.

Al finalizar, Claude deja un resumen como comentario dentro del mismo pull request, listando hallazgos y mejoras sugeridas. Una lucecita en el PR indica que la revisión está en curso.

¿Cómo mencionar a Claude dentro de un pull request?

La invocación manual ocurre en la sección de comentarios del PR. Escribes @claude seguido de la instrucción que necesitas, por ejemplo: "Explícame los cambios que están en esta rama".

Cuando Claude confirma la lectura del comentario, agrega una reacción de ojos al mensaje. Después publica un nuevo comentario con el enlace al job que está ejecutando tu solicitud.

¿Cómo se ven las tareas que ejecuta Claude?

El flujo dentro de GitHub replica lo que verías en la terminal:

• Claude lista las tareas que determinó hacer según tu prompt.
• Marca cada tarea como completada conforme avanza.
• Analiza tanto el código del PR como la base de código completa del repositorio.
• Publica un resumen final con los archivos modificados y los cambios específicos.

En el ejemplo, identifica que el archivo modificado es el README del backend y describe las dos líneas agregadas con precisión.

¿Cómo describir bien una tarea para Claude en un PR? Si envías código real a producción, sé explícito sobre qué quieres que evalúe: seguridad, lógica, rendimiento o estilo. Un prompt claro evita análisis genéricos.

¿Cómo traer los comentarios del PR a la terminal con pr comments?

Los comentarios del pull request, vengan de Claude o de un peer, son utilizables desde la terminal. Esto cierra el ciclo entre revisión remota y trabajo local.

Abres Claude Code en tu terminal y escribes el comando pr comments. Internamente usa el CLI de GitHub, el mismo que se utilizó al instalar la aplicación de Claude Code en el repositorio.

El comando recupera todos los comentarios del pull request actual y te los muestra organizados. En el ejemplo aparecen dos: el del code review automático con problemas de calidad, y el de la descripción de cambios solicitada manualmente.

¿Para qué sirve traer los comentarios al editor?

Este flujo resuelve un escenario muy común en equipos:

• Un compañero deja observaciones en tu pull request.
• Ejecutas pr comments desde tu terminal local.
• Claude Code lee los comentarios y los resuelve directamente sobre el código.
• Subes los cambios sin alternar entre la web y el editor.

Con Claude Code instalado en el repositorio habilitas acceso a la base de código sin depender de un editor de texto, y conviertes los comentarios del PR en tareas accionables desde la línea de comandos.

Te reto a involucrar a Claude Code en la creación de un nuevo feature usando solamente la interacción a través del pull request de GitHub. Cuéntame en los comentarios qué hiciste y cómo lo resolviste.