Claude Code git: commits, PRs y conflictos bajo control
Claude Code git: cómo pedir commits que expliquen el porqué, crear PRs con gh, resolver conflictos de merge y bloquear el force push con reglas deny.

489 commits.
Esa es la cifra que un developer dejó en el issue #29999 de anthropics/claude-code el 2 de marzo de 2026. Claude Code había firmado cada uno de sus commits con un Co-Authored-By: Claude, y él no se dio cuenta hasta tener casi quinientos. Su única salida, según contó: reescribir todo el historial y hacer force push.
Para mí, el problema de fondo no era la línea de atribución. Era que, en su flujo de Claude Code git, nadie había decidido qué podía escribir el agente en el historial. Para arreglarlo, la salida pasaba por la operación más peligrosa de git.
El riesgo real no es un mal commit del agente, sino perder el control de qué entra en el historial compartido.
En corto: delega en Claude Code los commits locales, la separación de cambios en commits atómicos, la redacción de la PR y la primera propuesta de resolución de conflictos. Revisa tú cada PR y cada conflicto resuelto, con los tests en verde. Prohíbe con reglas deny en settings.json el force push, el push a main y el merge de PRs.
¿Qué hace Claude Code con git?
Delegar git en Claude Code significa que el agente ejecuta git y gh desde su herramienta Bash (commits, ramas, PRs, resolución de conflictos), mientras las reglas de permisos y tu revisión deciden qué llega al historial compartido.
Según la referencia de settings, consultada en octubre de 2026, le pasa a Claude dos cosas al empezar la sesión: unas instrucciones propias sobre cómo escribir commits y PRs, y una foto del repo con la rama actual, la rama principal, el git status y los commits recientes. Si usas tu propio flujo, puedes quitar ambas con "includeGitInstructions": false.
También firma. Cada commit lleva por defecto un trailer Co-Authored-By: <modelo> <noreply@anthropic.com>, y cada PR una línea "Generated with Claude Code". Se controla con la clave attribution (commit, pr y sessionUrl). La antigua includeCoAuthoredBy está obsoleta desde la v2.0.62.
{
"attribution": {
"commit": "",
"pr": ""
}
}
Con cadenas vacías desaparece la firma. En el mismo issue, Boris Cherny, de Anthropic, respondió el 17 de agosto de 2026 justo con esa configuración. Dos usuarios le contestaron en septiembre que la queja no era si se puede apagar, sino que venga encendido por defecto.
Mi regla: decide la atribución el primer día y déjala en settings.json, no en una frase de CLAUDE.md. Una clave de configuración no depende de que el modelo la recuerde.
Commits con Claude Code que expliquen el porqué
Un commit que dice "update user service" no le sirve a nadie dentro de seis meses. El diff ya cuenta qué cambió; el mensaje tiene que contar por qué.
El agente describe el qué porque solo ve el diff. El porqué hay que pedirlo y dejarlo escrito donde lo lea en cada sesión, el CLAUDE.md del proyecto:
## Git
- Conventional Commits: `tipo(ámbito): resumen` en imperativo, máximo 72 caracteres.
- El cuerpo explica POR QUÉ: qué problema había y qué alternativa descartamos.
El qué ya está en el diff; no lo repitas.
- Un commit = un cambio lógico. Si el diff mezcla refactor y feature, sepáralos.
- Antes de commitear, `npm test` en verde. Nunca `--no-verify`.
- Nunca push a main ni force push. El push lo decide el humano.
Y en el momento del commit, dale el contexto que el diff no tiene:
Haz commit de estos cambios. El motivo: el endpoint /orders devolvía 500
cuando el cliente no tenía dirección, y preferimos un 422 con mensaje claro
a crear una dirección vacía. Ponlo en el cuerpo del commit.
Commits atómicos con Claude Code: separa antes de commitear
Tras una sesión larga, el working tree mezcla el fix que pediste, un refactor "de paso" y cambios de formato.
Pídele que lo ordene antes de tocar el historial:
Revisa git diff y agrupa los cambios en commits atómicos.
Antes de commitear, enséñame la propuesta: qué archivos van en cada commit
y el mensaje de cada uno. No hagas nada hasta que te diga "ok".
Ver la propuesta antes es la clave: un commit de 14 archivos con mensaje genérico se frena ahí, no en la PR.
Mi regla: cuando un mismo archivo mezcla dos cambios lógicos, lo separo yo con git add -p. Es interactivo y prefiero no pedirle al agente que lo emule con parches.
Pull request con Claude Code usando gh
Crear la PR es una de las tareas que mejor delega Claude Code. La guía de flujos comunes lo recoge tal cual: basta con pedir "create a pr" y el agente usa gh pr create. Además, Claude Code vincula la sesión a la PR: claude --from-pr 1234 abre el selector de sesiones filtrado por las vinculadas a esa PR, y vuelves a la conversación días después.
Lo que cambia la calidad de la PR es el prompt:
Crea una PR en borrador contra develop con gh. La descripción lleva:
1. Qué problema resuelve y por qué este enfoque.
2. Qué NO cubre esta PR.
3. Riesgos: qué puede romper en producción.
4. Checklist: tests añadidos, migraciones, variables de entorno nuevas.
Enséñame el cuerpo antes de ejecutar gh pr create.
En borrador (--draft) y con el cuerpo revisado antes, corriges el texto sin notificar a nadie. Si quieres aplicar este enfoque a un proyecto completo con Claude Code, es lo que hacemos en el curso Construye con IA.
Resolver conflictos de merge con Claude Code
Aquí el agente es útil y peligroso a la vez: leer dos lados de un conflicto es tedioso, pero "resolver" puede significar quedarse con un lado y borrar el otro en silencio.
Antes de nada, dale más contexto en los marcadores:
git config merge.conflictStyle zdiff3
Con zdiff3 cada conflicto muestra también la versión base, así el agente ve qué cambió cada rama en vez de adivinarlo.
Después, el prompt que obliga a explicar antes de elegir:
Hay conflictos en el merge. Para cada archivo en conflicto:
1. Usa git log --merge -p para ver qué commits tocaron cada lado.
2. Explícame la intención de cada lado en una frase.
3. Propón la resolución que conserva AMBAS intenciones.
4. Si no se pueden conservar las dos, para y pregúntame.
No hagas el commit del merge hasta que pasen los tests.
El paso 4 es el importante. Un conflicto donde las dos intenciones chocan no es un problema de texto: es una decisión de producto, y esa no la toma el agente.
Con varios agentes en paralelo, los conflictos se multiplican; cómo evitarlos lo conté en dirigir agentes de IA en paralelo sin que se pisen.
Qué delegar, qué revisar y qué prohibir
Este es el reparto que propongo para un flujo de Claude Code git. La última columna es la que manda: cuanto más difícil es deshacer una operación, menos autonomía le doy al agente.
| Operación | Decisión | Regla de permisos | Riesgo si sale mal |
|---|---|---|---|
git status, diff, log |
Delegar | Ninguna: Claude Code las trata como solo lectura | Nulo |
git add + git commit local |
Delegar | allow |
Bajo: se deshace con git reset --soft HEAD~1 |
| Separar en commits atómicos | Delegar con propuesta previa | allow |
Bajo: historial local |
gh pr create |
Revisar el cuerpo antes | ask |
Medio: notifica al equipo |
| Resolver conflicto de merge o rebase | Revisar + tests en verde | ask en --continue; en el prompt, parar antes del commit |
Alto: puede borrar lógica sin que falle nada |
git push a tu rama |
Revisar | ask |
Medio: ya es público |
git push --force, push a main |
Prohibir | deny |
Crítico: reescribe trabajo ajeno |
gh pr merge |
Prohibir | deny |
Crítico: salta la revisión humana |
Cómo bloquear el force push en Claude Code con reglas deny
El sitio para esto son las reglas de permisos de .claude/settings.json, no las instrucciones en lenguaje natural. Según la documentación de permisos, las reglas se evalúan en orden deny, luego ask, luego allow, y un deny gana siempre, aunque otra regla más específica permita lo mismo.
{
"permissions": {
"allow": [
"Bash(git add *)",
"Bash(git commit *)"
],
"ask": [
"Bash(git push *)",
"Bash(gh pr create *)",
"Bash(git rebase --continue*)",
"Bash(git merge --continue*)",
"Bash(git reset --hard*)",
"Bash(git clean *)"
],
"deny": [
"Bash(git push *--force*)",
"Bash(git push -f*)",
"Bash(git push * -f*)",
"Bash(git push * main)",
"Bash(git push * HEAD:main)",
"Bash(git commit *--no-verify*)",
"Bash(gh pr merge *)"
]
}
}
El * sustituye cualquier texto en su posición, así que git push *--force* cubre --force y --force-with-lease estén donde estén. Por qué esto va en permisos y no en un hook lo expliqué en hooks vs permissions en Claude Code: un hook que falla deja pasar el comando; una regla deny, no.
Mi regla: el agente no hace push. Si prefieres lo mismo, mueve Bash(git push *) de ask a deny y olvídate de las variantes.
Límites de delegar git a Claude Code
Esto no te protege de todo. Hay cuatro huecos.
Las reglas deny no son una frontera de seguridad. La propia documentación avisa: Bash(git push *) no bloquea git -C . push origin main ni git 'push' origin main. Tampoco paran git commit -n, que equivale a --no-verify, ni git push origin +rama, que fuerza sin --force. Y hay un hueco más común: un git push a secas desde main no menciona la rama, así que Bash(git push * main) no lo para. La barrera de verdad para main es la protección de ramas en GitHub o GitLab.
Los conflictos semánticos no salen en los tests. Si una rama renombra un campo y otra añade código que usa el nombre viejo en un sitio sin cobertura, git no marca conflicto y los tests pasan. Que el agente lo explique ayuda; solo lo detecta quien conoce el dominio.
Los commits grandes siguen colándose. Si no pides la propuesta antes, el agente puede agrupar una sesión entera en un solo commit.
Los mensajes vuelven a describir el qué. Con CLAUDE.md mejoran, pero si no le das el motivo en el prompt, el agente lo deduce del diff. Y un porqué inventado es peor que no tenerlo.
Claude Code git: cómo empezar hoy
Copia el bloque deny de arriba en el .claude/settings.json de tu proyecto y haz commit para que lo tenga todo el equipo. Son cinco minutos que convierten "espero que el agente no haga force push" en "el agente no puede hacer force push de la forma habitual".
Lo demás, los mensajes con porqué, los commits atómicos y las PRs con checklist, sale de la misma idea: escribir el contrato antes de que el agente ejecute. Si quieres aplicar eso a todo el ciclo y no solo a git, es la base del libro Spec-Driven Development.
Preguntas frecuentes
¿Cómo quito el Co-Authored-By de los commits de Claude Code?
Añade "attribution": { "commit": "", "pr": "" } a tu settings.json. Desde la v2.1.281 también puedes poner "attribution": false para quitar toda la atribución, incluido el enlace de sesión. Ojo: las versiones anteriores rechazan ese valor e ignoran el archivo entero, reglas deny incluidas. En un .claude/settings.json compartido por el equipo, usa cadenas vacías y "sessionUrl": false. La clave includeCoAuthoredBy está obsoleta desde la v2.0.62.
¿Puede Claude Code resolver conflictos de merge solo?
Puede proponer la resolución y aplicarla, pero no debería cerrar el merge sin tu revisión. Pídele que explique la intención de cada lado, que pare si chocan y que no cierre el merge hasta que pasen los tests.
¿Cómo hago que Claude Code escriba commits que expliquen el porqué?
Fija la convención en CLAUDE.md (cuerpo con el motivo, no con el qué) y dale el motivo en el prompt al pedir el commit. El agente solo ve el diff; el porqué tiene que venir de ti.
¿Cómo crea Claude Code una pull request?
Usa la CLI gh con gh pr create. Necesitas gh instalado y autenticado. Pídele la PR en borrador y que te enseñe la descripción antes de crearla.
¿Una regla deny de Claude Code bloquea cualquier git push –force?
No. Bloquea las formas habituales de escribir el comando, pero no variantes como git -C . push. Combínala con protección de ramas en el servidor para main.
Por Bezael Pérez — Developer senior con más de 15 años de experiencia y fundador de Dominicode.
¿Quieres construir con agentes en serio?
Curso «Construye con IA» con Claude Code, de la idea al producto.
Developer con más de 15 años en frontend y creador de Dominicode. Escribe sobre IA aplicada al desarrollo de software.
¿Te resultó útil este artículo?
Compártelo con tu comunidad y ayuda a otros desarrolladores.