La situación que todos acaban viviendo: Claude lleva quince minutos en
mitad de un refactor gordo en un terminal… y entra un bug real que necesita un arreglo de una línea en
main ya. Si interrumpes la sesión, pierdes contexto y probablemente trabajo. Si
esperas, el bug sigue vivo una hora. Hay una tercera opción.
Qué es un worktree, en realidad
Un worktree de Git es una segunda copia de tu proyecto en disco, apuntando a otra rama,
compartiendo el mismo repo por debajo. Dos carpetas. Dos ramas. Un proyecto.
--worktree es el flag de Claude Code que abre una sesión en una de esas carpetas
paralelas.
La versión en llano: en vez de cambiar de rama dentro de una carpeta (lo que le
quitaría el suelo a tu sesión de Claude en marcha), mantienes una segunda carpeta con su propia rama y
lanzas ahí un Claude aparte. Dos sesiones, dos cerebros, cero pisotones.
El flujo de los dos cerebros
🧠 Cerebro 1 (el largo)
Trabaja en refactor/payments en tu
carpeta de siempre. Dejas a Claude moler el cambio multi-archivo.
⚡ Cerebro 2 (el rápido)
Levantas un worktree en
hotfix/login-redirect: carpeta nueva, terminal nuevo, sesión nueva. Le das el arreglo de
una línea.
Ambos corren en paralelo sin saber el uno del otro; fusionas cada uno cuando termina. La clave:
cada sesión está aislada en su carpeta — no pueden pelearse por archivos porque literalmente no
miran los mismos. Git cose las ramas cuando estés listo.
Cuándo usarlo
- ✅ Algo multi-hora en una rama y una cosita no relacionada tiene que pasar en otra.
- ✅ Quieres hacer A/B de dos enfoques al mismo problema sin perder ninguno — un worktree prueba A, otro prueba B, comparas diffs al final.
- ✅ Estás demostrando o revisando en una rama mientras otro Claude construye en otra.
Cuándo NO usarlo
- ❌ Trabajo en solitario en una rama — no lo necesitas; un terminal basta.
- ❌ Cuando las dos ramas necesitan compartir estado vivo en vuelo — las ramas de Git son independientes a propósito.
- ❌ Si aún no conoces el techo de las 3 sesiones (siguiente lección). No pases de un Claude a cuatro.
🖥️ Escritorio vs CLI, honestamente: los worktrees son un movimiento de CLI. La
app de escritorio no tiene un menú amable de «abrir este worktree» — pero la carpeta del worktree es
solo una carpeta, así que la app la abre encantada como proyecto una vez existe. Móntalo en el
terminal, luego usa la superficie que prefieras por carpeta.
✅ Hecho cuando: has creado un worktree, lanzado una segunda sesión de Claude
dentro, y publicado un cambio pequeño en esa rama mientras una tarea más larga corría en la carpeta
original.
Fuente: Claude Code Club · Aula · Etapa 7 «Agents» — lección «claude --worktree — Dos ramas, dos cerebros».
Nota: lección de texto, sin infografía. · Añadido al cuaderno: 7 de julio de 2026. Traducción al español para estudio personal.