Cargando

Paralelización de Claude Code

Lección 613 min
Cargando

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.

Tres instancias de Claude Code trabajando en un mismo proyecto: "Add logging", "Support .pptx files", "Investigate failing test".

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.

Cuatro instancias de Claude Code, cada una con su propia copia de tu proyecto, para tareas como "Define a resource" y "Add logging".

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.

Rama feature_a en Folder One y feature_b en Folder Two, cada una con el mismo main.py, tools/document.py y tools/math.py.

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.

Diagrama de las ramas worktree feature_a y feature_b, cada una con un commit, fusionándose de nuevo en la rama principal.

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.

Prompt para crear un worktree llamado feature_a en la carpeta .trees, detenerse si ya existe, crear symlink de .venv y lanzar VS Code.

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:

  1. Cree un nuevo git worktree en una carpeta específica
  2. Cree symlinks de las dependencias que no están rastreadas por Git
  3. Lance una nueva instancia de VS Code en ese directorio

Prompt para crear un worktree llamado feature_a en .trees: detenerse si ya existe, crear symlink de .venv, lanzar VS Code con "code".

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.

Una segunda ventana de VS Code llamada feature_a, ejecutando Claude Code en la copia del worktree de los archivos del proyecto.

El comando personalizado puede referenciar $ARGUMENTS, que se reemplaza por los argumentos que le pases a tu comando. Por ejemplo:

  • /project:create_worktree feature_a crea un worktree llamado "feature_a"
  • /project:create_worktree develop crea 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:

Cuatro ventanas de VS Code con los mismos archivos del proyecto, etiquetadas "Document tests", "Add Logging", "Add notes tool", "Add math tool".

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

Prompt para fusionar el worktree $ARGUMENTS en .trees/$ARGUMENTS, usando comandos como "git status" para listar conflictos de fusión.

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:

  1. Cambie al directorio del worktree
  2. Examine el último commit
  3. Regrese al directorio raíz
  4. Fusione la rama del worktree
  5. Maneje automáticamente cualquier conflicto de fusión

VS Code con create_worktree.md y merge_worktree.md en .claude/commands, y Claude Code ejecutándose en la terminal.

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.