Codex CLI vs Codex App: diferencias y cuál elegir
Comparación práctica de CLI y App por entorno, tareas paralelas, revisión de diff, autenticación del proveedor, validación y errores comunes.
Índice
Respuesta rápida: elige Codex CLI si trabajas en terminal, por SSH, en contenedores o con scripts basados en codex exec. La aplicación de escritorio resulta más cómoda para varias tareas paralelas, worktrees integrados y revisión visual del diff. Son dos interfaces de Codex, no modelos distintos. Con un proveedor personalizado, el cliente también determina cómo se configura la autenticación.
Los detalles se verificaron el 11 de agosto de 2026 con la documentación actual de OpenAI y BetterToken.
Comparación directa
| Criterio | Codex CLI | Aplicación de escritorio |
|---|---|---|
| Interfaz | Terminal y TUI | Aplicación gráfica |
| Entorno ideal | Shell local, SSH, contenedor o servidor remoto | Ordenador local, proyectos y threads |
| Trabajo paralelo | Subagents integrados con /agent, procesos separados y codex exec | Varios threads, worktrees y gestión visual de resultados |
| Revisión | Diff en terminal y comandos Git | Diff visual, comentarios y apertura en el editor |
| Tareas recurrentes | Scripts de shell y scheduler externo | Automations con cola de resultados |
OpenAI indica que la App puede recuperar el historial y la configuración de CLI y de la extensión IDE. Aun así, cada proceso mantiene su entorno, necesita reiniciarse y debe verificarse por separado.
Proveedor personalizado: CLI, App y VS Code
BetterToken es un servicio API de pago por uso para herramientas compatibles con OpenAI. No sustituye al cliente Codex, a una cuenta ChatGPT ni a la aplicación. La configuración actual usa un custom provider, la Base URL `https://www.bettertoken.ai/v1%60?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-050&utm_content=codex-cli-ili-codex-app y el protocolo Responses.
Primero identifica el cliente:
- El comando
codexen Terminal es CLI. - Una tarea en la aplicación de escritorio es App.
- El panel Codex dentro de VS Code es Extension.
CLI y App comparten ~/.codex/config.toml (en Windows, %USERPROFILE%\.codex\config.toml). Para estos clientes, la clave se entrega mediante BETTERTOKEN_API_KEY y env_key, sin exigir la autenticación oficial de OpenAI al custom provider. La extensión VS Code conserva el inicio de sesión oficial y usa una ruta de autenticación distinta.
No dupliques [model_providers.custom] en el mismo TOML. Consulta la guía de CLI y App o la guía específica de VS Code.
La App y la extensión IDE pueden no heredar variables definidas solo en el perfil del shell. Si falta BETTERTOKEN_API_KEY, colócala en ~/.codex/.env según la guía actual de OpenAI, reinicia completamente y crea una sesión nueva.
Cómo comprobar la configuración
- Cierra por completo el proceso anterior de Codex.
- Abre una terminal nueva o reinicia la App; en VS Code ejecuta
Developer: Reload Window. - Crea una sesión nueva y envía una tarea corta.
- En CLI, abre
/status; en cualquier cliente, localiza la petición de prueba por hora y modelo en el Dashboard de BetterToken.
Una respuesta sin 401, 403 o model not found solo demuestra funcionamiento básico. /status o una petición coincidente en el Dashboard demuestra qué provider se usó.
Qué elegir según el trabajo
Usa CLI para terminal, máquinas remotas, contenedores, comandos reproducibles y scripts. Los subagents integrados y /agent permiten trabajo paralelo; todavía debes revisar directorios y cambios finales.
Usa la App cuando una corrección, una función y una revisión necesiten threads separados; cuando los worktrees integrados reduzcan conflictos; o cuando el diff visual facilite la aprobación.
Usa ambas si CLI ejecuta tareas remotas o automatizadas y la App concentra la gestión y la revisión. Antes de cada ejecución, revisa directorio, permisos, proveedor y autenticación.
Errores frecuentes
- Funciona en CLI pero no en VS Code: las credenciales se configuran en campos distintos. Sigue la guía de la extensión, recarga la ventana y abre una sesión nueva.
- Codex vuelve a pedir el login oficial: en CLI/App confirma que
BETTERTOKEN_API_KEYllega al proceso nuevo. En VS Code se conserva el login oficial. - Proveedor no encontrado:
model_provider = "custom"debe coincidir con[model_providers.custom]. Elimina secciones duplicadas y compruebawire_api = "responses". - El archivo cambió pero el cliente no: si la App no ve la variable del shell, usa
~/.codex/.env, reinicia y comprueba Model ID, clave, Base URL y autenticación.
Recomendación final
Elige CLI para terminal, SSH y scripts; elige la App para threads, worktrees y revisión visual. El 11 de agosto de 2026, la nueva App de ChatGPT con Codex está disponible para macOS y Windows. Los usuarios nuevos deben descargarla desde chatgpt.com/download.
