Lo que aprenderás

Esta guía te explica cada método para usar Claude Code de forma remota — desde la función oficial Remote Control de Anthropic hasta configuraciones SSH personalizadas con tmux, mosh y Tailscale. Al finalizar, tendrás una configuración de programación móvil funcional donde podrás iniciar tareas en tu escritorio, salir de tu oficina y mantener el control total desde tu teléfono.

Claude Code Remote Control: La guía completa de 2026

El February 25, 2026, Anthropic lanzó Remote Control — la capacidad de iniciar una tarea de programación en tu terminal, poner tu laptop en tu bolso y mantener el control total desde tu teléfono. Sin VPN, sin reenvío de puertos, sin necesidad de herramientas de terceros. Fuente

Pero la función oficial es solo una parte de la historia. La comunidad de desarrolladores ha construido un ecosistema completo de configuraciones de programación móvil alrededor de Claude Code, que van desde simples túneles SSH hasta sofisticados flujos de trabajo multiherramienta con notificaciones push y entrada de voz. Esta guía los cubre todos.

Parte 1: Remote Control oficial

Qué es

Remote Control es la función integrada de Anthropic para continuar sesiones de Claude Code en varios dispositivos. Funciona haciendo que tu instancia local de Claude Code se registre en la API de Anthropic como un servidor, permitiendo luego que clientes autorizados (tu teléfono) se conecten y controlen la sesión de forma remota. Fuente

Cómo funciona internamente

El modelo de seguridad es sencillo y conservador:

Tu escritorio (Claude Code)          Anthropic API           Tu teléfono (Claude App)
        │                                │                          │
        ├──── Registrar sesión ──────────►│                          │
        │                                │                          │
        │◄─── Asignar URL de sesión ─────┤                          │
        │                                │                          │
        │     Mostrar código QR          │                          │
        │                                │◄──── Escanear QR / Auth ─┤
        │                                │                          │
        │◄─── Enrutar mensajes ──────────┤──── Enrutar mensajes ───►│
        │                                │                          │
        │     (Todo el tráfico sobre TLS)│                          │

Propiedades clave de seguridad:

• Sin puertos de entrada — tu máquina local solo realiza solicitudes HTTPS de salida.
• Sin conexión directa — tu teléfono nunca se conecta directamente a tu escritorio.
• Cifrado TLS — todo el tráfico fluye a través de la API de Anthropic sobre TLS.
• Sesión limitada — cada sesión de Remote Control tiene una URL única que caduca.

Fuente

Pasos de configuración

Paso 1: Actualizar Claude Code

Remote Control requiere Claude Code v2.1.51 o posterior:

# Check your version
claude --version

# Update if needed
npm update -g @anthropic-ai/claude-code

Paso 2: Iniciar una sesión

Comienza a trabajar en tu proyecto normalmente:

cd ~/projects/my-app
claude

Paso 3: Activar Remote Control

Desde tu sesión de Claude Code, ejecuta:

/rc
# or
/remote-control

Esto inicia el servidor de Remote Control. Tu terminal mostrará:

Remote Control active
Session URL: https://code.claude.com/rc/abc123-def456
Press [space] to show QR code
Press [q] to stop Remote Control

Paso 4: Conectarse desde tu teléfono

Dos opciones:

1. Código QR: Presiona la barra espaciadora en tu terminal para mostrar un código QR. Abre la app Claude en tu teléfono y escanéalo.
2. URL: Copia la URL de la sesión y ábrela en la app Claude en tu teléfono.

Tu teléfono ahora tiene el control total de la sesión de Claude Code. Puedes enviar mensajes, aprobar cambios de archivos y revisar la salida — la conversación se mantiene sincronizada en todos los dispositivos conectados. Fuente

Activación de Remote Control por defecto

Si usas Remote Control con frecuencia, actívalo para todas las sesiones:

/mobile

Esto muestra un código QR para instalar la app Claude si aún no lo has hecho, y activa el ajuste "Enable Remote Control for all sessions" a true. Una vez activado, cada sesión de Claude Code se inicia automáticamente en modo Remote Control. Fuente

Requisitos del plan

Fuente

Limitaciones de Remote Control

• Requiere la app Claude — no puedes usar un navegador genérico; se requiere la aplicación móvil Claude.
• Dependencia de Anthropic — todo el tráfico se enruta a través de los servidores de Anthropic; si su API falla, Remote Control falla.
• Sin soporte offline — ambos dispositivos deben tener conectividad a internet.
• Tiempo de espera de sesión — las sesiones inactivas eventualmente caducan.
• Proveedor único — solo funciona con modelos de Claude, no si estás usando OpenCode u otras herramientas multiproveedor.

Parte 2: SSH + tmux + mosh (El enfoque DIY)

Para los desarrolladores que desean un control total de la terminal, soporte multiproveedor o trabajar en redes poco confiables, el enfoque basado en SSH es más robusto. Como escribió el desarrollador Harper Reed: "Al pensar en cómo usar Claude Code en un teléfono, la respuesta obvia fue conectarse por ssh a una computadora desde un teléfono y ejecutar claude." Fuente

¿Por qué tres herramientas?

Necesitas dos tipos diferentes de resiliencia:

• mosh gestiona la conexión móvil inestable — transiciones de WiFi a datos móviles, zonas muertas, modo de suspensión del teléfono.
• tmux gestiona la persistencia de la sesión — mantiene viva la sesión de Claude Code incluso cuando tu teléfono se desconecta por completo.

Juntos hacen que el desarrollo móvil sea realmente viable. Fuente

Configuración del stack

Paso 1: Instalar Tailscale (Redes privadas)

Tailscale crea una red mesh privada WireGuard entre tus dispositivos. Sin reenvío de puertos, sin configuración de router, sin reglas de firewall.

En tu escritorio:

# macOS
brew install tailscale

# Linux
curl -fsSL https://tailscale.com/install.sh | sh

# Start Tailscale
sudo tailscale up

En tu teléfono:

• Instala la app Tailscale desde tu tienda de aplicaciones.
• Inicia sesión con la misma cuenta.
• Ambos dispositivos están ahora en la misma red privada.

Tu escritorio obtiene una IP de Tailscale (algo como 100.64.x.x) a la que tu teléfono puede acceder directamente, sin importar en qué red WiFi o móvil se encuentre cada dispositivo. Fuente

Paso 2: Instalar tmux (Persistencia de sesión)

tmux mantiene vivas tus sesiones de terminal independientemente de tu conexión SSH. Cuando tu teléfono se desconecta (bloqueo de pantalla, cambio de red, batería agotada), la sesión de tmux sigue ejecutándose.

# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

Crea una configuración de tmux optimizada para uso móvil:

# ~/.tmux.conf

# Increase scrollback buffer
set -g history-limit 50000

# Enable mouse support (useful on mobile)
set -g mouse on

# Reduce escape-time for responsive mobile input
set -sg escape-time 10

# Status bar with useful info
set -g status-right '#H | %H:%M'

# Larger status bar for mobile readability
set -g status-style 'bg=colour235 fg=colour136'

Paso 3: Instalar mosh (Resiliencia de conexión)

mosh (Mobile Shell) utiliza UDP en lugar de TCP, lo que gestiona las transiciones de red con fluidez. Cuando tu teléfono cambia de WiFi a datos móviles o pasa por un túnel, mosh se reconecta automáticamente.

En tu escritorio:

# macOS
brew install mosh

# Ubuntu/Debian
sudo apt install mosh

En tu teléfono:

• iOS: Instala Blink Shell o Termius — ambos soportan mosh de forma nativa.
• Android: Instala JuiceSSH o Termux con el paquete mosh.

Paso 4: Conectar e iniciar Claude Code

Desde el cliente SSH de tu teléfono:

# Connect via mosh through Tailscale
mosh user@100.64.x.x

# Start or attach to a tmux session
tmux new-session -s claude
# or if session already exists:
tmux attach -t claude

# Launch Claude Code
cd ~/projects/my-app
claude

Ahora tienes una sesión de Claude Code que:

• Sobrevive a cambios de red (mosh).
• Sobrevive a desconexiones del teléfono (tmux).
• Es accesible desde cualquier dispositivo en tu red Tailscale.
• Funciona con cualquier proveedor de IA, no solo Claude.

Reconexión después de una desconexión

Cuando vuelvas a tomar tu teléfono más tarde:

# mosh will auto-reconnect if the session is still alive
# If mosh session died, start a new one:
mosh user@100.64.x.x

# Reattach to your tmux session
tmux attach -t claude

Tu sesión de Claude Code está exactamente donde la dejaste — misma conversación, mismo directorio de trabajo, mismos cambios pendientes.

Parte 3: Notificaciones push con ntfy

El problema tanto con Remote Control como con las configuraciones SSH: tienes que seguir revisando tu teléfono para ver si Claude Code terminó su tarea. La solución son las notificaciones push.

¿Qué es ntfy?

ntfy es un servicio de notificaciones push simple y de código abierto. Puedes alojarlo tú mismo para mayor privacidad o usar la instancia pública en ntfy.sh. Fuente

ntfy autoalojado con Tailscale

Para máxima privacidad, ejecuta ntfy en tu escritorio y accede a él a través de Tailscale:

# Install ntfy
brew install ntfy  # macOS
# or
sudo apt install ntfy  # Linux

# Start ntfy server (it listens on port 80 by default)
ntfy serve --listen-http :8090

Dado que tu teléfono y escritorio están en la misma red Tailscale, tu teléfono puede alcanzar ntfy en http://100.64.x.x:8090. Ningún dato sale de tu red privada.

Configuración de ganchos (hooks) de Claude Code

Los ganchos de Claude Code te permiten activar comandos personalizados cuando ocurren ciertos eventos. Configura un gancho para enviar una notificación cuando Claude Code necesite entrada:

// ~/.claude/settings.json
{
  "hooks": {
    "notification": {
      "command": "curl -s -d 'Claude Code needs your attention' http://100.64.x.x:8090/claude-code",
      "event": "stop"
    }
  }
}

Fuente

Configuración de la app móvil ntfy

1. Instala la app ntfy en tu teléfono (iOS o Android).
2. Agrega una suscripción al tema claude-code en tu servidor autoalojado (http://100.64.x.x:8090/claude-code).
3. Activa las notificaciones push para el tema.

Ahora, cada vez que Claude Code se detenga y necesite entrada — ya sea porque terminó una tarea, encontró un error o necesita aprobación — recibirás una notificación push en tu teléfono. No es necesario mantener la terminal abierta o revisar constantemente.

Configuración avanzada de notificaciones

Para notificaciones con más contexto, puedes incluir el último mensaje de Claude Code:

#!/bin/bash
# ~/.claude/hooks/notify.sh

# Get the last few lines of Claude Code output
LAST_OUTPUT=$(tail -5 /tmp/claude-code-output.log 2>/dev/null || echo "Task completed")

# Send notification with context
curl -s \
  -H "Title: Claude Code" \
  -H "Priority: high" \
  -H "Tags: robot" \
  -d "$LAST_OUTPUT" \
  http://100.64.x.x:8090/claude-code

Fuente

Parte 4: Happy Coder (Alternativa gratuita de código abierto)

Happy Coder es una herramienta gratuita y de código abierto que proporciona una interfaz web para controlar Claude Code de forma remota, con notificaciones push integradas y entrada de voz. Fuente

Características clave

• Gratuito y de código abierto — no requiere suscripción más allá de tu plan de Claude Code.
• Notificaciones push — sistema de notificaciones integrado, no requiere configuración de ntfy.
• Entrada de voz — dicta comandos en lugar de escribir en una pantalla pequeña.
• Soporte multiagente — funciona con Codex junto con Claude Code.
• Basado en la web — funciona en cualquier navegador móvil, no requiere instalación de app.

Configuración

# Install Happy Coder
npm install -g happy-coder

# Start the server
happy-coder start --port 3000

# Access from your phone via Tailscale
# http://100.64.x.x:3000

Happy Coder proporciona una interfaz web optimizada para móviles que muestra tu conversación con Claude Code, te permite enviar mensajes y muestra los cambios de archivos — todo a través de tu navegador.

Parte 5: Comparación completa de configuraciones

Matriz de comparación de métodos

Configuración recomendada según el caso de uso

Usuario ocasional (revisar tareas de vez en cuando): → Remote Control. Un comando, un escaneo QR, y listo.

Programador móvil diario (programa frecuentemente desde el teléfono): → SSH + tmux + mosh + ntfy. Máxima resiliencia y control.

Líder de equipo (monitorea múltiples sesiones): → Happy Coder. Basado en la web, soporta múltiples agentes, notificaciones integradas.

Desarrollador multiproveedor (usa Claude, Codex y modelos locales): → SSH + tmux + mosh. Funciona con cualquier herramienta que corra en una terminal.

Parte 6: Configuraciones avanzadas

Ejecución de múltiples sesiones de Claude Code

Con tmux, puedes ejecutar múltiples sesiones de Claude Code en paralelo y alternar entre ellas:

# Create named sessions for different projects
tmux new-session -d -s project-api
tmux new-session -d -s project-frontend
tmux new-session -d -s project-tests

# In each session, navigate and start Claude Code
tmux send-keys -t project-api 'cd ~/projects/api && claude' C-m
tmux send-keys -t project-frontend 'cd ~/projects/frontend && claude' C-m
tmux send-keys -t project-tests 'cd ~/projects/tests && claude' C-m

# From your phone, switch between sessions
tmux switch-client -t project-api
tmux switch-client -t project-frontend

Configuración en VM Linux Headless

Para equipos que desean un entorno de programación remoto dedicado, Claude Code Remote Control funciona en VMs Linux headless a través de SSH + tmux. Fuente

# On your cloud VM (AWS, GCP, etc.)
# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Start in a tmux session
tmux new-session -s remote-claude

# Launch Claude Code
claude

# Start Remote Control
/rc

Luego escanea el código QR desde tu teléfono. Esto te brinda un potente entorno de desarrollo basado en la nube controlado completamente desde el móvil.

Combinación de Remote Control con SSH

Puedes usar ambos métodos juntos para máxima flexibilidad:

1. SSH + tmux para persistencia de sesión y acceso total a la terminal.
2. Remote Control dentro de la sesión de tmux para la interfaz de chat optimizada para móviles.

# SSH into your machine
mosh user@100.64.x.x

# Attach to tmux
tmux attach -t claude

# Inside the session, Claude Code is running
# Enable Remote Control for phone access
/rc

Ahora tienes:

• tmux manteniendo la sesión viva.
• mosh manteniendo la conexión SSH estable.
• Remote Control proporcionando una interfaz móvil pulida.
• Acceso total a la terminal cuando lo necesites.

Parte 7: Construcción de aplicaciones desde el móvil

El flujo de trabajo de desarrollo móvil

La combinación de Claude Code + acceso remoto cambia fundamentalmente cuándo y dónde puedes ser productivo. Un flujo de trabajo práctico:

1. Camino al trabajo: Revisa los resultados de CI de la noche anterior en tu teléfono, inicia tareas de corrección vía Remote Control.
2. Hora del almuerzo: Verifica el progreso mediante notificaciones de ntfy, aprueba o redirige cambios.
3. Tarde: Toma tu laptop y la sesión de tmux estará exactamente donde la dejaste.

Cuándo tiene sentido programar desde el móvil

La programación móvil a través de Claude Code es ideal para:

• Inicio de tareas — describe qué quieres construir y deja que Claude Code trabaje mientras estás fuera.
• Revisión de código — lee diffs y aprueba cambios desde tu teléfono.
• Triaje de bugs — investiga problemas y dirige a Claude Code hacia las correcciones.
• Monitoreo de progreso — verifica tareas de larga duración.

Es menos adecuada para:

• Depuración compleja — las pantallas pequeñas dificultan la lectura de stack traces.
• Trabajo visual — los ajustes de CSS y diseño necesitan una pantalla completa.
• Refactorización a gran escala — es mejor revisar cambios extensos en un monitor adecuado.

Construyendo con ZBuild desde cualquier lugar

Para los desarrolladores que desean construir e iterar en aplicaciones mientras están en movimiento, plataformas como ZBuild complementan el flujo de trabajo remoto de Claude Code. ZBuild proporciona un constructor visual de apps que funciona bien en tablets y puede emparejarse con Claude Code para lógica de backend más compleja — brindándote una capacidad de desarrollo full-stack que no requiere una estación de trabajo de escritorio.

Parte 8: Resolución de problemas

Problemas comunes y soluciones

Problema: "Remote Control no disponible en tu plan" Solución: Verifica que estés en Pro, Max, Team o Enterprise. El nivel Free no soporta Remote Control.

Problema: El código QR no se escanea Solución: Asegúrate de que tu app Claude esté actualizada a la última versión. Intenta usar la URL de la sesión directamente en lugar de escanear.

Problema: La conexión mosh se cae y no se reconecta Solución: Verifica que mosh-server se esté ejecutando en tu escritorio (which mosh-server). Comprueba que Tailscale esté conectado en ambos dispositivos. Asegúrate de que el puerto UDP 60000-61000 esté abierto si no usas Tailscale.

Problema: La sesión de tmux muestra una pantalla en blanco después de reconectar Solución: Ejecuta tmux attach -t claude en lugar de crear una nueva sesión. Si la sesión murió, verifica si Claude Code falló revisando ~/.claude/logs/.

Problema: Las notificaciones de ntfy no llegan Solución: Verifica que el servidor ntfy esté corriendo (curl http://100.64.x.x:8090/health). Comprueba que la URL de suscripción en la app ntfy coincida con la dirección de tu servidor. Asegúrate de que la conexión Tailscale de tu teléfono esté activa.

Problema: La sesión de Claude Code expiró mientras el teléfono estaba desconectado Solución: Esto sucede con Remote Control después de una inactividad prolongada. Usa una configuración basada en tmux para sesiones que necesiten persistir durante horas. Las sesiones de tmux sobreviven indefinidamente sin importar las conexiones de los clientes.

Problema: Escribir es lento en el móvil Solución: Usa entrada de voz (Happy Coder) o mantén los mensajes cortos y orientados a tareas. Alternativamente, prepara los prompts en una app de notas y pégalos en la terminal.

Parte 9: Consideraciones de seguridad

Seguridad de Remote Control

• Todo el tráfico está cifrado vía TLS a través de la API de Anthropic.
• Las URL de sesión son únicas y expiran después de su uso.
• No se abren puertos de entrada en tu máquina.
• Tus credenciales y archivos nunca salen de tu máquina (solo se transmite la salida de texto de Claude Code).

Mejores prácticas de seguridad para SSH

Al exponer SSH para acceso móvil:

# Use key-based authentication only (disable password auth)
# In /etc/ssh/sshd_config:
PasswordAuthentication no
PubkeyAuthentication yes

# Restrict SSH to Tailscale interface only
ListenAddress 100.64.x.x

# Use a non-standard port
Port 2222

Seguridad de Tailscale

La red mesh basada en WireGuard de Tailscale proporciona:

• Cifrado de extremo a extremo entre dispositivos.
• Ningún enrutamiento de datos a través de los servidores de Tailscale (conexiones directas).
• MagicDNS para una fácil resolución de nombres de host.
• Listas de control de acceso (ACLs) para configuraciones de equipo.

Conclusión

Usar Claude Code de forma remota en 2026 varía desde lo sumamente simple (un comando /rc) hasta lo totalmente personalizado (SSH + tmux + mosh + ntfy + Tailscale). La configuración correcta depende de tu flujo de trabajo:

• Remote Control para revisiones móviles rápidas con cero configuración.
• Stack SSH para desarrolladores que viven en la terminal y necesitan máxima resiliencia.
• Happy Coder para un punto medio gratuito y rico en funciones.

El impacto práctico es significativo. El desarrollo ya no está atado a estar sentado en un escritorio con una laptop abierta. Puedes iniciar una tarea, alejarte y mantener el control. Ya sea que estés construyendo un proyecto personal, gestionando el código base de un equipo o prototipando una app con ZBuild, el acceso móvil a Claude Code significa que tu flujo de trabajo de desarrollo te sigue a ti, y no al revés.

Fuentes

• Documentación de Claude Code Remote Control — Anthropic
• Remote Claude Code: Programando como a principios de los 2000 — Harper Reed
• Claude Code desde la playa: mosh, tmux y ntfy — Rogs
• Claude Code Remote Control: Programa desde tu teléfono — Medium
• Claude Code en tu teléfono móvil — Builder.io
• Notificaciones perfectas de Claude Code con Tailscale y ntfy — Felipe Elias
• 3 formas de ejecutar Claude Code desde tu teléfono — Zilliz
• Cómo ejecutar Claude Code desde tu iPhone — Pete Sena / Medium
• Análisis del lanzamiento de Claude Code Remote Control — Blockchain News
• Remote Control en VM Linux Headless — GitHub Issue #29479
• Configuración móvil de Claude Code con tmux y Bitvise — GitHub Gist
• Cómo usar Claude Code en tu teléfono — FelloAI
• Configuración móvil de Claude Code — Sealos Blog