Worktrees en Claude Code: sesiones sin pisarse
Con worktrees, cada sesión de Claude Code trabaja en su propia copia del proyecto y puedes llevar varias a la vez sin que se pisen. Así se activan.
Llevar varias sesiones de Claude Code a la vez tiene un problema práctico: si trabajan sobre la misma carpeta, una puede cambiar lo que otra está editando. Los worktrees lo resuelven: cada sesión trabaja en su propia copia del proyecto.
Es el día 27 de #30DaysOfClaude; el resto de tips está en el índice de la serie.
¿Qué son los worktrees en Claude Code?
Según la documentación de Claude Code, un worktree es un directorio de trabajo aparte, con sus propios ficheros, que comparte la historia del proyecto. Si cada sesión tiene el suyo, una puede rehacer la página de precios mientras otra arregla el formulario de contacto, y los cambios no chocan. Cuando terminan, revisas cada una y te quedas con lo que vale.
Cómo activar un worktree en Claude Code
Hay dos formas:
- A mano, en la app de escritorio: + New session y marca la opción worktree. Cuando termines, archiva la sesión desde la barra lateral y la copia se borra.
- Pidiéndoselo a Claude en mitad de la sesión. Él crea el worktree y se pasa a trabajar ahí:
Haz [los cambios del formulario de contacto] en un worktree nuevo.
Tu paso para hoy: la próxima vez que tengas dos cambios independientes en el mismo proyecto, ábrelos en dos sesiones, cada una con su worktree, y revisa cada resultado por separado.
¿Cuándo no hacen falta los worktrees?
- Si las tareas dependen una de otra. Si la segunda necesita lo que haga la primera, en paralelo solo vas a tener que juntarlas a mano.
- Si prefieres que coordine Claude. Con Projects en Claude Code, le das todo en una conversación y él reparte el trabajo y te dice qué espera tu respuesta.
- Si tu carpeta no usa Git. Los worktrees necesitan que el proyecto esté en Git, como casi todo proyecto de código.
¿Qué dos cambios de tu proyecto podrían ir a la vez esta semana?
Preguntas frecuentes
¿Qué es un worktree en Claude Code?
Una copia aparte de tu proyecto, con sus propios ficheros, para una sola sesión de Claude. Así puedes tener varias sesiones trabajando a la vez sin que una toque lo que está cambiando otra.
¿Cómo se activa un worktree?
A mano, en la app de escritorio: + New session y marca la opción worktree. O pidiéndoselo a Claude durante la sesión: "haz los cambios en un worktree nuevo", y él lo crea.
¿Cómo se quita cuando termino?
En la app de escritorio, archiva la sesión desde la barra lateral y el worktree se borra.