Codex en un VPS: instálalo en un servidor Linux y conéctate por SSH

Cómo encaja Codex en un VPS

Intervienen tres máquinas, y cada una tiene una función:

• El servidor Linux ejecuta Codex. Los chats en sus proyectos ejecutan comandos, leen archivos y escriben cambios allí, con las dependencias, las políticas de seguridad y la capacidad de cómputo del servidor. La app de escritorio inicia Codex en él por SSH, en el shell de inicio de sesión del usuario remoto.
• Un Mac o PC con Windows ejecuta la app de escritorio de ChatGPT, que mantiene la conexión SSH. Es el host con el que habla tu móvil, así que también tiene que seguir despierto y conectado.
• Tu móvil ejecuta la app de ChatGPT y controla ese host mediante el control remoto. Envía prompts y aprobaciones y te muestra diffs, la salida del terminal y notificaciones.
• OpenAI solo documenta macOS y Windows como hosts de control remoto, así que vincular un móvil directamente con un servidor Linux no está documentado. Vincula tu móvil con el Mac o PC, idealmente un Mac mini siempre encendido.

Qué necesitas

• Un servidor Linux al que puedas llegar por SSH. La guía de instalación de la Codex CLI en GitHub indica Ubuntu 20.04+ o Debian 10+, con 4 GB de RAM como mínimo y 8 GB recomendados; hay builds de release para x86_64 y ARM64.
• Un Mac o PC con Windows con la app de escritorio de ChatGPT, para añadir el servidor como host SSH. Si quieres llegar al servidor desde el móvil, este ordenador tiene que seguir encendido.
• Una cuenta de ChatGPT para Codex. La tabla de planes de OpenAI incluye las conexiones remotas por SSH en Plus, Pro, Business y Enterprise y con una clave de API, y el control remoto desde el móvil en Plus, Pro, Business y Enterprise, pero no con una clave de API.
• La app de ChatGPT en el móvil, iOS o Android.

Cómo configurar Codex en un VPS Linux

1. Alquila un servidor y comprueba SSH

   Crea un servidor Linux y asegúrate de que puedes iniciar sesión por SSH desde el Mac o PC que ejecutará la app de escritorio. Usa inicio de sesión con clave y una cuenta con solo los permisos que Codex necesita, no root.

2. Instala la Codex CLI en el servidor

   Ejecuta el script de instalación de OpenAI en el servidor; el mismo comando lo actualiza más adelante, y npm también sirve. Instala bubblewrap para el sandbox de Codex: sin bwrap en el PATH, Codex recurre a un helper incluido que necesita user namespaces sin privilegios, y muestra un aviso al iniciarse. Ubuntu 24.04 puede seguir avisando hasta que cargues el perfil de AppArmor bwrap-userns-restrict.

   # On the server: install the Codex CLI (run it again to update)
   curl -fsSL https://chatgpt.com/codex/install.sh | sh
   # or: npm install -g @openai/codex
   
   # Codex's sandbox on Linux uses bubblewrap
   sudo apt install bubblewrap   # Fedora: sudo dnf install bubblewrap

3. Inicia sesión en un servidor sin interfaz gráfica

   El servidor no tiene navegador, así que usa el inicio de sesión con código de dispositivo: ejecuta codex login --device-auth, o elige Sign in with Device Code, y sigue las indicaciones. Está en beta, y el inicio de sesión con código de dispositivo tiene que activarse primero en los ajustes de seguridad de ChatGPT o por el administrador de tu workspace. Si no puedes usarlo, reenvía el callback del inicio de sesión con ssh -L 1455:localhost:1455 y ejecuta codex login en el servidor, o copia ~/.codex/auth.json de un ordenador donde tengas la sesión iniciada y trata ese archivo como una contraseña.

   # Headless sign-in (beta; turn on device code login in ChatGPT first)
   codex login --device-auth
   
   # Or forward the browser callback from your computer, then run codex login
   ssh -L 1455:localhost:1455 you@devbox.example.com
   
   # Exits 0 once you're signed in
   codex login status

4. Añade el servidor a tu configuración SSH

   En el Mac o PC, añade una entrada Host a ~/.ssh/config y comprueba que ssh devbox funciona. Codex lee de ese archivo los alias de host concretos e ignora las entradas que solo son patrones. La app de escritorio inicia Codex en el shell de inicio de sesión del usuario remoto, así que codex tiene que estar en el PATH allí.

   # ~/.ssh/config on the Mac or PC running the ChatGPT desktop app
   Host devbox
     HostName devbox.example.com
     User you
     IdentityFile ~/.ssh/id_ed25519
   
   # Check it works before adding it in the app
   ssh devbox

5. Añádelo como host SSH en la app de escritorio

   En la app de escritorio de ChatGPT, abre Settings > Connections, añade o activa el host SSH y elige una carpeta de proyecto en el servidor. Los chats de ese proyecto ejecutan comandos, leen archivos y escriben cambios en el servidor.

6. Contrólalo desde el móvil

   En el mismo Mac o PC, abre Settings > Connections > Control this Mac or PC, selecciona Set up o Add y escanea el código QR con la app de ChatGPT. Abre Codex en el móvil, elige ese ordenador y el proyecto del servidor, e inicia un chat. El chat se ejecuta en el servidor a través del Mac o PC, así que mantén ese ordenador despierto y conectado; un Mac mini en casa puede hacer ese trabajo. Los detalles de configuración y las soluciones están en control remoto de Codex.

Fuente: documentación de OpenAI sobre conexiones remotas y hosts SSH

Solo terminal: la Codex CLI por SSH en tmux

Si te basta con un terminal, puedes prescindir de la app de escritorio. Conéctate al servidor por SSH, ejecuta la Codex CLI dentro de tmux y sal de la sesión sin cerrarla (detach): Codex sigue en marcha después de que te desconectes, y vuelves a ella desde cualquier ordenador que pueda entrar por SSH.

1. Inicia Codex dentro de tmux

   Instala tmux desde los paquetes de tu distribución si no lo tienes, inicia una sesión y ejecuta codex en la carpeta de tu proyecto.

   # On the server: run Codex inside tmux so it outlives your SSH connection
   tmux new -s codex
   cd ~/my-project
   codex
   
   # Detach with Ctrl+B, then D. Reattach later with:
   tmux attach -t codex

2. Ten claro lo que no hace

   Esta configuración no está conectada a tu móvil. OpenAI dice que la configuración móvil empieza en la app de escritorio y no se puede hacer desde la CLI. La CLI tiene un comando experimental codex remote-control, que la documentación asocia a clientes de control remoto gestionados y flujos de trabajo por SSH, pero no describe cómo vincular un móvil con un servidor que solo ejecuta la CLI.

Protege el servidor

• Trátalo como cualquier servidor SSH: claves de confianza, una cuenta con privilegios mínimos y ningún servicio sin autenticación escuchando en la internet pública.
• No expongas el app server de Codex. codex app-server --listen y codex --remote son sobre todo para desarrollo y depuración, y OpenAI desaconseja abrir transportes del app server en una red compartida o pública.
• Para llegar al servidor desde fuera de su red, usa una VPN o una red mesh como Tailscale, que conecta solo tus propios dispositivos mediante enlaces WireGuard cifrados.
• Mantén privado ~/.codex/auth.json; OpenAI dice que lo trates como una contraseña.
• Los ajustes del sandbox, los controles de seguridad y las aprobaciones se aplican a los chats en el servidor igual que en local, y el sandbox en Linux necesita bubblewrap.

Pasa un chat entre tu ordenador y el servidor

La app de escritorio puede pasar un chat, con su estado de Git, entre tu ordenador y un host SSH conectado. Los dos necesitan un proyecto guardado para el mismo repositorio Git. En el pie del chat, elige dónde se ejecuta ahora, elige el host de destino (This computer lo trae de vuelta), revisa y selecciona Hand off. Codex crea o reutiliza un worktree allí. Una respuesta que todavía está en curso se interrumpe, y un chat no se puede pasar a Codex cloud.

Sin ningún servidor: Codex cloud

• Codex cloud ejecuta tareas de programación en la nube de OpenAI. Cada tarea tiene su propio workspace y sigue trabajando mientras tu ordenador está suspendido.
• Empieza desde la web, desde la app de escritorio (Work in > Cloud) o desde la app de ChatGPT en el móvil (abre Codex, elige Cloud y un entorno). Con el entorno por defecto puedes empezar sin elegir un repositorio, y Codex puede hacer checkout de repositorios de tu cuenta conectada de GitHub o GitLab.
• Una tarea en la nube solo ve su entorno en la nube: tus archivos locales, los procesos en ejecución, las sesiones iniciadas en el navegador y el acceso por VPN no se trasladan. Las configuraciones reutilizables están en Work in > Cloud > Select environment > Create environment.
• Necesita iniciar sesión con ChatGPT, no una clave de API. Desde un terminal, codex cloud abre un selector de tus chats en la nube y codex cloud exec envía una tarea.

Host Mac mini vs host SSH Linux vs Codex cloud

Dale al servidor un trabajo fijo

Un servidor que nunca se suspende sigue esperando tu siguiente prompt. Crewmark convierte un chat de Codex en él en un empleado de IA con un rol, un objetivo numérico, horario laboral y un heartbeat: durante el horario laboral, la CLI crewmark, que funciona en Linux además de en macOS y Windows, despierta al empleado para que avance con sus issues en un tablero compartido. El ordenador en el que se ejecuta tiene que seguir encendido, y un VPS lo está.

1. Contrata a un empleado

   Elige un rol de los roles de empleados de IA, como ingeniero de software o especialista SEO, y escribe sus objetivos y KPI.

2. Conecta Codex en el servidor

   Pega el enlace de configuración en un chat de Codex en el servidor. Instala la CLI crewmark y vincula ese chat al empleado. También funciona con Claude Code; consulta Claude Code en un VPS.

3. Fija el horario laboral y un heartbeat

   Solo entre semana o todos los días, un horario que puede pasar de la medianoche y un despertar cada 15, 30, 60, 120 o 240 minutos. Cada despertar llega al mismo chat de Codex, así que retoma el trabajo donde lo dejó. Las opciones de programación del propio Codex se comparan en Codex proactivo.

4. Asigna issues y háblale desde el móvil

   Abre crewmark.ai en el navegador del móvil para crear y asignar issues, o escribe al empleado en su registro de trabajo; el mensaje llega al chat de Codex en el servidor, y responde allí. Asignar una issue lo despierta al momento y, cuando necesita una revisión o una decisión, pone la issue en Needs action y te pregunta allí. Tienes trabajos para darle en casos de uso de Codex.

Preguntas frecuentes