Inicio rápido

Windows: Conectar Windows con tu cuenta.

Esta guía te acompaña en la instalación de Tactic Remote y tu primera conexión. Necesitarás un Mac (o PC con Windows) y un iPhone.

Tiempo: Unos 10 minutos para la primera configuración. Reconectar después toma segundos.

Requisitos previos

En tu Mac

• Tactic Remote Mac App — incluye el servidor local y una runtime de Node fijada. En el primer inicio comprueba las dependencias locales y puede ayudarte a instalar básicos como Homebrew y tmux.

• Al menos una CLI de agente de IA para programar — Tactic Remote puede iniciar Claude Code, OpenAI Codex o Sourcegraph Amp. Instala e inicia sesión en el agente que quieras usar antes de crear tu primera sesión.

  # Claude Code (instalador nativo recomendado por la documentación de Claude Code)
  curl -fsSL https://claude.ai/install.sh | bash
   
  # OpenAI Codex
  npm install -g @openai/codex
   
  # Sourcegraph Amp
  npm install -g @sourcegraph/amp

  Si claude, codex o amp ya funciona en tu terminal, Tactic Remote puede usarlo.

• tmux — mantiene vivas las sesiones de terminal en Mac/Linux tras desconexiones. La app de Mac lo comprueba y puede ayudarte a instalarlo; si usas la CLI, en macOS puedes ejecutar brew install tmux.

Si usas el arranque por CLI de un solo comando en lugar de la app de Mac y no tienes Node.js o Homebrew, instálalos primero:

# Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
# Node.js
brew install node

En tu iPhone

• iOS 16.4 o posterior.
• La app Tactic Remote para iOS (disponible en App Store).

Paso 1: Elige cómo quieres configurar tu Mac

Tactic Remote ofrece dos formas de configuración en Mac:

Opción A: App Mac (recomendada para la mayoría)

Descarga la app Tactic Remote para Mac desde la página de descarga. Abre el DMG y arrastra la app a Aplicaciones.

Al iniciar por primera vez, la app aparece en tu barra de menú. Haz clic en el icono para ver:

• Estado del servidor (en ejecución / detenido)
• Tu IP local y puerto (ej. 192.168.1.42:8765)
• Un código QR para emparejamiento rápido con iPhone

La app Mac incluye el servidor internamente, guía mejor la configuración y suele ser la opción más sencilla para quienes no viven en Terminal.

Opción B: Inicio en Terminal con un solo comando (CLI)

Ejecuta este comando en tu terminal:

npx tacticremote

El servidor se inicia y muestra un código QR. Escanéalo con tu iPhone para conectar. Eso es todo.

Requisitos: Node.js 16+, tmux (brew install tmux en macOS) y al menos una CLI de agente instalada (claude, codex o amp).

Funciona en macOS y Linux.

Paso 2: Conectar desde tu iPhone

1. Abre la app Tactic Remote en iOS.

2. Escanea el código QR mostrado por la app Mac o por el CLI. Esto rellena la dirección del servidor y la API key automáticamente.

   O conéctate manualmente:

   • Introduce la dirección IP de tu Mac y el puerto (ej. 192.168.1.42:8765)
   • Introduce la API key si hay una configurada
   • Toca Conectar

3. Deberías ver un indicador verde de Conectado en pocos segundos.

¿Cuál opción debería elegir? Para la mayoría, la app Mac es la mejor opción por defecto porque guía la configuración y muestra el código QR en la barra de menú. El CLI sigue siendo ideal si ya trabajas en Terminal o quieres el mismo flujo en macOS y Linux.

Auto-descubrimiento Bonjour: Si ambos dispositivos están en la misma WiFi, la app iOS también puede descubrir tu Mac automáticamente vía Bonjour — búscalo en la lista de servidores.

Paso 3: Crear una sesión

1. Toca el selector de sesiones (arriba a la izquierda).
2. Toca Nueva sesión.
3. Navega y selecciona un directorio de proyecto en tu Mac — este será el directorio de trabajo del agente seleccionado.
4. Dale un nombre a la sesión (ej. mi-proyecto).
5. Toca Crear.

Paso 4: Elegir e iniciar un agente

1. En Ajustes, elige el agente que quieras ejecutar: Claude Code, Codex o Amp. Claude Code es el predeterminado.
2. Toca el botón Iniciar.
3. El agente seleccionado se lanza dentro de una sesión tmux en tu Mac. Verás la salida del terminal transmitirse a tu iPhone en tiempo real.
4. Envía un prompt de prueba:

Lista los archivos en el directorio actual.

Si ves la respuesta del agente en streaming en tu teléfono, todo está funcionando.

Paso 5: Verificar

Siguientes pasos

• El Agent no responde — Comprueba la cola y el estado de entrega antes de reenviar la solicitud.
• Prueba una corrección pequeña — Sigue un caso concreto desde la solicitud hasta la verificación.
• Configuración de red local — optimiza tu conexión en la misma WiFi
• Cloudflare Tunnel — accede a tu Mac desde cualquier lugar
• Sesiones y flujo de trabajo — entiende las sesiones, el inicio y la reconexión
• Seguridad — gestión de API keys y controles de acceso