Nethür
Iniciar sesión
macOS próximamente

Blog · 3 de noviembre de 2026

Cómo ejecutar varios agentes de Claude Code en paralelo

Una guía práctica para sesiones paralelas de Claude Code: por qué un solo checkout se resiste, cómo lo resuelven los git worktrees y cómo mantener varios agentes revisables.

Espacio de trabajo de Nethür con varias sesiones de agentes ejecutándose en paralelo

Una sesión de Claude Code trabaja en un solo hilo dentro de un checkout: lee y escribe los archivos del directorio en el que la iniciaste. Para ejecutar varios agentes de Claude Code en paralelo, dale a cada uno su propio git worktree —un checkout separado en su propio branch— y lanza una instancia de Claude Code en cada uno. Herramientas gestionadas como Nethür automatizan el worktree, la terminal y la contabilidad de revisión.

Una sesión de Claude Code impresiona hasta el momento exacto en que necesitas tres cambios a la vez. El reflejo habitual es abrir tres pestañas de terminal en el mismo repositorio. Funciona durante unos minutos; después, dos agentes editan el mismo archivo, uno cambia de branch bajo los pies del otro y tu ejecución de tests empieza a leer un checkout que ya no existe.

Los agentes en paralelo no son un problema de prompting. Son un problema del sistema de archivos. Claude Code trabaja con archivos normales, así que dos sesiones necesitan dos directorios de trabajo que no compartan branch ni índice.

Por qué las pestañas de terminal no son trabajo en paralelo

Un repositorio git tiene un branch activo por cada árbol de trabajo. Si abres dos sesiones de Claude Code en ese árbol, comparten todo: los mismos archivos, el mismo índice, el mismo node_modules, el mismo puerto del servidor de desarrollo. Las sesiones parecen independientes porque las terminales lo son, pero el código que hay debajo no.

  • Uno de los agentes ejecuta git switch o git rebase y el otro sigue editando los archivos anteriores.
  • Dos agentes escriben el mismo archivo; la última escritura gana y el primer cambio desaparece del árbol de trabajo.
  • Un watcher de tests, un servidor de desarrollo o una migración se ejecutan contra el branch que estuviera activo en ese segundo.
  • Revisar el resultado es adivinar, porque el diff contiene trabajo de todas las sesiones a la vez.

Las pestañas siguen siendo útiles para explorar en solo lectura, seguir logs o hacer una pregunta rápida. Dejan de serlo en cuanto un agente necesita editar archivos y ejecutar tests.

Tres formas prácticas de ejecutar sesiones en paralelo

Hay tres opciones que merece la pena considerar. Se diferencian en cuánto aislamiento te dan y cuánta gestión te dejan a ti.

  1. Pestañas de terminal en un solo checkout: arrancan rápido, pero son inseguras para ediciones concurrentes.
  2. git worktrees manuales con una instancia de Claude Code por worktree: aislamiento real, pero tú gestionas rutas, dependencias y limpieza.
  3. Un espacio de trabajo como Nethür que crea y hace seguimiento de worktrees, ejecuta un agente en cada uno y reúne los diffs y las sesiones en un solo lugar.

Opción 1: crea los git worktrees tú mismo

Un git worktree es un segundo checkout del mismo repositorio, en su propio branch y en su propio directorio. Git comparte la base de objetos, así que la copia sale barata, pero los archivos y el índice son independientes.

git fetch origin
git worktree add ../shop-fix-login -b fix/login origin/main
git worktree add ../shop-fix-billing -b fix/billing origin/main

cd ../shop-fix-login && claude
# second terminal
cd ../shop-fix-billing && claude

Ahora cada instancia de Claude Code ve un directorio distinto y un branch distinto. Puedes pedirle a una que arregle la condición de carrera del login mientras la otra reescribe la facturación, y ninguna puede sobrescribir los archivos de la otra.

El problema es todo lo que un checkout nuevo no tiene. Faltan dependencias, faltan los archivos .env y ambas sesiones pueden intentar usar el mismo puerto. O reinstalas en cada worktree o compartes los directorios pesados que git ignora. Nethür documenta ese mismo problema y sus propias soluciones en la guía de worktrees: rutas compartidas, entradas de nethur.yaml, .worktreeinclude y hooks de configuración.

Opción 2: usa las superficies paralelas nativas de Claude Code

Claude Code no deja de añadir formas de ejecutar más de un flujo de trabajo. La app de escritorio puede ejecutar sesiones en paralelo en git worktrees aislados, y los subagentes y equipos de agentes permiten que una sesión delegue partes de una tarea. Si vives por completo dentro del producto de Anthropic y trabajas solo, puede que te baste.

Esas superficies siguen limitadas a Claude. No te dan un único espacio donde Claude Code, Codex y otros agentes de CLI se ejecuten unos junto a otros, ni ofrecen a los compañeros de equipo un lugar compartido para ver y retomar las sesiones de los demás. Si tu trabajo en paralelo cruza agentes, máquinas o personas, necesitas una capa por encima del agente.

Opción 3: un espacio de trabajo que gestiona los worktrees por ti

Nethür se construye sobre la idea de que una tarea recibe un espacio de trabajo, no una pestaña. Cada worktree es un git worktree real con su propio branch, archivos, terminales, pestañas de editor y pestañas de navegador. Crear uno es un diálogo breve, y el trabajo de git ocurre en segundo plano.

  1. Instala Nethür y añade el repositorio. Si trabajas en equipo, elige la máquina que alojará el trabajo: tu portátil, la máquina de un compañero, un VPS o un destino SSH.
  2. Crea un worktree por cada tarea en paralelo. Ponle el nombre de la tarea, elige la referencia desde la que partir (normalmente origin/main) y vincula un elemento de GitHub, GitLab, Linear o Jira si existe.
  3. Abre el selector de agentes dentro de cada worktree y lanza Claude Code. Nethür lo inicia con ese worktree como directorio de trabajo, así que las dos sesiones no pueden chocar.
  4. Divide los paneles o cambia entre worktrees mientras los agentes trabajan. La barra lateral muestra qué sesiones están trabajando, esperando o terminadas.
  5. Revisa cada diff contra su propia referencia de partida. Conserva el ganador, haz commit y push, abre el pull request desde ese worktree y luego elimina los worktrees perdedores y sus branches.

La diferencia importante no es el botón que crea un worktree. Es que el worktree, la sesión del agente, el diff y la limpieza permanecen unidos a la misma tarea. La receta de agentes en paralelo recorre el mismo flujo con capturas de pantalla y un ejemplo de tres agentes.

¿Qué enfoque encaja con tu trabajo?

EnfoqueAislamiento de archivosConfiguraciónRevisiónEquipo
Pestañas en un solo checkoutNinguno: archivos y branch compartidosInmediataDiff mezclado, separación manualSin vista compartida
git worktrees manualesTotal: un branch por worktreeComandos git, dependencias, archivos envUn diff por directorio, a manoRutas que se pasan por chat
Claude Code de escritorioTotal para sesiones de ClaudeInstalar e iniciar sesiónRevisión integrada para ClaudeSuperficie para un solo usuario
NethürTotal: git worktree o espacio de carpetaAñadir repo, crear worktreeDiffs por worktree, anotaciones, flujo de PRProyectos compartidos, chat, toma de control

Cuatro patrones que aprovechan bien el paralelismo

  • La misma tarea, tres agentes. Da el mismo prompt a Claude Code, Codex y otro CLI en tres worktrees. Compara los diffs en lugar de reintentar en secuencia; las discrepancias suelen señalar la parte difícil.
  • Dividir por superficie. Un agente se encarga del cambio de API, otro de la UI y otro escribe los tests. Vincula el mismo issue a cada worktree para que el contexto siga visible.
  • Implementar y revisar. Deja que un agente haga el cambio mientras otro, en un worktree aparte, lee el diff y busca regresiones. Tú sigues siendo quien desempata.
  • Explorar y entregar. Mantén una sesión de investigación de larga duración en un worktree y una sesión de implementación limpia en otro. El agente de investigación nunca ensucia el branch que estás a punto de fusionar.

Errores que conviene anticipar

  • Dependencias y secretos locales. Un worktree nuevo es un checkout limpio. Comparte node_modules y las cachés, copia los archivos .env con .worktreeinclude o ejecuta un hook de configuración después de crearlo.
  • Puertos y bases de datos. Dos servidores de desarrollo en el 3000 se pelearán. Dale a cada worktree su propio puerto y, cuando sea posible, su propia base de datos o esquema.
  • Archivos generados y migraciones. No ejecutes dos migraciones contra la misma base de datos salvo que las herramientas estén preparadas para ello.
  • Presupuesto de tokens. El paralelismo multiplica el uso. Empieza con dos o tres sesiones, vigila los medidores de uso y detén las que solo están esperando.
  • Deuda de limpieza. Cada worktree es un branch. Elimina los perdedores en cuanto elijas un ganador, o el repositorio se llenará de experimentos abandonados.

El trabajo en paralelo se complica con más gente

En el momento en que dos desarrolladores ejecutan agentes en el mismo proyecto, el problema del sistema de archivos se convierte en un problema de coordinación. ¿El worktree de quién está en qué branch? ¿Quién espera una revisión? ¿Puede otra persona retomar una sesión cuando quien la creó se desconecta?

Nethür lo resuelve con proyectos compartidos y un servidor de equipo: todo el mundo se conecta al mismo espacio de trabajo, ve las sesiones activas, se menciona con @ junto al trabajo y puede tomar el control de una sesión sin copiar una transcripción. Cada persona sigue iniciando sesión con su propia suscripción de Claude; no hay una clave compartida que rotar. La guía de equipos explica la configuración.

Empieza con dos worktrees

Elige una tarea que normalmente requeriría dos ejecuciones secuenciales de Claude Code. Crea dos worktrees desde la misma referencia, dale el mismo prompt a ambos agentes y compara lo que vuelve. Ese único experimento te dice más sobre el trabajo en paralelo que cualquier benchmark: verás el beneficio del aislamiento, la fricción de las dependencias y el coste de la revisión en tu propio repositorio.

Cuando funcione, conserva el branch ganador y elimina el otro worktree. Después repítelo con una tarea que se divida limpiamente en dos. Los agentes en paralelo son un hábito, no un interruptor.

Pon la guía en práctica.

Descarga Nethür y ejecuta tu primer agente en paralelo en minutos, o monta un espacio de trabajo de equipo en una máquina que ya tengas.