Paralelizar: worktrees, modelo y modo rápido
Un git worktree aísla una sesión paralela en su propia rama, y el indicador --worktree lo automatiza ahora por completo, donde antes solo existía el gesto manual git worktree add.
Un git worktree abre un segundo checkout del mismo repositorio, en su propia rama, en una carpeta separada. Dos sesiones de Claude Code pueden así trabajar en paralelo sin que una escriba en los archivos que la otra tiene en curso de modificación.
El gesto integrado de forma nativa
Este gesto está hoy integrado de forma nativa en Claude Code, sin que sea necesario llamar a git worktree uno mismo para el caso habitual. El comando claude --worktree feature-auth (o su alias corto -w) crea automáticamente un worktree aislado bajo .claude/worktrees/feature-auth/, en una nueva rama llamada worktree-feature-auth, y arranca la sesión directamente dentro.
claude --worktree feature-auth
# crea .claude/worktrees/feature-auth/ en la rama worktree-feature-auth
# y arranca la sesión en esa carpeta
El gesto manual, git worktree add, sigue siendo válido y necesario en dos casos que el atajo no cubre: partir de una rama existente precisa, o colocar el worktree fuera del repositorio. La reanudación de una sesión en su worktree es automática con --continue, --resume y en modo interactivo, y Claude puede él mismo crear o cambiar de worktree mediante una herramienta dedicada, con una confirmación pedida en cuanto sale de la carpeta .claude/worktrees/.
El modelo se elige según la dificultad, el modo rápido según el costo
En cada worktree, la elección del modelo sigue siendo independiente: una tarea mecánica y repetitiva va a un modelo ligero, una tarea de juicio o de verificación adversa va al modelo más capaz. El modo rápido, activado por /fast, es una preversión de investigación disponible solo en Opus 5 y Opus 4.8, ausente en Sonnet, en Haiku, y ahora también en Opus 4.7, donde el soporte fue retirado tras un período de desaprobación. Acelera la velocidad de salida hasta 2,5 veces, a una tarifa facturada por separado en créditos de uso, diez dólares por millón de tokens en entrada y cincuenta en salida, exactamente el doble de la tarifa estándar de Opus 5 y Opus 4.8, cinco dólares en entrada y veinticinco en salida según la página de tarifas de Claude. El modo sigue fuera de alcance en Bedrock, Vertex, Foundry y Claude Platform on AWS, y exige créditos de uso activados en la cuenta; para un plan Team o Enterprise, permanece desactivado por defecto mientras un titular del rol Owner no lo active para la organización. Activar este modo factura una vez el costo completo del contexto de conversación ya acumulado, en tokens no almacenados en caché: este costo es más bajo cuando el modo rápido se activa desde el inicio de una sesión, pero desactivarlo y luego reactivarlo más tarde no repite esta carga. Multiplicar las sesiones en worktrees multiplica por tanto también este costo potencial tantas veces como sesiones haya donde el modo rápido se ejecute en paralelo. La reanudación de un comando largo en uno de estos worktrees sigue la misma lógica de tarea en segundo plano que el modo headless y las tareas en segundo plano.
Sesión única frente a sesión en worktree aislado
| Aislamiento y costo de una sesión paralela | Aislamiento del código | Riesgo de colisión entre sesiones | Puesta en marcha |
|---|---|---|---|
| Sesión única en el repositorio principal | Una sola copia del código, todos los cambios se mezclan | Dos sesiones en el mismo repositorio escriben en los mismos archivos | Ningún comando adicional |
| Sesión lanzada con claude --worktree | Un checkout aislado bajo .claude/worktrees, en su propia rama | Cada sesión escribe en su propia carpeta, nada se cruza | Un solo comando, la creación de la rama y de la carpeta es automática |
Una desarrolladora lanza claude --worktree rapport-mensuel en su repositorio, y luego lanza claude --worktree tableau-bord desde una segunda ventana de terminal abierta en el mismo repositorio.
Escriba en una frase lo que esta situación establece, y en una frase lo que no establece.
Lo que esto establece: Esta situación establece que se crearon dos checkouts aislados en dos ramas distintas, uno para rapport-mensuel y otro para tableau-bord, en el mismo repositorio.
Lo que esto no establece: No establece que estas dos sesiones usen el mismo modelo o el mismo modo de velocidad, ya que cada sesión elige estos ajustes independientemente de la otra.
Los tres calibrados falsos más frecuentes
- Demasiado amplio Esta situación establece que las dos sesiones se fusionarán automáticamente una en la otra al final del trabajo.
- Demasiado estrecho Esta situación no establece nada en absoluto, ya que todavía no se describió ninguna modificación de archivo en ninguna de las dos sesiones.
- Fuera de tema Esta situación muestra que el repositorio ya contenía una rama llamada rapport-mensuel antes incluso de que se escribiera el comando.
- claude --worktree (o -w) crea y aísla ahora automáticamente un checkout en su propia rama, donde antes solo existía el gesto manual git worktree add.
- El gesto manual git worktree add sigue siendo necesario para partir de una rama existente precisa o colocar el worktree fuera del repositorio.
- --continue, --resume y el modo interactivo retoman automáticamente una sesión en su propio worktree, sin comando adicional.
- El modo rápido, activado por /fast, solo existe en Opus 5 y Opus 4.8, ya no en Opus 4.7 donde antes existía y cuyo soporte ahora está retirado, y factura el doble de la tarifa estándar, diez dólares en entrada y cincuenta en salida, bajo la condición de créditos de uso activados y fuera de Bedrock, Vertex, Foundry y Claude Platform on AWS.
- Activar el modo rápido desde el inicio de una sesión factura un costo de contexto más bajo que activarlo sobre la marcha, pero desactivarlo y luego reactivarlo más tarde no repite esa carga.
Desde un repositorio git existente en su equipo, lance claude --worktree essai-parallele en una terminal, verifique que la carpeta .claude/worktrees/essai-parallele/ apareció en su propia rama, y luego cierre esa sesión sin fusionar nada.
Cada afirmación datable de esta lección remite aquí al texto público que la respalda. Una fuente que no se abre no prueba nada.
- Claude Code, worktrees, indicador --worktree e integración nativa consultée le 2026-09-02
- Claude Code, modo rápido, disponibilidad y tarifa consultée le 2026-09-02
- Claude, tarificación de los modelos, tarifa estándar de Opus 5 y Opus 4.8 consultée le 2026-09-02