SpyBara
Go Premium

remote-control.md 2026-09-28 22:59 UTC to 2026-09-29 06:57 UTC

This page contains 135 additions and 143 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58 Mon 28 22:59 Tue 29 08:02

Continúe sesiones locales desde cualquier dispositivo con Remote Control

Continúe una sesión local de Claude Code desde su teléfono, tableta o cualquier navegador usando Remote Control. Funciona con claude.ai/code y la aplicación móvil de Claude.

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 su ejecución de código y acceso al sistema de archivos permanecen en su máquina. 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, y escribir @ completa automáticamente las rutas de archivo de su proyecto local.
  • Trabajar desde ambas superficies a la vez: la conversación y el progreso de subagentes y flujos de trabajo dinámicos se mantienen sincronizados en todos los dispositivos conectados, por lo que puede enviar mensajes desde su terminal, navegador y teléfono indistintamente.
  • Enviar imágenes y archivos desde su teléfono o navegador: adjunte una foto o archivo en la aplicación Claude o en claude.ai/code, con o sin un título. Claude ve las fotos adjuntas directamente como parte de su mensaje. Claude Code descarga otros archivos a su máquina y los pasa a Claude como referencias de archivo @.
  • Sobrevivir a interrupciones: si su portátil se duerme o su red se cae, Claude Code se reconecta automáticamente cuando su máquina vuelve a estar en línea.

A diferencia de sesiones en la nube, que se ejecutan 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 una ventana a esa sesión local, por lo que su computadora tiene que permanecer encendida y el proceso claude tiene que seguir ejecutándose.

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 propietario 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. Sin un inicio de sesión elegible, claude remote-control se cierra con un error, mientras que claude --remote-control aún inicia una sesión interactiva y muestra una notificación de fallo de Remote Control poco después del lanzamiento.
  • Punto final de API: no disponible en ninguna de estas configuraciones:
  • Evaluación de indicadores de características: si establece una variable de entorno que desactiva la evaluación de indicadores de características, la disponibilidad de Remote Control depende de cuál sea:
    • Si establece CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC o DISABLE_GROWTHBOOK, Remote Control no está disponible. Desactive la variable dondequiera que esté configurada, en su entorno de shell o en el bloque env de un archivo settings.json, para usar Remote Control.
    • Si establece solo DISABLE_TELEMETRY o DO_NOT_TRACK, Remote Control permanece disponible a menos que su organización requiera Dispositivos de confianza. Si es así, desactive la variable para usar Remote Control. El uso de Remote Control con cualquiera de estas variables establecidas requiere Claude Code v2.1.283 o posterior.
  • Confianza del espacio de trabajo: en un directorio que aún no ha confiado, claude remote-control imprime lo que confiar en él activa y pregunta ¿Confiar en <directorio>? [s/N] antes de iniciarse. Responder s guarda la opción, excepto en su directorio de inicio, donde la confianza nunca se guarda y la pregunta vuelve en cada ejecución. Cuando su entrada o salida estándar no es una terminal, el comando no puede preguntar y se cierra con un error Workspace not trusted.

Inicie una sesión de Remote Control

Puede iniciar una sesión de Remote Control desde la CLI, la aplicación Claude Desktop, o la extensión de VS Code. La CLI ofrece tres modos de invocación; la aplicación Desktop y VS Code usan el comando /remote-control.

En su directorio de proyecto, ejecute:

claude remote-control

Hasta que acepte la confirmación única de Remote Control, claude remote-control explica qué hace y pregunta Enable Remote Control? (y/n) antes de iniciar el servidor. Responda y para aceptar e iniciar el servidor. Si rechaza, Claude Code sale sin iniciar el servidor y pregunta nuevamente la próxima vez que ejecute el comando.

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:

Bandera Descripció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.
-c, --continue Reanude la sesión que el último servidor en este directorio inició, en lugar de crear una nueva. Consulte Reanude sesiones después de detener el servidor. No se puede combinar con --session-id, --spawn, --capacity, o --create-session-in-dir. Requiere Claude Code v2.1.200 o posterior.
--session-id <id> Reanude una sesión por su ID. Consulte Reanude sesiones después de detener el servidor. No se puede combinar con --continue, --spawn, --capacity, o --create-session-in-dir. Requiere Claude Code v2.1.200 o posterior.
--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.
--[no-]create-session-in-dir Pre-crear una sesión en el directorio actual cuando el servidor se inicia, para que tenga un lugar donde escribir inmediatamente. En modo worktree esta sesión permanece en el directorio actual mientras las sesiones bajo demanda obtienen worktrees aislados. Habilitado de forma predeterminada. Si pasa --no-create-session-in-dir para comenzar sin ninguno, Claude Code archiva las sesiones del servidor cuando lo detiene, por lo que no hay nada que reanudar.
--permission-mode <mode> Establezca el modo de permiso inicial para las sesiones del servidor, como acceptEdits. Acepta manual como alias para default; un modo no reconocido detiene el servidor al inicio y enumera los modos válidos.
-d, --debug[=<filter>] Active el registro de depuración para el servidor, opcionalmente filtrado por categoría. Pase un filtro solo en la forma =, como --debug=api,hooks. Requiere Claude Code v2.1.282 o posterior; las versiones anteriores rechazan la bandera como un argumento desconocido.
--debug-file <path> Escriba registros de depuración en el archivo dado.
--verbose Mostrar registros detallados de conexión y sesión.
--sandbox / --no-sandbox Habilitar o deshabilitar sandboxing para aislamiento del sistema de archivos y red. Deshabilitado de forma predeterminada.

Proporcione estas banderas después de remote-control.

Si pasa una bandera global claude antes de remote-control, o un script contenedor agrega una, Claude Code no lleva la bandera a las sesiones que crea el servidor. Claude Code deja pasar la bandera solo cuando se sabe que dejarla no cambia lo que esas sesiones pueden hacer, como --verbose o --model. Para cualquier otra bandera, como --settings, Claude Code se niega a iniciar y nombra la bandera a eliminar.

Claude Code verifica la elegibilidad de Remote Control antes de imprimir la ayuda, por lo que claude remote-control --help devuelve un error en lugar de esta lista de banderas cuando no ha iniciado sesión con una cuenta elegible.

Verifique el estado de la conexión

En una sesión interactiva, mientras Remote Control está conectado, la terminal muestra un indicador /rc active que se vincula a la sesión en claude.ai. El indicador se oculta cuando la terminal es demasiado estrecha para ajustarlo. Para ver la URL de la sesión y un código QR para conectarse desde otro dispositivo, ejecute /remote-control nuevamente para abrir el panel de estado. El panel también le permite desconectar Remote Control mientras su sesión local sigue ejecutándose.

Si la conexión falla en una sesión interactiva, el indicador cambia para mostrar el fallo, y Claude Code muestra el motivo en una notificación y lo agrega a la conversación. Ejecute /remote-control para reconectarse, a menos que el motivo diga que la sesión cambió en otro lugar:

  • Otra conexión tomó esta sesión: otro dispositivo o sesión de Claude Code la tiene ahora. Ejecute /remote-control solo si desea recuperarla.
  • Esta sesión fue terminada o archivada desde otro dispositivo o aplicación: ejecute /remote-control solo si la desea de vuelta. Claude Code reabre una sesión archivada.
  • El servidor ya no reporta esta sesión: puede haber sido eliminada desde otro dispositivo o aplicación.

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. En la aplicación móvil Claude, toque Code en la navegación para llegar a 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.

Cuando se conecta, el dispositivo muestra cualquier subagente y flujo de trabajo que la sesión ya tenga ejecutándose en segundo plano. Detenga uno de ellos desde el dispositivo, y Claude Code detiene esa tarea en su máquina.

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, Claude Code actualiza el título para reflejar su solicitud una vez que envíe una. Cuando renombra una sesión desde claude.ai o la aplicación Claude, Claude Code también actualiza el título local que se muestra en claude --resume.

Si aún no tiene la aplicación Claude, ejecute /mobile dentro de Claude Code para mostrar un código QR para claude.ai/mobile, que abre la tienda de aplicaciones correcta para su teléfono.

Lo que ven los dispositivos conectados

Un dispositivo conectado muestra la conversación en su terminal mientras sucede. Estos casos van más allá de los mensajes ordinarios:

  • Compactación y /clear: mientras Claude Code compacta la conversación, los dispositivos conectados muestran el progreso y luego dónde se compactó la conversación. Cuando ejecuta /clear, la conversación se reinicia en los dispositivos conectados también.
  • Cambiar conversaciones con /resume: el dispositivo conectado no recibe el título o historial anterior de la conversación a la que se cambió, pero los nuevos mensajes en ambas direcciones van hacia y desde cualquier conversación que esté abierta en su terminal. Para trabajar en la conversación original desde el dispositivo nuevamente, ejecute /resume en su terminal y vuelva a cambiar a ella.
  • Extraer una sesión con /teleport: cuando extrae una sesión de Claude Code en la web en su terminal con /teleport, el dispositivo conectado no recibe el historial anterior de la conversación extraída. Los nuevos mensajes en ambas direcciones van hacia y desde la conversación extraída, que ahora es la que está abierta en su terminal.
  • Mensajes de sus otras sesiones: con mensajería entre sesiones, la misma conexión lleva mensajes entre sus propias sesiones en diferentes máquinas y desde sus sesiones de Claude Code en la web.
  • Diferencia de sus cambios: cuando el directorio de la sesión está en un repositorio git, el panel de diferencia de un dispositivo conectado muestra sus cambios. En una rama que tiene confirmaciones por delante de la rama predeterminada del repositorio, el panel muestra los cambios desde que la rama se separó de ella, incluidas sus ediciones sin confirmar. En la rama predeterminada misma, o en una rama que no está por delante de ella, el panel muestra solo sus cambios sin confirmar.
  • Modelo: cuando elige un modelo desde un dispositivo conectado, Claude Code ejecuta la sesión en ese modelo. Requiere Claude Code v2.1.238 o posterior. Un modelo que elige desde el control de modelo del dispositivo se aplica solo a la sesión actual. Cuando envía /model <name> desde el dispositivo a una sesión interactiva, Claude Code también establece su predeterminado para nuevas sesiones.
  • Nivel de esfuerzo: cuando establece el nivel de esfuerzo desde un dispositivo conectado, con /effort o el control de esfuerzo del dispositivo, Claude Code lo aplica a la sesión en su máquina. Si fijó un nivel con CLAUDE_CODE_EFFORT_LEVEL, la sesión mantiene ese nivel, y Claude Code rechaza una selección diferente desde el control de esfuerzo. Seleccionar un nivel desde el control de esfuerzo requiere Claude Code v2.1.234 o posterior en su máquina.
  • Reconexión después de un fallo de conexión: ejecute /remote-control para reconectarse. Si la compactación rescribió la conversación o cambió conversaciones con /resume mientras tanto, Claude Code archiva la sesión del servidor que estaba usando en lugar de dejarla en la lista de sesiones. Aún puede encontrarla filtrando sesiones archivadas. Cambiar conversaciones mientras un dispositivo aún está conectado no archiva la sesión.

Habilite Remote Control para todas las sesiones

Remote Control solo se activa cuando ejecuta explícitamente claude remote-control, claude --remote-control, o /remote-control, a menos que la conexión automática esté activada. Para activar la conexión automática para cada sesión interactiva, ejecute /config dentro de Claude Code y establezca Enable Remote Control for all sessions. El botón de alternancia toma tres valores:

  • true: conectarse automáticamente cuando comienza una sesión interactiva.
  • false: desactivar la conexión automática, aunque un true de configuración administrada lo supera, porque Claude Code guarda la opción en su configuración de usuario. Un false en configuración de proyecto o local (.claude/settings.json, .claude/settings.local.json) desactiva la conexión automática incluso sobre un true administrado.
  • default: borrar su opción y seguir el predeterminado de administrador de su organización si uno está establecido, de lo contrario el predeterminado actual de Claude Code.

El mismo botón de alternancia aparece fuera de la CLI:

  • Aplicación de escritorio: Settings > Claude Code > Enable remote control by default.
  • Extensión de VS Code: Enable Remote Control for all sessions en la sección Configuración del menú de comandos.

Para activar la conexión automática desde un archivo de configuración en su lugar, establezca remoteControlAtStartup en true en su usuario ~/.claude/settings.json o en configuración administrada. En configuración de proyecto o local (.claude/settings.json, .claude/settings.local.json), Claude Code honra un false y desactiva la conexión automática para ese repositorio, pero ignora un true, por lo que un archivo registrado no puede activar Remote Control para todos los que abren el repositorio.

La conexión automática inicia sesión con su propia cuenta de claude.ai, por lo que una sesión que inicia aparece solo en sus propias aplicaciones Claude y no otorga acceso a nadie más.

Con esta configuración activada, cada proceso interactivo de Claude Code registra una sesión remota. Si ejecuta varias instancias, cada una obtiene su propia sesión remota. Para ejecutar varias sesiones concurrentes desde un único proceso, use modo servidor en su lugar.

Reanude sesiones después de detener el servidor

Cuando detiene claude remote-control con Ctrl+C, las sesiones que estaba sirviendo dejan de responder desde su teléfono o navegador. Siempre que no estuviera ejecutando otro claude remote-control en el mismo directorio y no haya iniciado este con --no-create-session-in-dir, Claude Code no las archiva. Para traerlas de vuelta, ejecute uno de estos comandos en el mismo directorio:

  • claude remote-control: trae de vuelta cada sesión que el servidor estaba sirviendo.
  • claude remote-control --continue: trae de vuelta solo la sesión que el servidor inició, y sale cuando esa sesión termina. Si este directorio no tiene registro, Claude Code usa la más nueva de los otros git worktrees de este repositorio.
  • claude remote-control --session-id <id>: trae de vuelta solo la sesión cuyo ID pasa, y sale cuando esa sesión termina. El ID es la parte de la URL de la sesión en claude.ai/code entre /code/ y cualquier ?.

Estos comandos funcionan durante aproximadamente cuatro horas después de que el servidor se detuvo. Después de eso, ejecute claude remote-control para iniciar una nueva sesión. Si archivó una sesión mientras tanto, --continue y --session-id la desarchivan en Claude Code v2.1.228 o posterior.

Para traer de vuelta una sesión que inició con claude --remote-control o /remote-control, reanude la conversación con claude --continue o claude --resume. Si Remote Control no se reconecta, consulte No se pudo reconectar a su sesión de Remote Control.

Si reanuda la conversación en una segunda terminal mientras la primera aún tiene Remote Control activado, Claude Code imprime un aviso Remote Control not started here en la segunda terminal y deja Remote Control desactivado allí en lugar de tomar la sesión de la primera. Ejecute /remote-control en la segunda terminal para mover Remote Control a ella.

Cuando reanuda una conversación en Claude Desktop o una extensión de IDE que tenía Remote Control activado, Claude Code lo vuelve a adjuntar a la sesión de claude.ai existente en lugar de agregar una nueva a la lista de sesiones.

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.

Mientras Remote Control está conectado, la transcripción de la sesión, incluidos sus mensajes, las respuestas de Claude y la actividad de herramientas, se almacena en los servidores de Anthropic. La transcripción almacenada mantiene la conversación sincronizada en todos sus dispositivos y permite que la sesión se reconecte después de una caída de red. La ejecución y el acceso al sistema de archivos permanecen en su máquina, y las transcripciones almacenadas se retienen bajo la política de Uso de datos.

Para desactivar Remote Control completamente, utilice la configuración disableRemoteControl. Las organizaciones con requisitos de cumplimiento como Retención Cero de Datos no pueden habilitar Remote Control.

Dispositivos de confianza

Trusted Devices requiere que cada miembro de su organización, o usted solo en un plan Pro o Max, verifique su dispositivo antes de poder ver o controlar sesiones de Remote Control desde claude.ai, las aplicaciones móviles de Claude o Claude Desktop. Vincula el acceso a Remote Control a un dispositivo conocido y una autenticación reciente, no solo a una cuenta con sesión iniciada.

Cuando la configuración está activada, interactuar con una sesión de Remote Control requiere ambas de las siguientes:

  • Un dispositivo inscrito: cada navegador, teléfono o aplicación de escritorio que un miembro usa para Remote Control inscribe su propia credencial. La inscripción solo se ofrece poco después de un inicio de sesión completo, por lo que un dispositivo se une a la lista de confianza como parte de una autenticación real en lugar de silenciosamente en el fondo.
  • Un inicio de sesión reciente: el inicio de sesión del miembro no debe tener más de 18 horas. En lugar de iniciar sesión nuevamente cada día, los miembros confirman presencia con Face ID, Touch ID, Windows Hello o una passkey. Este paso de autenticación biométrica actualiza la sesión inmediatamente.

Las verificaciones biométricas se ejecutan en el dispositivo a través del sistema operativo o navegador, el mismo mecanismo que el inicio de sesión con passkey. Anthropic nunca recibe ni almacena huellas dactilares, datos faciales ni ninguna otra información biométrica. Solo se almacenan la clave pública del dispositivo y metadatos básicos como nombre de pantalla, plataforma y hora de inscripción.

La configuración se aplica solo a Remote Control. El chat regular de Claude, Claude Code en la terminal y el uso de API no se ven afectados.

Habilite Trusted Devices para una organización Team o Enterprise

Un propietario habilita la configuración desde la configuración de la organización de claude.ai.

1

Vaya a la página Capabilities

Vaya a Organization settings > Capabilities > Remote sessions. El botón de alternancia Require trusted devices aparece en esa sección.

2

Active Require trusted devices

La configuración se aplica a cada miembro de la organización y a las sesiones de Remote Control iniciadas después de habilitar la opción. Las sesiones que ya se estaban ejecutando antes de activar el botón de alternancia no están protegidas retroactivamente y continúan sin el requisito de dispositivo hasta que finalicen. El alcance por equipo o por proyecto no está disponible.

3

Informe a los miembros qué esperar

La primera vez que un miembro ve o controla una nueva sesión de Remote Control desde un navegador, teléfono o aplicación de escritorio después de habilitar la configuración, se le solicita que inscriba ese dispositivo. Informarles con anticipación evita confusión.

Qué ven los miembros

La inscripción es un paso único por dispositivo. Después de eso, el único cambio visible es un mensaje biométrico ocasional.

  • Primer uso en cada dispositivo: se solicita al miembro que se inscriba. Si su inicio de sesión no es reciente, primero inicia sesión a través de su flujo normal, incluido SSO si está configurado, y luego confirma la inscripción.
  • Día a día: los miembros con un dispositivo inscrito y un inicio de sesión reciente no ven mensajes. Cuando el inicio de sesión envejece más de 18 horas, la siguiente interacción de Remote Control muestra un único mensaje de Face ID, Touch ID, Windows Hello o passkey.
  • Dispositivos no inscritos: las sesiones de Remote Control no se pueden ver ni controlar hasta que el dispositivo esté inscrito. El chat regular de Claude en ese dispositivo no se ve afectado.
  • Sin autenticador de plataforma: los miembros en una máquina sin Face ID, Touch ID o Windows Hello pueden usar una clave de seguridad de hardware, o iniciar sesión nuevamente en lugar de autenticarse.
  • En la terminal: la máquina que ejecuta Claude Code recibe su propia credencial automáticamente cuando el desarrollador inicia sesión en la CLI. No hay un paso de inscripción separado en la terminal.

Administre dispositivos inscritos

Los miembros pueden revisar y revocar sus propios dispositivos desde la configuración de la cuenta.

Abra claude.ai/settings/account y encuentre la sección Trusted devices para ver cada dispositivo inscrito con su nombre, plataforma y fecha de inscripción. Eliminar un dispositivo revoca su credencial inmediatamente, y el dispositivo puede reinscribirse más tarde después de un nuevo inicio de sesión. Las credenciales también expiran por sí solas si no se renuevan, por lo que un dispositivo no utilizado se cae de la lista de confianza automáticamente.

Para un dispositivo perdido o robado, el miembro lo elimina de esta página. Si el miembro no puede iniciar sesión, un administrador puede usar Sign out everywhere en la consola de administración para revocar cada sesión y dispositivo inscrito para ese miembro, después de lo cual el miembro reinscribe los dispositivos que aún posee.

Control Remoto vs sesiones en la nube

Control Remoto y sesiones en la nube ambos utilizan la interfaz claude.ai/code. La diferencia clave es dónde se ejecuta la sesión: Control Remoto se ejecuta en su máquina, por lo que sus servidores MCP locales, herramientas y configuración del proyecto permanecen disponibles. Una sesión en la nube se ejecuta en infraestructura en la nube, administrada por Anthropic de forma predeterminada.

Utilice Control Remoto cuando esté en medio de trabajo local y desee continuar desde otro dispositivo. Utilice una sesión en la nube cuando desee iniciar una tarea sin ninguna configuración local, trabajar en un repositorio que no tiene clonado, o ejecutar múltiples tareas en paralelo. Un proyecto combina los dos: sus hilos se ejecutan en la nube, y utiliza Control Remoto para ejecutar un hilo en su computadora cuando usted lo solicita allí.

Claude Code ofrece varias formas de trabajar cuando no está en su terminal. Difieren en lo que desencadena el trabajo, dónde se ejecuta Claude y cuánta configuración necesita.

Desencadenante Claude se ejecuta en Configuración Mejor para
Dispatch Envíe un mensaje con una tarea desde la aplicación móvil de Claude Su máquina (Desktop) Empareje la aplicación móvil con Desktop Delegar trabajo mientras está fuera, configuración mínima
Remote Control Controle una sesión en ejecución desde claude.ai/code o la aplicación móvil de Claude Su máquina (CLI, Desktop o VS Code) Ejecute claude remote-control o /remote-control Dirigir el trabajo en progreso desde otro dispositivo
Channels Envíe eventos desde una aplicación de chat como Telegram o Discord, o su propio servidor Su máquina (CLI) Instale un plugin de canal o cree el suyo propio Reaccionar a eventos externos como fallos de CI o mensajes de chat
Slack Mencione @Claude en un canal de equipo Nube de Anthropic Instale la aplicación de Slack con Claude Code en la web habilitado PRs y revisiones desde el chat del equipo
Entornos autohospedados Inicie una sesión en la nube y seleccione el entorno de su organización La infraestructura de su organización Implemente ejecutores, en planes Team y Enterprise Sesiones en la nube que deben ejecutarse dentro de su red
Tareas programadas Establezca una programación CLI, Desktop, o nube Seleccione una frecuencia Automatización recurrente como revisiones diarias

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 suya para continuar. También puede solicitar una notificación en su prompt, por ejemplo notifícame cuando terminen las pruebas. Más allá de los dos controles de encendido/apagado a continuación, no hay configuración por evento.

Para configurar notificaciones push móviles:

1

Instalar la aplicación móvil de 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 utiliza para Claude Code en la terminal.

3

Permitir notificaciones

Acepte el aviso de permiso de notificaciones del sistema operativo.

4

Habilitar push en Claude Code

En su terminal, ejecute /config y habilite Push cuando Claude decide para notificaciones proactivas, Push cuando se requieren acciones para avisos de permisos y preguntas, o ambas.

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. El aviso se borra la próxima vez que Remote Control se conecte.
  • En iOS, los modos de enfoque 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.

Claude Code omite las notificaciones push móviles mientras está escribiendo o enfocado en la terminal conectada. Para extender esto a cualquier momento en que esté en la máquina, incluso en otra ventana, establezca CLAUDE_CLIENT_PRESENCE_FILE en una ruta de archivo marcador: las notificaciones se omiten mientras el archivo existe. Configure un escucha de bloqueo de pantalla o una herramienta similar para crear el archivo cuando su pantalla se desbloquea y eliminarlo cuando su pantalla se bloquea.

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. Utilice modo servidor para ejecutar múltiples 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, sale de la aplicación de escritorio o VS Code, o detiene de otra manera el proceso claude, la sesión se desconecta hasta que la vuelva a conectar. Para mantener una sesión ejecutándose en una máquina remota después de desconectarse de SSH, inicie la sesión dentro de tmux o screen.
  • Sesiones que se cuelgan en modo servidor: si una sesión servida por claude remote-control se cuelga, envíele un mensaje desde un dispositivo conectado. Claude Code la sirve de nuevo. No tiene que reiniciar el servidor. Requiere Claude Code v2.1.238 o posterior.
  • Rechazos HTTP 403 en una sesión conectada: una vez que una sesión interactiva está conectada, Claude Code sigue reintentando durante hasta tres minutos cuando algo entre su máquina y los servidores de Anthropic responde con HTTP 403, lo que puede ocurrir después de un cambio de VPN o red. Si los rechazos duran más tiempo, Claude Code se desconecta, y el motivo indica qué rechazó: un borde de red, o un proxy, VPN o firewall en su propia red.
  • Interrupción de red extendida: si su máquina está encendida pero no puede alcanzar la red, lo que haga a continuación depende del modo:
    • Modo servidor: Claude Code se rinde después de aproximadamente 10 minutos y el proceso claude remote-control se cierra. Ejecute claude remote-control de nuevo para iniciar una nueva sesión.
    • Sesión interactiva: siga trabajando localmente. Claude Code reintenta mientras dure la interrupción y se reconecta automáticamente cuando la red vuelve.
  • Latidos de presencia fallidos: si una sesión interactiva se desconecta con could not reach the Remote Control server for about 30 minutes, ejecute /remote-control para reconectarse.
  • Los diálogos reenviados expiran: Claude Code mantiene los mensajes de permiso y las preguntas de AskUserQuestion abiertas hasta que las responda. Cuando Claude Code reenvía otro tipo de diálogo a la sesión remota, como el mensaje de selección de modelo que se muestra después de un rechazo de seguridad, espera cinco minutos por defecto, luego cierra el diálogo y continúa con el valor predeterminado sin acción del diálogo. Establezca dialogExpiry para ajustar o desactivar el plazo. Requiere Claude Code v2.1.224 o posterior.
  • El mensaje de consentimiento de créditos de uso de Fable no se reenvía: Claude Code muestra el mensaje de consentimiento de créditos de uso de Fable a mitad de sesión solo donde se ejecuta la sesión, no en su dispositivo. Cuando la sesión se ejecuta en una terminal y nadie allí responde antes de que Claude Code cierre el mensaje, el turno termina sin enviar la solicitud; consulte El mensaje de confirmación no fue respondido.
  • Algunos comandos son solo locales: los comandos que solo se ejecutan en la interfaz de terminal, como /plugin o /resume, funcionan solo desde la CLI local, independientemente de si pasa un argumento o no. Los siguientes funcionan desde dispositivos móviles y web:
    • Comandos de salida de texto: /compact, /clear, /context, /usage, /exit, /usage-credits, /recap, y /reload-plugins. /usage-credits imprime la URL de facturación en lugar de abrir un navegador. /reload-plugins funciona solo cuando la sesión se ejecuta en una terminal interactiva; una sesión sin una la rechaza.
    • /model, /effort, /fast, /color, y /rename: pase el valor como argumento, por ejemplo /model sonnet o /effort high. Desde dispositivos móviles y web, /model y /effort toman el argumento en lugar del selector de terminal o deslizador.
    • /mcp: desde la aplicación móvil, devuelve un resumen de texto del estado del servidor en lugar de abrir el selector. En la web, /mcp por sí solo abre un directorio de conectores de claude.ai en lugar de devolver el resumen. Los subcomandos reconnect, enable, y disable funcionan desde ambos. A diferencia de la CLI local, /mcp reconnect sin un nombre de servidor reconecta cada servidor que ha fallado o necesita autenticación.
    • /config: desde la aplicación móvil, pase key=value para establecer una configuración, o ejecútelo sin argumento para enumerar las claves que puede establecer. En la web, /config abre la sección Claude Code de su configuración en su lugar, e ignora el texto después del comando.
    • En Team y Enterprise, /usage-credits desde dispositivos móviles o web no envía una solicitud de créditos de uso a su administrador. El envío requiere una confirmación que aparece solo en la CLI interactiva, por lo que el comando le indica que la ejecute allí en su lugar.
    • /autocompact, desde v2.1.221: pase el tamaño de la ventana como argumento, por ejemplo /autocompact 500k. Sin argumento, imprime el tamaño de ventana actual como texto en lugar de abrir el diálogo que muestra el comando en una sesión de terminal.
    • /advisor, desde v2.1.260: pase el modelo como argumento, por ejemplo /advisor opus, o pase off para desactivar el asesor. Ambas formas se aplican solo a la sesión actual y dejan su valor predeterminado guardado sin cambios. Sin argumento, imprime el asesor actual como texto en lugar de abrir el selector.
    • /output-style, desde v2.1.269: pase el nombre del estilo como argumento, por ejemplo /output-style concise, o ejecútelo sin argumento para enumerar los estilos. Desde dispositivos móviles y web, puede enumerar y seleccionar solo estilos integrados. Para usar un estilo personalizado, selecciónelo en la sesión misma.
    • /focus, desde v2.1.281: pase on u off como argumento, por ejemplo /focus on, o ejecútelo sin argumento para alternar la vista de enfoque. Ambas formas se aplican solo a la sesión actual y dejan su selección guardada sin cambios.

Solución de problemas

"Remote Control requiere una suscripción a claude.ai"

No ha iniciado sesión con una cuenta de claude.ai, o una credencial diferente tiene precedencia sobre su inicio de sesión. El mensaje toma una de estas formas:

  • Sesión cerrada, desde /remote-control o --remote-control: Remote Control requiere una suscripción a claude.ai. o /remote-control requiere una suscripción a claude.ai.
  • Sesión cerrada, desde claude remote-control: Debe iniciar sesión para usar Remote Control. Remote Control solo está disponible con suscripciones a claude.ai.
  • Sesión iniciada, pero se está utilizando una clave API o token: Remote Control requiere autenticación de suscripción a claude.ai. seguido de la credencial en uso, como ANTHROPIC_API_KEY está configurada, por lo que esta sesión está utilizando autenticación de clave API. Una configuración apiKeyHelper y ANTHROPIC_AUTH_TOKEN se nombran de la misma manera.

Ejecute claude auth login y elija la opción de claude.ai. Si el mensaje menciona ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN, elimínelo dondequiera que esté configurado: su entorno de shell o el bloque env de un archivo de configuración. Si menciona apiKeyHelper, elimine esa configuración.

"Remote Control requiere un token de inicio de sesión de alcance completo"

Está autenticado con un token de larga duración de claude setup-token o la variable de entorno CLAUDE_CODE_OAUTH_TOKEN. Estos tokens solo pueden hacer solicitudes de modelo, por lo que 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.

"No se puede determinar su organización para la elegibilidad de Remote Control"

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

"Remote Control no está habilitado para esta cuenta"

Claude Code verificó la disponibilidad de Remote Control para la cuenta con la que ha iniciado sesión y la verificación resultó desactivada. La causa habitual son los derechos en caché que están desactualizados después de un cambio de plan. Ejecute claude auth logout y luego claude auth login para actualizarlos, y actualice Claude Code si está en una versión antigua.

Ejecute claude doctor para ver qué verificación de elegibilidad individual falló. Los conflictos de variables de entorno, las verificaciones inaccesibles y la configuración de Remote Control de su organización producen cada uno su propio mensaje, por lo que este error significa que la verificación a nivel de cuenta en sí.

Antes de v2.1.239, este mensaje decía "Remote Control aún no está habilitado para su cuenta".

"No se pudo verificar la elegibilidad de Remote Control"

Claude Code no pudo alcanzar el servicio de indicadores de características para verificar si Remote Control está habilitado para su cuenta, típicamente porque está sin conexión o un proxy está bloqueando la solicitud. Reinténtelo una vez que tenga acceso a la red, o ejecute claude doctor para obtener detalles. El mensaje relacionado "No se pudo verificar la política de Remote Control de su organización" significa que Claude Code encontró un error al leer esa política, y tiene la misma solución.

"Remote Control requiere evaluación de indicadores de características"

Una variable de entorno que desactiva la evaluación de indicadores de características está configurada, y el mensaje completo menciona la variable que Claude Code encontró. En versiones anteriores a 2.1.154, la misma configuración produce "Remote Control aún no está habilitado para su cuenta" en su lugar. Lo que debe hacer depende de la variable que menciona el mensaje:

  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC o DISABLE_GROWTHBOOK: desactive la variable dondequiera que esté configurada, en su entorno de shell o en el bloque env de un archivo settings.json.
  • DISABLE_TELEMETRY o DO_NOT_TRACK: en un plan Pro, Max, Team o Enterprise con DISABLE_GROWTHBOOK desactivado, estas variables dejan Remote Control disponible a menos que su organización requiera Dispositivos de confianza. Si lo hace, desactive la variable dondequiera que esté configurada para usar Remote Control. De v2.1.154 a v2.1.282, cualquiera de las variables produjo este mensaje, por lo que actualice Claude Code a v2.1.283 o posterior.

"Remote Control solo está disponible cuando se usa Claude a través de api.anthropic.com"

La sesión no está hablando directamente con la API de Anthropic, por lo que no hay un backend de claude.ai para emparejar. Esto sucede en Amazon Bedrock, en la plataforma de agentes de Google Cloud y en Microsoft Foundry. También sucede cuando ANTHROPIC_BASE_URL apunta a un host diferente de api.anthropic.com, como una puerta de enlace LLM o proxy, incluso si inicia sesión con claude.ai. Consulte la referencia de errores para obtener la lista completa de causas.

El mensaje menciona lo que enrutó la sesión lejos de la API de Anthropic, como CLAUDE_CODE_USE_BEDROCK o un ANTHROPIC_BASE_URL personalizado. Si tiene un inicio de sesión de claude.ai elegible, desactive la variable mencionada, elimínela de la clave env en configuración si la configuró allí, y reinicie la sesión.

"Remote Control está deshabilitado por la política de su organización"

Una política bloquea Remote Control. Verifique estas causas en orden:

  • El error menciona disableRemoteControl: su administrador de TI ha deshabilitado Remote Control en este dispositivo a través de configuración administrada, independientemente del conmutador de toda la organización y de cómo haya iniciado sesión.
  • Su plan de claude.ai es Pro o Max: Claude Code aún está firmado bajo una organización de Team o Enterprise de un inicio de sesión anterior, por lo que verifica la política de Remote Control de esa organización. Ejecute /status para ver qué plan y organización utiliza su inicio de sesión. Ejecute claude auth logout y luego claude auth login para iniciar sesión nuevamente bajo su plan actual.
  • El mensaje no dice que contacte a su administrador de organización: su organización tiene una configuración HIPAA que es incompatible con Remote Control, y /status enumera HIPAA en su fila Compliance. En este estado, el conmutador de Remote Control del panel de administración está atenuado, por lo que un propietario no puede cambiarlo allí. Póngase en contacto con el soporte de Anthropic para discutir opciones. Antes de v2.1.267, este caso mostraba "Remote Control no está disponible para su organización debido a su política de cumplimiento" en su lugar.
  • De lo contrario, un propietario no lo ha habilitado para su organización: Remote Control está desactivado de forma predeterminada en planes de Team y Enterprise. Un propietario puede habilitarlo en claude.ai/admin-settings/claude-code activando el conmutador Remote Control. Este conmutador es una configuración de organización del lado del servidor.

Antes de v2.1.281, este mensaje también aparecía cuando Claude Code no había cargado la política de su organización en esta máquina, por ejemplo después de iniciar sin conexión. Las versiones posteriores informan ese estado como No se pudo verificar la política de su organización para remote control en su lugar.

"No se pudo verificar la política de su organización para remote control"

Claude Code no pudo obtener la política de su organización y no tiene una copia guardada en esta máquina para usar en su lugar, por lo que mantiene Remote Control desactivado hasta que pueda confirmar que su organización lo permite. Esto generalmente sucede cuando inicia Claude Code sin conexión o antes de que se conecte una VPN, o cuando un proxy interfiere con la solicitud. En una conexión lenta también puede aparecer mientras la primera solicitud aún está en vuelo.

El mensaje toma una de estas formas:

  • Desde /remote-control, claude remote-control, o claude --remote-control: No se pudo verificar la política de su organización para remote control. Verifique su conexión de red e intente de nuevo.
  • Desde conexión automática cuando se inicia una sesión: no se pudo verificar la política de su organización — verifique su conexión de red e intente de nuevo, con el prefijo Remote Control falló en la notificación y Remote Control desconectado en la conversación. La sesión luego deja Remote Control desactivado.

Restaure su conexión de red, luego ejecute /remote-control o ejecute el comando nuevamente. Cada intento verifica la política nuevamente, por lo que no necesita reiniciar Claude Code. Si el mensaje sigue apareciendo, ejecute claude doctor y lea su línea Organization policy, que dice por qué la política no se cargó.

Antes de v2.1.281, este estado mostraba Remote Control está deshabilitado por la política de su organización en su lugar.

"Error al obtener credenciales remotas"

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 de 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ó anteriormente en la configuración. Verifique que su suscripción esté activa.

"No se pudo reconectar a su sesión de Remote Control"

Cuando reanuda una conversación con claude --resume o claude --continue, Claude Code se reconecta a la sesión de Remote Control registrada en esa conversación. Este mensaje significa que la reconexión falló por una razón que puede ser temporal, como una interrupción de red o un error del servidor, por lo que Claude Code no puede confirmar si la sesión remota aún existe.

Ejecute /remote-control para reintentar la conexión, o inicie una nueva sesión con claude --remote-control para crear una nueva sesión de Remote Control. Su sesión local sigue ejecutándose sin Remote Control mientras tanto.

"La sesión anterior no está disponible — ejecute /remote-control para iniciar una nueva"

Claude Code no pudo recuperar la sesión anterior de Remote Control y se detuvo en lugar de iniciar una nueva por su cuenta. Puede ver este mensaje después de reanudar una conversación con claude --resume o claude --continue, o después de que Claude Code se reconecte por su cuenta después de una desconexión.

Ejecute /remote-control para iniciar una nueva sesión de Remote Control bajo el inicio de sesión actual; su sesión local sigue ejecutándose sin Remote Control mientras tanto. El mensaje relacionado Remote Control no pudo verificar la cuenta con la que ha iniciado sesión — ejecute /remote-control para reconectar tiene la misma solución. Si ejecuta /remote-control después de La sesión anterior no está disponible sin reiniciar Claude Code primero, Claude Code deja los mensajes anteriores de la conversación fuera de la nueva sesión.

"Remote Control recibió una respuesta inesperada del servidor"

El servidor de Remote Control aceptó una solicitud pero respondió de una forma que esta versión de Claude Code no pudo leer, mientras creaba la sesión remota u obtenía sus credenciales. Reintentar en la misma versión falla de la misma manera. Ejecute claude update, luego ejecute /remote-control para reconectar.

"Su organización requiere Dispositivos de confianza para Remote Control, pero este dispositivo no está inscrito"

Su organización tiene Dispositivos de confianza habilitados y esta máquina aún no se ha inscrito. Ejecute /login en Claude Code. La inscripción ocurre como parte del inicio de sesión, y no hay un comando de inscripción separado.

"sesión expirada para verificación de dispositivo de confianza"

Su inicio de sesión tiene más de 18 horas. Ejecute /login en Claude Code, o confirme con Face ID, Touch ID, Windows Hello, o una contraseña cuando claude.ai o la aplicación móvil le solicite. Consulte Dispositivos de confianza.

  • Claude Code en la web: ejecute sesiones en la nube en lugar de en su máquina, configuradas a través de entornos en la nube
  • Mensajería entre sesiones: permita que Claude envíe mensajes a sus sesiones en otras máquinas o en sesiones en la nube
  • 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, Remote Control y en la nube