Cómo ejecutar varios agentes Claude Code en paralelo
El trabajo paralelo con Claude Code necesita aislamiento, visibilidad y una forma rápida de encontrar la sesión que requiere entrada. cmux da a cada tarea un workspace visible y mantiene las sesiones de Claude legibles mientras se ejecutan lado a lado.
Flujo paralelo seguro
Crea una rama, worktree, checkout, carpeta de repo o espacio de trabajo personalizado por tarea, ábrelo en cmux, ejecuta el agente normalmente y usa atajos de no leídos y notificaciones de cmux desde hooks, OSC o cmux notify para revisar las sesiones que te necesitan. Claude Code, Codex y OpenCode siguen siendo los agentes; cmux se encarga de la superficie de supervisión.
| Enfoque | Aislamiento | Visibilidad | Mejor uso |
|---|---|---|---|
| Una pestaña de terminal por tarea | Manual | Débil | Experimentos pequeños |
| Paneles de tmux | Manual | Media | Flujos en shell remota |
| Worktrees de Git manuales | Fuerte | Manual | Trabajo paralelo cuidadoso |
| Workspaces de cmux | Funciona con tu flujo de ramas o worktrees | Fuerte | Muchas sesiones Claude visibles en macOS |
| cmux claude-teams | Mapeo nativo de paneles para sesiones de teammates | Fuerte | Equipos de agentes de Claude Code con divisiones nativas de cmux en vez de paneles tmux/iTerm2 |
Dale a cada tarea un hogar visible
El principal fallo de los agentes en paralelo es perder qué terminal pertenece a qué tarea. Los workspaces de cmux mantienen rama, directorio, puertos y salida reciente visibles en la barra lateral.
Usa anillos de notificación como cola de revisión
Cuando un agente emite una notificación de cmux mediante hooks, OSC 99/777 o cmux notify, cmux marca el espacio de trabajo como no leído y enciende el anillo del panel. Cmd+Shift+U salta al elemento no leído más reciente. Cmd+Control+U marca el elemento actual como el no leído más antiguo y salta al siguiente elemento no leído más reciente, algo útil cuando varios agentes terminan a la vez.
Mantén Claude Code sin cambios
cmux no reemplaza Claude Code, Codex ni OpenCode. Ejecutas las mismas CLI con tus cuentas y ajustes existentes, mientras cmux añade espacios de trabajo, notificaciones y automatización por socket alrededor de la sesión de terminal.
Usa el modo teammate cuando encaje
Para el modo teammate de Claude Code, cmux puede traducir paneles teammate estilo tmux en divisiones nativas de cmux, de modo que los teammates generados sigan visibles con metadatos de barra lateral y notificaciones.
Preguntas frecuentes
¿cmux crea worktrees de Git automáticamente?
No por defecto. cmux puede programarse para crear espacios de trabajo alrededor de tu flujo de ramas, worktrees, varios repos, sin Git, código directo a main o desarrollo remoto, para que puedas conservar la configuración de repositorio que encaja con tu proyecto.
¿Claude Code y Codex pueden ejecutarse uno junto al otro?
Sí. cmux es independiente del agente, así que Claude Code, Codex, OpenCode y otros agentes CLI pueden ejecutarse en workspaces separados al mismo tiempo.
¿Qué atajo importa más para agentes en paralelo?
Cmd+Shift+U es el atajo central de supervisión porque salta al elemento no leído más reciente. Cmd+Control+U es útil cuando quieres marcar el elemento actual como el no leído más antiguo y saltar al siguiente elemento no leído más reciente.