Claude Code desde el teléfono

Guía · @vanlookeren

Claude Code desde el teléfono

Dejás una tarea corriendo en el Mac, te levantás, y la seguís desde el celular. El código nunca sale de tu máquina: el teléfono es solo la ventana.

Qué es, y qué no es

La función se llama Remote Control. Conecta la app de Claude en tu teléfono —o claude.ai/code en cualquier navegador— a una sesión de Claude Code que corre en tu computadora.

Esa distinción es todo. Tu sistema de archivos, tus servidores MCP, tus herramientas y la configuración del proyecto siguen donde están. El proceso local hace el trabajo; el teléfono manda mensajes y mira lo que pasa. Hasta el @ autocompleta rutas de tu proyecto real desde el celular.

No confundir con Claude Code en la web

Claude Code en la web corre en infraestructura de Anthropic, en una máquina que no es tuya. Remote Control corre en la tuya. Si tu proyecto necesita tus credenciales locales, tu base de datos o tus MCPs, querés Remote Control.

Lo que hace falta antes de empezar

Cómo se prende, paso a paso

  1. Elegí una de las tres formas de arrancar

    Las tres sirven, y la diferencia importa. Desde la carpeta de tu proyecto:

    claude remote-control

    Es el modo servidor: el proceso queda ocupando la terminal, esperando conexiones, y muestra la URL de la sesión. Apretá la barra espaciadora para ver un código QR y abrirla en el teléfono al toque.

    claude --remote-control
    claude --remote-control "Mi proyecto"

    Es una sesión interactiva normal con Remote Control encendido: podés seguir escribiendo en la terminal y desde el teléfono. Para mí esta es la que tiene sentido el 90% de las veces. Acepta --rc como atajo.

    /remote-control

    Si ya estás en una sesión y querés seguirla desde el teléfono, este comando la conecta sin perder nada de lo que venías haciendo. También responde a /rc.

  2. Conectá el teléfono

    Tres caminos, todos equivalentes:

    • Escaneá el QR y se abre directo en la app de Claude.
    • Abrí la URL de la sesión en cualquier navegador.
    • Abrí la app y tocá Code en la navegación. Tu sesión aparece en la lista con un ícono de computadora y un punto verde cuando está en línea.

    Si todavía no tenés la app instalada, el comando /mobile te muestra un QR de descarga para iOS y Android.

  3. Ponele nombre, o vas a perderla

    Sin nombre explícito, la sesión queda con algo tipo mimac-graceful-unicorn. Con dos o tres sesiones abiertas eso es inservible. Pasale el nombre al arrancar, o usá /rename después:

    claude --remote-control "Web del cliente"
  4. Si lo vas a usar siempre, dejalo automático

    Corré /config dentro de Claude Code y activá Enable Remote Control for all sessions. Desde ahí cada sesión interactiva se conecta sola al arrancar.

    El equivalente en archivo es remoteControlAtStartup: true en tu ~/.claude/settings.json.

Las tres cosas que te van a morder

01 · El proceso local tiene que seguir vivo

Si cerrás la terminal, la sesión se cae y el teléfono la ve offline en segundos. Remote Control no es un servidor en la nube: es tu propia máquina atendiendo. Si la vas a dejar corriendo mientras te movés, y sobre todo si entrás por SSH, arrancala adentro de tmux o screen.

02 · Una sesión remota por proceso

Una sesión interactiva sostiene una sola sesión remota. Si querés varias en paralelo desde un mismo proceso, ese es exactamente el caso del modo servidor (claude remote-control), que por defecto aguanta hasta 32.

03 · No todos los comandos andan desde el celular

Los que solo existen en la terminal —/plugin, /resume— siguen siendo locales. Otros funcionan pero cambian de forma: /model y /effort desde el teléfono necesitan el valor como argumento, porque no hay selector. Se escribe /model sonnet, no /model a secas.

Lo que en la práctica lo hace valer

El caso real no es programar desde el teléfono, que es incómodo y nadie quiere. Es otro: le dejás una tarea larga, te vas, y desde el celular aprobás los permisos que va pidiendo en vez de encontrarte una hora después con que estuvo trabado esperándote desde el minuto dos.

Claude Code juega a favor de eso: cuando un turno se hace largo te muestra un aviso de Still working con un link para seguirlo desde el teléfono, y si respondiste varios permisos seguidos te ofrece el link para aprobarlos desde ahí.

Y si el Mac se duerme o se te corta el wifi, la sesión no se pierde: encola los mensajes y los permisos, y los entrega cuando la conexión vuelve.