Remote Control está disponible en todos los planes. En Team y Enterprise, está deshabilitado de forma predeterminada hasta que un propietario habilite el botón de alternancia de Remote Control en configuración de administración de Claude Code.
- 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. Mientras se reconstruye la conexión, Claude Code pone en cola mensajes, solicitudes de permiso y actualizaciones de estado de subagentes y flujos de trabajo, y los entrega una vez que se recupera la conexión.
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
claudey use/loginpara 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-controlse cierra con un error, mientras queclaude --remote-controlaú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:
- Utiliza Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry.
- Apunta
ANTHROPIC_BASE_URLa un host distinto deapi.anthropic.com, como una puerta de enlace LLM o proxy. Desactive la variable para usar Remote Control. Antes de v2.1.196, Claude Code permitía Remote Control con unANTHROPIC_BASE_URLpersonalizado. - Inicia sesión a través de una puerta de enlace de aplicaciones Claude empresarial.
- Evaluación de indicadores de características:
DISABLE_TELEMETRY,DO_NOT_TRACK,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICyDISABLE_GROWTHBOOKcada una deshabilita la evaluación de indicadores de características de la que depende la disponibilidad de Remote Control. Desactive la variable dondequiera que esté configurada, en su entorno de shell o en el bloqueenvde un archivosettings.json, para usar Remote Control. - Confianza del espacio de trabajo: ejecute
claudeen su directorio de proyecto al menos una vez para aceptar el diálogo de confianza del espacio de trabajo. El diálogo de confianza de inicio nunca guarda la confianza para su directorio de inicio, así que inicie Remote Control desde un directorio de proyecto.
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.
- Modo servidor
- Sesión interactiva
- Desde una sesión existente
- VS Code
Navegue a su directorio de proyecto y ejecute: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: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. Antes de v2.1.248, cualquier opción antes de remote-control hacía que Claude Code rechazara las banderas después de ella con un error unknown option.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 de terminal interactiva, un indicador/rc active se muestra mientras la conexión está activa, y se oculta si la terminal es demasiado estrecha para ajustarlo. Con renderizado a pantalla completa se encuentra al final de la línea del directorio de trabajo en el encabezado de inicio, y sin él, en el pie de página debajo del cuadro de entrada.
El texto del indicador es un enlace a la sesión en claude.ai. Ejecute /remote-control nuevamente para abrir un panel de estado con la URL de la sesión y un código QR para conectarse desde otro dispositivo. Cuando el indicador está en el pie de página, también puede abrir el panel seleccionando el indicador con la tecla de flecha hacia abajo y presionando Intro. El panel también ofrece una opción de desconexión, que desactiva Remote Control mientras su sesión local sigue ejecutándose en la terminal.
Si la conexión falla, Claude Code muestra una notificación con el motivo del fallo, agrega una línea de advertencia con el motivo a la conversación, y cambia el indicador a un estado de fallo que permanece en su lugar. Para reconectarse, ejecute /remote-control, a menos que el motivo diga que la sesión fue tomada o terminada en otro lugar, o que el servidor no puede encontrarla.
Lea el motivo antes de reconectarse. Cuando la sesión fue tomada o terminada desde otro dispositivo, aplicación o sesión de Claude Code, o el servidor no puede encontrarla, el motivo dice cuál, y Claude Code omite su consejo habitual de ejecutar /remote-control:
- Otro dispositivo o sesión de Claude Code tomó la sesión: ejecute
/remote-controlsolo si desea recuperarla de ese dispositivo. - Terminó o archivó la sesión desde otro dispositivo o aplicación: ejecute
/remote-controlsolo si la desea de vuelta; Claude Code reabre una sesión archivada. - El servidor no puede encontrar la sesión: puede haber sido eliminada desde otro dispositivo o aplicación.
Recordatorios de URL de sesión
Mientras Remote Control está conectado, Claude Code le recuerda la URL de la sesión cuando cambiar a su teléfono o navegador es más útil, para que no tenga que encontrar el enlace en/remote-control. Un recordatorio aparece encima del cuadro de solicitud en cualquiera de estos momentos:
- Turno largo: cuando un turno se ejecuta más tiempo que un umbral ajustado por el servidor, Claude Code muestra una notificación Still working con un enlace Check in from your phone, para que pueda seguir el turno desde su teléfono o navegador en lugar de esperar en la terminal. Claude Code la elimina cuando el turno termina.
- Solicitudes de permiso repetidas: después de responder varios solicitudes de permiso en una sesión, aparece una notificación Approve tool calls from your phone que muestra la URL de la sesión. Claude Code la elimina cuando comienza su próximo turno.
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.
- El nombre que pasó a
--name,--remote-control, o/remote-control - El título que estableció con
/rename - El último mensaje significativo en el historial de conversación existente
- Un nombre generado automáticamente como
myhost-graceful-unicorn, dondemyhostes el nombre de host de su máquina o el prefijo que estableció con--remote-control-session-name-prefix
language si una está configurada; la coincidencia de idioma requiere Claude Code v2.1.176 o posterior.
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. Claude Code aplica el mismo cambio de nombre al nombre de sesión que se muestra en la barra de solicitud, y en la lista claude agents cuando la sesión se ejecuta en segundo plano. Antes de v2.1.221, renombrar desde la lista de sesiones en claude.ai o en la aplicación Claude actualizaba solo el título, y la CLI mantenía su nombre de sesión anterior; /rename, que se ejecuta en la CLI misma, establece el nombre en cualquier versión.
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.
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/resumeen 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 Claude Code en la web, a través de servidores de Anthropic como el resto del tráfico de Remote Control. Mensajería de sesiones en otras máquinas cubre las reglas de entrega y Controle los mensajes entrantes cubre los controles entrantes. Requiere Claude Code v2.1.224 o posterior.
- Solicitudes que envía a mitad de turno: cuando envía una solicitud desde un dispositivo conectado antes de que termine el turno actual, Claude Code la pone en cola y la mantiene en la transcripción del dispositivo después de que ese turno termina.
- 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 la diferencia de sus cambios sin confirmar. El dispositivo solicita la diferencia sobre la conexión, y Claude Code la calcula en su máquina. Cuando su árbol de trabajo está limpio, Claude Code en su lugar sirve los cambios de su rama desde que divergió de la rama predeterminada. Antes de v2.1.247, Claude Code reportaba la diferencia a los dispositivos conectados solo en sesiones servidas por
claude remote-control. - Modelo: cuando elige un modelo desde un dispositivo conectado, Claude Code ejecuta la sesión en ese modelo. El selector
/modeldel terminal,/status, y/configmuestran 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. - Si envía un nombre que Claude Code no reconoce, como un nombre para mostrar donde se espera un ID de modelo, Claude Code rechaza la selección y la sesión mantiene su modelo actual. Antes de v2.1.260, Claude Code guardaba una selección no reconocida desde el control de modelo del dispositivo, y su próximo mensaje fallaba.
- Un modelo que elige desde el control de modelo del dispositivo se aplica solo a la sesión actual. Cuando envía
- Nivel de esfuerzo: cuando establece el nivel de esfuerzo desde un dispositivo conectado, con
/efforto el control de esfuerzo del dispositivo, Claude Code lo aplica a la sesión en su máquina, y claude.ai/code muestra el nivel que la sesión está usando. Si fijó un nivel conCLAUDE_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-controlpara reconectarse. Si la compactación rescribió la conversación o cambió conversaciones con/resumemientras 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ícitamenteclaude 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 untruede configuración administrada lo supera, porque Claude Code guarda la opción en su configuración de usuario. Unfalseen configuración de proyecto o local (.claude/settings.json,.claude/settings.local.json) desactiva la conexión automática incluso sobre untrueadministrado.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.
- 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. Requiere Claude Code v2.1.203 o posterior.
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 detieneclaude 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?.
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 Claude Code se reconecta, y a qué sesión, depende del registro de reconexión de la conversación.
Si reanuda la conversación en una segunda terminal mientras la primera aún tiene Remote Control activado, Claude Code imprime un aviso en la segunda terminal y deja Remote Control desactivado allí en lugar de tomar la sesión de la primera. Mientras Remote Control permanece desactivado allí, Claude en esa terminal no ve sus sesiones en otras máquinas, y no pueden alcanzarlo. 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. Cuando la credencial de registro de un servidorclaude remote-control expira, el servidor se registra nuevamente con la API de Anthropic y continúa sirviendo sus sesiones.
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 está actualmente en beta. Las características y funcionalidades pueden evolucionar a medida que se refina la experiencia.Trusted Devices está disponible en planes Team y Enterprise. Está deshabilitado de forma predeterminada hasta que un propietario lo habilite.
- 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.
Habilite Trusted Devices para su organización
Un propietario habilita la configuración desde la consola de administración de Claude Code.1
Abra la configuración de administración de Claude Code
Vaya a claude.ai/admin-settings/claude-code. El botón de alternancia Require trusted devices aparece bajo la configuración de Remote Control.
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.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 servidores MCP locales, herramientas y configuración del proyecto permanecen disponibles. Claude Code en la web se ejecuta en la nube. 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 ejemplonotify me when the tests finish. Más allá de los dos botones de alternancia activado/desactivado a continuación, no hay configuración por evento.
Para configurar notificaciones push móviles:
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 para notificaciones proactivas, Push when actions required para mensajes de solicitud de permiso y preguntas, o ambos.- Si
/configmuestra 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.
CLAUDE_CLIENT_PRESENCE_FILE en una ruta de archivo marcador para extender esto a cualquier momento en que esté en la máquina, incluso en otra ventana: 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. 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
claudede otra manera, la sesión se desconecta hasta que la reanude. A menos que Claude esté en medio de una tarea, claude.ai y la aplicación Claude muestran la sesión como desconectada en segundos después de que el proceso se cierre. Para mantener una sesión ejecutándose en una máquina remota después de desconectarse de SSH, inicie la sesión dentro detmuxoscreen. - Sesiones bloqueadas en modo servidor: si una sesión servida por
claude remote-controlse bloquea, envíele un mensaje desde un dispositivo conectado. Claude Code la sirve nuevamente. 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 hasta tres minutos cuando algo entre su máquina y los servidores de Anthropic responde con HTTP 403, como puede suceder después de un cambio de VPN o red. Si los rechazos duran más tiempo, Claude Code se desconecta, y el motivo nombra lo que 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á despierta 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-controlse cierra. Ejecuteclaude remote-controlnuevamente 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 vuelva.
- Modo servidor: Claude Code se rinde después de aproximadamente 10 minutos y el proceso
- 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-controlpara reconectarse. Claude Code muestra este mensaje solo cuando los latidos de presencia de la sesión han estado fallando mientras el resto de la conexión se mantuvo activa; vuelve a registrar la sesión durante aproximadamente 30 minutos antes de desconectarse. - Los diálogos reenviados expiran: Claude Code mantiene los avisos de permiso y las preguntas de
AskUserQuestionabiertas hasta que las responda. Cuando Claude Code reenvía otro tipo de diálogo a la sesión remota, como el aviso 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. EstablezcadialogExpirypara ajustar o deshabilitar el plazo. Requiere Claude Code v2.1.224 o posterior. - El aviso de consentimiento de créditos de uso de Fable no se reenvía: Claude Code muestra el aviso 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 aviso, el turno finaliza sin enviar la solicitud; consulte El aviso para confirmar no fue respondido.
- Algunos comandos son solo locales: comandos que solo se ejecutan en la interfaz de terminal, como
/plugino/resume, funcionan solo desde la CLI local, independientemente de si pasa un argumento o no. Los siguientes funcionan desde móvil y web:- Comandos de salida de texto:
/compact,/clear,/context,/usage,/exit,/usage-credits,/recapy/reload-plugins./usage-creditsimprime la URL de facturación en lugar de abrir un navegador./reload-pluginsfunciona solo cuando la sesión se ejecuta en una terminal interactiva; una sesión sin una la rechaza. /model,/effort,/fast,/colory/rename: pase el valor como argumento, por ejemplo/model sonneto/effort high. Desde móvil y web,/modely/efforttoman 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,/mcppor sí solo abre un directorio de conectores de claude.ai en lugar de devolver el resumen. Los subcomandosreconnect,enableydisablefuncionan desde ambos. A diferencia de la CLI local,/mcp reconnectsin nombre de servidor reconecta cada servidor que ha fallado o necesita autenticación./config, a partir de v2.1.181: desde la aplicación móvil, pasekey=valuepara establecer una configuración, o ejecútelo sin argumentos para listar las claves que puede establecer. En la web,/configabre 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-creditsdesde móvil 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 lo ejecute allí en su lugar. Antes de v2.1.211, el formulario de texto enviaba la solicitud sin confirmación. /autocompact, a partir de 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, a partir de v2.1.260: pase el modelo como argumento, por ejemplo/advisor opus, o paseoffpara 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.
- Comandos de salida de texto:
Solución de problemas
“Remote Control requires a claude.ai subscription”
No está autenticado con una cuenta de claude.ai, o bien otra credencial está tomando precedencia sobre su inicio de sesión. El mensaje toma una de estas formas:- Sin sesión iniciada, desde
/remote-controlo--remote-control:Remote Control requires a claude.ai subscription. - Sin sesión iniciada, desde
claude remote-control:You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions. - Con sesión iniciada, pero se está usando una clave API o token:
Remote Control requires claude.ai subscription auth.seguido de la credencial en uso, comoANTHROPIC_API_KEY is set, so this session is using API-key auth. Una configuraciónapiKeyHelperyANTHROPIC_AUTH_TOKENse nombran de la misma manera.
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.
Antes de v2.1.206, ejecutar /remote-control mientras no estaba conectado reportaba Unknown command: /remote-control en lugar de este mensaje.
“Remote Control requires a full-scope login token”
Está autenticado con un token de larga duración declaude 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.
“Unable to determine your organization for Remote Control eligibility”
Su información de cuenta en caché está obsoleta o incompleta. Ejecuteclaude auth login para actualizarla.
“Remote Control isn’t enabled for this account”
Claude Code verificó la disponibilidad de Remote Control para la cuenta con la que está conectado 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. Ejecuteclaude auth logout y luego claude auth login para actualizarlos, y actualice Claude Code si está usando 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 la verificación a nivel de cuenta en sí.
Antes de v2.1.239, este mensaje decía “Remote Control is not yet enabled for your account”. Antes de v2.1.154, una variable que desactiva la evaluación de banderas de características, como DISABLE_TELEMETRY o DO_NOT_TRACK, también producía este mensaje; la entrada “Remote Control requires feature-flag evaluation” a continuación cubre esa configuración.
“Couldn’t verify Remote Control eligibility”
Claude Code no pudo alcanzar el servicio de banderas 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. Reintente una vez que tenga acceso a la red, o ejecuteclaude doctor para obtener detalles. El mensaje relacionado “Couldn’t verify your organization’s Remote Control policy” tiene la misma causa y la misma solución. Ambos mensajes se agregaron en v2.1.178.
“Remote Control requires feature-flag evaluation”
Una de estas variables está configurada:DISABLE_TELEMETRY, DO_NOT_TRACK, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, o DISABLE_GROWTHBOOK. Cada una de ellas desactiva la evaluación de banderas de características de la que depende la disponibilidad de Remote Control, y el mensaje completo nombra la variable que Claude Code encontró. Desactive esa variable dondequiera que esté configurada, en su entorno de shell o en el bloque env de un archivo settings.json. En versiones anteriores a 2.1.154, la misma configuración produce “Remote Control is not yet enabled for your account” en su lugar.
“Remote Control is only available when using Claude via 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 ocurre en Amazon Bedrock, Google Cloud’s Agent Platform y Microsoft Foundry. También ocurre cuandoANTHROPIC_BASE_URL apunta a un host distinto de api.anthropic.com, como una puerta de enlace LLM o proxy, incluso si inicia sesión con claude.ai. Antes de v2.1.196, Claude Code no mostraba este mensaje para un ANTHROPIC_BASE_URL personalizado. Vea la referencia de errores para la lista completa de causas.
El mensaje nombra 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 nombrada, elimínela de la clave env en configuración si la configuró allí, y reinicie la sesión. Antes de v2.1.219, el mensaje era solo la oración en el encabezado de esta sección, por lo que en versiones anteriores verifique su entorno usted mismo para variables de proveedor como CLAUDE_CODE_USE_BEDROCK y CLAUDE_CODE_USE_VERTEX, y para ANTHROPIC_BASE_URL.
“Remote Control is disabled by your organization’s policy”
Una política bloquea Remote Control, o Claude Code no pudo cargar la política de su organización en esta máquina y mantiene Remote Control desactivado mientras tanto. 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 botón de alternancia de toda la organización y de cómo esté conectado. - Su plan de claude.ai es Pro o Max: Claude Code aún está conectado bajo una organización 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
/statuspara ver qué plan y organización usa su inicio de sesión. Ejecuteclaude auth logouty luegoclaude auth loginpara conectarse nuevamente bajo su plan actual. - La política de la organización no se cargó en esta máquina: ejecute
claude doctory lea la líneaOrganization policy. Si la línea muestra que la política no está cargada, eso es lo que mantiene Remote Control desactivado. Antes de v2.1.261,claude doctorno imprimía esta línea. - El mensaje no dice que contacte a su administrador de la organización: su organización tiene una configuración de HIPAA que es incompatible con Remote Control, y
/statusenumeraHIPAAen su filaCompliance. En este estado, el botón de alternancia 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 isn’t available for your organization due to its compliance policy” en su lugar. - De lo contrario, un propietario no lo ha habilitado para su organización: Remote Control está desactivado de forma predeterminada en los planes Team y Enterprise. Un propietario puede habilitarlo en claude.ai/admin-settings/claude-code activando el botón de alternancia Remote Control. Este botón de alternancia es una configuración de organización del lado del servidor.
“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:
- No ha iniciado sesión: ejecute
claudey use/loginpara 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.
“Couldn’t reconnect to your Remote Control session”
Cuando reanuda una conversación conclaude --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 continúa ejecutándose sin Remote Control mientras tanto.
Cuando reanuda, también puede obtener uno de estos resultados en lugar de este mensaje:
- El servidor reporta que la sesión registrada se ha ido, o el registro de reconexión nombra una cuenta diferente: Claude Code se guía por lo que dice el registro de reconexión de la conversación:
- El registro nombra su cuenta conectada: Claude Code inicia una sesión de reemplazo con un nombre generado automáticamente y deja los mensajes anteriores de la conversación fuera de ella. Obtiene esto después de eliminar la sesión de claude.ai o de la aplicación Claude, por ejemplo.
- El registro nombra una cuenta diferente: Claude Code inicia una nueva sesión sin los mensajes anteriores de la conversación y sin mostrar un mensaje, independientemente de si la sesión registrada aún existe.
- El registro no dice qué cuenta era propietaria de la sesión, o Claude Code no puede leer su inicio de sesión guardado: Claude Code muestra
Previous session is unavailable — run /remote-control to start a new oneen lugar de este mensaje, no inicia nada, y elimina el registro de la conversación.
- Desactivó Remote Control antes de reanudar: a menos que la aplicación que aloja Claude Code le haya dicho que la aplicación es propietaria de la sesión de claude.ai, Claude Code eliminó el registro de reconexión cuando desactivó Remote Control desde el panel de estado de la CLI, la extensión de VS Code, o un host construido en el Agent SDK, por lo que no se reconecta. Cuando una aplicación propietaria lo desactivó, Claude Code mantuvo el registro y se reconecta.
- Otro Claude Code en esta máquina aún tiene la sesión: ve un aviso que comienza con
Remote Control not started here, y Claude Code deja Remote Control desactivado en la sesión reanudada. Ejecute/remote-controlallí para moverlo.
“Previous session is unavailable — run /remote-control to start a new one”
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 conclaude --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 continúa ejecutándose sin Remote Control mientras tanto. El mensaje relacionado Remote Control could not verify the signed-in account — run /remote-control to reconnect tiene la misma solución; Claude Code lo muestra cuando la cuenta conectada cambió o no se pudo leer entre validarla y reconectarse. Si ejecuta /remote-control después de Previous session is unavailable sin reiniciar Claude Code primero, Claude Code deja los mensajes anteriores de la conversación fuera de la nueva sesión.
Al reanudar, Claude Code inicia una nueva sesión en su lugar solo si el registro de reconexión de la conversación nombra la cuenta que era propietaria de la sesión, porque el servidor reporta una sesión que eliminó y una sesión propiedad de otra cuenta de la misma manera. Claude Code anterior a v2.1.227 no registraba esa cuenta, y Claude Code no puede verificar el registro cuando no puede leer su inicio de sesión guardado. Claude Code anterior a v2.1.232 mostraba Remote Control could not resume the previous session under the current login — run /remote-control to start fresh en su lugar, en un conjunto diferente de casos.
“Remote Control got an unexpected server response”
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. Ejecuteclaude update, luego ejecute /remote-control para reconectarse. Este mensaje se agregó en v2.1.225.
“Your organization requires Trusted Devices for Remote Control, but this device is not enrolled”
Su organización tiene Trusted Devices habilitado 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.
“session expired for trusted-device check”
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 passkey cuando claude.ai o la aplicación móvil se lo solicite. Vea Trusted Devices.
Elija el enfoque correcto
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.Recursos relacionados
- 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 Claude Code en la web
- 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
/loginy 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