Ir al contenido
Mastering Claude

Inicio / Gestos cotidianos

Gestos cotidianos10 minApplication

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.

Figure 1

Sesión única frente a sesión en worktree aislado

Aislamiento y costo de una sesión paralelaAislamiento del códigoRiesgo de colisión entre sesionesPuesta en marcha
Sesión única en el repositorio principalUna sola copia del código, todos los cambios se mezclanDos sesiones en el mismo repositorio escriben en los mismos archivosNingún comando adicional
Sesión lanzada con claude --worktreeUn checkout aislado bajo .claude/worktrees, en su propia ramaCada sesión escribe en su propia carpeta, nada se cruzaUn solo comando, la creación de la rama y de la carpeta es automática
La comparación cruza tres criterios, aislamiento del código, riesgo de colisión entre sesiones y puesta en marcha, entre una sesión única en el repositorio principal y una sesión lanzada con claude --worktree.
Calíbralo tú mismo

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 hay que recordar
  • 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.
Hazlo ahora

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.

Verificar en la fuente

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.