Claude Code Remote Control: cómo programar desde el teléfono con un código QR en 2026

Encontrarás más instrucciones en la documentación de Ailoot.

¿Qué es Claude Code Remote Control y para qué sirve en el teléfono?#

Anthropic lanzó Remote Control el 24 de febrero de 2026. Anthropic lo describe como una forma de continuar las sesiones locales desde cualquier dispositivo.

En pocas palabras: inicias una sesión en el terminal como siempre. Activas Remote Control. Abres la aplicación Claude en el teléfono → la pestaña Code → y verás tu sesión con un punto verde. Tócala, lee y responde. Puedes escribir desde el portátil, el teléfono y el navegador en cualquier combinación: todo se sincroniza.

La documentación oficial de Remote Control distingue la ejecución local del tráfico de red: los comandos y las operaciones del sistema de archivos se ejecutan en tu equipo, mientras la conversación se sincroniza a través de Anthropic.

Esa es la diferencia clave con Claude Code en la web, donde la sesión se ejecuta en una máquina virtual en la nube de Anthropic. Aquí, Claude sigue funcionando en tu propio equipo, con todos tus repositorios Git, variables de entorno y claves de bases de datos. Tu teléfono es solo una pantalla para hablar con Claude.

Por qué un vibe coder podría necesitarlo

Tres situaciones prácticas que el autor utilizaba cada semana:

1. Una refactorización larga durante la noche. Pídele a Claude que actualice 40 archivos para una nueva API. Aléjate del portátil. Por la mañana, túmbate en el sofá con el teléfono, revisa el diff y di: «Acepta los primeros 12; muéstrame el resto por separado». No hace falta abrir el portátil.
2. Aprobar un paso de camino al trabajo. Estás en el metro cuando Claude envía una notificación push: «Necesito que decidas sobre la migración del esquema». Ábrela, lee las dos alternativas y escribe: «Elige la primera opción; no toques las pruebas». La sesión sigue avanzando mientras viajas.
3. Mientras ves una retransmisión en directo o estás en una reunión. Durante una reunión de Zoom, puedes mirar el teléfono para comprobar si una segunda sesión de Claude ha creado una versión de prueba. No hace falta cambiar de ventana durante la videollamada.

Qué necesitas para usar Remote Control#

Tabla completa de requisitos:

Comprueba tu versión con:

claude --version

Si es anterior a 2.1.51, actualízala:

npm install -g @anthropic-ai/claude-code@latest

Si tienes configurada la variable ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN o apiKeyHelper en tu entorno, Remote Control no se iniciará. Desde la v2.1.139 (11.05.2026), Anthropic bloquea explícitamente la función cuando estas variables están presentes. Ejecuta unset ANTHROPIC_API_KEY y vuelve a iniciar sesión con /login.

Cómo iniciar Remote Control: 3 formas en 2 minutos#

Método 1. Modo servidor: un servidor dedicado a sesiones remotas

1. Abre un terminal en la carpeta del proyecto

   Ejecuta cd una vez para ir al directorio en el que vas a trabajar. Si es una carpeta nueva, ejecuta claude como de costumbre para completar el diálogo Workspace Trust.

2. Inicia el servidor

   claude remote-control
   

   El terminal permanece abierto. En la parte inferior aparecen una URL de sesión y el mensaje «Press space to show QR». El servidor espera conexiones.

3. Conéctate desde el teléfono

   Pulsa la barra espaciadora: aparecerá el código QR. Escanéalo con la aplicación Claude o con la cámara del iPhone para abrir la sesión.

Opcional: configura el nombre de la sesión y sus parámetros:

claude remote-control --name "Refactor API" --spawn worktree --capacity 4

• --name: el nombre que se muestra para la sesión en la lista del teléfono.
• --spawn worktree: cada sesión nueva se abre en su propio worktree de Git para que las sesiones paralelas no interfieran entre sí.
• --capacity 4: un máximo de 4 sesiones remotas simultáneas en el servidor. El valor predeterminado es 32.

Método 2. Modo interactivo: mi sesión con Remote Control activado

claude --remote-control
# o, más corto:
claude --rc

Así tendrás una sesión interactiva normal en el terminal, con Remote Control activado. Puedes escribirle a Claude desde el portátil y desde el teléfono: la conversación es una sola y está sincronizada.

A diferencia del modo servidor, aquí se trata de una sola sesión. Es útil si piensas trabajar sobre todo desde el ordenador y quieres tener el teléfono como alternativa cuando necesites ausentarte.

Método 3. Desde una sesión activa con /rc

¿Ya estás trabajando en Claude Code? No cierres la sesión. Escribe simplemente:

/remote-control

o, más corto:

/rc

La sesión pasa a ser remota. No perderás su contexto. Es útil cuando, a mitad de una tarea, te das cuenta de que tienes que ausentarte.

Código QR: conecta el teléfono en 10 segundos#

1. Instala la aplicación Claude

   Si todavía no la tienes, escribe /mobile en Claude Code. Aparecerá un código QR para descargar la aplicación desde el App Store o Google Play. Es más rápido que buscarla manualmente.

2. Muestra en el terminal el código QR de la sesión

   Después de ejecutar claude --rc o claude remote-control, pulsa la barra espaciadora. El código QR aparecerá directamente en el terminal.

3. Escanéalo con el teléfono

   Abre la cámara en la aplicación Claude o usa la cámara normal del iPhone (las cámaras de Android también pueden escanearlo). Si no funciona, amplía la ventana del terminal, cambia a iTerm2 o Windows Terminal, o copia la URL que aparece sobre el código QR y pégala manualmente en el navegador.

4. Activa las notificaciones push

   Escribe /config en la sesión y activa «Push when Claude decides». Claude Code debe tener la versión 2.1.110 o posterior.

Qué verás en el teléfono

La pestaña Code se abre en la aplicación Claude. Tu sesión aparece en la lista con un icono de ordenador y un punto verde (en línea). Tócala para entrar.

Después, funciona como claude.ai/code: puedes ver los mensajes de Claude y los diffs de archivos, aceptarlos o rechazarlos, y pedir cambios. Puedes escribir una nueva solicitud. Todo llega a tu equipo, donde Claude la procesa localmente y devuelve una respuesta.

Qué puede hacer Claude con las notificaciones push

Claude envía notificaciones push cuando considera que hacen falta. De forma predeterminada, esto ocurre en dos casos: cuando termina una tarea larga o cuando Claude necesita que tomes una decisión. También puedes pedirlo explícitamente: «Avísame cuando pasen las pruebas», y enviará una notificación.

Si no recibes notificaciones push:

• En iOS, comprueba Ajustes → Notificaciones → Claude. Los modos de concentración pueden silenciarlas.
• En Android, desactiva la optimización de batería para la aplicación Claude.
• Si /config indica «No mobile registered», abre la aplicación Claude al menos una vez para que pueda actualizar su token push.

Trabajar desde el sofá: 5 situaciones útiles#

Situación 1. Revisar desde el sofá: comprobar una tarea ejecutada durante la noche

Antes de acostarte, encárgale a Claude algo como: «Aplica las nuevas reglas de lint a todo el repositorio y corrige todo lo que no sea crítico; marca el resto como TODO». Ejecuta claude --rc y deja el terminal abierto.

Por la mañana, túmbate en el sofá con el teléfono. Abre la aplicación Claude → localiza la sesión con un punto verde → dentro encontrarás 87 commits en forma de diffs. Desplázate por ellos; en las partes dudosas, escribe «deshaz esto; lo corregiré manualmente» y, en las que estén bien, «acepta todo». Sin tener que «ir al portátil» a las 7 de la mañana.

Situación 2. Aprobar durante el trayecto: aprobar un paso en el metro

Por la mañana, inicia una migración larga del esquema de la base de datos. A las 9:30, recibes una notificación push en el metro: «He encontrado dos alternativas de migración; necesito que decidas». Tócala, lee las opciones, elige una y añade: «No borres la tabla antigua hasta que termine toda la ejecución de pruebas». Claude sigue adelante.

Sin Remote Control, Claude se detendría en ese punto y esperaría en silencio. Llegas a tu destino y abres el portátil: has perdido 40 minutos.

Situación 3. Ausentarse: seguir una tarea larga durante el almuerzo

Antes de comer, encarga a Claude: «Actualiza la documentación de todos los endpoints». Ve a una cafetería. Al cabo de 25 minutos, llega una notificación push: «Listo, revísalo». Toca «aceptar» una vez y vuelve a tu sopa. Sin Remote Control, o te quedas 25 minutos ante el portátil como un vigilante, o vuelves y descubres que Claude no ha hecho nada durante todo ese tiempo porque se ha topado con un punto de decisión.

Este es un punto importante. Remote Control no hace que Claude sea más autónomo: solo te permite acceder desde cualquier sitio. Cuantos menos puntos de decisión encuentre Claude, menos notificaciones push recibirás. Así que especifica mejor las instrucciones de la tarea: «Hazlo de esta manera; en estos casos, haz esto; si realmente no está claro, detente y envíame una notificación push».

Situación 4. Tomar una decisión de arquitectura desde una cafetería

A mitad de una refactorización, Claude encuentra dos vías de migración y te pide que elijas. Si estás lejos del ordenador, abre los diffs propuestos en el teléfono, elige una opción y añade el comentario: «Pero no toques la tabla user_settings; la eliminaré la semana que viene». La sesión continúa.

Esto funciona especialmente bien en modo worktree (--spawn worktree): cada tarea paralela está en su propia rama, por lo que no interfieren entre sí. En el teléfono, puedes cambiar de una a otra como si fueran chats.

Situación 5. Varias sesiones worktree a la vez

Una opción potente es combinar el modo servidor con varios worktrees. Inicia esto en el portátil:

claude remote-control --spawn worktree --capacity 4

Inicia sesiones en distintas ramas desde el teléfono: una crea una funcionalidad, otra corrige los bugs de una lista y una tercera ejecuta pruebas de regresión. Todas funcionan en paralelo en el portátil y ninguna bloquea a las demás.

Seguridad: qué permanece en tu ordenador y qué se envía#

Antes de conectar un proyecto sensible, decide qué contenido puede entrar en los prompts y en los resultados de herramientas. Mantén los secretos de producción fuera del entorno accesible al agente; la tabla de transferencias no demuestra que una sesión concreta no pueda divulgarlos.

En términos cotidianos: tu portátil pregunta a Anthropic «¿Tienes mensajes para mí?», recibe una respuesta y la procesa localmente. Nadie desde fuera abre un puerto entrante hacia tu equipo. Un cortafuegos corporativo lo permitirá sin ninguna configuración especial.

Qué datos llegan realmente a Anthropic

Remote Control añade una interfaz sincronizada, no un modo de inferencia sin conexión. Anthropic almacena la transcripción de la sesión conectada, incluidos mensajes, respuestas y actividad de herramientas, según su política de uso de datos. Revisa tanto los datos enviados al modelo como el acceso desde los dispositivos conectados.

Una nota sobre las credenciales

En otras palabras, varios tokens de corta duración circulan entre el portátil, Anthropic y el teléfono en lugar de un único token de larga duración. Si alguien compromete uno, no obtiene acceso a todos los demás.

Otra limitación importante: --dangerously-skip-permissions no funciona en Remote Control. Cada llamada a una herramienta (Bash, Write, Edit) sigue esperando tu aprobación. Es deliberado: evita que la función para el teléfono convierta el ordenador en «un portátil en piloto automático y sin supervisión».

¿Ya has iniciado Remote Control? Configúralo para que Claude no te interrumpa cada 10 minutos#

/rc es una forma práctica de llevar la sesión al teléfono. Pero si Claude escribe «No entiendo qué tengo que hacer» cada 10 minutos, el problema no es el teléfono, sino la ingeniería del contexto: la claridad con la que estableces las reglas al principio.

Seis problemas del primer uso y cómo resolverlos#

Problema 1. «Remote Control environments are not available for your account»

Es la queja más frecuente en el repositorio anthropics/claude-code (issue #29449 y más de una docena de duplicados). Respondiste y a «enable Remote Control?»: la CLI devolvió un error y ya no ofrece volver a intentarlo.

La causa casi siempre es la misma: ANTHROPIC_API_KEY o CLAUDE_CODE_OAUTH_TOKEN está configurada en el entorno. Remote Control solo funciona mediante OAuth completo a través de /login, no con una clave.

Solución:

unset ANTHROPIC_API_KEY
unset CLAUDE_CODE_OAUTH_TOKEN
unset apiKeyHelper

# comprueba que el entorno esté limpio:
env | grep -i anthropic
env | grep -i claude

# vuelve a iniciar sesión:
claude
/logout
/login

Después de iniciar sesión con /login mediante el navegador, Remote Control debería iniciarse.

Problema 2. El teléfono no puede escanear el código QR

Apuntas la cámara del teléfono al código, pero no responde o muestra «No se puede leer».

Causa: el terminal muestra el código QR demasiado pequeño o con poco contraste.

Solución:

1. Amplía el terminal a pantalla completa.
2. Si usas Apple Terminal, cambia a iTerm2 (o Warp). En Windows, usa Windows Terminal en lugar de CMD.
3. Reduce el tamaño de la fuente del terminal en 1–2 puntos para que el código QR se vea más grande.
4. Si no funciona, copia la URL que aparece sobre el código QR y ábrela en el navegador del teléfono.

Problema 3. El cortafuegos bloquea el puerto 443

Suele ocurrir en ordenadores corporativos con un proxy de interceptación (Zscaler o una VPN corporativa con MITM).

Solución: empieza con registros detallados y captura el error concreto:

claude remote-control --verbose

Si ves «certificate verification failed», hay una interceptación MITM y tendrás que hablar con el administrador de red. Si ves «connection refused» / «timeout», pídele al administrador que permita el acceso saliente a *.anthropic.com:443.

Problema 4. Claude Code está desactualizado

Compruébalo:

claude --version

Si la versión es anterior a 2.1.51, actualízala:

npm install -g @anthropic-ai/claude-code@latest

La extensión de VS Code necesita como mínimo la v2.1.79. Las notificaciones push requieren la v2.1.110.

Problema 5. No llegan las notificaciones push

Situación: Remote Control funciona, pero el teléfono no suena cuando Claude termina una tarea larga.

Lista de comprobación:

1. Ejecuta /config en la sesión. Si indica «No mobile registered», abre la aplicación Claude en el teléfono al menos una vez para que pueda actualizar su token push.
2. iOS: Ajustes → Notificaciones → Claude → comprueba que las notificaciones estén activadas y que el modo Concentración no las silencie.
3. Android: abre los ajustes de batería y excluye Claude de la optimización de batería.
4. Si está activado el resumen de notificaciones de iOS, es posible que llegue la notificación push, pero aparezca en el resumen por horas. Desactiva el resumen para Claude.

Problema 6. Claude Desktop interfiere con /remote-control

Si ejecutas /remote-control dentro de la aplicación Claude Desktop, aparece el error «Remote Control requires a full-scope login token» (issue de GitHub #48378).

Causa: Claude Desktop inserta un token OAuth con permisos limitados (solo inferencia).

Solución: ejecuta Claude Code en un terminal normal del sistema, no en el terminal integrado en Claude Desktop. Es una limitación conocida; Anthropic está trabajando en una solución.

Extra. La reconexión automática deja de funcionar sin avisar en sesiones largas

Síntoma: una sesión de Remote Control funciona durante 30–60 minutos y, después, el teléfono se desconecta en silencio y sin indicador (issue #34255). Soluciónalo manualmente: /remote-control → Disconnect → vuelve a iniciar la conexión. No es ideal, pero la función todavía es una versión preliminar de investigación.

Solo en mayo de 2026, Anthropic publicó ocho correcciones específicas para Remote Control: la función sigue mejorando activamente. Puedes quejarte, pero es razonable esperar que la mayoría de estos problemas desaparezcan en un par de meses.

Remote Control frente a los bots de Telegram y SSH+tmux#

Tabla comparativa

Cuándo elegir cada opción

• Remote Control — la opción predeterminada para «dejar el portátil y seguir dirigiendo el trabajo». Interfaz completa, sincronización entre dispositivos y ningún servicio de terceros.
• Channels (bot de Telegram) — cuando quieres que un fallo de CI, una nueva queja de un cliente o un mensaje de chat active automáticamente una investigación de Claude. Es «evento → Claude responde» en lugar de «dirijo Claude desde el teléfono». Más información en la guía sobre Telegram y Claude Code.
• SSH + tmux — cuando necesitas una shell arbitraria en el teléfono para ejecutar tus propios comandos (desplegar una versión, consultar un registro, reiniciar un servicio). Una shell universal fuera de Claude Code. Para tareas puntuales, funciona con Termux/Blink.
• Otros agentes de programación — Anthropic Remote Control solo funciona con Claude Code. Para comparar Claude con otras opciones, consulta Cursor vs Claude Code.

La propia documentación de Anthropic distingue estas dos funciones según su caso de uso: Remote Control sirve para dirigir; Channels, para responder.

Novedades de Remote Control entre mayo y junio de 2026#

Cronología completa de las correcciones:

Ocho correcciones específicas de Remote Control en un mes es algo normal para una función en versión preliminar de investigación. Anthropic claramente está respondiendo a los comentarios y resolviendo casos límite.

Si la función se comporta de forma extraña, lo primero es comprobar la versión y actualizarla. Es muy posible que el error ya se haya corregido.

Lista de comprobación: configúralo y ponlo en marcha en 5 minutos#

1. Comprueba tu versión de Claude Code

   claude --version: debería ser la 2.1.51 o posterior. Si no lo es, ejecuta npm install -g @anthropic-ai/claude-code@latest.

2. Quita las claves API del entorno

   Ejecuta unset ANTHROPIC_API_KEY y unset CLAUDE_CODE_OAUTH_TOKEN. Después ejecuta /logout → /login mediante el navegador.

3. Instala la aplicación Claude en el teléfono

   Ejecuta /mobile en una sesión de Claude Code para mostrar un código QR del App Store / Google Play.

4. Inicia Remote Control

   Ejecuta claude --rc o escribe /rc dentro de una sesión. Aparecerán una URL y el mensaje «Press space to show QR».

5. Escanea el código QR con el teléfono

   Pulsa la barra espaciadora en el terminal → usa la cámara o la aplicación Claude. Amplía la ventana del terminal si no se puede escanear.

6. Activa las notificaciones push

   /config → «Push when Claude decides». Si aparece «No mobile registered», abre la aplicación Claude al menos una vez.

7. Inicia una tarea larga y aléjate

   Haz que el prompt sea específico: «Hazlo de esta manera; en estos casos, haz aquello; si hay dudas, envía una notificación push». Después, trabaja desde el teléfono con las notificaciones push.

En un ejemplo práctico, se tardó 3–5 minutos en pasar de cero a la primera conversación desde el sofá.

Cuando quieras, descubre Ailoot.