Guía31 de agosto de 2026

Cómo ejecutar varios agentes de Claude Code en paralelo

Una tarea por worktree, una ruta de revisión por resultado y ningún checkout compartido que pueda corromperse.

La forma más segura de ejecutar varios agentes de Claude Code en paralelo es asignar un Git worktree distinto a cada tarea independiente. Claude Code puede crear esos worktrees por sí mismo. Agentastic añade la capa operativa: preparación del repositorio, estados visibles, terminales nativos, contenedores, pruebas en navegador, revisión del diff y una ruta clara hacia el pull request.

Worktrees paralelos de Claude Code con entornos y puertos aislados desde un repositorio Git

Resumen rápido#

NecesidadMejor punto de partida
Dos sesiones aisladas de Claude sin otra interfazclaude --worktree <nombre>
Control completo de ramas y directoriosgit worktree add y un terminal por tarea
Varios agentes, preparación repetible, revisión o proveedores mezcladosWorkspaces de Agentastic
Aislamiento de paquetes, procesos o serviciosModo contenedor de Agentastic

La documentación oficial de Claude Code explica --worktree, .worktreeinclude, el aislamiento de subagentes y la limpieza. La guía de agentes en paralelo ayuda a elegir entre worktrees, subagentes, agent view y equipos coordinados.

Por qué no bastan varios terminales#

Dos terminales abiertos sobre el mismo repositorio siguen compartiendo el mismo directorio de trabajo. Las sesiones pueden sobrescribir archivos sin confirmar, invalidar la compilación de la otra, competir por el índice de Git o arrancar servidores en el mismo puerto.

Una rama no crea aislamiento físico. Un worktree sí: cada tarea recibe sus propios archivos, dependencias locales, artefactos, archivos ignorados y diff.

Opción 1: worktrees nativos de Claude Code#

Desde un repositorio Git:

bash
claude --worktree corregir-checkout claude --worktree pruebas-cupones claude --worktree documentar-reembolsos

Si el checkout necesita archivos ignorados, añade una lista explícita a .worktreeinclude:

text
.env .env.local config/secrets.json

Esta opción es excelente cuando Claude Code es el único agente y quieres que el producto oficial gestione la sesión.

Opción 2: worktrees manuales#

bash
git fetch origin git worktree add -b agent/fix-checkout \ ../store-fix-checkout origin/main git worktree add -b agent/coupon-tests \ ../store-coupon-tests origin/main

Después inicia Claude en cada checkout:

bash
cd ../store-fix-checkout && claude cd ../store-coupon-tests && claude

Es la ruta más transparente, pero tú administras preparación, puertos, procesos, estados, revisión, merge y limpieza.

Opción 3: varias sesiones de Claude Code en Agentastic#

Agentastic ejecuta el CLI oficial que ya has instalado y autenticado. No sustituye Claude Code ni intermedia las llamadas al modelo.

1. Verifica primero el CLI#

bash
which claude claude --version

2. Crea una tarea delimitada#

Abre el repositorio en Agentastic, entra en Agent Home, elige la rama base, Claude Code y el modo Worktree.

Un prompt útil define resultado, restricciones y verificación:

text
Corrige la regresión de redondeo del checkout. No cambies la API pública de dinero. Mantén el comportamiento actual para USD y EUR. Ejecuta la suite enfocada de checkout y explica la causa raíz al terminar.

3. Una tarea independiente por workspace#

Por ejemplo:

  • fix-checkout-rounding
  • add-zero-coupon-tests
  • update-refund-docs

Agentastic crea una rama y un worktree por tarea, ejecuta la preparación del proyecto y mantiene la sesión, el terminal, el navegador y el diff asociados al mismo workspace.

4. Automatiza la preparación#

Crea .agentastic/setup.sh:

bash
#!/usr/bin/env bash set -euo pipefail if [ -f "$AGENTASTIC_MAIN_REPO_PATH/.env" ] && [ ! -f .env ]; then cp "$AGENTASTIC_MAIN_REPO_PATH/.env" .env fi if [ -f package-lock.json ]; then npm ci elif [ -f pnpm-lock.yaml ]; then pnpm install --frozen-lockfile fi

Hazlo ejecutable con chmod +x .agentastic/setup.sh. El script debe ser idempotente para que pueda repetirse sin destruir estado.

5. Supervisa excepciones, no cada token#

El navegador de Agentes muestra qué sesiones están trabajando, esperando una respuesta, finalizadas o fallidas. Mayús-Comando-U salta al siguiente agente que necesita atención.

6. Verifica cada resultado#

Para cada worktree:

  1. Revisa la salida de pruebas.
  2. Inspecciona todos los archivos cambiados.
  3. Ejecuta tú mismo la verificación importante.
  4. Abre el servidor de ese worktree en el navegador integrado.
  5. Usa un agente nuevo como revisor cuando el riesgo lo justifique.

Agentastic puede enviar el mismo diff a Claude, Codex, CodeRabbit, Greptile o un revisor personalizado.

Qué tareas conviene paralelizar#

Funcionan bien las pruebas de módulos distintos, bugs independientes, documentación, endpoints separados y varios intentos donde solo conservarás uno.

Mantén en secuencia dos refactors del mismo tipo central, una migración y el código que depende de su forma final, cambios sobre el mismo archivo generado o tareas que comparten una base de datos mutable.

El límite práctico lo marca tu capacidad de revisar. Si los diffs terminados se acumulan, más agentes reducen el rendimiento real.

Cuándo usar contenedores#

Los worktrees aíslan archivos, pero no procesos, puertos, credenciales, paquetes globales ni servicios externos. Usa el modo contenedor cuando también necesites límites de runtime, montajes o red.

Descarga Agentastic para macOS o consulta Tu primer agente.

Más información#