Cómo controlar Codex en un servidor Linux desde el móvil: las cuatro opciones
Todas las formas que funcionan en 2026 para manejar una sesión de Codex en un equipo Linux sin pantalla desde el móvil: el Remote de OpenAI, la CLI codex remote-control, SSH con tmux y una app complementaria. Qué necesita cada una y dónde falla.
- CLI
- 0.2.17
- Ref de preview
- a2c45c8
En resumen
Hay cuatro formas de llegar desde el móvil a una sesión de Codex en un equipo Linux sin pantalla. Se diferencian en una pregunta: ¿qué más tiene que estar en marcha además del equipo Linux?
- El Remote de OpenAI (oficial, compatible): un Mac o un PC con Windows ejecuta la app de escritorio de ChatGPT, se conecta a tu equipo Linux por SSH y el móvil se empareja con ese PC. El trabajo lo hace el equipo Linux, pero el Mac o el PC tiene que seguir despierto.
codex remote-controlen el propio equipo Linux: está documentado como comando de la CLI y hay gente que cuenta que funciona con ChatGPT para móvil. La página Remote connections de OpenAI sigue diciendo que la configuración móvil empieza desde la app de escritorio, así que trátalo como un camino no oficial y espera cambios.- SSH + tmux (o mosh) desde una app de terminal en el móvil: nada extra en el servidor y control total, pero leer diffs y responder aprobaciones en una pantalla pequeña es un suplicio.
- Una app complementaria que se ejecuta en el equipo Linux: por ejemplo Happier, una app de código abierto para ejecutar y orquestar agentes de programación entre dispositivos. El equipo pasa a ser una máquina en la que inicias sesiones de Codex directamente, y con Codex CLI 0.131.0 o posterior la TUI nativa de Codex y el móvil comparten el mismo hilo.
Si ya tienes un Mac siempre encendido, la opción 1 es la respuesta sencilla y compatible. Si el equipo Linux es el único ordenador que tienes siempre encendido, sigue leyendo.
El problema
Una configuración habitual: las ejecuciones largas de Codex viven en un equipo Linux metido en un armario. Nunca entra en reposo, tiene los repositorios y las herramientas adecuadas. El portátil, en cambio, entra en reposo constantemente.
Si buscas "control remoto de Codex en un servidor Linux", las respuestas mezclan "no está soportado", "funciona, estos son los comandos" y "funcionó diez minutos y luego el móvil volvió a mostrar la pantalla de bienvenida". Resulta que las tres son ciertas, según el camino que elijas.
Esta guía repasa cada camino: qué necesita, qué te da y los fallos que la gente cuenta de verdad.
Opción 1: el Remote de OpenAI, con un Mac o un PC con Windows en medio
Es la vía compatible. A fecha de 2026-10-11, la página Remote connections de OpenAI dice:
- El acceso remoto "admite hosts que ejecutan la app de escritorio de ChatGPT en macOS y Windows".
- "La configuración móvil empieza desde la app. No puedes configurarla desde la CLI de Codex ni desde la extensión del IDE."
- Un equipo Linux encaja como host SSH: la app de escritorio lee alias de host concretos de
~/.ssh/config, inicia por SSH el servidor de la app de Codex remoto y ejecuta los chats sobre el sistema de archivos remoto.codextiene que estar en elPATHdel usuario remoto. - En un espacio de trabajo de ChatGPT, "puede que tu administrador tenga que activar el acceso a Remote Control".
Lo que significa en la práctica:
- Lo bueno: oficial, una interfaz móvil pulida, aprobaciones y diffs en el móvil, y el trabajo se ejecuta de verdad en el equipo Linux.
- La pega: el Mac o el PC con Windows que ejecuta la app de escritorio forma parte de la cadena. Si entra en reposo, pierde la red o se cierra la app, el acceso remoto se detiene. La propia OpenAI recomienda tener ese host enchufado y despierto.
Si de todas formas tienes un Mac mini siempre encendido, quédate aquí. Es la opción con menos piezas.
Opción 2: codex remote-control directamente en el equipo Linux
La referencia de comandos para desarrolladores de OpenAI documenta:
codex remote-control # run in the foreground
codex remote-control start # start the local app-server daemon with remote control enabled
codex remote-control pair # print a short-lived manual pairing code
codex remote-control stopEl código de emparejamiento se introduce en la app móvil de ChatGPT. En r/codex hay usuarios que cuentan que funciona en Linux sin pantalla, con dos requisitos con los que se topan una y otra vez: necesitas iniciar sesión con ChatGPT, no con una clave de API (el error citado en el hilo es "remote control requires ChatGPT authentication"), y un comentario dice que la versión de npm no les funcionó y la del script de instalación sí.
Lo que la gente cuenta que falla (Reddit, de julio a septiembre de 2026. Puede variar según la versión):
- El móvil se conecta y, unos minutos después, muestra la pantalla de bienvenida pidiéndote que conectes una app de Mac.
- Ves el historial de sesiones, pero al enviar un mensaje desde el móvil se va por su propia bifurcación en lugar de entrar en la sesión de la CLI que ya tienes en marcha.
- Tras una actualización, el móvil se comporta como si el ordenador nunca se hubiera emparejado. Una respuesta de personal de OpenAI en ese hilo remite a
codex remote-control pair.
En la práctica: es un comando real y merece la pena probarlo, sobre todo para chats nuevos iniciados desde el móvil. Pero no montes un flujo que dependa de que siga funcionando igual, porque la página oficial dice que la CLI no es una vía de configuración compatible para el móvil.
Opción 3: SSH + tmux desde el móvil
El clásico fiable. En el servidor:
tmux new -s codex # or: tmux attach -t codex
codexEn el móvil, cualquier cliente SSH (Termius, Blink, Moshi, Termux en Android). Usa mosh si tu conexión cambia de red y Tailscale si no quieres abrir SSH a internet.
- Lo bueno: nada nuevo en lo que confiar, funciona con cualquier agente y aguanta desconexiones porque tmux mantiene la sesión.
- La pega: lees una interfaz de terminal completa en el móvil. La revisión de diffs, los prompts de aprobación largos y el "¿cuál de los tres paneles está bloqueado?" acaban cansando. No hay notificaciones push salvo que montes hooks tú mismo.
Si solo echas un vistazo de vez en cuando, esto basta y es gratis.
Opción 4: una app complementaria que se ejecuta en el equipo Linux
Si quieres controlar Codex en un equipo Linux desde el móvil sin tener otro ordenador despierto, Happier es una app de código abierto para ejecutar y orquestar Codex, Claude Code, OpenCode y otros agentes entre dispositivos, desde el móvil, el escritorio o la web. Hay otras apps en este ámbito, y algunas son compatibles con Codex en Linux. Los pasos siguientes explican la configuración de Happier.
El modelo es distinto al de las opciones 1 y 2: instalas la CLI de Happier en el equipo Linux, que registra ese equipo como una máquina de tu cuenta, y el móvil habla con el equipo a través de un relay (Happier Cloud o uno que alojes tú). El contenido de las sesiones va cifrado de extremo a extremo por defecto. Los metadatos, como identificadores, marcas de tiempo e identificadores de dispositivo, no.
1) Instala Happier en el equipo Linux
curl -fsSL https://happier.dev/install | bash
happier setuphappier setup te pregunta qué relay usar, inicia tu sesión, registra esta máquina y configura el arranque automático del servicio en segundo plano.
Si prefieres hacerlo desde un escritorio, la app de escritorio también puede configurar una máquina remota por SSH (Add machine over SSH en los ajustes de Máquinas, o happier machine setup --ssh user@host desde un ordenador que ya tenga la CLI).
2) Asegúrate de que Codex está instalado y con la sesión iniciada en el equipo
happier install provider codex # or: npm install -g @openai/codex
codex --version # shared TUI control needs 0.131.0 or newerDespués inicia sesión. Puedes ejecutar codex login en el equipo o dejar que Happier guarde la credencial:
happier connect codex --device # device-code flow, handy on a headless box
happier connect codex --paste # fallback: paste the redirect URL
happier connect codex --api-key # API key modePuede que la autenticación por dispositivo requiera activar antes "device code authorization for Codex" en los ajustes de ChatGPT.
3) Inicia la sesión desde cualquiera de los dos lados
Desde el equipo (dentro de tmux, para que la TUI sobreviva a un corte de SSH):
cd ~/src/my-repo
happier codexO desde el móvil: nueva sesión, elige la máquina Linux, elige Codex y escribe la tarea.
4) Usa el móvil y la TUI en el mismo hilo
Desde Happier 0.2.13, con Codex CLI 0.131.0 o posterior en macOS o Linux, Happier y la TUI de Codex se conectan al mismo hilo del servidor de la app en ejecución. Puedes escribir en la TUI por SSH y aprobar el siguiente comando desde el móvil, y los dos siguen en directo. Si la sesión se inició desde el móvil, happier attach <session-id> en el equipo abre la TUI en esa misma sesión.
Los límites, sin rodeos:
- El control compartido solo se aplica a sesiones iniciadas a través de Happier. Si iniciaste un hilo directamente con
codex, Happier no puede unirse mientras se ejecuta, porque Codex mantiene un único escritor activo por hilo. - En Windows, en modo ACP o con una Codex CLI antigua, el control es exclusivo: un mensaje desde el móvil espera hasta que el turno del terminal llega a un punto seguro.
- El equipo Linux tiene que estar en línea. Happier no arregla un equipo apagado, una red caída ni una caída del proveedor. Solo hace que el equipo sea lo único que tiene que estar despierto.
Opcional: si usas Herdr como multiplexor de terminal, la versión 0.2.16 de Happier lo añade como host de terminal para sesiones nuevas (Herdr 0.9.2 o posterior, macOS y Linux). Algunas páginas de la documentación todavía lo marcan como función de compilación de desarrollo mientras se ponen al día.
¿Cuál elegir?
| Tienes... | Elige |
|---|---|
| Un Mac o PC con Windows siempre encendido, y solo usas Codex | El Remote de OpenAI (opción 1) |
| Solo el equipo Linux, y sobre todo inicias chats nuevos desde el móvil | Prueba codex remote-control (opción 2) y deja la opción 3 como plan B |
| Solo el equipo Linux, y quieres responder aprobaciones y revisar diffs con comodidad | Una app complementaria en el equipo (opción 4) |
| Ningunas ganas de instalar nada nuevo | SSH + tmux (opción 3) |
Solución de problemas
"remote control requires ChatGPT authentication"
Has iniciado sesión con una clave de API. Para las opciones 1 y 2, inicia sesión en Codex con tu cuenta de ChatGPT (codex login y elige ChatGPT). En Happier, el modo con clave de API funciona con happier connect codex --api-key, pero comprueba a qué cuenta quieres que se facturen las sesiones.
El móvil vuelve a mostrar la pantalla de bienvenida de "conecta tu Mac"
Con la opción 2 es un problema que se cuenta a menudo. Vuelve a ejecutar codex remote-control pair y empareja de nuevo. Si sigue pasando, es la parte no compatible del camino dando la cara. Las opciones 1 y 4 son las vías estables.
Los mensajes del móvil abren un chat nuevo en lugar de continuar mi sesión de la CLI
Es la bifurcación que la gente cuenta con la opción 2. Con Happier, inicia la sesión con happier codex (o desde la app) para que la TUI y el móvil compartan el mismo hilo. A un hilo iniciado con codex a secas no te puedes unir en directo.
Happier muestra la máquina Linux como desconectada
En el equipo:
happier daemon status --allAsegúrate de que el equipo y el móvil usan el mismo relay y la misma cuenta. Si el servicio está en marcha pero las sesiones no consiguen iniciar Codex, comprueba que codex está en el PATH que ve el servicio en segundo plano, no solo en el de tu shell interactiva.
Preguntas frecuentes
¿Necesito un Mac para controlar Codex desde el móvil?
Para la vía Remote compatible de OpenAI, sí: un Mac o un PC con Windows con la app de escritorio de ChatGPT (a fecha de 2026-10-11). La vía de la CLI codex remote-control y las apps complementarias de terceros no lo necesitan.
¿El trabajo se ejecuta en el móvil o en la nube?
En las cuatro opciones, el código y los comandos se ejecutan en el equipo Linux. El móvil envía prompts y aprobaciones. (Las tareas en la nube de Codex son otro producto de OpenAI y no se tratan aquí.)
¿Puedo hacer lo mismo con Claude Code?
Sí, y el Remote Control de Anthropic tiene requisitos distintos (inicio de sesión en claude.ai, no una clave de API). Consulta Cómo supervisar Claude Code desde el móvil.
¿Happier es gratis?
La app y la CLI son de código abierto. Codex se sigue facturando a través de tu plan de OpenAI o tu clave de API.