Cómo ejecutar varios agentes de Claude Code a la vez

Cuatro formas de ejecutar agentes de Claude Code en paralelo

Subagentes: ayudantes en paralelo dentro de una sesión

Un subagente tiene su propia ventana de contexto, su propio prompt de sistema y sus propias herramientas. No ve tu conversación y solo devuelve su resumen, lo que mantiene pequeño el contexto de la sesión principal. Claude Code incluye algunos integrados, como Explore (solo lectura) y Plan, y puedes añadir los tuyos.

1. Define un subagente

   Crea un archivo Markdown en .claude/agents/ (compartido con el proyecto) o en ~/.claude/agents/ (solo para ti). Solo son obligatorios name y description; tools limita lo que puede usar y model elige el modelo.

   ---
   name: code-reviewer
   description: Reviews code for quality and best practices
   tools: Read, Glob, Grep
   model: sonnet
   ---
   
   You are a code reviewer. When invoked, analyze the code and give
   specific, actionable feedback on quality, security and best practices.

2. Deja que Claude ejecute varios a la vez

   Pide el trabajo en paralelo, por ejemplo: “revisa en paralelo los módulos de auth, billing y search”. Los subagentes que lanza Claude empiezan en segundo plano por defecto, hasta 20 a la vez, e informan cuando terminan. Escribe /tasks para verlos.

3. Dale su propio worktree a cada subagente que edita archivos

   Añade isolation: worktree al frontmatter del subagente, o pide a Claude que use worktrees para sus agentes. Así cada uno edita una copia temporal del repositorio, que se elimina si no hizo cambios.

Ejecuta sesiones de Claude Code en paralelo en git worktrees

1. Ignora la carpeta de worktrees

   Claude Code crea los worktrees en .claude/worktrees/, en la raíz del repositorio. El repositorio necesita al menos un commit.

   echo ".claude/worktrees/" >> .gitignore

2. Inicia una sesión por tarea

   En cada terminal, ejecuta claude --worktree (o -w) con un nombre distinto. Cada una tiene su propia carpeta y una rama llamada worktree-<name>, basada en la rama por defecto.

   # terminal 1
   claude --worktree feature-auth
   
   # terminal 2
   claude --worktree bugfix-login

3. Copia los archivos sin seguimiento que necesites

   Un worktree nuevo solo tiene los archivos con seguimiento en git. Enumera archivos como .env en un archivo .worktreeinclude (con sintaxis de gitignore) y Claude Code los copiará.

   .env
   .env.local

4. Fusiona y limpia

   Cuando termina una sesión, un worktree sin cambios se elimina junto con su rama; uno con cambios te pregunta si quieres conservarlo. Fusiona las ramas como harías con cualquier otra. Las ejecuciones headless con -p no preguntan, así que elimínalas con git worktree remove.

5. O usa la app de escritorio

   Pulsa Cmd+N (Ctrl+N en Windows) para abrir una sesión nueva y activa Worktree antes de iniciarla; viene desactivado por defecto. Las sesiones pueden colocarse una al lado de otra en vista dividida.

Fuente: documentación de worktrees de Anthropic

Sesiones en segundo plano con --bg y agent view

claude --bg "<prompt>" inicia una sesión en segundo plano y vuelve al momento, así que puedes iniciar varias seguidas. Cada una pasa a su propio worktree antes de editar nada. claude agents las lista; claude logs <id>, claude attach <id> y claude stop <id> gestionan una concreta.

Siguen en marcha después de cerrar el terminal, pero no después de apagar el ordenador. La agent view es una vista previa de investigación (research preview). Para saber más sobre ejecuciones sin supervisión, consulta cómo ejecutar agentes de Claude Code en segundo plano.

Agent teams: agentes que hablan entre sí

Los agent teams son experimentales y vienen desactivados por defecto. Actívalos con CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 en tu shell o en el bloque env de settings.json, y luego pide a Claude que “cree tres compañeros” para una tarea. Los compañeros comparten una lista de tareas y se escriben entre sí; aparecen en el terminal, o en paneles divididos con tmux o iTerm2.

• Solo en sesiones interactivas: -p y el Agent SDK no crean compañeros.
• Un equipo por sesión, sin equipos anidados, y /resume no restaura a los compañeros que se ejecutan dentro del proceso.
• Los compañeros comparten un mismo checkout, así que dale a cada uno un conjunto de archivos distinto.
• Cuestan mucho más: según la documentación de Anthropic, un equipo usa aproximadamente 7 veces los tokens de una sola sesión cuando los compañeros trabajan en plan mode.

Evita que los agentes en paralelo se pisen el trabajo

• Si dos agentes pueden tocar los mismos archivos, dale a cada uno su propio worktree. Una sesión en un worktree no puede editar el checkout principal, y sus subagentes tampoco.
• En un agent team, reparte el trabajo por archivos: dos compañeros que editan el mismo archivo se sobrescriben.
• Todos los subagentes y sesiones consumen de los mismos límites de uso, así que ejecutar varios multiplica el consumo. Usa model: haiku para los subagentes sencillos.
• Los agentes que ejecutan los mismos tests o el mismo servidor de desarrollo pueden chocar en los puertos; dale a cada uno su propio puerto.

Convierte agentes en paralelo en un equipo con trabajos fijos

Los worktrees y los agent teams dividen una tarea que estás vigilando. Crewmark ejecuta varias sesiones de Claude Code o Codex como empleados con sus propios roles, objetivos y horarios, y les da trabajo en un único tablero.

1. Un empleado por rol

   Un especialista SEO, un ingeniero de software y un diseñador de UI viven cada uno en su propia conversación, con sus propias instrucciones y su objetivo.

2. Un tablero para todos

   Asigna las tareas al empleado que encaje. Cada uno se despierta con su latido (heartbeat), toma su siguiente tarea y comenta sobre la marcha, así que ves quién está haciendo qué.

3. Te preguntan a ti, no entre ellos

   Cuando un empleado necesita una revisión o un permiso, te escribe y pasa a otra cosa. Lee qué es un empleado de IA.

Preguntas frecuentes sobre varios agentes de Claude Code