Ejecute Claude Code en tmux o Herdr y contrólelo desde el teléfono

Se corta una conexión SSH y Claude Code termina con ella. El teclado de un terminal móvil carece de teclas Esc y Ctrl. Se regresa una hora después y Claude Code ha permanecido inactivo todo el tiempo esperando la aprobación de una solicitud.

Esta guía resuelve estos tres problemas. Ejecute Claude Code en tmux o Herdr para que sobreviva a las desconexiones. Después, agregue Collie para priorizar las sesiones en espera en el teléfono y contar con las teclas faltantes.

Mantener Claude Code en ejecución en tmux

Inicie Claude Code dentro de una sesión de tmux. Continuará ejecutándose en el host si se corta la conexión.

tmux new -s claude       # start a session named claude
claude                   # run Claude Code inside it

Desconecte con Ctrl+b y luego d. Inicie sesión más tarde desde cualquier máquina y vuelva a conectar:

tmux attach -t claude

El servidor de tmux es el propietario de la sesión y no el inicio de sesión SSH, por lo que una desconexión no detiene Claude Code. Ejecute tmux ls para listar las sesiones en el host.

Herdr

Herdr es un gestor de espacios de trabajo en terminal diseñado para agentes de programación. Funciona del mismo modo.

curl -fsSL https://herdr.dev/install.sh | sh    # or: brew install herdr
herdr                                           # start Herdr, or reattach to it
claude                                          # in the pane Herdr opens

Desconecte con Ctrl+b y luego q, o cierre el terminal. El servidor de Herdr mantiene activos los paneles y Claude Code. Ejecute herdr de nuevo para volver a conectar.

zellij

Ejecute zellij -s claude, inicie claude, desconecte con Ctrl o y luego d, y vuelva a conectar con zellij attach claude. Collie solo refleja una sesión de zellij. Consulte Notas sobre zellij.

Ejecutar varias sesiones de Claude Code a la vez

Asigne a cada sesión su propia ventana y copia de trabajo para que dos agentes no editen los mismos archivos.

# a second checkout, on its own branch
git worktree add ~/src/app-review -b review
tmux new-window -t claude -n review -c ~/src/app-review
claude                                     # in the new window

Dentro de tmux, presione Ctrl+b y luego c para abrir una ventana, y Ctrl+b luego w para listarlas. Presione Ctrl+b y luego % para dividir un panel a izquierda y derecha, y Ctrl+b luego " para dividir arriba y abajo.

En Herdr, asigne a cada agente su propio espacio de trabajo mientras Herdr se ejecuta:

herdr workspace create --label review --cwd ~/src/app-review

Ejecutar varias sesiones genera múltiples solicitudes en espera. Collie ubica los paneles que requieren intervención en la parte superior del panel de control, agrupando el resto por espacio de trabajo. Mantenga presionada una fila para fijar ese panel arriba. En tmux y zellij, esta ordenación requiere los hooks de beacon de paso 3.

Controlar el sistema desde el teléfono con Collie

Collie se ejecuta en el host y refleja los paneles de Herdr, tmux o zellij en el navegador del teléfono. El procedimiento es idéntico para Codex, OpenCode o cualquier otro agente de terminal. Solo cambia el comando dentro del panel.

Nota. Collie proporciona acceso remoto a la shell de la máquina por diseño. Lea Seguridad antes de instalarlo.

• —
  Claude Code se ejecuta en el host dentro de un panel de Herdr, tmux o zellij. En el teléfono no se ejecuta código de ningún agente.
• —
  El teléfono abre Collie en un navegador a través de la tailnet. El panel de control lista los paneles y prioriza las sesiones en espera.
• —
  Es posible leer la salida, enviar respuestas y transmitir Esc, Tab, flechas o teclas modificadoras desde la bandeja Keys. No se requiere un cliente SSH.
• —
  Notificaciones push opcionales avisan cuando un agente necesita intervención.

Requisitos previos

• —
  Un host Linux o macOS con Claude Code instalado.
• —
  Un multiplexor de terminal: Herdr, tmux o zellij. Herdr detecta los agentes de forma directa. En tmux y zellij, Collie utiliza hooks de beacon, que requieren Linux.
• —
  Tailscale instalado en el host y en el teléfono, con HTTPS habilitado en la tailnet. Para otras configuraciones, consulte Despliegue.
• —
  Un teléfono iPhone o Android.

1. Instalar Collie

curl -fsSL https://colliepwa.dev/install.sh | sh

En Herdr, el plugin se puede instalar directamente: herdr plugin install AltanS/collie. Instalación cubre ambos métodos.

2. Iniciar la herramienta

collie start

La primera ejecución comprueba la presencia de Herdr, tmux y zellij, y guarda la opción elegida en .env. Inicia tailscale serve y muestra una URL de tailnet. Consulte Iniciarlo.

3. Ejecutar Claude Code en un panel

En Herdr, abra un panel y ejecute claude. Herdr marca el panel como un agente ante Collie.

En tmux o zellij, instale los beacon hooks una vez por host. Esto permite a Collie distinguir agentes de shells estándar. A continuación, abra una ventana o pestaña en la sesión que Collie replica y ejecute Claude Code:

collie hooks install claude    # once per host, Linux only
tmux new-window -n claude      # or: zellij action new-tab --name claude
claude

Collie replica el servidor de tmux predeterminado a menos que se defina COLLIE_MUX_ENDPOINT_TMUX. La sesión claude anterior aparece automáticamente.

Las instancias de Claude Code en ejecución no recargan la configuración automáticamente. Reinicie Claude Code tras instalar los hooks. Consulte Collie escribe hooks en la propia configuración de Claude.

4. Abrir en el teléfono

Ejecute collie qr en el host para escanear el código, o abra el enlace desde collie url. Mantenga el teléfono en la misma tailnet.

1. 01
   Vincular el teléfono. Ejecute collie pair en el host y escanee el código QR. La vinculación otorga al teléfono acceso de escritura a sus paneles (Emparejar un dispositivo).
2. 02
   Añadir a la pantalla de inicio. En Android, pulse Instalación en la parte superior de Ajustes. En un iPhone, pulse la hoja de compartir de Safari.

5. Responder a Claude Code

• —
  El panel de control ordena los paneles que requieren intervención al principio. Pulse uno para abrirlo.
• —
  El campo de redacción utiliza un cuadro de texto estándar, por lo que el dictado del teléfono funciona en él.
• —
  Pulse Teclas en la fila de acciones situada sobre el teclado. La bandeja incluye Esc, teclas de dirección, Enter, Tab, Espacio, modificadores, dígitos y de F1 a F12. Las combinaciones con Esc y Ctrl no dependen del teclado del teléfono.
• —
  Los botones de Claude Code se encuentran en la misma fila: Model, Effort, Compact y Resume. Consulte Configuración.

6. Recibir notificaciones (opcional)

collie push-keys     # writes the VAPID keys to your .env
collie restart

Active las notificaciones en los Ajustes de Collie en el teléfono. Requiere intervención está habilitado por defecto. En un iPhone, instale primero Collie en la pantalla de inicio. Safari restringe Web Push a las aplicaciones web añadidas a la pantalla de inicio. Consulte Web Push.

Otras formas de acceder a Claude Code desde un teléfono

• —
  Claude Code Remote Control conecta la aplicación de Claude o claude.ai/code con una sesión de Claude Code en su equipo, y su tráfico pasa a través de la API de Anthropic (Documentación de Anthropic). En cambio, Collie replica paneles de terminal, por lo que funciona con cualquier agente en su multiplexor y permanece dentro de su tailnet.
• —
  Una aplicación SSH como Termius, Moshi o Termux expone el terminal completo. Funciona, pero los controles de terminal en teclados móviles resultan incómodos. Esc, Ctrl y las teclas de dirección requieren soluciones provisionales.