Inicio seguro y reconexión

Dos cosas causan la mayor confusión: iniciar accidentalmente Claude Code dos veces y ver salida desactualizada tras reconectar. Esta página cubre cómo evitar ambas.

Inicio seguro

Antes de tocar Iniciar, revisa el indicador de estado de la sesión:

• Verde (En ejecución): Claude Code ya está activo. No toques Iniciar.
• Gris (Detenido): Claude Code no está en ejecución. Toca Iniciar para lanzarlo.

La app tiene protección integrada contra inicio duplicado — tocar Iniciar mientras Claude ya está en ejecución no hace nada. Pero verificar el indicador primero evita cualquier confusión.

Si no estás seguro de si Claude está en ejecución

Abre el selector de sesiones, vuelve a seleccionar tu sesión. La vista del terminal se refresca y muestra el estado actual. Si ves el prompt de Claude Code, está en ejecución. Si ves un prompt de shell normal, no lo está.

Reconexión

Cuando reabres la app después de que estuvo en segundo plano o tras una interrupción de red:

1. Reconexión automática: La app reconecta al servidor automáticamente. Esto normalmente toma 1-3 segundos.
2. Restauración de sesión: La salida del terminal de tu sesión tmux se retransmite a tu teléfono.

Si el terminal parece en blanco o desactualizado

Esto puede pasar después de periodos largos en segundo plano. Solución:

1. Abre el selector de sesiones (arriba a la izquierda).
2. Vuelve a seleccionar tu sesión actual.
3. La vista del terminal se refresca.

Si la sesión fue eliminada

Si alguien (o un reinicio del servidor) eliminó la sesión tmux:

• La app muestra un estado vacío.
• Crea una nueva sesión y empieza desde cero.

Tareas de larga duración

Para tareas que toman minutos o más:

1. No mantengas la app abierta. iOS eventualmente suspenderá la conexión de red.
2. Usa notificaciones en su lugar. Los eventos hook de Claude Code disparan notificaciones push en tu iPhone cuando una tarea se completa.
3. Cuando llegue la notificación, abre la app, reconecta y revisa la salida.

Esto es más fiable que intentar mantener una conexión permanente en primer plano en iOS.

Rutina diaria

1. Abre la app. Reconecta automáticamente.
2. Revisa el estado de la sesión. Si Claude Code está en ejecución, continúa donde lo dejaste.
3. Si está detenido, toca Iniciar.
4. Envía tus prompts. Para tareas largas, bloquea el teléfono y espera las notificaciones.
5. Cuando termines, puedes dejar la sesión en ejecución o tocar Detener.