Saltar al contenido principal
Remote Control está disponible en todos los planes. En Team y Enterprise, está deshabilitado de forma predeterminada hasta que un administrador habilite el botón de alternancia de Remote Control en configuración de administración de Claude Code.
Remote Control conecta claude.ai/code o la aplicación Claude para iOS y Android a una sesión de Claude Code que se ejecuta en su máquina. Inicie una tarea en su escritorio y luego continúela desde su teléfono en el sofá o desde un navegador en otra computadora. Cuando inicia una sesión de Remote Control en su máquina, Claude sigue ejecutándose localmente todo el tiempo, por lo que nada se mueve a la nube. Con Remote Control puede:
  • Usar su entorno local completo de forma remota: su sistema de archivos, MCP servers, herramientas y configuración del proyecto permanecen disponibles
  • Trabajar desde ambas superficies a la vez: la conversación se mantiene sincronizada en todos los dispositivos conectados, por lo que puede enviar mensajes desde su terminal, navegador y teléfono indistintamente
  • Sobrevivir a interrupciones: si su portátil se duerme o su red se cae, la sesión se reconecta automáticamente cuando su máquina vuelve a estar en línea
A diferencia de Claude Code en la web, que se ejecuta en infraestructura en la nube, las sesiones de Remote Control se ejecutan directamente en su máquina e interactúan con su sistema de archivos local. Las interfaces web y móvil son solo una ventana a esa sesión local.
Remote Control requiere Claude Code v2.1.51 o posterior. Verifique su versión con claude --version.
Esta página cubre la configuración, cómo iniciar y conectarse a sesiones, y cómo Remote Control se compara con Claude Code en la web.

​
Requisitos

Antes de usar Remote Control, confirme que su entorno cumple con estas condiciones:
  • Suscripción: disponible en planes Pro, Max, Team y Enterprise. Las claves API no son compatibles. En Team y Enterprise, un administrador debe habilitar primero el botón de alternancia de Remote Control en configuración de administración de Claude Code.
  • Autenticación: ejecute claude y use /login para iniciar sesión a través de claude.ai si aún no lo ha hecho.
  • Confianza del espacio de trabajo: ejecute claude en su directorio de proyecto al menos una vez para aceptar el diálogo de confianza del espacio de trabajo.

​
Inicie una sesión de Remote Control

Puede iniciar una sesión de Remote Control desde la CLI o la extensión de VS Code. La CLI ofrece tres modos de invocación; VS Code usa el comando /remote-control.
Navegue a su directorio de proyecto y ejecute:
claude remote-control
El proceso sigue ejecutándose en su terminal en modo servidor, esperando conexiones remotas. Muestra una URL de sesión que puede usar para conectarse desde otro dispositivo, y puede presionar la barra espaciadora para mostrar un código QR para acceso rápido desde su teléfono. Mientras una sesión remota está activa, la terminal muestra el estado de la conexión y la actividad de las herramientas.Banderas disponibles:
BanderaDescripción
--name "My Project"Establezca un título de sesión personalizado visible en la lista de sesiones en claude.ai/code.
--remote-control-session-name-prefix <prefix>Prefijo para nombres de sesión generados automáticamente cuando no se establece un nombre explícito. El valor predeterminado es el nombre de host de su máquina, produciendo nombres como myhost-graceful-unicorn. Establezca CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX para el mismo efecto.
--spawn <mode>Cómo el servidor crea sesiones.
• same-dir (predeterminado): todas las sesiones comparten el directorio de trabajo actual, por lo que pueden entrar en conflicto si editan los mismos archivos.
• worktree: cada sesión bajo demanda obtiene su propio git worktree. Requiere un repositorio git.
• session: modo de sesión única. Sirve exactamente una sesión y rechaza conexiones adicionales. Se establece solo al inicio.
Presione w en tiempo de ejecución para alternar entre same-dir y worktree.
--capacity <N>Número máximo de sesiones concurrentes. El valor predeterminado es 32. No se puede usar con --spawn=session.
--verboseMostrar registros detallados de conexión y sesión.
--sandbox / --no-sandboxHabilitar o deshabilitar sandboxing para aislamiento del sistema de archivos y red. Deshabilitado de forma predeterminada.

​
Conectarse desde otro dispositivo

Una vez que una sesión de Remote Control está activa, tiene varias formas de conectarse desde otro dispositivo:
  • Abra la URL de la sesión en cualquier navegador para ir directamente a la sesión en claude.ai/code.
  • Escanee el código QR que se muestra junto a la URL de la sesión para abrirlo directamente en la aplicación Claude. Con claude remote-control, presione la barra espaciadora para alternar la visualización del código QR.
  • Abra claude.ai/code o la aplicación Claude y encuentre la sesión por nombre en la lista de sesiones. Las sesiones de Remote Control muestran un icono de computadora con un punto de estado verde cuando están en línea.
El título de la sesión remota se elige en este orden:
  1. El nombre que pasó a --name, --remote-control, o /remote-control
  2. El título que estableció con /rename
  3. El último mensaje significativo en el historial de conversación existente
  4. Un nombre generado automáticamente como myhost-graceful-unicorn, donde myhost es el nombre de host de su máquina o el prefijo que estableció con --remote-control-session-name-prefix
Si no estableció un nombre explícito, el título se actualiza para reflejar su solicitud una vez que envíe una. Si el entorno ya tiene una sesión activa, se le preguntará si desea continuarla o iniciar una nueva. Si aún no tiene la aplicación Claude, use el comando /mobile dentro de Claude Code para mostrar un código QR de descarga para iOS o Android.

​
Habilite Remote Control para todas las sesiones

De forma predeterminada, Remote Control solo se activa cuando ejecuta explícitamente claude remote-control, claude --remote-control, o /remote-control. Para habilitarlo automáticamente para cada sesión interactiva, ejecute /config dentro de Claude Code y establezca Enable Remote Control for all sessions en true. Establézcalo de nuevo en false para deshabilitar. Con esta configuración activada, cada proceso interactivo de Claude Code registra una sesión remota. Si ejecuta varias instancias, cada una obtiene su propio entorno y sesión. Para ejecutar varias sesiones concurrentes desde un único proceso, use el modo servidor en su lugar.

​
Conexión y seguridad

Su sesión local de Claude Code realiza solo solicitudes HTTPS salientes y nunca abre puertos entrantes en su máquina. Cuando inicia Remote Control, se registra con la API de Anthropic y sondea el trabajo. Cuando se conecta desde otro dispositivo, el servidor enruta mensajes entre el cliente web o móvil y su sesión local a través de una conexión de transmisión. Todo el tráfico viaja a través de la API de Anthropic sobre TLS, el mismo transporte de seguridad que cualquier sesión de Claude Code. La conexión utiliza múltiples credenciales de corta duración, cada una limitada a un único propósito y expirando de forma independiente.

​
Remote Control vs Claude Code en la web

Remote Control y Claude Code en la web ambos usan la interfaz claude.ai/code. La diferencia clave es dónde se ejecuta la sesión: Remote Control se ejecuta en su máquina, por lo que sus MCP servers locales, herramientas y configuración del proyecto permanecen disponibles. Claude Code en la web se ejecuta en infraestructura en la nube administrada por Anthropic. Use Remote Control cuando esté en medio del trabajo local y desee continuar desde otro dispositivo. Use Claude Code en la web cuando desee iniciar una tarea sin ninguna configuración local, trabajar en un repositorio que no tiene clonado, o ejecutar varias tareas en paralelo.

​
Notificaciones push móviles

Cuando Remote Control está activo, Claude puede enviar notificaciones push a su teléfono. Claude decide cuándo enviar. Típicamente envía una cuando una tarea de larga duración finaliza o cuando necesita una decisión de usted para continuar. También puede solicitar un push en su solicitud, por ejemplo notify me when the tests finish. Más allá del botón de alternancia activado/desactivado a continuación, no hay configuración por evento.
Las notificaciones push móviles requieren Claude Code v2.1.110 o posterior.
Para configurar notificaciones push móviles:
1

Instale la aplicación móvil Claude

Descargue la aplicación Claude para iOS o Android.
2

Inicie sesión con su cuenta de Claude Code

Use la misma cuenta y organización que usa para Claude Code en la terminal.
3

Permita notificaciones

Acepte el mensaje de solicitud de permiso de notificación del sistema operativo.
4

Habilite push en Claude Code

En su terminal, ejecute /config y habilite Push when Claude decides.
Si las notificaciones no llegan:
  • Si /config muestra No mobile registered, abra la aplicación Claude en su teléfono para que pueda actualizar su token push. La advertencia se borra la próxima vez que Remote Control se conecte.
  • En iOS, los modos Focus y los resúmenes de notificaciones pueden suprimir o retrasar los pushes. Verifique Configuración → Notificaciones → Claude.
  • En Android, la optimización agresiva de batería puede retrasar la entrega. Exima la aplicación Claude de la optimización de batería en la configuración del sistema.

​
Limitaciones

  • Una sesión remota por proceso interactivo: fuera del modo servidor, cada instancia de Claude Code admite una sesión remota a la vez. Use el modo servidor para ejecutar varias sesiones concurrentes desde un único proceso.
  • El proceso local debe seguir ejecutándose: Remote Control se ejecuta como un proceso local. Si cierra la terminal, cierra VS Code, o detiene el proceso claude de otra manera, la sesión finaliza.
  • Interrupción de red extendida: si su máquina está despierta pero no puede alcanzar la red durante más de aproximadamente 10 minutos, la sesión agota el tiempo de espera y el proceso se cierra. Ejecute claude remote-control nuevamente para iniciar una nueva sesión.
  • Ultraplan desconecta Remote Control: iniciar una sesión de ultraplan desconecta cualquier sesión de Remote Control activa porque ambas características ocupan la interfaz claude.ai/code y solo una puede estar conectada a la vez.

​
Solución de problemas

​
”Remote Control requires a claude.ai subscription”

No está autenticado con una cuenta de claude.ai. Ejecute claude auth login y elija la opción de claude.ai. Si ANTHROPIC_API_KEY está configurado en su entorno, desactívelo primero.

​
”Remote Control requires a full-scope login token”

Está autenticado con un token de larga duración de claude setup-token o la variable de entorno CLAUDE_CODE_OAUTH_TOKEN. Estos tokens se limitan a solo inferencia y no pueden establecer sesiones de Remote Control. Ejecute claude auth login para autenticarse con un token de sesión de alcance completo en su lugar.

​
”Unable to determine your organization for Remote Control eligibility”

Su información de cuenta en caché está obsoleta o incompleta. Ejecute claude auth login para actualizarla.

​
”Remote Control is not yet enabled for your account”

La verificación de elegibilidad puede fallar con ciertas variables de entorno presentes:
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC o DISABLE_TELEMETRY: desactívelas e intente de nuevo.
  • CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX, o CLAUDE_CODE_USE_FOUNDRY: Remote Control requiere autenticación de claude.ai y no funciona con proveedores de terceros.
Si ninguno de estos está configurado, ejecute /logout luego /login para actualizar.

​
”Remote Control is disabled by your organization’s policy”

Este error tiene tres causas distintas. Ejecute /status primero para ver qué método de inicio de sesión y suscripción está usando.
  • Está autenticado con una clave API o cuenta de Console: Remote Control requiere OAuth de claude.ai. Ejecute /login y elija la opción de claude.ai. Si ANTHROPIC_API_KEY está configurado en su entorno, desactívelo.
  • Su administrador de Team o Enterprise no lo ha habilitado: Remote Control está deshabilitado de forma predeterminada en estos planes. Un administrador puede habilitarlo en claude.ai/admin-settings/claude-code activando el botón de alternancia Remote Control. Esta es una configuración de organización del lado del servidor, no una clave de configuración administrada.
  • El botón de alternancia del administrador está atenuado: su organización tiene una configuración de retención de datos o cumplimiento que es incompatible con Remote Control. Esto no se puede cambiar desde el panel de administración. Póngase en contacto con el soporte de Anthropic para discutir opciones.

​
”Remote credentials fetch failed”

Claude Code no pudo obtener una credencial de corta duración de la API de Anthropic para establecer la conexión. Vuelva a ejecutar con --verbose para ver el error completo: 
claude remote-control --verbose
Causas comunes:
  • No ha iniciado sesión: ejecute claude y use /login para autenticarse con su cuenta de claude.ai. La autenticación con clave API no es compatible con Remote Control.
  • Problema de red o proxy: un firewall o proxy puede estar bloqueando la solicitud HTTPS saliente. Remote Control requiere acceso a la API de Anthropic en el puerto 443.
  • Error en la creación de sesión: si también ve Session creation failed — see debug log, el error ocurrió antes en la configuración. Verifique que su suscripción esté activa.

​
Elija el enfoque correcto

Claude Code offers several ways to work when you’re not at your terminal. They differ in what triggers the work, where Claude runs, and how much you need to set up.
TriggerClaude runs onSetupBest for
DispatchMessage a task from the Claude mobile appYour machine (Desktop)Pair the mobile app with DesktopDelegating work while you’re away, minimal setup
Remote ControlDrive a running session from claude.ai/code or the Claude mobile appYour machine (CLI or VS Code)Run claude remote-controlSteering in-progress work from another device
ChannelsPush events from a chat app like Telegram or Discord, or your own serverYour machine (CLI)Install a channel plugin or build your ownReacting to external events like CI failures or chat messages
SlackMention @Claude in a team channelAnthropic cloudInstall the Slack app with Claude Code on the web enabledPRs and reviews from team chat
Scheduled tasksSet a scheduleCLI, Desktop, or cloudPick a frequencyRecurring automation like daily reviews

​
Recursos relacionados

  • Claude Code en la web: ejecute sesiones en entornos en la nube administrados por Anthropic en lugar de en su máquina
  • Ultraplan: inicie una sesión de planificación en la nube desde su terminal y revise el plan en su navegador
  • Channels: reenvíe Telegram, Discord o iMessage a una sesión para que Claude reaccione a los mensajes mientras está fuera
  • Dispatch: envíe un mensaje de una tarea desde su teléfono y puede generar una sesión de Desktop para manejarla
  • Autenticación: configure /login y administre credenciales para claude.ai
  • Referencia de CLI: lista completa de banderas y comandos incluyendo claude remote-control
  • Seguridad: cómo las sesiones de Remote Control se ajustan al modelo de seguridad de Claude Code
  • Uso de datos: qué datos fluyen a través de la API de Anthropic durante sesiones locales y remotas