Un sitio devuelve un error 502. En lugar de copiar los logs en un chatbot, le pide a un agente de IA que está en el servidor que inspeccione los archivos pertinentes y le explique el problema. Es un uso práctico de Codex CLI en un VPS Linux.
Esta guía cubre la instalación, el inicio de sesión desde una sesión SSH y una primera tarea con permisos restringidos. Después explicamos la prueba real que hay detrás de nuestro vídeo: Codex identificó una discrepancia de puertos en un sitio de demostración roto a propósito.
Qué se ejecuta y dónde: el agente Codex y sus herramientas de línea de comandos se ejecutan en su VPS. Con la configuración de OpenAI que se describe aquí, el modelo de IA se ejecuta en la nube de OpenAI. Necesita su propia cuenta de ChatGPT con acceso o un acceso a la API de OpenAI facturado por separado. Un VPS de SharpHeberg no incluye ese acceso.
Antes de empezar
- Un VPS Linux al que pueda acceder por SSH, con acceso HTTPS saliente. Los comandos de paquetes que se muestran a continuación son para Debian y Ubuntu.
- Un usuario Linux normal con sudo disponible para instalar paquetes del sistema. Ejecute Codex con ese usuario, no como root.
- Una cuenta de OpenAI con acceso a Codex. Consulte la disponibilidad y los límites actuales de su plan; la facturación de la API es independiente de una suscripción a ChatGPT.
- Un proyecto de pruebas o un entorno de staging. Mantenga las credenciales de producción y los archivos de clientes no relacionados fuera de la cuenta y del espacio de trabajo accesibles para el agente.
No necesita alojar los pesos del modelo ni aprovisionar una GPU para este flujo de trabajo respaldado por la nube. Los recursos que consumen sus proyectos, herramientas de compilación y servicios siguen siendo importantes a la hora de elegir un VPS.
Alcance de la validación: nuestra demostración de diagnóstico se ejecutó en un VPS Debian 12 desechable con Codex CLI 0.164.0. Ese experimento aislado usó una cuenta de diagnóstico con privilegios; no es la configuración de cuenta que recomendamos para producción. También comprobamos el instalador independiente oficial en un directorio de instalación aislado de Linux x86-64 y verificamos la versión de la CLI y las opciones de inicio de sesión y sandbox. No hemos probado todas las versiones de Ubuntu ni todas las configuraciones de VPS.
1. Conéctese a su VPS
Desde su propio ordenador, conéctese con su cuenta SSH existente sin privilegios de root. Sustituya el usuario y la dirección de ejemplo:
ssh youruser@YOUR_VPS_IP
Si su servidor solo tiene una cuenta root, cree y verifique primero una cuenta aparte siguiendo las instrucciones de administración de su sistema operativo. No debería dar a un agente de IA una shell de root solo para empezar.
En Debian o Ubuntu, instale las herramientas de descarga y de proyecto que se usan en esta guía:
sudo apt update
sudo apt install ca-certificates curl git less
Estos comandos instalan paquetes del sistema; no actualizan todo el servidor ni modifican su firewall.
2. Instale Codex CLI
OpenAI documenta un instalador independiente para macOS y Linux, además de alternativas con npm y Homebrew. La vía independiente no requiere que instale antes Node.js y npm. Consulte la guía oficial de instalación de Codex CLI.
Descargue el instalador en su propio directorio para poder inspeccionarlo antes de ejecutarlo:
mkdir -p "$HOME/codex-setup"
curl -fsSL https://chatgpt.com/codex/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
Pulse q para salir de less. Tras revisar el script, ejecútelo con su usuario normal:
sh "$HOME/codex-setup/install.sh"
export PATH="$HOME/.local/bin:$PATH"
codex --version
codex --help
El instalador oficial usa por defecto ~/.local/bin y gestiona su paquete independiente dentro del directorio de usuario de Codex. Puede actualizar el archivo de inicio de su shell. Vuelva a abrir el terminal cuando se le indique; el export anterior también hace que la ubicación de instalación predeterminada esté disponible en la sesión actual.
Si falla la URL de descarga corta: el código fuente del instalador también está disponible en el repositorio oficial de OpenAI Codex. Descargue ese código, inspecciónelo y siga los mismos pasos de instalación:
curl -fsSL https://raw.githubusercontent.com/openai/codex/main/scripts/install/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
sh "$HOME/codex-setup/install.sh"
No lo sustituya por un script de un mirror desconocido. Si falla la propia descarga del binario, OpenAI documenta CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false para seleccionar GitHub Releases:
CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh "$HOME/codex-setup/install.sh"
Si ya gestiona una instalación compatible de Node.js/npm, la alternativa documentada con npm es npm install -g @openai/codex. Elija un único método de instalación en lugar de mezclar varios y preguntarse qué codex hay en su PATH.
3. Inicie sesión desde un servidor sin interfaz gráfica
Su VPS normalmente no tiene un navegador de escritorio. OpenAI recomienda la autenticación por código de dispositivo para esta situación:
codex login --device-auth
Siga el enlace que aparece en su terminal desde su propio ordenador o su móvil, inicie sesión e introduzca el código de un solo uso. Es posible que primero tenga que activar el inicio de sesión por código de dispositivo en los ajustes de seguridad de ChatGPT, o que el administrador de su espacio de trabajo lo permita. No envíe nunca ese código a otra persona.
Después, compruebe el método de autenticación:
codex login status
Si el inicio de sesión por código de dispositivo no está disponible, OpenAI también documenta un túnel SSH para el flujo normal de inicio de sesión en el navegador. Inicie esta conexión desde su ordenador:
ssh -L 1455:localhost:1455 youruser@YOUR_VPS_IP
Dentro de esa sesión SSH, ejecute codex login y abra su enlace de inicio de sesión en su navegador local. Esto reenvía la devolución de llamada de localhost sin exponer públicamente un puerto de autenticación. Consulte las instrucciones de OpenAI para el inicio de sesión sin interfaz gráfica si su entorno usa una configuración de callback diferente.
Usar una clave de API en su lugar
Si prefiere el acceso a la API por consumo, aprovisione de forma segura su propia clave de API de OpenAI como variable de entorno y páselo después por la entrada estándar:
printenv OPENAI_API_KEY | codex login --with-api-key
No pegue una clave de API literal en un comando que se guarde en el historial del shell. El uso de la API se factura a través de su cuenta de OpenAI Platform y no se descuenta de la factura de su hosting VPS. Trate las credenciales almacenadas de Codex como contraseñas y manténgalas fuera de los repositorios, las capturas de pantalla y los tickets de soporte. La guía oficial de autenticación explica ambos métodos.
4. Empiece con una tarea de solo lectura
Entre en un proyecto de pruebas cuyos archivos entienda. Si no tiene uno, basta con un directorio vacío para abrir la CLI e inspeccionar la interfaz:
mkdir -p "$HOME/codex-first-session"
cd "$HOME/codex-first-session"
codex --sandbox read-only --ask-for-approval on-request
En un repositorio de pruebas real, un primer prompt útil es:
Explain how this project starts. Read the relevant configuration and README files, identify the entry point, and list anything you cannot verify. Do not change files or install packages.
read-only restringe los comandos generados por el modelo mediante el sandbox configurado. on-request permite que el modelo solicite una aprobación adicional; no significa que cada comando requiera automáticamente una confirmación. Lea cualquier solicitud de escalada de privilegios antes de decidir si la permite.
Un prompt que diga “no cambies nada” no es por sí solo un límite de seguridad. Use una cuenta y un entorno de pruebas dedicados, limite los datos accesibles y compruebe los permisos que muestra su versión instalada. El acceso de solo lectura puede seguir exponiendo al servicio del modelo el contenido de los archivos legibles.
Consulte codex --help y la referencia de comandos de la CLI antes de copiar opciones de un tutorial antiguo. Evite saltarse el sandbox o las aprobaciones para esquivar un error de instalación.
5. Pase de una explicación a una tarea útil en el servidor
Un siguiente paso sensato es dar a Codex un alcance de diagnóstico pequeño y explícito. Prepare copias depuradas de los logs y la configuración pertinentes dentro de un directorio de pruebas y pregunte:
This demo site returns HTTP 502. Inspect only the supplied nginx configuration, application entry point and error log. Explain the cause and propose the smallest fix. Do not edit files, install packages or restart services.
Revise el cambio propuesto antes de aplicarlo usted mismo. En un servicio real, haga una copia de seguridad de la configuración, valídela con la comprobación propia del servicio y prepare un plan de reversión. Una explicación de una IA no es una prueba de que un cambio sea seguro para producción.
Lo que ocurrió en nuestra demostración
Configuramos mal a propósito un sitio de demostración en un VPS desechable. Nginx reenviaba las solicitudes al puerto 3000, mientras que la aplicación escuchaba en el 3001. El sitio devolvía un HTTP 502.
Codex inspeccionó en modo de solo lectura la configuración, la aplicación y el log de errores seleccionados. Identificó la discrepancia y propuso una corrección de una sola línea en aproximadamente 22 segundos, sin editar los archivos proporcionados. Nuestro operador de producción aplicó esa propuesta, comprobó la configuración de nginx, recargó el servicio y verificó una respuesta HTTP 200.
Fue una prueba controlada con un fallo conocido, introducido deliberadamente. No es un benchmark, ni una garantía de tiempo de reparación, ni una demostración de recuperación en producción sin supervisión.
Si algo no funciona
codex: command not found: vuelva a abrir el terminal, compruebecommand -v codexy confirme que el directorio del instalador está en su PATH.- La URL o la descarga del instalador está bloqueada: use el código fuente del repositorio oficial y la selección de GitHub Releases documentada más arriba. No desactive la verificación TLS.
- El inicio de sesión no puede abrir un navegador: use el inicio de sesión por código de dispositivo o el túnel SSH documentado. No publique puertos de autenticación de localhost.
- Ha alcanzado un límite de uso: compruebe la cuenta y el método de autenticación que muestra
codex login status. Instalar la CLI o comprar un VPS no elimina los límites de uso de OpenAI. - Errores del sandbox o de utilidades auxiliares: mantenga completa la instalación oficial y compruebe si su distribución admite los mecanismos de aislamiento necesarios. Un contenedor o un VPS restringido puede tener limitaciones adicionales. No lo resuelva ejecutando Codex como root ni desactivando sus salvaguardas.
Vea la demostración y pruébelo después en su propio VPS
Nuestro vídeo complementario sigue el ejemplo de diagnóstico desde el sitio roto hasta la respuesta verificada. Muestra en qué puede ayudarle a investigar el agente instalado; los comandos de instalación están en esta guía.
Demostración controlada en un VPS de pruebas desechable: Codex propone la corrección; nuestro operador la aplica y la verifica. Vea la demostración en YouTube.
Empiece con un proyecto de pruebas, mantenga estrechos los permisos del agente y verifique cada resultado. Si necesita un servidor para ese espacio de trabajo, descubra los planes de VPS Linux de SharpHeberg. Su cuenta de OpenAI y su uso siguen siendo independientes del servicio de hosting.