Claude Code Remote Control: tu sesión local desde el móvil

Son las siete de la tarde. Claude Code lleva cuarenta minutos migrando una suite de tests y le quedan otros tantos. Tienes que salir.

Ya sabes lo que va a pasar. A los diez minutos de cerrar la puerta, el agente se parará en un prompt de permisos para un comando que no está en tu allowlist. Y se quedará ahí, esperando, con el trabajo a medias.

Hasta ahora la salida era abrir SSH desde el móvil, engancharte a un tmux y pelearte con un teclado de 6 pulgadas. Claude Code Remote Control convierte ese apaño en una función oficial: la sesión sigue en tu PC y tú la conduces desde el teléfono.

En corto: Claude Code Remote Control conecta la app de Claude (iOS y Android) o claude.ai/code a una sesión que se ejecuta en tu máquina, para aprobar permisos, mandar mensajes y revisar el progreso desde fuera. Se activa con claude remote-control, claude --remote-control o /remote-control, y requiere un plan Pro, Max, Team o Enterprise. Si tu PC va a estar apagado, lo que necesitas es una sesión en la nube.

¿Qué es Claude Code Remote Control?

Claude Code Remote Control es la función que expone una sesión local de Claude Code a claude.ai/code y a la app móvil de Claude, para manejarla desde otro dispositivo mientras el código, las herramientas y los archivos siguen en tu ordenador.

La documentación oficial de Remote Control (consultada en octubre de 2026) la describe como una ventana a esa sesión local. Tus servidores MCP y tu configuración siguen disponibles, y la conversación se sincroniza entre terminal, navegador y móvil.

La consecuencia práctica: tu ordenador tiene que seguir encendido y el proceso claude tiene que seguir vivo.

Cómo activar Claude Code Remote Control

Hay tres formas de arrancarlo desde la CLI:

# Modo servidor: espera conexiones y muestra URL + QR (barra espaciadora)
claude remote-control --name "migracion-tests"

# Sesión interactiva normal, también accesible desde el móvil
claude --remote-control "migracion-tests"   # alias: --rc

# Dentro de una sesión ya abierta (conserva el historial)
/remote-control                              # alias: /rc

El subcomando claude remote-control llegó en la versión 2.1.51, según el CHANGELOG oficial. En el móvil abres la app de Claude, entras en la pestaña Code y eliges la sesión, o escaneas el QR de la terminal.

En modo servidor, --spawn worktree da su propio git worktree a cada sesión que abras bajo demanda, para que no se pisen archivos (requiere un repo git; la sesión creada al arrancar se queda en el directorio actual), y --capacity limita las sesiones concurrentes (32 por defecto).

Para conectar todas tus sesiones automáticamente, pon remoteControlAtStartup: true en ~/.claude/settings.json. En el .claude/settings.json del repo ese true se ignora, y con razón.

Requisitos: planes y cuenta

Remote Control solo funciona con una suscripción de claude.ai: Pro, Max, Team o Enterprise. Con API key no. En Team y Enterprise, además, un Owner tiene que activar el toggle en la configuración de administración.

Tampoco funciona con Bedrock, Google Cloud Agent Platform o Microsoft Foundry, con ANTHROPIC_BASE_URL apuntando a un gateway o proxy, ni con CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC o DISABLE_GROWTHBOOK activos. El token de larga duración de claude setup-token tampoco sirve: necesitas claude auth login.

En el móvil necesitas la app de Claude con la misma cuenta y organización que en la terminal. No hay una app aparte de Claude Code: todo vive en la pestaña Code.

Qué puedes hacer desde el móvil

Desde el móvil puedes aprobar o rechazar permisos, responder preguntas, mandar mensajes, adjuntar archivos, ver el diff, parar subagentes y cambiar el modo de permisos. Lo que resuelve el problema de las siete de la tarde son las notificaciones push. En /config activas Push when actions required para permisos y preguntas, y Push when Claude decides para que avise al terminar una tarea larga. También puedes pedirlo en el prompt: notify me when the tests finish.

Los prompts de permisos y las preguntas de AskUserQuestion se quedan abiertos hasta que respondes. Otros diálogos reenviados se cierran a los cinco minutos por defecto (ajustable con dialogExpiry).

Puedes elegir los modos Manual, Accept edits, Plan y Auto, pero no Bypass permissions. Me parece la decisión correcta: si no estás delante, no deberías poder quitarle todos los frenos al agente.

Si no tienes claro qué comandos dejar en la allowlist, en hooks vs permissions en Claude Code explico dónde va cada guardarraíl. Con Remote Control esa decisión pesa más: cada prompt te llega al bolsillo.

Qué sale de tu máquina y qué no

Tu sesión local solo hace peticiones HTTPS salientes y nunca abre puertos de entrada. Se registra en la API de Anthropic, que enruta los mensajes entre el móvil y tu terminal sobre TLS, con credenciales de vida corta.

Se queda en tu máquina la ejecución de comandos y el acceso a archivos. Sale la transcripción (tus mensajes, las respuestas de Claude y la actividad de herramientas), que se guarda en servidores de Anthropic mientras Remote Control está conectado.

Ojo: la actividad de herramientas forma parte de esa transcripción. Si el agente hace cat de un .env, asume que esa salida queda guardada en Anthropic mientras estés conectado, además de en tu historial local de ~/.claude/projects/. Antes de salir, niega la lectura de .env con una regla deny o un hook. Las organizaciones con Zero Data Retention o configuración HIPAA no pueden activarlo, y el ajuste disableRemoteControl lo apaga del todo.

Si quieres más control, activa Trusted Devices (en beta): exige dispositivos registrados y un inicio de sesión de menos de 18 horas.

Claude Code Remote Control vs sesión en la nube vs SSH + tmux

La diferencia clave es dónde se ejecuta el trabajo. Remote Control conduce tu sesión local. Una sesión en la nube corre en una máquina virtual aislada de Anthropic y sigue viva con el portátil cerrado.

Criterio	Remote Control	Sesión en la nube	SSH + tmux
Dónde se ejecuta	Tu PC	VM aislada de Anthropic	Tu PC o servidor
¿PC encendido?	Sí, con claude vivo	No	Sí
MCP y herramientas locales	Disponibles	Solo lo del entorno cloud	Disponibles
Cómo se activa	/remote-control	claude.ai/code o claude --cloud	Servidor SSH + cliente móvil
Origen del código	Tu checkout local	Tu rama remota de GitHub	Tu checkout local
Planes	Pro, Max, Team, Enterprise	Pro, Max, Team; Enterprise con asientos premium o Chat + Claude Code	Cualquiera, incluso API key
Limitación o riesgo	Transcripción guardada en Anthropic; si el PC se apaga, se para	Clonar y hacer push requieren GitHub (sin él sube un bundle local, pero no puede hacer push de vuelta); consume tus límites; la VM se recicla tras inactividad	Puerto SSH expuesto (salvo VPN o túnel); sin push de la app

Un detalle que confunde: claude --cloud "tarea" clona tu remoto de GitHub en la rama actual, no tu checkout local, así que haz push antes. Para traer una sesión cloud a tu terminal, usa claude --teleport. Y --cloud no mueve la sesión que ya tienes abierta: crea una nueva.

Si quieres que el trabajo se lance solo, sin ti, eso ya son Claude Code Routines, que corren en esa misma infraestructura cloud.

Un caso real: la tarea larga que apruebas desde la calle

Vuelvo a la migración de las siete. Con lo que dice la documentación, este es el flujo que recomiendo:

1. Antes de salir, escribe /remote-control migracion-tests en la sesión abierta.
2. Comprueba que Push when actions required está activo en /config.
3. Añade al prompt que te avise cuando pasen todos los tests.
4. Cuando llegue un permiso, léelo entero. Si es un rm o un git push, recházalo y escribe qué quieres en su lugar.

Si la tarea no necesita tu entorno local, lanza claude --cloud y cierra el portátil. Delegar lo largo y reservar tu atención para las decisiones es justo lo que trabajamos en Construye con IA.

Cuándo NO usar Claude Code Remote Control

Tu máquina es el punto único de fallo. Si el portátil se queda sin batería o cierras la terminal, la sesión se cae. En modo servidor, tras unos 10 minutos sin red el proceso sale. Para horas sin supervisión, la nube es más honesta.

La reconexión todavía da guerra. El issue #34255 de anthropics/claude-code, abierto desde marzo de 2026 con más de 70 comentarios, describe conexiones con la app de iOS que se caen en silencio. Su autor, que lo reportó sobre la v2.1.76, indica "Connection typically drops after 15-60 minutes of use" y que tenía que volver al teclado para reconectar. La documentación actual dice que reconecta sola; yo no le confiaría una entrega crítica sin probarlo en tu red.

No todos los comandos funcionan desde el móvil. /plugin y /resume son solo locales, y /model o /effort piden el valor como argumento.

No es para código que no puede salir de tu red. La ejecución es local, pero la transcripción pasa por Anthropic. Con Zero Data Retention, ni siquiera está disponible.

Cómo empezar hoy con Claude Code Remote Control

Una sola recomendación: antes de tu próxima tarea larga, haz una prueba de diez minutos. Ejecuta /remote-control, activa las dos opciones de push, sal de la habitación y aprueba un permiso desde el móvil. Si aguanta en tu red, ya tienes el hábito. Si se cae, para lo largo te toca la nube.

Y si lo que te frena es no fiarte de lo que aprobaste desde el sofá, el problema no es Remote Control: es cómo revisas el código del agente. Eso trabajamos en el workshop SDD + Agentic Engineering. Para el resto del día a día, aquí tienes mi flujo con Claude Code.

Preguntas frecuentes

¿Qué diferencia hay entre Remote Control y Claude Code en la web?

Remote Control conduce una sesión que se ejecuta en tu ordenador, con tus archivos y tus servidores MCP. Claude Code en la web (claude.ai/code) también lanza sesiones en la nube, que corren en una máquina virtual de Anthropic y siguen activas con tu PC apagado. Ambas se ven en la misma interfaz; cambia dónde se ejecuta el código.

¿Puedo usar Claude Code Remote Control con una API key?

No. Exige iniciar sesión con una suscripción de claude.ai (Pro, Max, Team o Enterprise). Si tienes ANTHROPIC_API_KEY en el entorno, Claude Code te avisa y no conecta. Tampoco funciona con proveedores de terceros como Bedrock.

¿Remote Control abre algún puerto en mi máquina?

No. La sesión local solo hace peticiones HTTPS salientes a la API de Anthropic. Es la gran diferencia frente a exponer SSH. A cambio, la transcripción se guarda en servidores de Anthropic mientras está conectada.

¿Qué pasa si mi portátil se suspende durante una sesión remota?

Claude Code se reconecta cuando la máquina vuelve a estar online. Si cierras el proceso claude, la sesión queda offline, pero no la pierdes. Si la abriste con /remote-control o claude --remote-control, recupérala con claude --continue o claude --resume. Si era un servidor claude remote-control que paraste con Ctrl+C, ejecuta claude remote-control --continue en el mismo directorio durante unas cuatro horas.

---

Por Bezael Pérez — Developer senior con más de 15 años de experiencia y fundador de Dominicode.