Configuración de red local

Este es el modo de conexión más simple. Tu iPhone se conecta directamente al Mac a través de tu WiFi local. La latencia es mínima y no se requiere internet.

Cuándo usar esto

iPhone y Mac están en la misma red WiFi.
Estás en casa, la oficina o cualquier red de confianza.
Quieres la menor latencia y la configuración más simple.

Paso 1: Verificar tu red

Ambos dispositivos deben estar en la misma red WiFi y subred. Cosas que pueden impedirlo:

WiFi corporativo u hotelero que aísla dispositivos (client isolation).
VPN ejecutándose en cualquiera de los dispositivos que cambia la ruta de red.
Firewall del Mac bloqueando conexiones entrantes en el puerto del servidor.

Paso 2: Encontrar la IP de tu Mac

La app de Mac muestra tu IP en el panel de la barra de menú. Alternativamente:

ipconfig getifaddr en0

Esto devuelve algo como 192.168.1.42.

Paso 3: Iniciar el servidor

Si usas la app de Mac, haz clic en Iniciar servidor desde la barra de menú. El puerto por defecto es 8765.

Si usas el servidor independiente:

cd MacServer && npm start

Puedes personalizar el puerto con la variable de entorno PORT:

PORT=9000 npm start

Paso 4: Conectar desde iPhone

Opción A: Código QR (más rápido)

Haz clic en el icono QR en la barra de menú de la app Mac. Escanea con la app de iPhone.

Opción B: Auto-descubrimiento Bonjour

El servidor se anuncia vía Bonjour/mDNS. Tu Mac debería aparecer en la lista de servidores de la app iPhone.

Opción C: Entrada manual

Introduce 192.168.x.x y puerto 8765 (o tu puerto personalizado) en la app de iPhone.
Introduce la API key si está configurada.
Toca Conectar.

Paso 5: Verificar

Una vez conectado, crea o selecciona una sesión y envía un prompt de prueba. La salida del terminal debería aparecer en 1-2 segundos.

Consejos

Suspensión del Mac: la app de Mac puede prevenir la suspensión mientras el servidor está en ejecución. Activa esto en los ajustes de la app si tu Mac se duerme durante tareas largas.
IP estática: si la IP de tu Mac cambia frecuentemente (DHCP), considera asignar una IP estática en Ajustes del Sistema > Red, o usa el descubrimiento Bonjour en lugar de una IP manual.
Firewall: si el Firewall de macOS está activo, permite conexiones entrantes para la app Tactic Remote (o el proceso node si usas el servidor independiente).