Módulo 15 — tmux & agent teams

15.1 — Por qué tmux cambia las reglas del juego con Claude Code

Cuando trabajas con Claude Code, interactúas con una sola terminal. Haces una pregunta, esperas la respuesta, relanzas. Es secuencial. Pero imagina poder lanzar tres, cuatro, cinco instancias en paralelo, cada una sobre una parte diferente de tu proyecto, y vigilarlas todas desde una sola pantalla. Es exactamente lo que tmux permite.

tmux, por terminal multiplexer, crea varias sesiones en tu terminal, cada una conteniendo ventanas (windows), a su vez divisibles en paneles (panes). A diferencia de las pestañas nativas de tu terminal, tmux persiste del lado del servidor: puedes desvincularte de una sesión, cerrar tu terminal, y volver más tarde, todo sigue funcionando. Es fundamental cuando tus agentes Claude Code trabajan sobre tareas largas.

La arquitectura se apoya en tres niveles jerárquicos. Las sessions son el nivel más alto, espacios de trabajo completos. Las windows son pestañas dentro de una sesión. Los panes son divisiones de la pantalla dentro de una ventana. Para un setup Agent Teams típico, usas una session, una window, y 4 panes: un gran panel a la izquierda para el lead, tres paneles apilados a la derecha para los teammates.

La instalación es trivial:

# macOS
brew install tmux

# Ubuntu / Debian
sudo apt install tmux

# Arch
sudo pacman -S tmux

¿Por qué tmux en lugar de un split nativo (iTerm2, VS Code)? Tres razones. Persistencia: tmux sobrevive al cierre del terminal. Scripting: puedes automatizar por completo la creación de layouts complejos. Portabilidad: tmux funciona en todas partes, incluso por SSH en un servidor remoto, lo que permite hacer correr tus agentes en una máquina potente y conectarte a ella desde cualquier lugar.