Problemas frecuentes

No puedo conectar al servidor

Síntomas: La conexión se agota o falla inmediatamente.

Soluciones:

• Verifica que ambos dispositivos estén en la misma WiFi (para modo local).
• Comprueba que la app de Mac / servidor esté realmente en ejecución.
• Confirma que la dirección IP y el puerto son correctos. Ejecuta ipconfig getifaddr en0 en tu Mac.
• Si el Firewall de macOS está activo, permite conexiones entrantes para la app.
• Desactiva la VPN en ambos dispositivos si redirige el tráfico de forma diferente.
• WiFi corporativo/hotelero puede aislar dispositivos. Prueba con una red doméstica o el hotspot del teléfono.

No puedo escribir puntos en la dirección IP

Síntoma: Algunos locales (alemán, francés) muestran una coma , en lugar de . en el teclado numérico.

Solución: Cambia al teclado alfabético estándar para escribir puntos, o pega la dirección IP desde Notas.

Conectado pero el terminal está en blanco

Síntoma: Indicador verde de conexión, pero la vista del terminal no muestra nada.

Soluciones:

1. Abre el selector de sesiones y vuelve a seleccionar tu sesión.
2. Si no aparecen sesiones, crea una nueva.
3. Si existe una sesión pero no tiene salida, toca Iniciar para lanzar Claude Code.

Tocar Iniciar parece no hacer nada

Síntoma: Tocas Iniciar pero nada cambia.

Esto es esperado si Claude Code ya está en ejecución. La app tiene protección contra inicio duplicado. Revisa el indicador de estado — si muestra En ejecución (verde), Claude Code ya está activo. Simplemente empieza a enviar prompts.

Las notificaciones no llegan

Síntoma: Claude Code termina tareas pero no aparece notificación push.

Soluciones:

• Revisa Ajustes de iOS > Tactic Remote > Notificaciones — deben estar activadas.
• Asegúrate de que el servidor y la app estén en la última versión.
• Las notificaciones requieren eventos hook de Claude Code. Se envían automáticamente pero dependen de que la conexión WebSocket sea alcanzable.

La conexión se cae cuando la app pasa a segundo plano

Síntoma: Al volver a la app después de un rato se muestra un estado desconectado.

Este es un comportamiento normal de iOS. iOS suspende las conexiones de red en segundo plano para ahorrar batería. La app reconecta automáticamente cuando regresas.

Para tareas largas, confía en las notificaciones push en lugar de mantener la app abierta.

La IP del servidor sigue cambiando

Síntoma: Tu Mac obtiene una IP diferente cada vez, rompiendo la conexión guardada.

Soluciones:

• Asigna una IP estática a tu Mac en Ajustes del Sistema > Red.
• Usa auto-descubrimiento Bonjour en lugar de una IP manual.
• Usa un Cloudflare Tunnel para una URL estable.

Claude Code dice "API key not set"

Este es un error de Claude Code, no de Tactic Remote. Claude Code necesita una API key de Anthropic para funcionar.

Configúrala en tu terminal:

export ANTHROPIC_API_KEY="tu-api-key-de-anthropic"

O ejecuta claude config para configurarla permanentemente.

Nota: Esto es diferente de la API key del servidor de Tactic Remote. La clave de Anthropic es para el servicio de IA de Claude. La API key del servidor es para autenticar la conexión iPhone-a-Mac.

¿Necesitas más ayuda?

Visita la página de soporte o abre un issue en GitHub con:

• Versión de la app
• Modo de conexión (Local o Cloudflare Tunnel)
• Qué intentaste y qué pasó