Índice del artículo
Qué es
Un worktree es una segunda carpeta de trabajo del mismo repositorio: otra copia de los archivos del proyecto, abierta en su propia rama. Las dos carpetas son del mismo proyecto, pero trabajan por separado.
Para qué sirve: para que dos tareas —o dos agentes— avancen a la vez sin pisarse. Cada una edita sus archivos en su carpeta, y lo que se aprueba se junta después, como se juntan las ramas.
Explicado fácil
Piensa en un despacho con un expediente y dos abogados que lo necesitan al mismo tiempo: en una sola mesa se estorban. La solución no es otro expediente, sino una copia para cada mesa. Las dos copias son del mismo caso, cada quien trabaja sobre la suya y las notas se integran al expediente único al final.
El worktree es esa segunda mesa: la historia es la del proyecto; la carpeta, aparte.
Ejemplo práctico
Una tienda en línea tiene su web en un repositorio. La dueña le encargó al agente un cambio grande: renovar todas las fichas de producto. El trabajo va por la mitad cuando llega lo urgente: la página de pago muestra un precio equivocado.
Corregirlo en la misma carpeta mezclaría lo urgente con el cambio grande a medias. La dueña pide una segunda carpeta de trabajo con su propia rama y le encarga ahí la corrección: se trabaja aparte, sin tocar el cambio grande; después se revisa y se integra, resolviendo los conflictos que puedan salir.
En herramientas para agentes como Claude Code, esa segunda carpeta se abre con una sola instrucción.
claude --worktree precios-urgentesAsí no
Corregir lo urgente en la misma carpeta donde un cambio grande va a medias.
Así sí
Una carpeta de trabajo por tarea, cada una en su propia rama.
Las dos carpetas son del mismo proyecto: lo que se aprueba se junta después, no se copia a mano.
Por qué te importa
Porque convierte el «espera a que termine» en «adelante, en paralelo». Con una carpeta por tarea, lo urgente no espera al cambio grande ni lo pone en riesgo. Y si trabajas con varios agentes, es la pieza que reparte la mesa: cada agente trabaja en su carpeta y nadie estorba a nadie.
El error típico
Creer que la rama basta para trabajar en paralelo. La rama separa la línea de cambios, no los archivos: en una sola carpeta hay un solo juego de archivos a la vez, y al cambiar de rama los archivos cambian para quien trabaja ahí. Dos tareas a la vez piden dos carpetas.
El otro error es acumular carpetas sin recoger: cada carpeta es trabajo vivo. Lo que se aprueba se junta y la carpeta que sobra se limpia.
No lo confundas con
La rama. La rama es la línea de cambios; el worktree es la carpeta donde esa línea está abierta. Una rama sola no separa los archivos.
El repositorio. No son dos proyectos: las carpetas son del mismo repositorio, con la historia del proyecto. Lo que cambia es dónde trabaja cada quien.
Términos relacionados
Consultoría
¿Quieres esto en tu negocio, montado y funcionando?
Mira los ejemplos de automatizaciones (atención por WhatsApp, recepcionista por voz, pedidos y stock, documentos, correo) o cuéntanos tu caso: te decimos qué automatizar primero y el precio por escrito.
¿Prefieres aprender a hacerlo tú? Apúntate a la lista de espera de la formación →