Diagnóstico de conexión
Guía paso a paso para diagnosticar problemas de conexión y latencia.
Cuando las cosas no funcionan, los reintentos aleatorios son una pérdida de tiempo. Usa esta secuencia para aislar el problema.
Paso 1: Clasificar el síntoma
| Síntoma | Causa probable |
|---|---|
| No conecta en absoluto | Red o configuración de endpoint incorrecta |
| Conecta pero el terminal va lento | Latencia de red o Mac bajo carga |
| Conecta pero la salida está desactualizada | Problema de estado de sesión |
| Faltan notificaciones | Entrega de hooks o permisos iOS |
Paso 2: Verificar el servidor
En tu Mac, verifica que el servidor está escuchando:
Deberías ver un proceso node. Si no aparece nada, el servidor no está en ejecución.
Si usas Cloudflare Tunnel, también verifica:
Paso 3: Probar la accesibilidad de red
Desde otro dispositivo en la misma red (o desde tu propio Mac):
Si el puerto no es accesible, verifica:
- Configuración del firewall del Mac
- La interfaz de red correcta (
en0para WiFi,en1para Ethernet) - Si los dispositivos están en la misma subred
Paso 4: Verificar el rendimiento del Mac
Si la conexión funciona pero se siente lenta:
Un Mac bajo carga pesada retrasará la salida del terminal, haciendo que parezca un problema de red.
Paso 5: Refrescar la sesión
Si la salida parece desactualizada o el terminal está en blanco:
- Abre el selector de sesiones en la app de iPhone.
- Vuelve a seleccionar la sesión.
- Esto reconecta a la sesión tmux y refresca la salida.
Si la sesión ya no existe (fue eliminada o el servidor se reinició), crea una nueva.
Paso 6: Verificar la entrega de notificaciones
Si las notificaciones push no funcionan:
- Permisos iOS: Ajustes > Tactic Remote > Notificaciones > Permitir.
- Eventos hook: Claude Code dispara eventos hook que el servidor retransmite. Asegúrate de que el servidor los está recibiendo:
- Versión de la app: Asegúrate de que tanto la app de Mac como la de iOS estén en la última versión.
Cuándo abrir un ticket de soporte
Si nada de lo anterior resuelve el problema, contacta con soporte con:
- Versión de la app (Mac e iOS)
- Modo de conexión (Local o Túnel)
- Pasos que intentaste
- Capturas de pantalla o mensajes de error (redacta cualquier API key)