Flujo Git integrado

Commits automáticos

La operación de Git más frecuente con Claude Code es la creación de commits. En lugar de escribir manualmente git add, redactar un mensaje y ejecutar git commit, basta con pedir a Claude que haga un commit.

haz commit de los cambios

Claude analiza el diff completo de los archivos modificados, identifica el propósito de los cambios y genera un mensaje de commit descriptivo. Antes de ejecutar el commit, muestra el mensaje propuesto y solicita aprobación. El flujo completo se resuelve en un solo paso:

flowchart TD
    A["Pedir commit"] --> B["Claude lee git diff"]
    B --> C["Genera mensaje"]
    C --> D["Solicita aprobación"]
    D -->|Acepta| E["Ejecuta git add + commit"]
    D -->|Rechaza| F["Cancela operación"]

El mensaje generado refleja el contenido real de los cambios, no una descripción genérica. Si se han modificado tres archivos para corregir un bug de autenticación, el mensaje reflejará esa corrección y mencionará los componentes afectados.

Commits atómicos a partir de cambios mezclados

Una de las capacidades más prácticas es la separación de commits cuando se han mezclado cambios no relacionados. Si durante una sesión de desarrollo se han modificado archivos de la API, del frontend y de los tests, Claude puede dividirlos en commits independientes:

separa estos cambios en commits lógicos

Claude analiza los archivos modificados, agrupa los cambios por funcionalidad y genera una secuencia de commits con mensajes coherentes. Cada commit incluye solo los archivos relevantes para ese cambio concreto.

Los commits atómicos facilitan el trabajo del equipo: cada commit tiene un propósito claro, es reversible de forma independiente y el historial de Git queda limpio y navegable.

Convenciones de commit del equipo

Claude Code respeta las convenciones de commit definidas en el archivo CLAUDE.md del proyecto. Si el equipo utiliza Conventional Commits, basta con indicarlo:

# Commits
- Formato: conventional commits (feat:, fix:, docs:, refactor:, test:, chore:)
- Idioma: inglés
- Scope obligatorio cuando afecte a un módulo concreto

Con estas instrucciones, Claude genera mensajes como feat(auth): add OAuth2 refresh token rotation o fix(api): handle empty response body in user endpoint de forma consistente.

Atribución

Los commits creados por Claude Code incluyen de forma automática una línea de atribución que indica que han sido generados con asistencia de IA. Esta atribución se puede personalizar o desactivar desde la configuración attribution en settings.json:

{
  "attribution": {
    "commit": "Generado con Claude Code",
    "pr": "Pull request creado con Claude Code"
  }
}

Asignar una cadena vacía a commit o pr oculta la atribución correspondiente.

Gestión de branches

Claude Code gestiona branches de Git como parte natural de su flujo de trabajo. Puede crear, cambiar y fusionar branches bajo instrucciones del usuario:

crea una branch para la nueva feature de notificaciones

Claude genera un nombre de branch siguiendo las convenciones del proyecto (si están definidas en CLAUDE.md) o usando un formato descriptivo por defecto como feature/notificaciones o fix/auth-token-expiry.

Operaciones habituales

Las operaciones de branch más comunes se resuelven con instrucciones en lenguaje natural:

• Crear y cambiar: "crea una branch para refactorizar el módulo de pagos".
• Rebasing: "haz rebase de esta branch sobre main". Claude ejecuta el rebase y, si encuentra conflictos, los analiza y propone resoluciones.
• Merge: "fusiona esta branch en develop". Claude verifica el estado, ejecuta el merge y resuelve conflictos si los hay.
• Limpieza: "elimina las branches locales que ya estén fusionadas". Claude identifica y elimina las branches que ya se han integrado.

Resolución de conflictos

Cuando un rebase o merge produce conflictos, Claude los aborda de forma inteligente. Lee los archivos con marcadores de conflicto, analiza ambas versiones del código y propone una resolución que combina los cambios de forma coherente:

hay conflictos en el rebase, resuélvelos

Claude examina cada conflicto, entiende la intención de ambas ramas y genera una versión integrada. Si un conflicto es ambiguo (dos implementaciones diferentes de la misma función, por ejemplo), Claude explica las opciones y pide confirmación antes de resolver.

Claude Code no resuelve conflictos a ciegas: analiza el contexto de ambas ramas para entender la intención del código y proponer una integración coherente. Aun así, conviene revisar cada resolución antes de aceptarla.

Pull requests

Claude Code crea pull requests directamente desde la terminal utilizando el CLI de GitHub (gh). El proceso integra la generación del PR con un resumen automático basado en los commits de la branch.

crea un pull request para esta branch

Claude ejecuta los siguientes pasos:

• 1. Verifica el estado de la branch y la diferencia con la rama base.
• 2. Lee el historial de commits desde el punto de bifurcación.
• 3. Genera un título descriptivo y un cuerpo con el resumen de los cambios.
• 4. Ejecuta git push si la branch no está publicada en el remoto.
• 5. Crea el PR con gh pr create.

El cuerpo del pull request incluye una sección de resumen con los cambios principales y, si procede, un plan de testing. Claude adapta el formato a las plantillas de PR del repositorio si existen.

Monitorización de PRs

Cuando la rama de trabajo tiene un pull request abierto, Claude Code muestra un enlace al PR en la interfaz de la terminal. El enlace incluye un indicador visual del estado de la revisión:

| Color | Estado | |---|---| | Morado | Fusionado (merged) | | Gris | Borrador (draft) | | Rojo | Cambios solicitados | | Amarillo | Pendiente de revisión | | Verde | Aprobado |

El estado se actualiza automáticamente cada 60 segundos. Si la CI detecta errores, Claude puede analizarlos y proponer correcciones:

la CI ha fallado, analiza los errores y corrígelos

Claude lee los logs de la CI, identifica los tests o checks que han fallado, aplica las correcciones necesarias y hace push de los cambios para que la CI se ejecute de nuevo.

Code review

Claude Code puede actuar como revisor de código, analizando los cambios de un pull request y proporcionando feedback detallado.

Revisar cambios locales

Para revisar los cambios antes de hacer commit:

revisa los cambios que he hecho

Claude ejecuta git diff, analiza cada modificación y proporciona observaciones sobre calidad del código, posibles bugs, adherencia a las convenciones del proyecto y sugerencias de mejora.

Revisar un pull request

Para revisar un PR existente:

revisa el PR #42

Claude descarga los cambios del PR, analiza cada archivo modificado y genera un informe con observaciones organizadas por archivo. Las observaciones incluyen desde errores de estilo hasta problemas lógicos o de rendimiento.

flowchart TD
    A["Solicitar revisión"] --> B["Claude lee el diff"]
    B --> C["Analiza cada archivo"]
    C --> D["Identifica problemas"]
    D --> E["Genera informe con observaciones"]
    E --> F{"Hay cambios sugeridos?"}
    F -->|Sí| G["Aplica correcciones si se autoriza"]
    F -->|No| H["Revisión completada"]

Visor interactivo de diferencias

El comando /diff dentro de una sesión interactiva abre un visor de diferencias que muestra los cambios no confirmados con formato de colores. Permite navegar por los archivos modificados y ver las adiciones y eliminaciones de forma clara.

Integración con GitHub Actions

Claude Code se integra con GitHub mediante una GitHub Action oficial (anthropics/claude-code-action) que permite automatizar tareas de desarrollo directamente en el repositorio. La acción se activa mencionando @claude en comentarios de issues o pull requests.

Las capacidades principales de la GitHub Action incluyen:

• Revisión automática de PRs: Claude analiza los cambios y deja comentarios de revisión.
• Implementación de cambios: Claude puede hacer cambios de código directamente en la branch del PR como respuesta a feedback.
• Respuesta a issues: Claude puede analizar issues y proponer soluciones o crear PRs con la implementación.

La instalación se puede realizar ejecutando /install-github-app dentro de una sesión interactiva de Claude Code, lo que guía el proceso de configuración del GitHub App y los secrets necesarios en el repositorio.

Workflow Git completo

Un flujo de trabajo habitual que combina todas las capacidades de Git integradas en Claude Code se ejecuta en una secuencia de instrucciones naturales:

crea una branch para añadir validación de email

implementa la validación de email en el servicio de registro

ejecuta los tests

haz commit de los cambios

crea un PR con los cambios

Cada paso se resuelve con una sola instrucción. Claude mantiene el contexto de la sesión, por lo que entiende que la validación de email, el commit y el PR forman parte del mismo flujo de trabajo. El resultado es un ciclo completo de desarrollo desde la branch hasta el pull request sin salir de la terminal.

Claude Code no reemplaza el conocimiento de Git: lo complementa. Entender cómo funcionan branches, rebasing y merge sigue siendo fundamental para dar instrucciones precisas y revisar el trabajo del agente.