¿Alguna vez has deseado poder aprovechar el poder de la última herramienta de codificación de OpenAI sin la molestia de iniciar una distribución de Linux o depender de la nube? Pues bien, prepárate, porque ejecutar Codex en Windows ahora es mucho más fácil con WSL (Subsistema de Windows para Linux). Codex en Windows a través de WSL cambia las reglas del juego para los desarrolladores que quieren aprovechar el Codex CLI, el agente de codificación ligero y de código abierto de OpenAI que reside directamente en tu terminal. Anunciado en 2025, el Codex CLI lleva la inteligencia de modelos como GPT-5 a tu configuración local, ayudándote a generar código, depurar errores e incluso ejecutar comandos de forma segura. Ya sea que estés creando aplicaciones, ajustando scripts o simplemente explorando Codex en WSL, esta configuración te permite hacerlo todo sin salir de la comodidad de tu entorno Windows. En esta guía conversacional, te guiaremos a través de todo, desde la configuración inicial de WSL hasta la puesta en marcha del Codex CLI y su funcionamiento. Al final, estarás chateando con Codex como un viejo amigo, todo mientras optimizas tu flujo de trabajo para esa dulce experiencia de Codex en Windows. ¡Vamos a sumergirnos!
¿Quieres una plataforma integrada y todo en uno para que tu equipo de desarrolladores trabaje en conjunto con la máxima productividad?
¡Apidog satisface todas tus demandas y reemplaza a Postman a un precio mucho más asequible!
¿Qué es Codex CLI y por qué ejecutarlo en WSL?
Antes de meternos en faena, hablemos de qué es realmente Codex. El Codex CLI es la herramienta de línea de comandos de código abierto de OpenAI que actúa como un agente de codificación directamente desde tu terminal. Está diseñado para comprender solicitudes en lenguaje natural, leer tu base de código, sugerir ediciones, ejecutar comandos e incluso manejar entradas multimodales como capturas de pantalla. Impulsado por modelos avanzados (piensa en GPT-5), se ejecuta localmente, lo que significa que tu código permanece privado a menos que decidas compartirlo. Se acabaron los cambios entre editores o servicios en la nube: Codex se integra perfectamente en tu flujo de desarrollo.
Ahora, ¿por qué molestarse con WSL para Codex en Windows? El soporte de Windows para Codex CLI sigue siendo experimental a partir de septiembre de 2025, por lo que las instalaciones nativas pueden presentar errores con el sandboxing y los permisos. WSL, la capa de Linux de Microsoft en Windows, proporciona un entorno estable, similar a Linux, donde Codex en WSL puede prosperar. Es perfecto para herramientas basadas en Node.js como esta, evitando las peculiaridades de las rutas y shells de Windows. Además, con WSL, obtienes lo mejor de ambos mundos: la potencia de Linux para codificar y la familiaridad de Windows para todo lo demás. Si te gusta la codificación intuitiva o el desarrollo agéntico, Codex en WSL es tu billete a la productividad sin dolores de cabeza.
Primeros pasos con WSL en Windows
Muy bien, empecemos configurando WSL, la base para una navegación fluida de Codex en Windows. WSL te permite ejecutar una distribución completa de Linux directamente dentro de Windows, con acceso a la terminal, sin necesidad de una máquina virtual. A partir del 18 de septiembre de 2025, la última versión es WSL 2, que utiliza una VM ligera para un mejor rendimiento.
Aquí te explicamos cómo empezar:
Habilitar características de Windows: Abre el menú Inicio de Windows y busca "Activar o desactivar las características de Windows" (o simplemente escribe "características"). En el cuadro de diálogo que aparece, desplázate hacia abajo y marca las casillas de "Plataforma de máquina virtual" y "Subsistema de Windows para Linux". Estas son cruciales para el soporte de WSL 2; sin ellas, te quedarás atascado en el modo heredado. Haz clic en Aceptar y deja que Windows instale los componentes. Es posible que necesites reiniciar tu PC.
Verificar el estado de WSL: Abre una nueva ventana de Símbolo del sistema o PowerShell (busca "cmd" o "powershell" en Inicio). Escribe wsl --status y presiona Enter. Si todo está bien, verás algo como "Versión predeterminada: 2". Si dice Versión 1 o da errores, no te preocupes, procede al siguiente paso.
Actualizar WSL: Todavía en tu terminal, ejecuta wsl --update. Esto descarga el último kernel y las correcciones para WSL 2. Puede tardar un minuto, pero una vez hecho, ejecuta wsl --status de nuevo para confirmar. ¡Voilá! WSL está listo y preparado. Consejo profesional: Si estás en Windows 11, es aún más fluido con soporte integrado para aplicaciones GUI, pero Windows 10 también funciona bien.
Con WSL en funcionamiento, estás listo para instalar una distribución de Linux y cerrar la brecha hacia Codex en WSL.
Instalando una distribución de Linux en WSL
Ahora que WSL está habilitado, es hora de traer una versión de Linux; piensa en esto como la instalación del sistema operativo donde residirá Codex en WSL. Microsoft Store lo hace muy sencillo, sin necesidad de unidades USB.
Para esta guía, optaremos por Ubuntu, una opción popular entre los desarrolladores debido a su estabilidad y su vasto ecosistema de paquetes. Pero siéntete libre de elegir Kali para pruebas de seguridad o Debian para el minimalismo.
Dirígete a Microsoft Store: Abre la aplicación Microsoft Store (búscala en el menú Inicio). En la barra de búsqueda, escribe "Ubuntu" o tu distribución preferida como "Kali Linux". Verás opciones; elige la última versión de Ubuntu (por ejemplo, 22.04 LTS para mayor fiabilidad).
Instalar y Ejecutar: Haz clic en "Instalar" y espera a que se descargue (son unos 500 MB). Una vez hecho, haz clic en "Abrir" o inícialo desde el menú Inicio. Aparecerá una ventana de terminal y Ubuntu se inicializará; esto puede tardar unos minutos mientras configura el sistema de archivos.
Configurar tu usuario: Se te pedirá que crees un nombre de usuario y una contraseña para tu usuario de Ubuntu. Mantenlo simple pero seguro (la contraseña no se mostrará mientras escribes). Esta será tu identidad de Linux para ejecutar comandos, incluido el Codex CLI.
Probar el entorno: En la terminal de Ubuntu, intenta ls para listar archivos (debería mostrar tu directorio de inicio). Si funciona, ¡felicidades, tu distribución de Linux está instalada en WSL! Ejecuta uname -a para verificar que se está ejecutando bajo WSL 2. Todo está ahora preparado para Node.js y Codex en WSL.
Si encuentras problemas como "WSL no encontrado", verifica que las características estén habilitadas y reinicia. Para ajustes avanzados, edita /etc/wsl.conf dentro de Ubuntu para establecer los valores predeterminados.
Instalando Node.js en WSL
Codex CLI es un paquete npm, por lo que necesitamos Node.js (que incluye npm) instalado en tu entorno WSL. Esto es sencillo en Ubuntu, pero hagámoslo paso a paso para evitar problemas.
Actualizar paquetes: Primero, actualiza tus repositorios: sudo apt update && sudo apt upgrade -y. Introduce tu contraseña cuando se te solicite; esto mantiene a Ubuntu actualizado.
Instalar curl: Codex en WSL depende de Node a través de NVM (Node Version Manager), que necesita curl. Ejecuta sudo apt install curl -y.
Instalar NVM: NVM facilita la gestión de versiones de Node. Pega esto: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash. (Nota: Verifica la última versión en el GitHub de NVM si es necesario). Esto descarga y ejecuta el instalador.
Activar NVM: Cierra y vuelve a abrir tu terminal de Ubuntu, o ejecuta source ~/.bashrc para cargar NVM. Verifica con command -v nvm; debería mostrar "nvm" si tuvo éxito.
Instalar Node.js: Usa NVM para obtener la versión LTS: nvm install --lts. Esto instala Node y npm. Para la última versión (Node 22+ recomendado para Codex CLI), ejecuta nvm install node. Cambia de versión con nvm use node si es necesario.
Verificar instalación: Ejecuta node --version (debería mostrar v20+ o la versión que hayas instalado) y npm --version. Si ambos funcionan, ¡Node está listo en WSL! Esta configuración asegura que Codex en Windows se sienta nativo, sin conflictos con Node en Windows.
¿Solución de problemas? Si no se encuentra NVM, revisa tu archivo .bashrc en busca de las líneas de exportación añadidas por el instalador.
Instalación y uso de Codex CLI en WSL
El momento que estabas esperando: Dar vida a Codex en WSL. Con Node configurado, instalar el Codex CLI es una sola línea de comando, pero hagámoslo un proyecto de demostración para divertirnos.
Crear una carpeta de demostración: En tu directorio de inicio de Ubuntu (/home/yourusername), ejecuta mkdir codex-cli-demo (nómbrala como quieras). Luego, cd codex-cli-demo para entrar en ella. Esto mantiene las cosas organizadas para probar Codex en WSL.
Instalar globalmente: Ejecuta `npm install -g @openai/codex`. Esto descarga la última versión de npm; espera que tarde un minuto mientras descarga las dependencias. (A partir de septiembre de 2025, la versión 0.25.0+ es estable).
Ejecutar Codex: Simplemente escribe `codex` en la terminal. El Codex CLI lanzará una interfaz de usuario interactiva. Para la configuración inicial, solicitará autenticación.
Autenticar: Tienes opciones: iniciar sesión con tu cuenta de ChatGPT (recomendado para usuarios Plus/Pro) o usar una clave API. Para esta demostración, elige ChatGPT: te proporcionará un enlace. En WSL, los navegadores se abrirán automáticamente a menos que se indique lo contrario (usa el enlace proporcionado). Instala primero las utilidades de WSL: De vuelta en PowerShell (lado de Windows), ejecuta `wsl --install -d Ubuntu` si no lo has hecho, luego en Ubuntu: `sudo apt install wslu -y`. Ahora, cuando ejecutes `codex`, el enlace se abrirá en tu navegador de Windows. Inicia sesión en ChatGPT (necesitarás un plan de pago para acceder a GPT-5; los niveles gratuitos son limitados). ¡Autoriza, y listo!
Uso básico: Una vez en ejecución, chatea con Codex como: "Crea un script simple de Python para 'hola mundo'". Lee tu directorio, genera código e incluso lo ejecuta si se aprueba. Usa modos como --suggest para ideas o --full-auto para manos libres (úsalo con precaución). Verifica con `codex --version`.
Para la autenticación con clave API: Exporta export OPENAI_API_KEY=yourkey en .bashrc, luego ejecuta codex. Los planes de pago desbloquean modelos premium (gpt-5), así que actualiza en openai.com si es necesario.
Consejos y solución de problemas para Codex en WSL
Ejecutar Codex en WSL es en su mayor parte sencillo, pero aquí tienes algunos consejos profesionales:
- Integración con Git: Inicializa un repositorio (
git init) en tu carpeta de demostración; **Codex CLI** advierte si no lo haces por seguridad. - Modos y banderas: Prueba
codex --auto-editpara ediciones interactivas o adjunta imágenes con--image ruta/a/captura_de_pantalla.png. - Problemas comunes: Si npm falla, ejecuta
sudo apt install build-essential -y. Para enlaces del navegador, asegúrate de que WSLU esté instalado. Actualiza Codex connpm update -g @openai/codex. - Rendimiento: **WSL** 2 usa más RAM, así que asigna más a través de
.wslconfigsi es necesario. Para tareas pesadas, combínalo con la extensión Remote-WSL de VS Code o prueba con Docker Desktop.
Explora el repositorio de GitHub (github.com/openai/codex) para configuraciones en ~/.codex/config.toml; ajusta modelos o comportamientos.
Conclusión: ¿Por qué elegir Codex en Windows con WSL?
Adoptar Codex en WSL significa desbloquear la magia de la codificación con IA en Windows sin compromisos. Es local, privado y potente, perfecto para desarrolladores de Windows cansados de la envidia de macOS. Con WSL, también estarás preparado para el futuro con las herramientas de Linux. ¡Sumérgete, experimenta y observa cómo Codex transforma tu terminal en una potencia de codificación!
