Superficies: Aplicación de escritorio, nube, IDE y CLI
En esta página
Lección reescrita el 3 de noviembre de 2026 basándose en las páginas de Codex CLI, Extensión de IDE de Codex y Codex Cloud, así como en la referencia de comandos de Codex. La versión anterior instruía a los usuarios para instalar un paquete npm inexistente (
@openai/codex-cli) y citaba una bandera--interactiveque no existe; las opciones se han verificado frente a la CLI 0.166.0. Fuentes: Codex CLI · Extensión de IDE de Codex · Codex Cloud.
Un agente, múltiples superficies
Codex no es una única aplicación; es un agente accesible a través de múltiples superficies, cada una adaptada a un contexto de trabajo específico. El agente es el mismo; lo que cambia es dónde trabaja (en tu máquina local o en la nube), el contexto al que tiene acceso y cómo realizas el seguimiento de la ejecución. Elegir la superficie adecuada suele marcar más la diferencia en tu flujo de trabajo diario que elegir un modelo concreto.
La aplicación de escritorio de ChatGPT
La aplicación de escritorio de ChatGPT para macOS, Windows y Linux es el punto de entrada más completo. Inicia sesión con tu cuenta de ChatGPT, abre una carpeta o proyecto y selecciona Codex en el menú de ChatGPT para desarrollo de software. El agente trabaja entonces sobre los archivos de esa carpeta utilizando tus herramientas de desarrollo locales. Esta es la superficie indicada para sesiones largas y proyectos locales. También es desde donde puedes lanzar trabajos en la nube, igual que harías desde la interfaz web.
Codex Cloud
Para tareas que necesitan ejecutarse de forma remota, Codex Cloud ejecuta el trabajo en un entorno que configuras una sola vez. Desde la web o la aplicación de escritorio, elige Trabajar en › Nube, luego Seleccionar entorno y Crear entorno. Selecciona tus repositorios de GitHub; Codex inspecciona el proyecto, instala dependencias y herramientas, prueba el flujo de trabajo y te solicita cualquier permiso de acceso faltante. Una vez publicado el entorno, cada tarea obtiene su propio espacio de trabajo y sigue ejecutándose aunque tu ordenador entre en modo de suspensión. Revisas los archivos modificados y los resultados de las pruebas, solicitas correcciones y, finalmente, haces un commit o abres una pull request, todo ello desde la web, el móvil o la aplicación de escritorio.
Esta es la superficie para trabajos de larga duración que lanzas antes de una reunión: una migración de framework, una refactorización extensa o múltiples tareas paralelas sobre el mismo entorno.
La extensión para el IDE
La extensión de Codex se instala en Visual Studio Code y editores compatibles como Cursor, Windsurf y VS Code Insiders. Xcode y los IDE de JetBrains ofrecen sus propias integraciones nativas de Codex. Una vez conectada, abre Codex mediante su icono (o en VS Code y derivados, desde la paleta de comandos: Codex: Open Codex Sidebar; en JetBrains, abre AI Chat y selecciona Codex).
Su ventaja es el contexto inmediato: los archivos abiertos, las selecciones actuales y las conversaciones recientes se alimentan directamente en tu prompt, y los cambios aparecen lado a lado con tu código. Esta es la superficie para tareas diarias: generar pruebas para la función actual, explicar un bloque de código heredado o corregir un error que acaba de mostrar el terminal integrado. Cuando una tarea crece demasiado, puedes delegarla en la nube desde el editor y volver a los resultados más tarde. La documentación recomienda crear puntos de control de Git antes y después de una tarea para poder revertir si fuera necesario.
La CLI
La CLI está dirigida a desarrolladores que viven en el terminal. La documentación ofrece cuatro métodos de instalación:
# macOS y Linux: instalador independiente
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# npm
npm install -g @openai/codex
# Homebrew
brew install --cask codex
En Windows, ejecuta el instalador independiente desde PowerShell: powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex".
Ejecutar codex sin argumentos en una carpeta de proyecto abre la interfaz de terminal interactiva. En el primer lanzamiento, te pedirá que inicies sesión con tu cuenta de ChatGPT u otro método.
# Abrir una sesión interactiva
codex
# Abrir una sesión con un prompt inicial
codex "Add email validation to the signup form"
# Seleccionar un modelo
codex --model gpt-6.1-sol "Refactor the payment module"
Su verdadero valor brilla cuando vas más allá del uso manual. codex exec (alias codex e) ejecuta una tarea sin interacción, lo que la hace ideal para scripts y pipelines. Cuando se redirige stdin y también se proporciona un prompt, codex exec añade el contenido recibido al prompt dentro de un bloque <stdin>. Esto permite encadenar comandos que producen listas de archivos.
# Buscar archivos sin pruebas y pedir a Codex que las genere
find src/ -name "*.ts" -not -name "*.test.ts" | codex exec "Generate missing tests for these files"
¿Qué superficie deberías elegir?
| Situación | Superficie recomendada | Por qué |
|---|---|---|
| Migración de framework | Codex Cloud | Tarea de larga duración, entorno preparado, trabajo paralelo |
| Refactorización de un archivo abierto | Extensión para el IDE | Contexto local inmediato, revisión lado a lado |
| Proyecto local, sesión larga | Aplicación de escritorio | Carpeta abierta, herramientas de desarrollo |
| Script de automatización | CLI (codex exec) | Integración en pipeline |
| Generación rápida de pruebas | Extensión para el IDE | Los resultados aparecen en el editor |
En la práctica, la mayoría de los desarrolladores combinan estas superficies en una sola semana. Las sesiones de inicio de sesión se comparten: la CLI y la extensión reutilizan las mismas credenciales en caché. Además, todas las superficies leen el mismo archivo AGENTS.md, el archivo de instrucciones que se cubre en la siguiente lección.
Puntos clave
- Codex es accesible a través de la aplicación de escritorio de ChatGPT, Codex Cloud, la extensión para el IDE y la CLI
- La aplicación de escritorio y la extensión funcionan localmente; Codex Cloud ejecuta tareas en entornos publicados
- La extensión se instala en VS Code y derivados; Xcode y JetBrains tienen sus propias integraciones
- Instala la CLI mediante el instalador independiente,
npm install -g @openai/codexo Homebrew; usacodex execpara automatización - Todas las superficies leen el mismo archivo
AGENTS.md