Ejecutar varias instancias de Claude Code en paralelo es una de las mayores ganancias de productividad que puedes lograr. Dado que Claude es ligero, puedes poner en marcha fácilmente varias copias, asignarle a cada una una tarea diferente y hacer que trabajen simultáneamente. Esto, en la práctica, te da un equipo de ingenieros de software virtuales trabajando en tu proyecto.
El desafío: conflictos de archivos
El principal problema con las instancias paralelas es que pueden intentar modificar los mismos archivos al mismo tiempo. Esto puede generar código conflictivo o inválido, ya que cada instancia no tiene conocimiento de lo que están haciendo las demás.

La solución es darle a cada instancia de Claude su propio espacio de trabajo independiente. Cada instancia trabaja con su propia copia de tu proyecto, realiza cambios de forma aislada y luego fusiona esos cambios de nuevo con tu proyecto principal.

Git worktrees
Los git worktrees son perfectos para este flujo de trabajo. Si tu proyecto ya está gestionado con Git, puedes usar worktrees de inmediato. Son como una extensión de la funcionalidad de ramificación (branching) de Git que te permite crear copias completas de tu proyecto en directorios separados en tu máquina.

Cada worktree corresponde a una rama independiente. Puedes tener una carpeta para la función A y otra para la función B, cada una con una copia completa de tu base de código. Luego ejecutas instancias independientes de Claude Code en cada worktree, trabajando en total aislamiento.

Una vez que cada instancia de Claude termina su función, haces commit del trabajo y lo fusionas de nuevo con tu rama principal, igual que al fusionar cualquier rama normal de Git.

Automatización de la creación de worktrees
Esto puede sonar complicado de gestionar, pero puedes delegar todo el flujo de trabajo al propio Claude Code. Puedes escribir un prompt que le pida a Claude que:
- Cree un nuevo git worktree en una carpeta específica
- Cree symlinks de las dependencias que no están rastreadas por Git
- Lance una nueva instancia de VS Code en ese directorio

Comandos personalizados
En lugar de copiar y pegar prompts largos cada vez, puedes crear comandos slash personalizados en Claude Code. Agrega un archivo .md a .claude/commands para crear un comando personalizado.

El comando personalizado puede referenciar $ARGUMENTS, que se reemplaza por los argumentos que le pases a tu comando. Por ejemplo:
/project:create_worktree feature_acrea un worktree llamado "feature_a"/project:create_worktree developcrea un worktree llamado "develop"
Desarrollo paralelo en acción
Así es como se ve el flujo de trabajo completo en la práctica. Puedes crear varios worktrees para diferentes funciones:

Cada instancia de Claude trabaja en su tarea asignada:
- Actualizar las pruebas de documentos
- Agregar registro (logging)
- Agregar herramientas de toma de notas
- Agregar una herramienta de resta

Fusión de cambios
Cuando las funciones estén completas, también puedes automatizar el proceso de fusión. Crea otro comando personalizado que le indique a Claude que:
- Cambie al directorio del worktree
- Examine el último commit
- Regrese al directorio raíz
- Fusione la rama del worktree
- Maneje automáticamente cualquier conflicto de fusión

Claude puede incluso resolver conflictos de fusión automáticamente, basándose en su comprensión de los cambios realizados en cada rama.
Resultados
Este enfoque escala a tantas instancias paralelas como puedas gestionar. En lugar de trabajar en las funciones de forma secuencial, puedes tener varias instancias de Claude desarrollando diferentes partes de tu proyecto simultáneamente. Es como tener tu propio equipo de desarrolladores, cada uno trabajando en su propio entorno aislado antes de unir su trabajo.
Las ganancias de productividad son sustanciales: en esencia, estás multiplicando tu capacidad de desarrollo por la cantidad de instancias paralelas que ejecutes.