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.
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
- Instala la CLI. En Mac o Linux, desde la terminal:
En Windows, desde una ventana nueva de PowerShell:curl -fsSL https://chatgpt.com/codex/install.sh | sh
También se instala conpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"npm install -g @openai/codexo, en Mac, conbrew install --cask codex. - Entra a una carpeta de prueba y arráncalo. Usa una copia de algo que no te duela perder:
La primera vez elige Sign in with ChatGPT e inicia sesión con tu cuenta.cd ruta/a/tu-carpeta codex - Empieza preguntando. Un pedido que no cambia nada:
Explícame qué hay en esta carpeta y para qué sirve cada archivo. - 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
/diffves exactamente qué cambió. - 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.
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.
| Modo | Qué hace sin preguntarte | Cuándo usarlo |
|---|---|---|
| Solo lectura | Leer archivos y ejecutar comandos, sin permiso para escribir | Para conversar o planear, y en carpetas sin Git |
| Auto | Leer, editar y ejecutar comandos dentro de la carpeta de trabajo. Pide permiso para salir de ella o usar internet | El día a día, en carpetas con Git |
| Revisión automática | Lo mismo que Auto, pero las solicitudes de permiso las evalúa primero un agente revisor | Tareas largas que ya conoces bien |
| Acceso total | Todo, sin sandbox ni aprobaciones | Casi 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.mdaplica a todas tus carpetas. Ahí van tus preferencias generales. - Del proyecto. Un
AGENTS.mden 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
| Codex | Claude Code | |
|---|---|---|
| De quién es | OpenAI | Anthropic |
| Planes | Limitado en Free y Go; Plus, Pro, Business y Enterprise; o clave de API | Pro, Max, Ultra, Team y Enterprise; o cuenta de Console |
| Dónde | App de escritorio de ChatGPT, terminal, editores y nube | Terminal, editores, app de escritorio y web |
| Instrucciones | AGENTS.md, se crea con /init | CLAUDE.md, se crea con /init |
| Permisos | /permissions: solo lectura, Auto, revisión automática, acceso total | Shift+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.