01 Qué es Codex hoy
El nombre Codex tuvo una primera vida como modelo de OpenAI para generar código. Hoy designa otra cosa: un agente de programación que lee tu repositorio, edita archivos, ejecuta comandos y pruebas, y te devuelve el trabajo para revisar. La filosofía es muy parecida a la de Claude Code, y lo que aprendes en uno se traslada casi entero al otro.
La CLI es de código abierto (licencia Apache-2.0) y comparte cuenta y configuración con el resto de puertas de entrada de Codex.
CLI
El agente en tu terminal, trabajando sobre los archivos de tu ordenador.
Extensión de editor
Codex dentro de VS Code, Cursor o Windsurf, con los cambios como diffs en línea.
App de escritorio
Se abre con codex app y permite gestionar varios hilos de trabajo a la vez.
Codex en la nube
Tareas que corren en contenedores de OpenAI desde chatgpt.com/codex y terminan en una pull request.
Revisión en GitHub
Comentando @codex review en una pull request, una vez activada la revisión en el repositorio.
02 Instalación de la CLI
# macOS o Linux: instalador oficial
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Con npm (cualquier sistema con Node.js)
npm install -g @openai/codex
# Con Homebrew en macOS
brew install --cask codexpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"-
1
Inicia sesión
Ejecuta codex y elige Sign in with ChatGPT para usar el cupo de tu plan, o configura una clave de API si prefieres pagar por uso. Con codex login status compruebas qué método está activo.
-
2
Entra en tu proyecto
Abre la terminal en la carpeta del proyecto, idealmente un repositorio Git para poder revertir cualquier cambio.
-
3
Crea el AGENTS.md
Dentro de Codex escribe /init. Genera un AGENTS.md con la estructura del proyecto, los comandos y las reglas. Revísalo y déjalo corto y preciso.
-
4
Empieza en modo seguro
Con /permissions puedes pasar a solo lectura mientras exploras. Cuando confíes, vuelve al modo automático.
03 Permisos y sandbox: lo que debes entender
Codex combina dos controles. El sandbox limita técnicamente lo que puede hacer (dónde escribe y si accede a la red) y la política de aprobación decide cuándo tiene que pedirte permiso. En la CLI y el editor, por defecto no hay red y solo puede escribir en la carpeta de trabajo; carpetas como .git quedan protegidas en solo lectura.
| Modo | Qué puede hacer | Cuándo usarlo |
|---|---|---|
| read-only | Leer y proponer, sin modificar nada | Explorar un proyecto nuevo o pedir explicaciones |
| Auto (workspace-write) | Editar y ejecutar en la carpeta; pide permiso para salir de ella o usar la red | El trabajo diario |
| danger-full-access | Todo, sin sandbox | Solo dentro de un contenedor o máquina aislada |
04 Comandos que usarás a menudo
| Comando | Para qué sirve |
|---|---|
| /init | Crear un AGENTS.md inicial |
| /model | Cambiar de modelo y ajustar el razonamiento |
| /permissions | Cambiar el nivel de autonomía |
| /review | Revisar los cambios de tu checkout de Git |
| /status | Ver la sesión, los directorios de trabajo y el cupo restante |
| /compact | Resumir una conversación larga |
| /new y /resume | Abrir un chat nuevo o retomar uno guardado |
| codex exec | Ejecutar una tarea sin interacción, para scripts o CI |
| codex mcp add | Añadir un servidor MCP |
05 Prompts para tus primeras sesiones
Estás en modo de solo lectura: no edites archivos ni ejecutes nada que los cambie.
Necesito entender este repositorio antes de tocarlo:
1. Qué hace la aplicación y para quién, en dos frases.
2. Cómo está organizado: carpetas principales y responsabilidad de cada una.
3. Cómo se instala, se ejecuta y se prueba.
4. Dónde tocaría para cambiar [FUNCIONALIDAD QUE QUIERES MODIFICAR] y qué riesgos ves.
Termina con una propuesta de AGENTS.md de menos de 40 líneas, sin crearlo todavía.Hay un fallo: [DESCRIBE QUÉ OCURRE Y CÓMO REPRODUCIRLO].
Trabaja así:
1. Localiza la causa y explícamela en dos frases antes de cambiar nada.
2. Aplica el cambio más pequeño posible; no aproveches para refactorizar.
3. Añade o actualiza una prueba que falle sin tu cambio y pase con él.
4. Ejecuta las pruebas del proyecto y enséñame el resultado.
5. Muéstrame el diff final y espera mi aprobación antes de hacer commit.06 Codex y Claude Code juntos
No hace falta elegir bando. Los dos agentes funcionan sobre las mismas carpetas y Git, así que muchos equipos los combinan: uno implementa y el otro revisa, o se reparten tareas independientes. La equivalencia de conceptos es casi directa:
| Concepto | Claude Code | Codex |
|---|---|---|
| Instrucciones del proyecto | CLAUDE.md | AGENTS.md |
| Configuración | settings.json | config.toml |
| Ejecución sin interacción | claude -p | codex exec |
| Añadir un MCP | claude mcp add | codex mcp add |
| Revisión de cambios | /code-review | /review |
Preguntas frecuentes
Se incluye en los planes de ChatGPT con distintos límites de uso; la documentación recomienda Plus, Pro, Business, Edu o Enterprise. También puedes usarlo con una clave de API y pagar por tokens. Los precios y cupos cambian a menudo: confírmalos en la web oficial.
Para empezar no, pero sí debes revisar lo que hace. Trátalo como un colaborador muy rápido al que hay que supervisar, sobre todo en cambios que tocan datos, pagos o seguridad.
ChatGPT conversa y sugiere. Codex actúa sobre tu código real: lo lee, lo modifica y ejecuta comandos, en tu ordenador o en la nube.
OpenAI publica sus políticas de datos por plan y producto. Si trabajas con código de clientes, revisa la configuración de privacidad de tu cuenta o espacio de trabajo antes de empezar.
Puede ocurrir hasta que marques la carpeta como de confianza. Usa /permissions para cambiar el modo y /status para ver qué directorios forman parte del espacio de trabajo.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.