tmux y Claude Code: orquestar 6 agentes en una terminal

¿Por qué tmux se convirtió en el pegamento de los agentes de IA?

Una tarea medida de Claude Code con Sonnet 5.5 consumió 27,7 millones de tokens, frente a 3,2 millones de Codex con GPT-6.1 Sol, según la comparativa de TechRepublic basada en el índice de agentes de código de Artificial Analysis. Traducido a tu factura: mover varios agentes en paralelo dejó de ser una decisión de comodidad y pasó a ser una de costo.

El gasto, sin embargo, no es la parte más difícil. Lo difícil es no saber cuál de tus agentes te está esperando.

Ese es el hueco que explica por qué tmux —un multiplexor de terminal que existe desde 2007 y que no sabe nada de inteligencia artificial— se volvió infraestructura estándar para quienes corren agentes de código. La guía publicada por crystl en crystl.dev lo resume en tres propiedades que encajan con la forma de un agente: es un proceso largo que quiere seguir hablando con una terminal.

• Sobrevive a la desconexión. El servidor de tmux es dueño de la pty, no tu ventana. Cierras la laptop, pierdes el SSH, duermes la máquina: el agente sigue corriendo y lo encuentras al volver.
• Alberga muchas sesiones nombradas. Cuatro agentes son cuatro sesiones que cambias con una combinación de teclas, no cuatro ventanas perdidas en el conmutador de aplicaciones.
• Es scripteable desde afuera. Cualquier shell puede escribir dentro de un agente en ejecución o leer su pantalla. Sin API que construir, sin IPC que cablear.

No es una intuición aislada. El 19 de agosto de 2026, UiPath anunció Maestro Flow, una capa de orquestación para convertir el trabajo de agentes de código en procesos de negocio ejecutables, en vista previa pública según ADTmag. Raghu Malpani, su director de producto y tecnología, lo resumió así: las empresas no tienen un problema de agentes, tienen un problema de orquestación.

El atajo que ya viene dentro de Claude Code

Antes de escribir una sola línea de configuración, revisa lo que ya trae el propio Claude Code, tal como documenta la guía de crystl. Los flags -w, --worktree [name] y --tmux resuelven el caso de un agente sobre una rama:

claude --worktree auth-refactor --tmux

Dos detalles importan antes de depender de esto. Primero, --tmux falla si no va acompañado de --worktree: es una función de worktree que de paso crea una sesión, no un flag general de sesiones. Segundo, en iTerm2 usa paneles nativos en lugar de tmux, lo cual se ve mejor pero deja sin destino a todos los comandos de tmux que verás más abajo. Si planeas scriptear contra la sesión, pasa --tmux=classic para tener tmux de verdad debajo.

Lo que este atajo no hace: correr varios agentes en una sola sesión, ordenar paneles para vigilarlos, escribirle a un agente en ejecución desde un script, decirte cuál está esperando una decisión tuya, ni montar nada de eso en una máquina remota por SSH. Cada uno de esos huecos es donde la gente termina escribiendo tmux a mano.

¿Cómo organizas varios agentes sin perderte?

La regla que mantiene todo usable es contraintuitiva: una sesión de tmux por repositorio, nombrada como el repositorio. No por tarea, no por agente. Las tareas van y vienen; el proyecto es lo estable.

tmux new-session -d -s api -c ~/code/api

La variante útil en el día a día es -A, que adjunta si la sesión existe o la crea si no. Eso la vuelve segura de repetir dentro de una función de shell: defines agent(), le pasas un directorio y obtienes la sesión correcta sin pensar. Un detalle que rompe el script: los nombres de sesión no pueden contener . ni :, porque tmux los usa como separadores de destino. De ahí el tr . - que aparece en los ejemplos de la guía.

Con eso, tmux ls deja de ser un listado y se vuelve un inventario real de en qué está trabajando tu equipo. Dentro de cada sesión, la recomendación es darle una ventana por agente, nombrada por tarea, y reservar los paneles para los dos o tres que quieres ver lado a lado ahora. Las ventanas no consumen espacio en pantalla; los paneles sí. Si creas un panel nuevo, no olvides -c '#{pane_current_path}': sin eso el panel abre en el directorio donde arrancó la sesión, no donde estás, y el agente queda apuntando al repositorio equivocado. Para el acomodo, tiled da una grilla pareja y main-vertical deja un panel grande para el agente que estás dirigiendo. Ojo con main-pane-width en porcentaje: necesita tmux 3.2 o superior; en versiones viejas usa columnas absolutas y verifícalo con tmux -V.

send-keys y capture-pane: la API que no tuviste que construir

Acá está la propiedad que la gente aprovecha. send-keys escribe en un panel como si estuvieras en el teclado, y capture-pane es la mitad de lectura. Con esas dos piezas puedes disparar un agente desde cron, desde un hook de git o desde otro agente, sin construir ninguna integración.

Tres cosas salen mal, en orden de frecuencia. Primero, los argumentos sueltos se interpretan como nombres de tecla: si tu prompt contiene la palabra Enter como argumento independiente, se envía como tecla. La solución es -l para enviar texto literal. Segundo, un punto y coma en tu texto se lee como separador de comandos de tmux; hay que escaparlo. Tercero, las interfaces de los agentes suelen re-renderizar al pegar, y un Enter que llega en el mismo cuadro que el texto se pierde: la guía recomienda enviar el prompt, esperar unas décimas de segundo y recién entonces enviar Enter. Interrumpir un agente desbocado usa el mismo mecanismo con C-c.

Del lado de la lectura, el flag que más rinde es -J: sin él, una línea que se envolvió en tu ancho de terminal vuelve como dos líneas y cualquier grep que escribas falla justo en las costuras. Para transcribir en continuo en vez de tomar fotos, pipe-pane -o manda toda la salida a un archivo.

¿Dónde se queda corto tmux?

Acá conviene ser claro, y el propio autor de la guía lo es. tmux no tiene idea de qué es un agente, porque su modelo se diseñó antes de que existieran.

• No distingue un agente parado de uno pensando. Un agente esperando una aprobación se ve igual que uno trabajando y que uno que terminó hace veinte minutos: los tres son un panel con texto.
• No avisa cuándo termina uno. Lo más cercano es monitor-silence, que dispara ante cualquier panel callado por cualquier motivo. El silencio es un proxy de terminado, no un reporte.
• El scraping de pantalla es frágil por construcción. capture-pane devuelve el cuadro renderizado: spinners, cajas, columnas truncadas, secuencias ANSI. No lo que el agente dijo, ni qué herramienta llamó, ni si esa llamada funcionó. Cada parser que escribas se rompe cuando el agente cambie su interfaz.
• No hay estado compartido entre sesiones y nada sobrevive a un reinicio. El scrollback se pierde cuando el servidor muere. Si la transcripción importa, hay que pipearla a un archivo.

La guía la publica crystl, una terminal para macOS que apunta exactamente a ese hueco y que propone tratar el estado del agente como una señal de primera clase en lugar de raspar la pantalla. Vale leerlo sabiendo quién firma: el diagnóstico de las limitaciones es honesto y verificable; la conclusión es de parte.

Por qué la aprobación humana es el nuevo cuello de botella

Si tmux resuelve el transporte, lo que queda sin resolver es la decisión. Y hay datos duros sobre cuánta decisión hay realmente: Anthropic afirma que los usuarios de Claude Code aprueban el 93% de los prompts de permiso, según TechRepublic. En pruebas internas, su clasificador de modo automático redujo los falsos positivos sobre acciones benignas al 0,4%, pero mantuvo un 17% de falsos negativos sobre 52 acciones reales calificadas como demasiado agresivas.

Ese 93% es la métrica que importa para tu operación. Si casi todo lo que el agente pide se aprueba igual, cada interrupción es fricción pura: pagas atención humana sin cambiar el resultado. El mismo artículo cita un estudio de julio que vinculó el uso regular de agentes de código en línea de comandos con aproximadamente 24% más de pull requests fusionados, y aclaró que el resultado dependió de la capacidad de revisión del equipo.

El costo escala en la misma dirección. Según ZDNET, el rediseño de proyectos de Claude Code permite correr varios hilos a la vez y cada uno es una sesión completa del producto, por lo que los límites de uso se alcanzan antes. Ese diseño es hoy para sesiones en la nube de suscriptores selectos de Pro y Max, no para quien trabaja contra archivos locales.

Qué significa esto para tu startup

Adopta la regla de una sesión por repositorio hoy, no cuando tengas diez agentes. Es la diferencia entre un tmux ls que tu equipo entiende en cinco segundos y una lista de sesiones crípticas que nadie se atreve a cerrar. El costo de implementarlo es una función de shell.

Estandariza cómo escribes y lees los agentes. Si vas a scriptear, usa --tmux=classic para tener tmux real debajo, envía texto con -l, separa el Enter del prompt y lee con -J. Son cuatro hábitos que evitan horas de depuración silenciosa.

Transcribe en continuo lo que importa. pipe-pane a un archivo por sesión te da un rastro que sobrevive a un reinicio, y de paso te permite auditar después qué decisiones tomó el agente.

Trata la aprobación como un recurso escaso. Define de antemano qué comandos son seguros en tu repositorio y déjalos fuera del circuito de permiso. Perseguir prompts que ibas a aprobar igual es el impuesto más caro de la operación con agentes.

Ponle un umbral a tu flota. Cuando el tiempo que gastas coordinando supera el que ganas delegando, el problema dejó de ser de multiplexación y pasó a ser de orquestación. Ahí es donde entran las capas que están apareciendo en el mercado: Maestro Flow de UiPath para llevar trabajo de agentes a procesos gobernables, o los proyectos en la nube de Claude Code para quien pueda trabajar fuera de su máquina. tmux sigue siendo la respuesta correcta para un servidor remoto y para procesos largos; para seis agentes que te piden decisiones a destiempo, es una pieza del rompecabezas, no el rompecabezas entero.

Fuentes

• crystl — tmux for AI agents (fuente original)
• Crypto Briefing — Anthropic updates Claude Code to support AGENTS.md
• InfoWorld — Claude Code now also accepts instructions in OpenAI's Agents.md format
• TechRepublic — OpenAI Codex vs Claude Code
• ADTmag — UiPath Targets Coding-Agent Orchestration with Maestro Flow
• ZDNET — Claude Code's revised projects adds AI orchestration