Guía

Claude Code sigue trabajando con el portátil cerrado: tmux en un servidor

Usted inicia Claude Code en un servidor, le encarga una tarea larga y entonces se corta la conexión: se cae el wifi, cierra el portátil o lo reinicia por una actualización. Sin precauciones, el trabajo del agente se pierde. Con tmux, eso ya no ocurre.

Por qué el agente muere cuando se corta la conexión

Todo lo que inicia en una sesión SSH depende de esa sesión. Cuando termina, el sistema envía a los programas en ejecución una señal para que finalicen (SIGHUP). Claude Code se detiene a mitad de la tarea.

La solución es un multiplexor de terminal como tmux. tmux sigue ejecutándose en el servidor, independientemente de su conexión. Usted se conecta, trabaja, se desconecta, y los programas que hay dentro siguen funcionando sin más.

tmux en cinco minutos

Instale tmux en el servidor; en Debian o Ubuntu, así:

sudo apt install tmux

Inicie una sesión llamada main o conéctese a ella si ya existe:

tmux new -A -s main

Ejecute en ella claude e introduzca su tarea. Para desconectarse, pulse Ctrl+b y después d. La sesión sigue en marcha aunque usted cierre la sesión SSH. Más tarde la recupera así:

tmux attach -t main

tmux ls muestra todas las sesiones en marcha.

Entrar siempre en la misma sesión

Es aún más cómodo si cada inicio de sesión por SSH entra automáticamente en la misma sesión de tmux. Para ello, añada al final del archivo ~/.bashrc del servidor:

if [[ -n "$SSH_CONNECTION" && -z "$TMUX" && $- == *i* && "$TERM_PROGRAM" != "vscode" ]]; then
  exec tmux new -A -s main
fi

Las condiciones hacen que esto solo ocurra en inicios de sesión SSH interactivos. Las transferencias de archivos con scp o rsync no se ven afectadas. El terminal de VS Code queda excluido, porque VS Code gestiona sus terminales por sí mismo.

A partir de ahora basta con ssh meinserver y estará justo donde lo dejó.

Si el proceso se ha terminado de todos modos

Incluso sin tmux no está todo perdido, porque Claude Code guarda sus conversaciones. Con este comando continúa la última conversación del directorio actual:

claude --continue

La forma corta es claude -c. Con claude --resume, en cambio, elige en una lista de sesiones anteriores. Una tarea interrumpida no continúa por sí sola: simplemente pida al agente que siga donde lo dejó.

Seguir desde el móvil

Con Remote Control puede controlar una sesión de Claude Code en marcha desde el navegador o el móvil. Para ello, inicie Claude Code así:

claude --remote-control

En una sesión que ya está en marcha, escriba en su lugar /remote-control o, en corto, /rc. Después abre la sesión en claude.ai/code o en la app de Claude. La sesión sigue ejecutándose en su servidor; el navegador y la app son solo la ventana. Combinado con tmux, el agente sigue trabajando en el servidor y usted consulta su progreso desde donde esté.

Remote Control está disponible en los planes Pro, Max, Team y Enterprise. En Team y Enterprise, un administrador debe activarlo primero en la configuración.

Conclusión

tmux en el servidor, la entrada automática mediante .bashrc y, si hace falta, Remote Control: así su agente sigue trabajando pase lo que pase con su portátil. En la euhost Box todo esto ya viene configurado.