Worktrees y desarrollo en paralelo
Trabaja en varias funcionalidades a la vez sin conflictos
⏱ Estim. ~5 min
01 · Leer
¿Y si pudieras trabajar en dos funcionalidades a la vez sin que ninguna pise los archivos de la otra? Normalmente tu proyecto tiene un único set de archivos por rama. Si estás a medias implementando auth y entra un bug crítico, tienes que hacer stash, cambiar de rama y pierdes el ritmo.
Los git worktrees resuelven eso. Un worktree es un directorio de trabajo separado que comparte el mismo historial de git con tu proyecto principal. Cada worktree tiene su propia rama y sus propios archivos. Claude Code trae soporte integrado para worktrees: con una sola bandera abres un espacio de trabajo aislado.
💡 Imagínalo asíImagina tu oficina con dos escritorios en vez de uno. Cada escritorio tiene su propia copia de los documentos en los que estás trabajando, pero los dos están conectados al mismo archivero (el historial de git). Puedes trabajar en una funcionalidad en el escritorio 1 y arreglar un bug en el escritorio 2, sin mover papeles de un lado a otro.
Puntos clave
- Un worktree es un directorio de trabajo separado que comparte el mismo repo de git
- Cada worktree tiene su propia rama y sus propios archivos
- Sin stash, sin cambiar de rama, sin perder el ritmo
- Claude Code crea worktrees automáticamente con --worktree
02 · Ejemplo de código
Usa la bandera --worktree para crear un worktree. Cada uno tiene su propia rama y directorio.
Crear un worktree
# Start a Claude session in an isolated worktree
claude --worktree feature-auth
# Start another session for a bug fix
claude --worktree bugfix-login
# Auto-generate a random worktree name
claude --worktree
Qué pasa detrás
Worktree location: .claude/worktrees/feature-auth/
Branch created: worktree-feature-auth
Files: Full copy of your project
Git history: Shared with main repo
Cada worktree vive en su propio directorio dentro de .claude/worktrees/ con su propia rama de git. Dos sesiones de Claude pueden editar archivos al mismo tiempo sin chocar. Al terminar, los worktrees sin cambios se limpian solos.
03 · Leer
Los worktrees son especialmente potentes para sesiones de Claude en paralelo. Este es el flujo típico:
1. Estás implementando una funcionalidad en tu directorio principal 2. Entra un reporte de bug: claude --worktree bugfix-123 3. La sesión del bugfix trabaja de forma independiente en su propia copia 4. Se arregla, haces merge de la rama bugfix de vuelta a main 5. Sigues con tu funcionalidad sin perder el hilo
También puedes usar worktrees dentro de subagentes. Agrega isolation: worktree al frontmatter del SKILL.md del subagente y trabajará automáticamente en su propio worktree. Es perfecto para tareas que necesitan editar archivos sin afectar tu directorio de trabajo principal.
Puntos clave
- Corre varias sesiones de Claude en paralelo, cada una en su propio worktree
- Haz merge de la rama del worktree cuando termines
- Los subagentes pueden usar worktrees con isolation: worktree
- Agrega .claude/worktrees/ a tu .gitignore
04 · Leer
Para cambios verdaderamente a gran escala (renombrar una función en 100 archivos, migrar una API), Claude Code ofrece el comando /batch. Descompone tu tarea en unidades independientes, genera un subagente para cada una y cada subagente trabaja en su propio worktree.
Cada subagente crea un draft pull request para su parte. Tú revisas, mergeas los buenos e iteras los demás. Así manejan los profesionales las refactorizaciones grandes: dividirlas en bloques independientes y revisables.
Puntos clave
- /batch descompone una tarea grande en unidades independientes
- Cada unidad va a su propio worktree con su propio subagente
- Cada uno crea un draft PR para revisión
- Perfecto para refactorizaciones y migraciones a gran escala
05 · Quiz
¿Qué pasa cuando una sesión de Claude en un worktree termina sin cambios sin commitear?
- El worktree se limpia automáticamente
- El worktree se queda para siempre hasta que lo borres a mano
- Claude te pide hacer commit antes de cerrar
- El worktree se mueve a un directorio de respaldo
06 · Clasificar arrastrando
Ordena estos pasos de un flujo de trabajo con worktree en paralelo en la secuencia correcta.
(Esta sección es interactiva — activa JavaScript para usarla.)
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.