- 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.
claude tiene que seguir ejecutándose.
Remote Control es una función de Claude Code. Para conversaciones en otros productos de Claude, consulta el Centro de ayuda de Claude.
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.
- Roles personalizados: si tu organización Enterprise administra tu acceso con roles personalizados, tus roles deben otorgarte tanto el permiso de sesiones en la nube como el permiso Claude Code remote control. Si falta alguno de los dos, al iniciar Remote Control se muestra
Remote Control is disabled by your organization's policy. Pide a un propietario que revise tus roles y agregue lo que falta en Organization settings > Roles. - 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. - Inicia sesión a través de una puerta de enlace de aplicaciones Claude empresarial.
- Evaluación de indicadores de características: si estableces 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 estableces
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICoDISABLE_GROWTHBOOK, Remote Control no está disponible. Elimina la variable dondequiera que esté configurada, en tu entorno de shell o en el bloqueenvde un archivosettings.json, para usar Remote Control. - Si estableces solo
DISABLE_TELEMETRYoDO_NOT_TRACK, Remote Control permanece disponible a menos que tu organización requiera Dispositivos de confianza. Si es así, elimina 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, o v2.1.304 o posterior en la aplicación Claude Desktop.
- Si estableces
- Confianza del espacio de trabajo: en un directorio que aún no ha confiado,
claude remote-controlimprime lo que confiar en él activa y preguntaTrust <directory>? [y/N]antes de iniciarse. Responderyguarda 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 errorWorkspace 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.
- Modo servidor
- Sesión interactiva
- Desde una sesión existente
- VS Code
- Aplicación de escritorio
En su directorio de proyecto, 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.Pase cualquiera de 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.Para sandboxear las sesiones que crea el servidor, active sandboxing en un archivo de configuración.Para imprimir los flags de remote-control en tu terminal, ejecuta claude remote-control --help. Antes de v2.1.302, sin un inicio de sesión elegible, el comando devolvía en su lugar uno de los errores de Solución de problemas.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-controlsolo si desea recuperarla. - Esta sesión fue terminada o archivada desde otro dispositivo o aplicación: ejecute
/remote-controlsolo 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.
- 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
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/resumeen su terminal y vuelva a cambiar a ella. - Extraer una sesión con
/teleport: cuando extrae una sesión en la nube 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 tus otras sesiones: con la mensajería entre sesiones, la misma conexión transporta mensajes entre tus propias sesiones en diferentes máquinas.
- 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
/efforto el control de esfuerzo del dispositivo, Claude Code lo aplica a la sesión en su máquina. 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: ejecuta
/remote-controlpara reconectarte. Si la compactación reescribió la conversación o cambiaste de conversación 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 puedes encontrar esa sesión entre tus sesiones archivadas en claude.ai/code. Cambiar de conversación mientras un dispositivo sigue 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 tu elección y seguir el valor predeterminado del administrador de tu organización si hay uno establecido; de lo contrario, el valor predeterminado actual de Claude Code. Si establecisteDISABLE_TELEMETRYoDO_NOT_TRACK, consulta Conexión automática conDISABLE_TELEMETRYoDO_NOT_TRACKestablecidos.
- Extensión de VS Code: Enable Remote Control for all sessions en la sección Configuración del menú de comandos.
- Aplicación de escritorio: Connect new sessions to Remote Control en Settings > Code o Settings > Claude Code. Consulta Controla qué sesiones aparecen en tus otros dispositivos.
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.
Conexión automática con DISABLE_TELEMETRY o DO_NOT_TRACK establecidos
Si solo tienes establecido DISABLE_TELEMETRY o DO_NOT_TRACK, tus sesiones no se conectan automáticamente a través del valor predeterminado del administrador de tu organización ni del propio valor predeterminado de Claude Code. Si otra cosa hace que Remote Control no esté disponible para ti, como DISABLE_GROWTHBOOK o un gateway de LLM, empieza por Requisitos.
Antes de activar la conexión automática con solo DISABLE_TELEMETRY o DO_NOT_TRACK establecidos, confirma que tu versión de Claude Code cumple el requisito para estas variables. Luego comprueba si tu organización requiere Trusted Devices:
- No requerido: establece Enable Remote Control for all sessions en
trueen/config. - Requerido: Remote Control no está disponible mientras
DISABLE_TELEMETRYoDO_NOT_TRACKesté establecido. Elimina la variable que hayas establecido de las dos. Si tus sesiones siguen sin conectarse automáticamente, establece Enable Remote Control for all sessions entrueen/config.
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 iniciaste con claude --remote-control o /remote-control, reanuda la conversación con claude --continue o claude --resume. Para conocer el modo de permisos con el que comienza la conversación reanudada, consulta modo de permisos al reanudar. Si Remote Control no se reconecta, consulta No se pudo reconectar a tu 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.
Establece el modo de creación predeterminado para un proyecto
Siclaude remote-control imprime Spawn mode: <mode> (saved for this folder; press w to change) al iniciarse, el servidor se está iniciando en un modo de creación guardado previamente para este proyecto.
El modo guardado proviene de una elección que hiciste en tu propia terminal. Si claude remote-control preguntó Spawn mode for this project: allí, Claude Code conservó lo que respondiste: 1 para same-dir o 2 para worktree. Si presionaste w mientras se ejecutaba, Claude Code conservó el modo al que cambiaste, incluso en una ejecución que iniciaste con --spawn same-dir o --spawn worktree.
- Mientras el servidor se ejecuta en modo
same-diroworktree, presionawen la terminal del servidor para cambiar al otro. Cambiar requiere un repositorio git o un hookWorktreeCreate. - Para usar un modo diferente en una sola ejecución, pasa
--spawn <mode>.
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, usa el ajustedisableRemoteControl. Las organizaciones con Retención Cero de Datos habilitada, o con la configuración de HIPAA aplicada, 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 Pro, Max, Team y Enterprise y está deshabilitado de forma predeterminada. En planes Team y Enterprise, un propietario lo habilita para la organización. En planes Pro y Max, usted habilita Require trusted devices en su configuración, en la página Cowork o Account.
- 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 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.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 ejemplonotifí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:
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
/configmuestra 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_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. Usa el modo servidor para ejecutar varias sesiones simultáneas desde un solo proceso.
- El proceso local debe seguir ejecutándose: Remote Control se ejecuta como un proceso local. Si cierras la terminal, sales de la aplicación de escritorio o de VS Code que ejecuta la sesión en tu máquina, o detienes de cualquier otra forma el proceso
claude, la sesión se desconecta hasta que la recuperes. Si ejecutasclaudedesde una terminal en una máquina remota, inícialo dentro detmuxoscreenpara que la sesión siga ejecutándose después de desconectarte de SSH. - Sesiones bloqueadas en modo servidor: si una sesión servida por
claude remote-controlse bloquea, envíale un mensaje desde un dispositivo conectado. Claude Code la vuelve a servir. No tienes 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 un máximo de tres minutos cuando algo entre tu máquina y los servidores de Anthropic responde con HTTP 403, como puede ocurrir después de un cambio de VPN o de red. Si los rechazos duran más, Claude Code se desconecta, y el motivo indica qué los rechazó: un borde de red, o un proxy, VPN o firewall en tu propia red.
- Interrupción prolongada de la red: si tu máquina está activa pero no puede acceder a la red, lo que hagas a continuación depende del modo:
- Modo servidor: Claude Code se rinde después de unos 10 minutos y el proceso
claude remote-controlfinaliza. Ejecutaclaude remote-controlde nuevo para iniciar una nueva sesión. - Sesión interactiva: sigue trabajando localmente. Claude Code reintenta mientras dure la interrupción y se vuelve a conectar por sí solo cuando la red regresa.
- Modo servidor: Claude Code se rinde después de unos 10 minutos y el proceso
- Archivos adjuntos que no se descargan: si un archivo que adjuntas desde tu teléfono o navegador no se puede descargar a tu máquina, Claude igualmente recibe tu mensaje y los archivos que sí se descargaron. En lugar de los archivos faltantes, Claude Code agrega al mensaje una nota como
[1 of 3 attachments did not arrive]. - Fallos en las señales de presencia: si una sesión interactiva se desconecta con
could not reach the Remote Control server for about 30 minutes, ejecuta/remote-controlpara volver a conectarte. - Los diálogos reenviados caducan: Claude Code mantiene abiertas las solicitudes de permiso y las preguntas de
AskUserQuestionhasta que las respondes. Cuando Claude Code reenvía otro tipo de diálogo a la sesión remota, como el prompt de elección de modelo que se muestra después de un rechazo por seguridad, espera cinco minutos de forma predeterminada y luego cierra el diálogo y continúa con la opción predeterminada del diálogo, que no realiza ninguna acción. ConfiguradialogExpirypara ajustar o desactivar el plazo. Requiere Claude Code v2.1.224 o posterior. - El prompt de consentimiento de créditos de uso de Fable no se reenvía: Claude Code muestra el prompt de consentimiento de créditos de uso de Fable que aparece a mitad de la sesión solo donde se ejecuta la sesión, no en tu dispositivo. Cuando la sesión se ejecuta en una terminal y nadie allí responde antes de que Claude Code cierre el prompt, el turno termina sin enviar la solicitud; consulta The prompt to confirm went unanswered.
- Algunos comandos son solo locales: los comandos que solo se ejecutan en la interfaz de la terminal, como
/plugino/resume, funcionan únicamente desde la CLI local, pases o no un argumento./claude-apitampoco está disponible cuando lo escribes desde el móvil o la web. Claude aún puede cargar ese skill por su cuenta allí. Los siguientes funcionan desde el móvil y la 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-pluginssolo funciona cuando la sesión se ejecuta en una terminal interactiva; una sesión sin ella lo rechaza. /model,/effort,/fast,/colory/rename: pasa el valor como argumento, por ejemplo/model sonneto/effort high. Desde el móvil y la web,/modely/efforttoman el argumento en lugar del selector o el control deslizante de la terminal./mcp: desde la aplicación móvil, devuelve un resumen en texto del estado de los servidores 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 cuando la sesión se ejecuta en una terminal interactiva./mcp reconnectsin nombre de servidor reintenta todos los servidores que fallaron o que necesitan autenticación. Para autorizar un conector de claude.ai sin el selector, consulta Autorizar un conector de nuevo desde tu shell./config: desde la aplicación móvil, pasakey=valuepara establecer un ajuste, o ejecútalo sin argumento para listar las claves que puedes establecer. En la web,/configabre en su lugar Settings > Code o Settings > Claude Code.- En Team y Enterprise,
/usage-creditsdesde el móvil o la web no envía una solicitud de créditos de uso a tu administrador. El envío requiere una confirmación que solo aparece en la CLI interactiva, por lo que el comando te indica que lo ejecutes allí. /autocompact, desde v2.1.221: pasa el tamaño de la ventana como argumento, por ejemplo/autocompact 500k. Sin argumento, imprime el tamaño actual de la ventana como texto en lugar de abrir el diálogo que el comando muestra en una sesión de terminal./advisor, desde v2.1.260: pasa el modelo como argumento, por ejemplo/advisor opus, o pasaoffpara desactivar el asesor. Ambas formas se aplican solo a la sesión actual y no modifican tu valor predeterminado guardado. Sin argumento, imprime el asesor actual como texto en lugar de abrir el selector./output-style, desde v2.1.269: pasa el nombre del estilo como argumento, por ejemplo/output-style concise, o ejecútalo sin argumento para listar los estilos. Desde el móvil y la web, solo puedes listar y seleccionar estilos integrados. Para usar un estilo personalizado, selecciónalo en la propia sesión./focus, desde v2.1.281: pasaonuoffcomo argumento, por ejemplo/focus on, o ejecútalo sin argumento para alternar la vista de enfoque. Ambas formas se aplican solo a la sesión actual y no modifican tu selección guardada.
- Comandos de salida de texto:
Volver a autorizar un conector desde tu shell
Cuando un conector de claude.ai necesita autenticación en una sesión que manejas mediante Remote Control, el panel/mcp no está disponible desde la aplicación móvil ni desde la web. Obtén el enlace de autorización desde una terminal en la máquina donde se ejecuta la sesión y luego abre el enlace en el dispositivo que estás usando. No puedes ejecutar el comando desde la aplicación móvil ni desde la web. Una línea que envíes desde allí y que comience con ! llega a Claude como un mensaje y no se ejecuta en modo shell.
1
Obtén el enlace de autorización
En una terminal de la máquina donde se ejecuta la sesión, por ejemplo a través de SSH, ejecuta El comando imprime un enlace de claude.ai y termina. Abre el enlace en tu navegador y completa la autorización en claude.ai.
claude mcp login con el nombre del conector entre comillas. El nombre de un conector comienza con claude.ai, como claude.ai Slack para el conector de Slack. El siguiente comando obtiene el enlace para el conector de Slack:--no-browser evita que el comando abra un navegador en esa máquina, que podría no ser el dispositivo que estás usando.2
Usa el conector en una sesión
Inicia una nueva sesión o vuelve a conectar el conector en la sesión que ya se está ejecutando:En la terminal, Claude Code imprime
- Nueva sesión: una sesión que inicies después de autorizar se conecta al conector sin ningún paso adicional.
- Sesión en ejecución: ejecuta
/mcp reconnectcon el mismo nombre y sin comillas, en el prompt de Claude Code o desde la aplicación móvil o la web. Para comprobar que tu sesión acepta el comando desde allí, consulta la entrada de/mcpen qué comandos funcionan desde el móvil y la web.
Successfully reconnected to claude.ai Slack. Desde la aplicación móvil o la web, la respuesta es Reconnected "claude.ai Slack".Solución de problemas
“Remote Control disconnected” o “Can’t reach”
En claude.ai/code o en la aplicación de escritorio, Remote Control disconnected o un mensaje Can’t reach significa que tu navegador o aplicación perdió el contacto con Claude Code en tu computadora. Ninguno de los dos mensajes te indica si Claude o un subagente que estabas observando sigue trabajando en tu computadora. En esa computadora, verifica en qué estado se encuentra Claude Code y sigue el paso correspondiente para reconectarte:- Una sesión interactiva muestra
Remote Control disconnected: sigue los pasos de reconexión para el motivo que indica esa línea - Claude Code se está ejecutando y no muestra ningún error: una sesión interactiva se reconecta por sí sola una vez que la máquina está activa y en línea, por lo que no necesitas hacer nada. Si usaste
claude remote-control, consulta Interrupción prolongada de la red en Limitaciones - Claude Code no se está ejecutando: inícialo de nuevo y recupera la sesión
“Remote Control requires a claude.ai subscription”
No has iniciado sesión con una cuenta de claude.ai, o una credencial diferente tiene precedencia sobre tu inicio de sesión. El mensaje toma una de estas formas:- Sesión cerrada, desde
/remote-controlo--remote-control:Remote Control requires a claude.ai subscription.o/remote-control requires a claude.ai subscription. - Sesión cerrada, desde
claude remote-control:You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions. - Sesión iniciada, pero se está utilizando una clave de 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. Un ajusteapiKeyHelperyANTHROPIC_AUTH_TOKENse nombran de la misma manera.
claude auth login y elige la opción de claude.ai. Si el mensaje menciona ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN, elimínalo dondequiera que esté configurado: tu entorno de shell o el bloque env de un archivo de configuración. Si menciona apiKeyHelper, elimina ese ajuste.
“Remote Control requires a full-scope login token”
Estás 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. Ejecuta claude auth login para autenticarte con un token de sesión de alcance completo en su lugar.
“Unable to determine your organization for Remote Control eligibility”
Tu información de cuenta en caché está obsoleta o incompleta. Ejecutaclaude 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 has 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. Ejecutaclaude auth logout y luego claude auth login para actualizarlos, y actualiza Claude Code si estás en una versión antigua.
Ejecuta claude doctor para ver qué verificación de elegibilidad individual falló. Los conflictos de variables de entorno, las verificaciones inaccesibles y el ajuste de Remote Control de tu organización producen cada uno su propio mensaje, por lo que este error se refiere a 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”.
“Couldn’t verify Remote Control eligibility”
Claude Code no pudo alcanzar el servicio de indicadores de características para verificar si Remote Control está habilitado para tu cuenta, típicamente porque estás sin conexión o un proxy está bloqueando la solicitud. Reinténtalo una vez que tengas acceso a la red, o ejecutaclaude doctor para obtener detalles. El mensaje relacionado “Couldn’t verify your organization’s Remote Control policy” significa que Claude Code encontró un error al leer esa política, y tiene la misma solución.
“Remote Control requires feature-flag evaluation”
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 is not yet enabled for your account” en su lugar. Lo que debes hacer depende de la variable que menciona el mensaje:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICoDISABLE_GROWTHBOOK: desactiva la variable dondequiera que esté configurada, en tu entorno de shell o en el bloqueenvde un archivosettings.json.DISABLE_TELEMETRYoDO_NOT_TRACK: en un plan Pro, Max, Team o Enterprise conDISABLE_GROWTHBOOKdesactivado, estas variables dejan Remote Control disponible a menos que tu organización requiera Dispositivos de confianza. Si tu organización los requiere, desactiva la variable dondequiera que esté configurada para usar Remote Control. De v2.1.154 a v2.1.282, ves este mensaje con cualquiera de las variables configurada, por lo que actualiza Claude Code a una versión que cumpla el requisito para estas variables.
“Remote Control is only available when using Claude via api.anthropic.com”
La sesión no está hablando directamente con la API de Anthropic, que es lo que Remote Control requiere. Esto sucede en Amazon Bedrock, en Agent Platform de Google Cloud y en Microsoft Foundry. También sucede cuandoANTHROPIC_BASE_URL apunta a un host diferente de api.anthropic.com, como un gateway de LLM o proxy, incluso si inicias sesión con claude.ai. Consulta 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 tienes un inicio de sesión de claude.ai elegible, desactiva la variable mencionada, elimínala de la clave env en la configuración si la configuraste allí, y reinicia la sesión.
“Remote Control is disabled by your organization’s policy”
Una política bloquea Remote Control. Verifica estas causas en orden:- El error menciona
disableRemoteControl: tu administrador de TI ha deshabilitado Remote Control en este dispositivo a través de la configuración administrada, independientemente del conmutador de toda la organización y de cómo hayas iniciado sesión. - Tu plan de claude.ai es Pro o Max: Claude Code aún tiene la sesión iniciada 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. Ejecuta
/statuspara ver qué plan y organización utiliza tu inicio de sesión. Ejecutaclaude auth logouty luegoclaude auth loginpara iniciar sesión nuevamente bajo tu plan actual. - El mensaje no dice que contactes al administrador de tu organización: tu organización tiene aplicada la configuración HIPAA, que desactiva Remote Control. Para confirmarlo, ejecuta
/statusy buscaHIPAAen la líneaOrganization configuration. Un propietario ve el conmutador Remote Control atenuado en la configuración de administración y no puede activarlo. Si tienes preguntas sobre la configuración, consulta a un propietario, quien puede ponerse en contacto con el equipo de cuenta de Anthropic de tu organización. Antes de v2.1.267, este caso mostraba “Remote Control isn’t available for your organization due to its compliance policy” en su lugar. - Remote Control funciona para otros miembros de tu organización pero no para ti: si tu organización Enterprise administra tu acceso con roles personalizados, tus roles pueden ser la causa. Remote Control necesita tanto el permiso de sesiones en la nube como el permiso Claude Code remote control. Pide a un propietario que verifique si tus roles incluyen ambos y que agregue lo que falte en Organization settings > Roles.
- De lo contrario, un propietario no lo ha habilitado para tu 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 un ajuste de organización del lado del servidor.
Couldn't verify your organization's policy for remote control en su lugar.
“Remote Control was turned off by your organization’s policy”
La política de tu organización dejó de permitir Remote Control mientras una sesión estaba conectada, por lo que Claude Code la desconectó. Lo que sucede con la sesión depende de cómo iniciaste Remote Control:- Con
/remote-control,claude --remote-controlo conexión automática: la sesión sigue ejecutándose sin Remote Control, y Claude Code la archiva en claude.ai - Con
claude remote-control: el servidor se detiene y archiva las sesiones que estaba atendiendo, y luego sale
/remote-control en la sesión o claude remote-control en tu shell. Cualquiera de los dos comandos falla con Remote Control is disabled by your organization's policy hasta que Claude Code en esta máquina haya obtenido la política modificada. Una sesión abierta la obtiene aproximadamente una vez por hora. Para averiguar qué está bloqueando Remote Control, compara el texto completo que imprime el comando con esa entrada.
“Couldn’t verify your organization’s policy for remote control”
Claude Code no pudo obtener la política de tu 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 tu organización lo permite. Esto generalmente sucede cuando inicias 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 curso. El mensaje toma una de estas formas:- Desde
/remote-control,claude remote-control, oclaude --remote-control:Couldn't verify your organization's policy for remote control. Check your network connection and try again. - Desde conexión automática cuando se inicia una sesión:
couldn't verify your organization's policy — check your network connection and try again, con el prefijoRemote Control faileden la notificación yRemote Control disconnecteden la conversación. La sesión luego deja Remote Control desactivado.
/remote-control o ejecuta el comando nuevamente. Cada intento verifica la política nuevamente, por lo que no necesitas reiniciar Claude Code. Si el mensaje sigue apareciendo, ejecuta claude doctor y lee 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 is disabled by your organization's policy en su lugar.
“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. Vuelve a ejecutar con--verbose para ver el error completo:
- No has iniciado sesión: ejecuta
claudey usa/loginpara autenticarte con tu cuenta de claude.ai. La autenticación con clave de 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 ves
Session creation failed — see debug log, el error ocurrió anteriormente en la configuración. Verifica que tu suscripción esté activa.
“Couldn’t reconnect to your Remote Control session”
Cuando reanudas 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.
Ejecuta /remote-control para reintentar la conexión, o inicia una nueva sesión con claude --remote-control para crear una nueva sesión de Remote Control. Tu sesión local sigue ejecutándose sin Remote Control mientras tanto.
“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. Puedes 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.
Ejecuta /remote-control para iniciar una nueva sesión de Remote Control bajo el inicio de sesión actual; tu sesión local sigue 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. Si ejecutas /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.
“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. Ejecutaclaude update, luego ejecuta /remote-control para reconectar.
“Your organization requires Trusted Devices for Remote Control, but this device is not enrolled”
Tu organización tiene Dispositivos de confianza habilitados y esta máquina aún no se ha inscrito. Ejecuta/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”
Tu inicio de sesión tiene más de 18 horas. Ejecuta/login en Claude Code, o confirma con Face ID, Touch ID, Windows Hello o una llave de acceso (passkey) cuando claude.ai o la aplicación móvil te lo soliciten. Consulta Dispositivos de confianza.
Recursos relacionados
- Usar Claude Code en la nube: 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
/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, Remote Control y en la nube