Directorio / Guías / Otras herramientas de IA

Codex desde cero

Qué es Codex de OpenAI hoy, qué planes lo incluyen, cómo instalarlo y darle tu primera tarea, cómo controlar lo que hace sin preguntarte y para qué sirve AGENTS.md.

Guía paso a paso5 min de lecturaPor Rafael Schwart

Codex es el agente de OpenAI que trabaja con archivos y código. Como Claude Code, abre la carpeta que le indicas, lee lo que necesita, edita archivos y ejecuta comandos, dentro de los permisos que le des. Nació para programar, pero sirve para tareas de negocio que viven en archivos: ordenar una carpeta, limpiar una hoja exportada o armar una página sencilla.

Esta guía usa la documentación oficial de OpenAI a noviembre de 2026, que reúne la ayuda de ChatGPT y de Codex.

Dónde funciona

  • La app de escritorio de ChatGPT. Para macOS y Windows, con guía aparte para Linux. Abres una carpeta o un proyecto y eliges Codex. Es lo más cómodo si no usas la terminal.
  • Codex CLI. En la terminal. Es la que usa esta guía.
  • Extensión para editores. VS Code, Cursor y Windsurf usan la extensión de Codex. Xcode y los IDE de JetBrains tienen su propia integración.
  • Codex Cloud. Tareas que corren en la nube, con o sin un repositorio de GitHub o GitLab, y siguen aunque tu computadora esté en reposo. Las lanzas desde la web, la app de escritorio o el celular.

Qué plan necesitas

Codex viene con tu cuenta de ChatGPT y comparte el uso con ChatGPT Work. En Free y Go el acceso es limitado. Plus lo incluye, Pro amplía el uso, y también está en Business y Enterprise. En Business, OpenAI no entrena con los datos de tu empresa por defecto.

La otra opción es usarlo con una clave de la API de OpenAI y pagar por consumo. Así funciona en la terminal, el editor y el SDK, pero sin las funciones en la nube. Revisa los límites en la página de precios de Codex.

Instalarlo y tu primera tarea

  1. Instala la CLI. En Mac o Linux, desde la terminal:
    curl -fsSL https://chatgpt.com/codex/install.sh | sh
    En Windows, desde una ventana nueva de PowerShell:
    powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
    También se instala con npm install -g @openai/codex o, en Mac, con brew install --cask codex.
  2. Entra a una carpeta de prueba y arráncalo. Usa una copia de algo que no te duela perder:
    cd ruta/a/tu-carpeta
    codex
    La primera vez elige Sign in with ChatGPT e inicia sesión con tu cuenta.
  3. Empieza preguntando. Un pedido que no cambia nada:
    Explícame qué hay en esta carpeta y para qué sirve cada archivo.
  4. Después, un cambio pequeño y verificable. «En precios.csv, agrega una columna con el precio con impuesto incluido» se revisa en un minuto. Con /diff ves exactamente qué cambió.
  5. Guarda un punto de retorno. La documentación recomienda un punto de control con Git antes y después de cada tarea, para poder deshacer. Si no usas Git, trabaja sobre una copia.
Primero el proceso. Antes del pedido, define en una frase qué tiene que cambiar y cómo vas a comprobar que quedó bien.

Cómo controlar lo que hace

Dos controles trabajan juntos. El sandbox define qué archivos puede tocar y si puede usar internet. Las aprobaciones definen cuándo se detiene a preguntarte. En la terminal los cambias con /permissions.

ModoQué hace sin preguntarteCuándo usarlo
Solo lecturaLeer archivos y ejecutar comandos, sin permiso para escribirPara conversar o planear, y en carpetas sin Git
AutoLeer, editar y ejecutar comandos dentro de la carpeta de trabajo. Pide permiso para salir de ella o usar internetEl día a día, en carpetas con Git
Revisión automáticaLo mismo que Auto, pero las solicitudes de permiso las evalúa primero un agente revisorTareas largas que ya conoces bien
Acceso totalTodo, sin sandbox ni aprobacionesCasi nunca. La documentación no lo recomienda

Al arrancar, Codex mira si la carpeta tiene control de versiones: si lo tiene, recomienda Auto; si no, solo lectura. Por defecto trabaja sin acceso a la red. Con /status ves el modo activo y qué carpetas puede modificar.

En la app de escritorio y en el editor, el control de permisos está debajo de donde escribes. Ask for approval trabaja dentro de la carpeta y se detiene antes de salir de ella; es el modo recomendado para empezar. Approve for me mantiene el mismo límite, pero manda esas solicitudes a la revisión automática.

AGENTS.md: el manual de tu proyecto

Codex lee los archivos AGENTS.md antes de empezar cualquier trabajo. Es su equivalente del CLAUDE.md de Claude Code: lo que tiene que saber del proyecto y las reglas que debe seguir. El comando /init crea uno base en la carpeta actual para que lo completes.

  • Global. ~/.codex/AGENTS.md aplica a todas tus carpetas. Ahí van tus preferencias generales.
  • Del proyecto. Un AGENTS.md en la raíz del proyecto, y otros en subcarpetas que necesiten reglas propias. El más cercano a la carpeta donde trabajas tiene la última palabra.
# AGENTS.md
## Sobre este proyecto
- Catálogo de productos de la tienda. Los precios están en precios.csv.
## Reglas
- No borres archivos. Si algo sobra, muévelo a la carpeta archivo/.
- Pregunta antes de cambiar un precio.

Lo que hace bueno a un CLAUDE.md sirve aquí: corto, concreto y al día. Si vienes de Claude Code, el comando /import trae su configuración, tus proyectos y tus conversaciones.

Codex y Claude Code, lado a lado

CodexClaude Code
De quién esOpenAIAnthropic
PlanesLimitado en Free y Go; Plus, Pro, Business y Enterprise; o clave de APIPro, Max, Ultra, Team y Enterprise; o cuenta de Console
DóndeApp de escritorio de ChatGPT, terminal, editores y nubeTerminal, editores, app de escritorio y web
InstruccionesAGENTS.md, se crea con /initCLAUDE.md, se crea con /init
Permisos/permissions: solo lectura, Auto, revisión automática, acceso totalShift+Tab: Manual, Accept edits, Plan, Auto

Los dos hacen el mismo tipo de trabajo y la forma de usarlos es muy parecida. Elige por el plan que ya pagas y por cuál resuelve mejor tus tareas reales. Para ver la otra opción paso a paso, lee Claude Code desde cero.

Sigue leyendo

Más guías.

Cada una se lee en menos de cinco minutos.

Todas las guías
Guía paso a paso · 5 min

n8n desde cero: tu primer flujo con IA

Nube o servidor propio, qué permite su licencia, cómo se arma un flujo con disparadores, nodos y credenciales, un nodo de IA, el manejo de errores y un ejemplo completo con aprobación.

Comparativa · 4 min

n8n, Make o Zapier: cómo elegir dónde automatizar

Cómo cobra cada plataforma, qué tan fácil es, qué trae de IA, cuál puedes alojar tú, cuántas integraciones declara y dónde guarda tus datos, con una guía para elegir según tu negocio.

  Arqentia

¿Prefieres que lo armemos contigo?

Treinta minutos para ver tu operación: cómo entra el dinero, dónde se pierde tiempo y qué conviene automatizar primero. Gratis para negocios y sin compromiso.

Agendar consulta