Código y publicación

Qué es un worktree

Un worktree de Git es una carpeta adicional del mismo repositorio —el proyecto con su historial— para avanzar en otra tarea sin alterar la carpeta original.

Por

Director de Ciade · 7 min de lectura ·

Foto: Joshua Sun / Unsplash · tratamiento Ciade · Licencia de Unsplash
Índice del artículo
  1. En 30 segundos
  2. Una urgencia mientras renuevas la web
  3. Un expediente, dos mesas
  4. Cómo se abre con Claude Code
  5. De la corrección a la publicación
  6. Lo que no separa una carpeta nueva
  7. Cuándo te compensa y por dónde seguir
  8. Dudas sobre worktrees, respuestas cortas

En 30 segundos

  1. Un worktree de Git es una carpeta adicional del mismo repositorio —el proyecto con su historial— para avanzar en otra tarea sin alterar la carpeta original.

  2. Es una función de Git, el programa que guarda el historial de cambios. Puedes utilizarla sin inteligencia artificial; un agente, un programa que realiza tareas con herramientas, también puede trabajar en ella.

Una urgencia mientras renuevas la web

Una tienda de suministros de Valencia está renovando las fichas de producto de su web. El trabajo va a medias cuando la dueña detecta un precio mostrado incorrecto. Es un ejemplo ilustrativo: se corrige un texto de prueba, sin modificar cobros ni pedidos. La dueña necesita atender la corrección y conservar lo que ya está en marcha.

El responsable técnico abre otra carpeta del mismo proyecto y prepara allí la corrección. La renovación mantiene sus archivos tal como estaban. La dueña confirma el precio correcto; el técnico comprueba el cambio y decide cómo incorporarlo. Esa es la utilidad del worktree: mantener abiertas las dos tareas, cada una con sus archivos, en lugar de mezclar la urgencia con una renovación incompleta.

Un expediente, dos mesas

El expediente

El repositorio conserva la historia del proyecto. Las carpetas enlazadas comparten ese historial; abrir otra mesa no convierte el trabajo en otro proyecto.

La línea de cambios

Una rama identifica una línea de cambios dentro de ese historial. Puedes dedicar una a renovar las fichas y otra a corregir el precio mostrado.

La mesa de trabajo

El worktree aporta otra carpeta para editar. Cada tarea tiene sus archivos a la vista, aunque las dos pertenezcan al mismo repositorio.

No lo confundas con una rama o una clonación

Otra rama

Qué abre: Otra línea de cambios. Crear la rama no abre una carpeta adicional.

Cuándo encaja: Cuando cambias de tarea de forma sucesiva en una misma carpeta.

Otro worktree

Qué abre: Otra carpeta de trabajo enlazada al mismo repositorio.

Cuándo encaja: Cuando necesitas mantener tareas abiertas en carpetas distintas.

Otra clonación

Qué abre: Otro repositorio local con su propia carpeta, independiente del primero.

Cuándo encaja: También permite trabajo paralelo, pero exige coordinar repositorios separados.

Dentro de **una misma carpeta**, dos sesiones siguen viendo el mismo juego de archivos aunque cada tarea tenga su propia rama. Si estos conceptos son nuevos para ti, empieza por las explicaciones de repositorio y rama enlazadas más abajo.

Cómo se abre con Claude Code

Claude Code lee un proyecto, modifica archivos y ejecuta órdenes. Si ya tienes acceso a la herramienta, puedes iniciar una sesión en un worktree con una orden. La orden siguiente se escribe en la terminal, la aplicación donde introduces comandos. Es una orden de Claude Code; Git tiene su propia orden para añadir carpetas de trabajo.

La carpeta nueva parte de un estado guardado en Git, llamado commit. Por defecto, Claude Code usa la rama principal remota, la versión de referencia del proyecto guardada en su origen compartido. No copia los cambios que tienes pendientes de guardar en el historial. Antes de empezar, confirma con el técnico desde qué versión se abrirá: la que ya está publicada, por ejemplo, puede ser distinta de la renovación que está a medias. Necesitas tener el repositorio preparado y ese punto de partida claro antes de empezar.

Abrir otra sesión
claude --worktree precios-urgentes
Abre una sesión de Claude Code en otra carpeta y crea la rama para esta tarea. Requiere acceso a Claude Code y un repositorio preparado.

De la corrección a la publicación

  1. Acotar el encargo
  2. Abrir otra carpeta
  3. Corregir y probar
  4. Revisar el cambio
  5. Integrar
  6. Autorizar publicación

Integrar significa incorporar los cambios de una rama a otra. Puede haber un conflicto si las tareas han modificado partes incompatibles: el técnico debe resolverlo y comprobar el resultado conjunto. Separar carpetas no evita esa revisión. Terminar la corrección tampoco autoriza por sí solo a publicarla; conviene dejar claro quién toma esa decisión.

Lo que no separa una carpeta nueva

El worktree no es otro ordenador. Puede necesitar que prepares las dependencias, los programas que el proyecto utiliza para funcionar, y sus archivos de configuración. Si la web no arranca, comprueba ese entorno antes de dar por fallida la corrección. Tampoco copies credenciales automáticamente para que arranque: el acceso a servicios debe corresponder al encargo de prueba.

Las bases de datos y las cuentas externas se configuran aparte. Si ambas carpetas apuntan a la misma base de datos, podrán afectar al mismo destino. Separar los archivos no crea otra base de datos ni restringe por sí solo los accesos. En la tienda del ejemplo, pide datos de prueba y comprueba que la corrección no tenga acceso a los pedidos o al proveedor de pagos reales.

Encargo para una prueba
Prepara la corrección del precio mostrado en una carpeta de trabajo aparte.
Indica desde qué estado guardado del proyecto partes.
Trabaja solo sobre el texto de prueba autorizado.
No modifiques pedidos, cobros ni la base de datos de producción.
Enséñame qué has cambiado y qué comprobaciones has realizado.
Deja pendiente la publicación y conserva el trabajo hasta que esté revisado.
Prueba la corrección de la tienda de Valencia con este encargo. Configura los accesos de prueba antes de ejecutarlo; el texto no sustituye esos controles.

Cuándo te compensa y por dónde seguir

Si solo tienes una tarea abierta, puedes seguir con una sola carpeta. El worktree encaja cuando necesitas conservar trabajo incompleto mientras atiendes otra tarea, o cuando varias personas o agentes preparan cambios distintos. Al repartir el trabajo, acuerda qué prepara cada persona o agente y quién revisa e integra los cambios.

Para entender las piezas, consulta qué es un repositorio y qué es una rama. Si vas a repartir encargos a agentes, el siguiente paso es Claude Code a fondo, donde se trabaja el uso de worktrees en tareas paralelas. Un subagente reparte trabajo; una carpeta separa archivos. Puedes combinar ambas cosas, pero ninguna activa automáticamente la otra.

Dudas sobre worktrees, respuestas cortas

¿Cada worktree tiene que estar en otra rama?

Para separar tareas, lo habitual es asignar una rama distinta a cada carpeta. Git también permite abrir un estado sin rama asociada, así que un worktree no crea una rama obligatoriamente. Por defecto, impide abrir en otra carpeta una rama que ya está en uso.

¿Es una copia de seguridad del proyecto?

No conviene tratarlo como tal: las carpetas enlazadas comparten el repositorio. Su función es ofrecer lugares de trabajo separados dentro del mismo proyecto. Otra clonación crea otro repositorio local, pero la elección entre clonar y abrir un worktree depende de cómo necesites organizar las tareas y coordinar sus cambios.

¿Puedo borrar la carpeta al terminar?

Primero comprueba que el trabajo esté revisado y conservado. Retirar una carpeta de Git y borrar una rama son operaciones distintas. En Claude Code, la opción de retirada puede eliminar ambas. No aceptes una limpieza si todavía necesitas revisar, integrar o recuperar los cambios de esa tarea.

¿Abrir más worktrees amplía el uso de Claude Code?

No. Las carpetas nuevas no añaden cuota a tu suscripción: Claude y Claude Code comparten límites. El acceso mediante una API, una conexión para usar el servicio desde un programa, puede facturarse aparte. Antes de abrir sesiones paralelas, comprueba con qué cuenta se ejecutan y cómo se cobra su consumo.

Fuentes

Fuentes oficiales, consultadas el 4 de noviembre de 2026

  1. F1 · Git · Carpetas de trabajo enlazadas
  2. F2 · Git · Ramas
  3. F3 · Git · Clonación de repositorios
  4. F4 · Git · Integración y conflictos
  5. F5 · Git · Programa libre y de código abierto
  6. F6 · Git · Distribución e instalación
  7. F7 · Claude Code · Sesiones paralelas con worktrees
  8. F8 · Claude Code · Qué hace la herramienta
  9. F14 · Claude Code · Aislamiento de archivos y red
  10. F10 · Claude · Condiciones y límites de Pro
  11. F16 · Claude Code · Uso compartido y facturación

Cómo lo comprobamos. No hay resultados medidos de este caso. Ciade usa Claude Code a diario desde España y el curso conserva una demostración anterior de trabajo paralelo. No se ha repetido esta prueba para la actualización. Las fuentes cubren el funcionamiento de Git, la apertura de sesiones, sus límites y la configuración de accesos.

Qué ha cambiado.

  • 4 de noviembre de 2026: Reescrito como v2: ejemplo de Valencia, analogía visual, comparación con ramas y clonaciones, punto de partida, integración, accesos y limpieza.

Términos relacionados

Aprende a usar la IA en tu trabajo, con criterio.

El nivel 0 es gratis: cuarenta minutos para entender qué pedirle a la IA y qué revisar. El programa completo enseña a implementarla en tu propio negocio, tarea a tarea.

El canal de Telegram de Ciade

El lunes, una palabra del glosario. El miércoles, un consejo práctico. El viernes, las noticias de IA de la semana. Y el martes, el boletín.

Unirme al canal

Tú decides qué medimos

Las cookies técnicas hacen que la web funcione. Con tu permiso, además, medimos las visitas con Ahrefs y de qué campaña llegas, y Meta mide nuestros anuncios y puede mostrarte los de Ciade en Facebook e Instagram. Puedes cambiarlo cuando quieras en «Configurar cookies», al pie de la página. Política de cookies