¿Claude Code Remote Control no funciona? Todos los errores y soluciones (2026)
Cuando Claude Code Remote Control no funciona, casi siempre es por una de tres razones. El inicio de sesión no es el correcto. Un ajuste envía Claude a un servidor que no es de Anthropic. O la sesión en tu Mac se detuvo.
Busca abajo el mensaje que ves. Cada error tiene una solución corta basada en la documentación oficial de Anthropic.
| Error o síntoma | Causa | Solución |
|---|---|---|
| "Remote Control requires a claude.ai subscription" | No iniciaste sesión con claude.ai | claude auth login |
| "Remote Control requires claude.ai subscription auth" | Hay una clave API o un token definido | Quitar la variable |
| "Remote Control requires a full-scope login token" | Token de claude setup-token | claude auth login |
| "Remote Control isn't enabled for this account" | Datos del plan antiguos en caché | Cerrar sesión y volver a entrar |
| "Couldn't verify Remote Control eligibility" | Sin conexión o bloqueado por un proxy | Reintentar y luego claude doctor |
| "Remote Control is only available when using Claude via api.anthropic.com" | Bedrock, Google Cloud, Foundry o ANTHROPIC_BASE_URL | Quitar la variable |
| "Remote Control is disabled by your organization's policy" | Desactivado en Team o Enterprise | Revisar /status, pedir a un Owner |
| "could not reach the Remote Control server for about 30 minutes" | Sin contacto durante mucho tiempo | Ejecutar /remote-control |
| La sesión no aparece en la app | Nunca se inició Remote Control | Ejecutar /rc |
| La sesión quedó sin conexión | El proceso claude se detuvo | claude remote-control --continue |
| La sesión de la app Desktop no aparece en el móvil | Error conocido, issue #92306 | Iniciarla en Terminal |
| La sesión bifurcada no aparece | Error conocido, issue #94396 | Ejecutar /remote-control en ella |
/remote-control no muestra nada | Reportado en la issue #96591 | Usar claude remote-control |
| La sesión desaparece tras horas sin mensajes | Reportado en la issue #98879 | Enviar un mensaje o /remote-control |
| "Couldn't reconnect to your Remote Control session" | La app se cerró, reinició o actualizó | Reintentar y luego sesión nueva |
“Remote Control requires a claude.ai subscription”
Este mensaje sale cuando Claude Code no inició sesión con una cuenta de claude.ai. Con claude remote-control dice "You must be logged in to use Remote Control."
Remote Control funciona en los planes Pro, Max, Team y Enterprise. No funciona con claves API. Inicia sesión con tu cuenta de claude.ai:
claude auth login“Remote Control requires claude.ai subscription auth”
Iniciaste sesión, pero una clave API o un token tiene prioridad. El mensaje lo nombra, por ejemplo "ANTHROPIC_API_KEY is set, so this session is using API-key auth".
Quita esa variable de tu perfil de shell y del bloque env de tus ajustes de Claude. Después vuelve a iniciar Claude:
unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN
claude --remote-controlSi el mensaje menciona apiKeyHelper, quita ese ajuste.
“Remote Control requires a full-scope login token”
Usas un token de larga duración de claude setup-token o CLAUDE_CODE_OAUTH_TOKEN. Esos tokens solo sirven para peticiones al modelo. Inicia sesión de la forma normal:
claude auth login“Remote Control isn't enabled for this account”
Claude Code revisó tu cuenta y la respuesta fue negativa. Suele pasar tras un cambio de plan, cuando aún hay datos viejos guardados. Las versiones antiguas mostraban "Remote Control is not yet enabled for your account".
Cierra sesión, vuelve a entrar y actualiza Claude Code. claude doctor muestra qué comprobación falló:
claude auth logout
claude auth login
claude doctor“Couldn't verify Remote Control eligibility”
Claude Code no pudo conectar con el servicio que revisa tu cuenta. Estás sin conexión o un proxy bloquea la petición. Vuelve a intentarlo con una conexión normal o ejecuta claude doctor para ver detalles.
“Remote Control is only available when using Claude via api.anthropic.com”
Es uno de los errores más comunes. Remote Control necesita que Claude Code hable directo con la API de Anthropic. No funciona en Amazon Bedrock, Google Cloud ni Microsoft Foundry. También falla si ANTHROPIC_BASE_URL apunta a un proxy o a un gateway LLM, aunque hayas entrado con claude.ai.
El mensaje nombra la causa, como CLAUDE_CODE_USE_BEDROCK o una ANTHROPIC_BASE_URL propia. Quítala de la shell y del bloque env de tus ajustes. Luego reinicia la sesión:
env | grep -i -e ANTHROPIC -e CLAUDE_CODE_USE
unset ANTHROPIC_BASE_URL
claude --remote-control“Remote Control is disabled by your organization's policy”
En los planes Team y Enterprise, Remote Control empieza desactivado. Un Owner lo activa en los ajustes de administración de Claude Code. Si pagas Pro o Max, puede que Claude Code siga conectado a una organización Team antigua.
Ejecuta /status para ver tu plan y tu organización. Si sale la equivocada, ejecuta claude auth logout y luego claude auth login. Si el mensaje menciona disableRemoteControl, tu equipo de TI lo desactivó en este equipo.
“could not reach the Remote Control server for about 30 minutes”
Tu sesión perdió el contacto con los servidores de Anthropic durante mucho tiempo. Ejecuta esto dentro de la sesión para reconectar:
/remote-controlLa sesión no aparece en la app de Claude
Remote Control solo arranca cuando lo pides. Ejecuta /rc en tu sesión o inicia Claude con claude --remote-control. En la app de Claude, toca Code para ver tus sesiones. Los dos dispositivos necesitan la misma cuenta.
Para conectar cada sesión de forma automática, abre /config y activa Enable Remote Control for all sessions. En la app de escritorio está en Ajustes > Claude Code > Connect new sessions to Remote Control.
La sesión quedó sin conexión
Remote Control corre dentro del proceso claude de tu Mac. Si cierras la terminal o sales de la app, la sesión queda sin conexión.
Si usaste el modo servidor, puedes recuperarla en unas cuatro horas:
claude remote-control --continuePara una sesión iniciada con --remote-control o /rc, ejecuta claude --continue y luego /rc. Lanza las tareas largas dentro de tmux para que cerrar una ventana no las detenga.
Se detiene cuando mi Mac entra en reposo
El trabajo se pausa mientras el Mac está en reposo. Claude Code se reconecta solo cuando el Mac despierta.
Para mantener el Mac despierto durante una tarea, inicia Claude con caffeinate:
caffeinate -i claude --remote-controlLa mayoría de los MacBook entran en reposo al cerrar la tapa, salvo con una pantalla externa y el cargador conectados.
La sesión no aparece en tu móvil o desaparece
Son errores conocidos reportados en GitHub. En octubre de 2026 la mayoría siguen abiertos. Esto es lo que pasa en cada caso y lo que puedes hacer ahora.
Las sesiones de la app Claude Desktop nunca aparecen
En macOS, las sesiones interactivas de Code en la app Desktop pueden no registrarse en Remote Control aunque tengas activada la conexión automática. Las tareas programadas de la misma app sí aparecen en el móvil. Está reportado en la issue #92306 y sigue abierto.
Todavía no hay una solución oficial. Según el reporte, la CLI instalada por separado no está afectada. Iniciar la sesión en Terminal con claude --remote-control puede ayudarte a evitarlo.
Una sesión bifurcada nunca aparece
Una sesión que bifurcaste de otra nunca se marca para Remote Control. Por eso no aparece en la pestaña Code del móvil. Mira la issue #94396, sigue abierta.
La solución temporal del autor: actívalo a mano con /remote-control dentro de esa sesión. Envía antes un mensaje. Si no, verás "Remote Control requires an active session. Send a message first."
/remote-control no muestra nada y la sesión nunca aparece
Algunas personas ejecutan /remote-control y no reciben ningún enlace ni confirmación. Al ejecutarlo otra vez aparece "Remote Control disconnected." Se reportó en la issue #96591 y se cerró como no planificado.
Ejecuta claude doctor para revisar tu inicio de sesión y tu red. Luego prueba el modo servidor con claude remote-control. Muestra una URL de sesión y un código QR para abrir la sesión directamente.
La sesión desaparece tras horas sin mensajes
Un reporte en Android cuenta que una sesión desapareció de la lista Code tras unas 8 horas sin mensajes. El ordenador seguía despierto. Volvió a aparecer después de usar la app Desktop. Mira la issue #98879, sigue abierta.
Todavía no hay solución. Envía un mensaje desde tu Mac para recuperarla o vuelve a conectar con /remote-control.
"Couldn't reconnect to your Remote Control session"
Cuando la app Desktop se cierra, se reinicia o se actualiza, sus sesiones se detienen y Remote Control no vuelve a activarse. Al activarlo de nuevo puede fallar con "Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume." Mira la issue #98504, sigue abierta.
Haz lo que dice el mensaje. Reintenta una vez y luego inicia una sesión nueva. Una sesión detenida tiene que hacer un turno en tu Mac antes de poder activar Remote Control otra vez.
Una solución de la comunidad en ese hilo: ejecuta claude dentro de tmux, fuera de la app Desktop. Así los reinicios de la app no lo detienen.
Cuando necesitas algo más que la sesión de Claude
Remote Control es genial para chatear con Claude Code. A veces también necesitas el resto de tu Mac. Macky abre la terminal y la pantalla de tu Mac en tu iPhone.
- Funciona con clave API, Bedrock o un proxy. Es tu propia shell, así que tu configuración no cambia.
- Modos propios para Claude Code y Codex, más una terminal normal para git, Docker y todo lo demás.
- Una barra de teclas con Esc, Tab y Ctrl. Aprueba con y y Enter.
- Tus claves SSH se quedan en tu Mac. Escribe
ssh my-vpsy ya estás dentro. - Con Pro, usa tu MacBook con la tapa cerrada y mantén las sesiones conectadas en segundo plano.
Instala Macky en tu Mac y tu iPhone, inicia sesión en ambos y conéctate. Es gratis con sesiones de 5 minutos. Pro cuesta 29 $ en un solo pago. Descárgalo en la App Store.
¿Es tu primera vez con Remote Control? Lee la guía de Claude Code Remote Control. Para comparar ambos, mira Macky vs Claude Code Remote Control.
Preguntas frecuentes
¿Por qué no funciona Claude Code Remote Control?
Casi siempre es el inicio de sesión, una clave API o ANTHROPIC_BASE_URL, o que el proceso claude se detuvo en el Mac. El mensaje de error te dice cuál.
¿Cómo arreglo "Remote Control is only available when using Claude via api.anthropic.com"?
Quita ANTHROPIC_BASE_URL o la variable de Bedrock, Google Cloud o Foundry que nombra el mensaje. Luego reinicia Claude Code con tu sesión de claude.ai.
¿Remote Control funciona con una clave API?
No. Necesitas iniciar sesión con claude.ai en un plan Pro, Max, Team o Enterprise.
¿Por qué mi sesión no aparece en la app de Claude?
Remote Control solo arranca con /rc o claude --remote-control, salvo que actives la conexión automática en /config. Ambos dispositivos necesitan la misma cuenta.
¿Qué pasa si mi Mac entra en reposo?
La sesión se pausa. Claude Code se reconecta cuando el Mac despierta.
¿Puedo controlar Claude Code desde el móvil sin Remote Control?
Sí. Macky abre la terminal de tu Mac en tu iPhone, así que Claude Code funciona con cualquier inicio de sesión, incluida una clave API.
Guías y comparativas relacionadas
Prueba Macky
Conéctate a la consola de tu Mac desde tu iPhone.