Skip to content

Codex Uso: el agente de codificación local de OpenAI ​

En la lección anterior llevamos Claude Code hasta el punto de «usarlo con soltura»; en esta lección, de 12 minutos, instalamos igualmente hasta que quede a mano la herramienta equivalente del bando de OpenAI, Codex: instalación, inicio de sesión con cuenta de ChatGPT, asignar la primera tarea, vigilar sus permisos, cambiar de modelo y revisar los cambios al cerrar. Este tutorial de Codex se centra en la CLI como forma principal: la posición oficial es «un agente de codificación que se ejecuta localmente en tu ordenador»; la extensión de IDE, la aplicación de escritorio y la versión web, tres formas que comparten la misma cuenta, se muestran juntas al final. (Momento de verificación de datos: 2026-11-05; los comandos y funciones pueden cambiar con las versiones, consulta la documentación oficial como referencia.)

Qué podrás hacer al terminar ​

  • Instalar la Codex CLI en macOS, Linux o Windows, e iniciar sesión con tu cuenta de ChatGPT
  • Asignar tareas en el directorio del proyecto: pedirle que explique el proyecto, haga cambios pequeños o corrija bugs: él mismo lee los archivos y ejecuta comandos en el sandbox
  • Vigilarle las manos con /permissions: conocer los tres niveles de sandbox y la política de aprobación, preguntando antes de salirse de los límites
  • Usa /model para cambiar de modelo (como el gpt-6.2-sol predeterminado) y /status para consultar el estado de la sesión y el uso
  • Revisar cambios con /diff y /review, comprimir conversaciones largas con /compact, retomar sesiones antiguas con codex resume

Tu situación actual ​

  • Hablar de código en la versión web de ChatGPT: hay que copiar cada archivo, pegarlo de vuelta tras modificarlo, un ir y venir que cansa las manos
  • Instalaste Codex pero te quedaste atascado en el inicio de sesión: cuenta de ChatGPT y API key son dos caminos, no sabes cuál elegir ni si tu suscripción incluye o no Codex
  • Se detiene a cada rato para preguntar «¿quieres aprobar este comando?», lo cual resulta exasperante; pero si le das libertad total, temes que estropee el proyecto

Cuándo usar esta técnica ​

Cuando necesitas:

  • Que los modelos de OpenAI lean tu proyecto, modifiquen archivos y ejecuten comandos directamente en tu ordenador: los cambios se quedan en local, listos para consultar o revertir en cualquier momento
  • Usar tu suscripción existente de ChatGPT (Plus / Pro / Business / Edu / Enterprise) para impulsar el agente de codificación, sin comprar una API aparte
  • Con límites claros: el sandbox encierra los archivos y redes a los que puede acceder, y se requiere aprobación para salirse de los límites

Y además no quieres:

  • Ir copiando y pegando código y errores de un lado a otro en el cuadro de chat web
  • Darle a la IA control total sobre tu ordenador
  • Volver a aprender un conjunto de conceptos al cambiar de herramienta: el enfoque de la lección anterior, «explicar una tarea con claridad como al asignar trabajo», se aplica aquí tal cual

🎒 Preparativos antes de empezar ​

  • Haber leído la guía de uso diario, y saber que esta página trata sobre Codex, una de las cuatro herramientas (bando de OpenAI)
  • Una cuenta de ChatGPT: la recomendación oficial es iniciar sesión con una suscripción Plus / Pro / Business / Edu / Enterprise; los precios y lo incluido en cada nivel están en la comparativa de precios (las capacidades del nivel gratuito se rigen por la página oficial)
  • Un directorio de proyecto para practicar, idealmente un repositorio git: la recomendación oficial es crear puntos de control (checkpoint) de Git antes y después de la tarea, para facilitar la reversión completa
  • 12 minutos de tiempo sin interrupciones

💡 La lección anterior no es un requisito previo

Esta lección solo requiere que hayas leído la guía de uso diario. El uso de Claude Code y esta lección son independientes entre sí, pero el enfoque de «asignar tareas» es común, y leerlos en paralelo ayuda a captar la idea.

Idea central ​

La posición oficial de la Codex CLI en una frase: un agente de codificación de OpenAI que se ejecuta localmente en tu ordenador (a coding agent from OpenAI that runs locally on your computer). Trabaja sobre tu repositorio local: examina archivos, hace modificaciones y ejecuta las herramientas ya instaladas en tu máquina; no es un cuadro de chat donde «pegas código y te da respuestas», sino un agente donde «tú asignas la tarea y él la completa».

La diferencia fundamental con la versión web de ChatGPT:

ChatGPT webCodex CLI
El código entra en el contextoLo copias y pegas manualmenteÉl mismo lee el repositorio local
Modificar códigoTe da fragmentos y los pegas tú mismoEdita los archivos directamente, /diff para revisar
VerificaciónTú mismo ejecutas los comandosÉl ejecuta pruebas en el sandbox, lee los errores y se corrige solo
FacturaciónCuota de chatEl uso de Codex incluido en la suscripción de ChatGPT, o API key por consumo

Cuatro formas, una cuenta. La CLI es el hilo principal de esta lección; las otras tres formas usan la misma cuenta de ChatGPT (las tareas en la nube requieren obligatoriamente iniciar sesión con cuenta de ChatGPT; la CLI y la extensión de IDE comparten además la misma credencial de inicio de sesión local):

FormaPosición en una frase
CLI de terminal (hilo principal de esta lección)Ejecutar codex en el directorio del proyecto: lee código, modifica archivos, ejecuta comandos, sin salir de la terminal
Extensión IDEBarra lateral de VS Code, Cursor y Windsurf (extensión openai.chatgpt; Xcode y JetBrains tienen integraciones aparte)
App de escritoriocodex app Lanza el escritorio de ChatGPT desde la terminal (macOS/Windows), elige Codex dentro de la app y empieza a chatear
Codex WebAbre chatgpt.com/codex en el navegador: agente en la nube, las tareas corren en la nube y siguen avanzando aunque tu computadora esté dormida

El modelo de seguridad se resume en una frase: sandbox con límites + aprobación como control. El sandbox decide qué archivos y redes puede tocar; la política de aprobación decide si debe detenerse a preguntarte antes de salirse de los límites. Para el día a día empieza con Ask for approval; la combinación de baja fricción que recomienda el oficial es --sandbox workspace-write --ask-for-approval on-request: trabaja con libertad dentro del workspace y reporta antes de salirse.

¿Cómo elegir y combinar Claude Code de la lección anterior? Ambos siguen la misma idea de «agente local», y la diferencia está sobre todo en el modelo y la suscripción de respaldo: Claude Code usa modelos Claude + suscripción de Anthropic, y Codex usa modelos GPT + suscripción de ChatGPT. Usarlos juntos es totalmente viable: ambos tienen mecanismos de documento de proyecto (ver AGENTS.md y CLAUDE.md), y el /import de Codex incluso puede migrar directamente la configuración y el historial de chat de Claude Code. La tabla completa de costos está en comparación de precios.

Hazlo conmigo ​

Paso 1: instala la CLI de Codex ​

Por qué: Codex CLI es una herramienta de línea de comandos que se instala por separado; primero instálala para que exista todo lo demás. El script oficial de instalación lo resuelve con un solo comando.

Método A: script oficial de instalación (recomendado) ​

Usuarios de macOS / Linux:

bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh

Usuarios de Windows (ejecuta en una ventana nueva de PowerShell):

powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Método B: gestor de paquetes ​

bash
npm install -g @openai/codex
bash
brew install --cask codex

Verifica después de instalar:

bash
codex --version

Deberías ver: la terminal imprime el número de versión.

Para actualizar más adelante: vuelve a ejecutar el comando de instalación del método A; los usuarios de brew usan brew upgrade --cask codex; la CLI también incluye codex update que se autoverifica y actualiza.

  • Pequeña verificación: codex --version imprime el número de versión

Paso 2: inicia sesión en Codex con tu cuenta de ChatGPT ​

Por qué: el oficial recomienda iniciar sesión con una cuenta de ChatGPT: usas directamente la cuota de Codex incluida en las suscripciones Plus / Pro / Business / Edu / Enterprise, sin comprar una API key aparte.

bash
cd /path/to/your/project
codex

La primera ejecución te pedirá elegir el método de inicio de sesión; elige Sign in with ChatGPT: el navegador abre la página de inicio de sesión de OpenAI y, tras iniciar sesión, las credenciales vuelven automáticamente a la terminal.

Comprueba el estado después de iniciar sesión:

bash
codex login status

Deberías ver: la información de la cuenta con sesión iniciada. Cuando existen credenciales, el código de salida de este comando es 0, así que también sirve para verificar el estado de sesión en scripts.

💡 Otra vía: API key con pago por uso

Si no tienes suscripción, hay una alternativa: inicia sesión con una API key de OpenAI, facturada según la tarifa estándar de API (el README oficial advierte que esta vía requiere configuración adicional):

bash
printenv OPENAI_API_KEY | codex login --with-api-key

Ten claras dos cosas: la vía de API key no incluye las funciones en la nube (revisión automática de código en GitHub, integración con Slack, etc.), y la disponibilidad de modelos depende de tu key; para usuarios con suscripción, el inicio de sesión con ChatGPT sigue siendo lo recomendado para el día a día.

  • Pequeña verificación: codex login status muestra la sesión iniciada

Paso 3: Codex núcleo del tutorial: ¿cómo asignar tareas? Explica una cosa con claridad, como al coordinar a un colega ​

Por qué: igual que con Claude Code de la lección anterior, la calidad del resultado del agente depende de si te explicaste bien. La primera tarea que sugiere el oficial está bien elegida: pídele primero que te hable del proyecto; así practicas y, con su respuesta, puedes ver cuánto entiende del proyecto.

text
Tell me about this project

Cómo plantear las tareas cotidianas más habituales:

TareaQué dices
Entender el proyectoTell me about this project (ejemplo oficial)
Hacer un cambio pequeñoDeja claro qué archivo cambiar, a qué cambiarlo y qué cuenta como hecho bien
Corregir un bugPega el mensaje de error tal cual y explica cómo se provocó
Explicar un fragmento de código@ cita la ruta del archivo para que hable en torno a ese archivo

Deberías ver: Codex lee los archivos por su cuenta, enumera la estructura del proyecto o edita directamente; cuando necesita verificar, ejecuta comandos en el sandbox, observa la salida y continúa.

Recomendación oficial: crea un checkpoint de Git antes y después de cada tarea, para poder revertir todo si algo sale mal.

  • Pequeña verificación: asigné una tarea concreta y vi a Codex leer archivos, modificar archivos o ejecutar comandos por sí mismo

Paso 4: vigílale las manos: configura permisos y sandbox con /permissions ​

Por qué: el agente ejecuta comandos en tu computadora, así que los límites deben quedar claros. Codex usa dos compuertas: el sandbox decide qué archivos y redes puede tocar, y la aprobación decide si debe preguntarte antes de salirse de los límites.

Escribe en la sesión:

text
/permissions

Deberías ver: aparece el selector de permisos, donde puedes cambiar el preset de aprobación; por ejemplo, Auto para dejarlo correr, Read Only para control estricto de solo lectura.

Tres niveles de sandbox (campo sandbox_mode en el archivo de configuración ~/.codex/config.toml):

Modo de sandboxSignificado
read-onlySolo mirar: modificar archivos o ejecutar comandos requiere aprobación
workspace-writeLectura y escritura libres dentro del workspace y ejecución de comandos habituales (el valor por defecto de baja fricción recomendado por el oficial)
danger-full-accessSin restricciones de sandbox, úsalo solo cuando quieras abrir todo explícitamente

Dos niveles de política de aprobación: on-request (por defecto, pregunta solo al salirse de los límites) y never (nunca pregunta).

Diferencias por plataforma que conviene saber de antemano:

  • macOS: funciona nada más instalar (el sistema incluye el framework Seatbelt)

  • Windows: usa el sandbox nativo de Windows en PowerShell; en WSL2 va por el sandbox de Linux

  • Linux: instala primero bubblewrap: sudo apt install bubblewrap (Ubuntu/Debian) o sudo dnf install bubblewrap (Fedora)

  • Pequeña verificación: /permissions abre el selector y sé en qué nivel de sandbox estoy ahora

Paso 5: cambia de modelo y consulta el estado: /model y /status ​

Por qué: distintas tareas requieren distinta potencia: para bugs difíciles usa un modelo fuerte que piense más, y para lotes de tareas pequeñas usa un modelo rápido que ahorre cuota. Desde 0.171.0 (2026-11-20), el catálogo de modelos incorpora GPT-6.2 Sol y GPT-6.2 Astra, con Sol como opción predeterminada. Recomendación oficial: para programar a diario usa Sol, y para los trabajos más difíciles como depurar bugs entre servicios usa Astra. Cuidado con no escribir nombres de modelos antiguos: GPT-5.5 fue retirado de «Codex con inicio de sesión de ChatGPT» el 2026-10-14.

Cambia de modelo dentro de la sesión:

text
/model

Deberías ver: aparece la lista de modelos disponibles para tu cuenta (como gpt-6.2-sol, gpt-6.2-astra, gpt-6-luna), y al seleccionar uno se confirma el cambio en la conversación. Los dos modelos de GPT-6.2 están disponibles para Plus, Pro, Business, Enterprise y Edu (Enterprise / Edu requiere que el administrador los active primero).

También puedes especificarlo directamente al iniciar:

bash
codex --model gpt-6.2-sol

Para tareas difíciles cambia a Astra: codex -m gpt-6.2-astra. Para saber qué modelo elegir según el tipo de tarea, consulta cómo elegir modelo.

Consulta el estado de la sesión:

text
/status

Deberías ver: el modelo actual, la política de aprobaciones, los directorios editables y el uso de tokens. La documentación oficial dice: para consultar el crédito restante en una sesión activa de la CLI, usa esto.

💡 Vigila el consumo

En la sesión, /usage muestra la actividad de tokens de la cuenta (diaria / semanal / acumulada); el panel de uso en la web está en chatgpt.com/codex/settings/usage, y la recomendación oficial es revisarlo cada semana o dos para tener claro tu propio ritmo.

  • Comprobación rápida: en /status puedes ver el modelo actual y la política de aprobaciones

Paso 6: revisar los cambios y cerrar la sesión — /diff y codex resume ​

Por qué: el código modificado por la IA hay que revisarlo antes de incorporarlo; la gestión de sesiones determina «si al día siguiente te apetece volver a abrirla».

EscenarioOperaciónEfecto
Ver qué ha cambiado/diffGit diff, incluye incluso los archivos nuevos que Git aún no rastrea
Pedirle que se auto-revise/reviewResume los problemas del espacio de trabajo (cambios de comportamiento, tests faltantes), sin modificar tus archivos
La conversación se ralentiza al alargarse/compactComprime el historial en un resumen y libera contexto
Ejecutar shell directamente! git statusLa salida entra en la conversación y responde automáticamente
Referenciar archivos@src/...Las rutas de archivos entran en el prompt
Continuar mañanatras salir codex resumeReabre la sesión más reciente del repositorio actual, y también puede buscar sesiones anteriores

Deberías ver: /diff lista los archivos modificados y el contenido añadido/eliminado; codex resume vuelve con el contexto de la conversación anterior.

  • Comprobación rápida: he revisado los cambios con /diff y he retomado una sesión con codex resume

Punto de control ✅ ​

  • codex --version muestra la versión, codex login status confirma que has iniciado sesión
  • He iniciado codex en el directorio del proyecto, le he asignado la primera tarea y lo he visto leer archivos por sí mismo y ejecutar comandos en el sandbox
  • Sé usar /permissions para cambiar el preset de aprobaciones, y sé que la combinación recomendada oficialmente es workspace-write + on-request
  • Usaré /model para cambiar de modelo (por ejemplo gpt-6.2-sol) y /status para consultar el estado; sé que gpt-5.5 ya fue retirado
  • Reviso los cambios con /diff; comprimo las conversaciones largas con /compact; retomo las sesiones con codex resume

Advertencias sobre errores comunes ​

❌ El nombre del modelo sigue siendo gpt-5.5——ya está retirado ​

GPT-5.5 fue retirado de «Codex con inicio de sesión de ChatGPT» el 2026-10-14 (las sesiones con API key no se ven afectadas). Solución de reemplazo dada en el anuncio oficial de retiro: los planes Plus / Pro / Business / Enterprise / Edu usan gpt-6.1-sol; los planes Free / Go usan gpt-6-luna en la App de escritorio. Desde Codex 0.171.0 el valor predeterminado ya es gpt-6.2-sol, así que los usuarios de Plus y superiores pueden cambiar directamente a este; si la configuración debe compartirse con la extensión de IDE, la recomendación oficial es elegir un modelo presente en todos los clientes, por ejemplo gpt-6.1-sol. Hay que actualizar también los valores predeterminados del espacio de trabajo, los ajustes de modelo guardados, los agentes personalizados, las tareas programadas y los nombres de modelos antiguos en los scripts.

❌ En Linux aparece una advertencia del sandbox al iniciar ​

Causa: el sandbox de Linux depende de bubblewrap (bwrap); si no está instalado o no puede crear namespaces de usuario, Codex muestra la advertencia al arrancar. Solución correcta: sudo apt install bubblewrap (Ubuntu/Debian) o sudo dnf install bubblewrap (Fedora); si tras instalarlo en Ubuntu 24.04 sigue apareciendo la advertencia, sigue la documentación oficial para instalar el perfil AppArmor bwrap-userns-restrict en /etc/apparmor.d/ y cargarlo.

❌ Activar danger-full-access directamente para ahorrarse molestias ​

La advertencia de seguridad oficial es muy clara: --dangerously-bypass-approvals-and-sandbox solo debería usarse en entornos controlados como una VM de sandbox dedicada. En el día a día quédate en workspace-write; si necesitas que escriba en directorios fuera del espacio de trabajo, añade --add-dir para especificarlo, en lugar de abrirlo todo. Y recuerda además: delegar las aprobaciones en la revisión automática (Approve for me) no amplía el sandbox——solo revisa por ti las solicitudes que exceden los límites; la frontera sigue siendo la misma.

❌ Tratar las credenciales de inicio de sesión como archivos normales ​

Codex guarda en caché las credenciales de inicio de sesión en ~/.codex/auth.json (o en el almacén de credenciales del sistema), y la recomendación oficial es «trátalas como una contraseña»: no las subas al repositorio, no las pegues en tickets ni las envíes por chat de grupo. Para iniciar sesión con API key usa el método de tubería que indica la documentación oficial, printenv OPENAI_API_KEY | codex login --with-api-key; no escribas la key en texto plano en la línea de comandos.

Técnicas avanzadas (opcional) ​

Deja un «manual» para tu proyecto. Ejecuta /init en la sesión y Codex genera en el directorio actual el esqueleto AGENTS.md——escribe ahí los comandos de verificación, las convenciones y los escollos, y en cada sesión lo leerá primero. Para una explicación detallada de cómo escribirlo, consulta AGENTS.md y CLAUDE.md: deja un manual del proyecto para la IA.

Usa Codex como una herramienta Unix. En scripts y CI usa el modo no interactivo codex exec, que sale automáticamente al terminar y cuya salida puede canalizarse directamente a otras herramientas:

bash
codex exec "generate release notes for the last 10 commits" | tee release-notes.md

codex exec usa por defecto un sandbox de solo lectura; para que modifique archivos, añade --sandbox workspace-write. Desde 0.169.0 (2026-11-13), en directorios no confiables codex exec desactiva la configuración del proyecto y los servidores MCP, incluso si se añade --sandbox workspace-write; para guardar explícitamente la confianza del proyecto, añade --trust a codex exec o codex review.

Migra la configuración desde Claude Code. Ejecuta /import en la sesión, elige Claude Code (o Cursor), e importa la configuración, los archivos del proyecto y los chats recientes——según la documentación oficial, busca hasta 50 chats de los últimos 30 días como máximo.

Que siga trabajando aunque apagues el ordenador. Abre chatgpt.com/codex y entrega la tarea a la nube: cada tarea tiene su propio espacio de trabajo y puede seguir ejecutándose aunque tu ordenador esté dormido; luego revisas los cambios y envías el PR desde la web, el móvil o la App de escritorio. En la terminal, codex cloud permite explorar y enviar tareas en la nube.

Sigue usándolo en el IDE. En VS Code, Cursor y Windsurf instala la extensión openai.chatgpt; los archivos abiertos en el editor y el código seleccionado entran directamente en el prompt; desde el escritorio, un solo comando codex app lo abre.

Resumen de la lección ​

✅ La rutina diaria del tutorial de Codex = instalar la CLI → iniciar sesión con la cuenta de ChatGPT → entrar en el directorio y asignar tareas → /permissions vigilar los límites → /model ajustar la potencia → /diff revisar, codex resume retomar. Con esos seis pasos en marcha, es tu agente de programación de OpenAI siempre a mano en la terminal.

✅ Es un agente, no un chatbot: lee por sí mismo el repositorio local, modifica archivos y ejecuta comandos en el sandbox——tú te encargas de decirle con claridad «qué hacer y cómo debe quedar».

✅ Cuatro formas, una cuenta: CLI (esta lección), extensión de IDE, App de escritorio (codex app) y Codex Web (tareas en la nube en chatgpt.com/codex).

✅ Dos compuertas de seguridad: sandbox (read-only / workspace-write / danger-full-access) + aprobaciones (on-request / never); combinación diaria workspace-write + on-request.

✅ No escribas el nombre antiguo del modelo: gpt-5.5 fue retirado el 2026-10-14, cámbialo por gpt-6.2-sol (el predeterminado desde 0.171.0) o gpt-6-luna (Free / Go).

Repaso de las operaciones clave:

OperaciónCómo hacerloDescripción
Instalacióncurl -fsSL https://chatgpt.com/codex/install.sh | sh (macOS/Linux); comando de instalación en PowerShell (Windows)Alternativas: npm, brew; para actualizar, vuelve a ejecutar el comando de instalación
Iniciar sesióncodex y luego elige Sign in with ChatGPTcodex login status para ver el estado
Asignar tareasEscribe directamente la descripción de la tareaPrimera tarea oficial: Tell me about this project
Configurar permisos/permissionsTres niveles de sandbox + dos niveles de aprobación
Cambiar de modelo/model o codex --model gpt-6.2-solel predeterminado es Sol, para problemas difíciles usa gpt-6.2-astra; gpt-5.5 ya fue retirado
Ver el estado/statusModelo, política de aprobación, directorios con permiso de escritura, uso de tokens
Ver los cambios/diff, /reviewIncluye archivos nuevos sin rastrear por Git
Reanudar sesióncodex resumeReabre el chat más reciente del repositorio actual

Vista previa de la próxima lección ​

Cuando domines Codex, en la próxima lección conocerás OpenCode del bando de código abierto: OpenCode Uso: agente de código abierto, conecta libremente modelos chinos.

Aprenderás:

  • OpenCode Qué es: agente de codificación con IA de código abierto, sin vincular el modelo a ningún proveedor
  • Cómo conectar modelos nacionales: DeepSeek, Kimi, Zhipu y otros están en el catálogo oficial de modelos
  • OpenCode frente a Codex, Claude Code: cómo elegir y cómo usarlos en conjunto
  • Tabla completa de costos de las cuatro herramientas en comparación de precios
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.