Codex

Codex CLI: qué es, cómo funciona y diferencias con App y Web

Descubre cómo funciona Codex CLI en una terminal local y en qué se diferencia de Codex App y Codex Web. Con configuración, comportamiento esperado y soluciones.

Codex CLI es el agente de programación local de OpenAI para la línea de comandos. Trabaja con el workspace seleccionado, lee y modifica archivos, ejecuta comandos y aplica la configuración del sandbox y de aprobación. A diferencia de Codex App, su interfaz principal es la terminal; a diferencia de Codex Web, se ejecuta localmente y no en un navegador o runtime remoto.

Respuesta breve

Resulta útil cuando quieres que un agente ayude con cambios de código, revisión, corrección de pruebas, scripts y tareas de ingeniería de varios pasos dentro de un repositorio local.

Codex CLI se diferencia de una conversación normal de ChatGPT. No se limita a sugerir código. Trabaja con el directorio actual, las instrucciones del proyecto, los resultados de las herramientas y los permisos de ejecución locales.

Comparación rápida de CLI, App y Web

Opción	Dónde se ejecuta	Cuándo elegirla
Codex CLI	Terminal y workspace locales	Necesitas comandos, archivos y configuración en `config.toml`
Codex App	Aplicación de escritorio	Necesitas sesiones gráficas, plugins o Remote Control
Codex Web	Navegador o entorno remoto	La tarea debe ejecutarse en la nube o a distancia

Consulta Codex CLI frente a Codex App y Codex Web para una comparación detallada.

Cuándo es importante

Instalas @openai/codex por primera vez
Comparas Codex CLI, Codex App y Codex Web
Quieres que un agente edite archivos de un proyecto local
Necesitas configurar un proveedor de API, una Base URL o un modelo personalizados
Quieres comprender el sandbox, las aprobaciones y AGENTS.md

Conceptos básicos

Concepto	Significado
Codex CLI	Agente de programación Codex que se ejecuta en la terminal local
Workspace	Directorio que Codex puede leer, buscar y modificar
`config.toml`	Archivo de configuración local de Codex para modelos, proveedores, sandbox, aprobaciones y otros comportamientos
`AGENTS.md`	Archivo de instrucciones del proyecto que comunica a Codex las reglas del repositorio y las preferencias de colaboración
Sandbox	Límite de seguridad local para el acceso al sistema de archivos, la red y los comandos
Aprobación	Política que determina qué acciones necesitan confirmación

Flujo recomendado

Inicia Codex CLI dentro del directorio del proyecto que quieres modificar.
Pídele que inspeccione los archivos o instrucciones relevantes antes de realizar cambios amplios.
Para tareas complejas, solicita un plan antes de permitir que modifique archivos.
Elige la configuración del sandbox y de aprobación según el riesgo de la tarea.
Guarda las reglas permanentes del proyecto en AGENTS.md y los requisitos puntuales en la conversación actual.

Si utilizas un proveedor de API de terceros, revisa model_provider, base_url, wire_api y los campos del modelo en config.toml. Codex y otras herramientas compatibles con OpenAI suelen utilizar un endpoint compatible con OpenAI, que en esta documentación es https://bettertoken.ai/v1.

Errores habituales

Tratar Codex CLI como un asistente que solo responde por chat.
Suponer que Codex CLI, Codex App y Codex Web se ejecutan en el mismo entorno.
Cambiar solo model sin configurar el proveedor y la Base URL correspondientes.
Reducir las restricciones del sandbox y las aprobaciones sin pruebas, revisión ni límites para los comandos.
Mezclar Base URL compatibles con OpenAI y con Anthropic.

Cómo interviene BetterToken

Al utilizar un proveedor personalizado compatible con OpenAI, BetterToken puede actuar como capa de API del modelo para Codex CLI. Gestiona la API Key, la Base URL, el enrutamiento de modelos, el saldo y los registros de uso.

BetterToken no sustituye el sandbox local de Codex CLI, las aprobaciones, AGENTS.md ni la política de ejecución de comandos.

Para el acceso general a Codex API y sus casos de uso, consulta la página de Codex API de BetterToken. Esta FAQ se centra en Codex CLI y su flujo local.