Remote Control de Claude Code: paso a paso desde el celular
· 6 min de lectura
Remote Control es la función de Claude Code que te deja seguir desde el teléfono una sesión que corre en tu propio computador. Se abre con claude --remote-control para una sesión interactiva, o con claude remote-control en modo servidor, y conectas escaneando un código QR. Necesitas suscripción de Claude: las claves de API no están soportadas.
Claude Code corre en tu computador. Remote Control te deja tomar esa misma sesión desde el teléfono o desde cualquier navegador, sin instalar nada aparte y sin pagar nada aparte: el proceso sigue en tu máquina y el celular es solo la ventana.
Esta guía es el cómo — los comandos exactos, cómo sacar el código QR (no sale solo) y los límites reales. Si lo que buscas es el caso, qué pasó cuando lo dejé corriendo una madrugada entera, eso está en https://ninodirector.com/articulos/claude-code-desde-el-celular
Qué es Remote Control y qué necesitas
Remote Control conecta claude.ai/code y la app de Claude para iOS y Android con una sesión de Claude Code que corre EN tu máquina. La diferencia con Claude Code en la web es dónde se ejecuta el trabajo: aquí tu sistema de archivos, tus servidores MCP y la configuración de tu proyecto siguen disponibles, porque el proceso nunca sale de tu computador.
Lo que necesitas antes de empezar:
Suscripción de Claude (Pro, Max, Team o Enterprise). La documentación oficial lo dice sin rodeos: "API keys are not supported". Una clave de API no abre Remote Control.
Haber entrado con /login desde tu cuenta de claude.ai. Un token largo de claude setup-token o la variable CLAUDE_CODE_OAUTH_TOKEN tampoco sirven: solo pueden hacer peticiones al modelo, no abrir sesiones remotas.
Estar hablando con api.anthropic.com. No funciona en Amazon Bedrock, Google Cloud ni Microsoft Foundry, y desde la 2.1.196 tampoco si ANTHROPIC_BASE_URL apunta a un gateway o a un proxy.
Haber abierto claude en esa carpeta al menos una vez, para aceptar el diálogo de confianza del proyecto. Ese diálogo nunca guarda la confianza de tu carpeta personal, así que arranca Remote Control desde un directorio de proyecto.
Cómo se hace: la sesión en tu celular en cinco pasos
Comprueba tu versión con claude --version. Para retomar sesiones con --continue necesitas la 2.1.200 o superior; esta guía está verificada sobre la 2.1.229.
Comprueba que la bandera existe en tu build: corre claude --help y busca remote. De una sola línea, claude --help | grep -i remote. Si no devuelve nada, tu versión o tu cuenta todavía no la tienen y ningún comando de abajo va a funcionar.
Abre la sesión. Hay dos formas y no son la misma. claude --remote-control te da una sesión interactiva normal en tu terminal que además se puede manejar desde el celular. claude remote-control la arranca en modo servidor: el proceso se queda esperando conexiones y tú no escribes ahí. Si quieres seguir tecleando en tu terminal, usa la bandera.
Saca el código QR y escanéalo. Esto es lo que casi todo el mundo cuenta mal: el QR no aparece solo. En modo servidor pulsas la barra espaciadora para mostrarlo u ocultarlo. En sesión interactiva, el indicador /rc active vive en el pie del cuadro de texto: lo seleccionas con la flecha abajo y Enter, o vuelves a correr /remote-control, y ahí se abre el panel con la URL de la sesión y el QR. Escaneas con el teléfono y la sesión te queda en la mano.
Para retomar la última, en esa misma carpeta: claude remote-control --continue. El CHANGELOG de Claude Code no dice "Added" en la 2.1.229: dice "Documented claude remote-control --continue". O sea que la función llevaba tiempo ahí y lo nuevo es que por fin está escrita.
Un detalle que despista: remote-control no aparece en la lista de Commands de claude --help, donde solo salen las banderas --remote-control y --remote-control-session-name-prefix. El subcomando existe igual: correr claude remote-control --help imprime su propia ayuda. Y en la 2.1.229 esa ayuda añade una letra pequeña que la web no trae — --continue solo reengancha lo que quedó registrado en ese directorio dentro de las últimas cuatro horas, más o menos. Pasado ese rato, sesión nueva.
Qué puede salir mal
Esperas un QR que nunca sale. Es el fallo número uno y no es tuyo: es que nadie lo explica. Vuelve al paso 4 — barra espaciadora en modo servidor, /remote-control en sesión interactiva.
Se te cae a los diez minutos. La sesión vive DENTRO de tu computador, no en la nube. Si la máquina está despierta pero no consigue llegar a la red por más de unos diez minutos, la sesión caduca y el proceso se cierra. Que el portátil se duerma es otra cosa: de eso Claude Code se recupera solo cuando la máquina vuelve.
Cierras la terminal y se acabó. Es un proceso local: si matas claude, matas la sesión. Para dejarla viva en una máquina a la que entras por SSH, arráncala dentro de tmux o de screen.
Tienes ANTHROPIC_API_KEY puesta. Sale el error "Remote Control requires a claude.ai subscription". Quita la variable del entorno y entra con claude auth login eligiendo la opción de claude.ai.
Apagaste la telemetría. DISABLE_TELEMETRY, DO_NOT_TRACK, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC y DISABLE_GROWTHBOOK desactivan la evaluación de feature flags de la que depende Remote Control. Con cualquiera de ellas puesta, no arranca — y el mensaje de error no siempre te dice eso.
Estás en una cuenta de equipo. En Team y Enterprise viene apagado por defecto hasta que un Owner encienda el interruptor de Remote Control en la consola de Claude Code. Si además activan Trusted Devices, hoy en beta, cada navegador o teléfono se enrola una vez y tu inicio de sesión no puede tener más de 18 horas: pasadas esas, la siguiente interacción te pide Face ID, Touch ID, Windows Hello o una passkey.
Cuentas con 32 sesiones y solo tienes una. El tope de sesiones concurrentes en modo servidor es 32 por defecto, ajustable con --capacity. Pero eso es modo servidor: en una sesión interactiva cada proceso de Claude Code sostiene una sola sesión remota.
Lo tratas como algo estable. La nota de la documentación oficial es explícita: "Remote Control is in research preview and available on all plans". Está en research preview, así que lo que verifiques hoy puede cambiar el mes que viene. Por eso el paso 2 de esta guía es comprobar la bandera en tu propia máquina y no fiarte de ningún tutorial, incluido este.
Remote Control o Claude Code en la web: cuál te toca
Las dos se ven en claude.ai/code, así que es fácil confundirlas. La diferencia es dónde corre el trabajo. Remote Control ejecuta en tu máquina: sirve cuando ya estás a mitad de una tarea local y quieres seguirla desde otro lado, con tus MCP, tus archivos y tu configuración intactos. Claude Code en la web ejecuta en la nube: sirve para arrancar algo sin montar nada, tocar un repo que no tienes clonado o lanzar varias tareas en paralelo. La regla rápida: si el trabajo depende de un archivo que solo existe en tu disco, la respuesta es Remote Control.
Preguntas frecuentes
¿Cuál es el comando para usar Claude Code desde el celular?
Son dos comandos y no hacen lo mismo. claude --remote-control abre una sesión interactiva normal en tu terminal que además puedes manejar desde el teléfono, mientras que claude remote-control la arranca en modo servidor y se queda esperando conexiones. Los dos se corren dentro de la carpeta del proyecto en el que quieres trabajar. Después conectas escaneando el código QR o abriendo la URL de la sesión en claude.ai/code.
¿Cómo retomo la última sesión de Remote Control?
Con claude remote-control --continue, corrido en la misma carpeta donde arrancó la sesión anterior. Necesitas Claude Code 2.1.200 o superior, porque las versiones anteriores rechazan la bandera como argumento desconocido. La ayuda del propio comando en la 2.1.229 avisa de que solo reengancha lo que quedó registrado en ese directorio dentro de las últimas cuatro horas aproximadamente. Si pasó más tiempo, sale un error y toca abrir una sesión nueva.
¿Remote Control funciona con una clave de API?
No. La documentación oficial dice literalmente que las claves de API no están soportadas, y necesitas una suscripción Pro, Max, Team o Enterprise con la sesión iniciada desde claude.ai. Los tokens largos de claude setup-token y la variable CLAUDE_CODE_OAUTH_TOKEN tampoco valen, porque solo pueden hacer peticiones al modelo. Si tienes ANTHROPIC_API_KEY en el entorno, quítala antes de intentarlo.
¿Qué pasa si se cae el internet mientras Claude Code trabaja?
Depende de qué se caiga. Si tu computador se duerme o la red parpadea un momento, Claude Code se reconecta solo cuando la máquina vuelve a estar en línea. Pero si la máquina sigue despierta y no consigue alcanzar la red durante más de unos diez minutos, la sesión caduca y el proceso se cierra, porque la sesión vive dentro de tu computador y no en la nube. En ese caso hay que abrir una sesión nueva.
¿Por qué no me aparece el código QR de Remote Control?
Porque no aparece solo, y ahí se atasca casi todo el mundo. En modo servidor, con claude remote-control, tienes que pulsar la barra espaciadora para mostrar u ocultar el QR. En una sesión interactiva abierta con claude --remote-control, el QR está en el panel de estado: selecciona el indicador del pie con la flecha abajo y pulsa Enter, o vuelve a correr el comando /remote-control. Si ni siquiera ves el indicador, revisa que la conexión no haya fallado.