Claude Code: prueba cada cambio en su propia rama (git worktree)

Un worktree de git es una copia de tu proyecto en otra carpeta, con su propia rama, para trabajar en paralelo sin tocar la copia de siempre. Es como sacar una fotocopia para hacer pruebas y poder tirarla después.

Con la opción --worktree (o su forma corta -w), Claude Code arranca en una de esas copias aisladas. Todo lo que escriba y ejecute se queda ahí: tu carpeta de trabajo y tu rama principal no se tocan.

Si el cambio te gusta, lo unes (lo fusionas) a tu rama buena. Si no, borras la copia y sigues como estabas, sin restos.

• Probar sin miedo. Puedes pedirle un cambio grande sabiendo que, si sale mal, tu proyecto bueno no se entera.
• Comparar caminos. Probar una idea en una copia y otra distinta en otra, y quedarte con la mejor.
• Trabajar en varios frentes a la vez. Cada sesión en su copia, sin que se pisen los ficheros.

Es especialmente útil cuando no controlas mucho de git: la red de seguridad la pone Claude Code por ti.

• Abre la terminal en la carpeta de tu proyecto. El proyecto tiene que estar bajo git (si no lo está, primero hay que iniciarlo).

• Arranca Claude Code con la opción de copia aislada:

claude --worktree

La forma corta es claude -w. También puedes añadirle un nombre a la copia para reconocerla.

• Pídele el cambio con normalidad. Claude trabajará en una copia aparte, dentro de .claude/worktrees/, en su propia rama de git.

• Decide qué hacer con el resultado: si te convence, le dices que lo una a tu rama principal; si no, se descarta la copia y listo.

• Truco extra: en los subagentes también existe la opción isolation: "worktree", que hace lo mismo para el trabajo de un subagente.

• Hace falta git. Si tu proyecto no usa git, esta opción no tiene sentido. Además conviene entender lo básico de las ramas para no perderse entre copias.
• Ocupa espacio en disco. Cada copia es un proyecto entero. Si haces muchas y no las borras, se acumulan.
• Hay que limpiarlas. Cuando termines con una copia, conviene quitarla. Si no, se quedan por ahí.
• Claude Code es de pago (plan Pro o clave de API). No entra en el plan gratuito de Claude.

Comprobado el 06/10/2026 en la documentación oficial de Claude Code: la referencia de la línea de órdenes (cli-reference) describe --worktree/-w como una «copia aislada de git» en .claude/worktrees/ y la guía de flujos de trabajo (common-workflows) lo explica en «Run parallel sessions with worktrees».

1. Me dice que no hay un repositorio de git. Tu carpeta no está bajo git. Primero hay que iniciar el control de versiones ahí.

2. No encuentro la copia. Las copias se crean dentro de .claude/worktrees/. Míralo ahí para ver todas las que tienes abiertas.

3. Se me han acumulado copias y no sé cuál es cuál. Ponles nombre al crearlas (con la opción --worktree y un nombre detrás) para reconocerlas de un vistazo.

4. He hecho cambios en la copia equivocada. No pasa nada: cada copia tiene su rama. Revisa con git qué rama está activa y une solo la que quieras.