01 Qué es Codex y en qué se parece a Claude Code
Codex es el agente de programación de OpenAI. Como Claude Code, trabaja sobre una carpeta de tu ordenador: lee el proyecto, edita archivos, ejecuta comandos y propone cambios que tú apruebas. Se usa desde la terminal (Codex CLI), desde extensiones para el editor y desde la app de escritorio de ChatGPT, que añade navegador integrado y uso del ordenador.
La buena noticia si vienes de Claude Code: casi todo lo que sabes se traslada. Cambian nombres de archivos y comandos, no la forma de trabajar.
| Concepto | Claude Code | Codex |
|---|---|---|
| Instrucciones del proyecto | CLAUDE.md | AGENTS.md (y AGENTS.override.md para excepciones) |
| Instrucciones globales | ~/.claude/CLAUDE.md | ~/.codex/AGENTS.md |
| Generar el archivo inicial | /init | /init |
| Planificar antes de tocar nada | Modo plan | /plan |
| Skills del proyecto | .claude/skills/ | .agents/skills/ |
| Skills personales | ~/.claude/skills/ | ~/.agents/skills/ |
| Invocar una skill | /nombre | $nombre o el selector /skills |
| Ejecución sin interacción | claude -p | codex exec |
02 Instalación
# macOS y Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Con npm
npm install -g @openai/codex
# Con Homebrew
brew install --cask codex
# Arrancar en la carpeta del proyecto
cd mi-proyecto
codexEn Windows hay un instalador para PowerShell en la documentación oficial. La primera vez que ejecutes codex te pedirá iniciar sesión con tu cuenta de ChatGPT u otro método disponible. Antes de cada tarea importante, haz un commit: es la forma más sencilla de deshacer cambios.
03 Paso 1: AGENTS.md y modo plan
Codex lee AGENTS.md antes de empezar cualquier trabajo. Combina el archivo global de ~/.codex con los que encuentre desde la raíz del repositorio hasta la carpeta donde trabajas, uno por nivel. Si ya tienes un CLAUDE.md bien escrito, la mayor parte sirve tal cual.
Lee el CLAUDE.md de este repositorio (si existe), el README y los archivos de configuración del proyecto. Con eso, redacta un AGENTS.md en la raíz con: propósito del proyecto en una línea, stack y versiones, comandos para instalar, probar, formatear y desplegar, convenciones de código y de commits, y reglas que nunca se rompen (seguridad, datos, ramas). Máximo 80 líneas. No inventes comandos: si no encuentras alguno, déjalo marcado como pendiente. Escribe solo ese archivo y espera mi revisión.04 Paso 2: conectar servicios
Codex admite servidores MCP, que se gestionan con codex mcp y se guardan en ~/.codex/config.toml; dentro de una sesión, /mcp lista las herramientas disponibles. También puede instalar plugins para conectar con herramientas de equipo. Para servicios sin conector, pídele que diseñe la integración en modo plan.
/plan Quiero leer datos de [SERVICIO] mediante su API oficial. Propón: 1) el método de autenticación más sencillo y seguro para uso interno, 2) los pasos exactos para obtener las credenciales, 3) cómo guardarlas en .env.local y comprobar que está en .gitignore, 4) un script mínimo que descargue [DATOS] a un JSON local, 5) cómo manejar límites de uso y errores típicos. No ejecutes nada hasta que apruebe el plan.05 Paso 3: un primer entregable útil
La diferencia entre un resultado genérico y uno útil está casi siempre en el encargo. Antes de pedir «analiza estos datos», define qué decisiones quieres tomar con el resultado, qué categorías te importan y qué formato necesitas.
/plan Con el archivo [RUTA DEL CSV O JSON], crea un libro de Excel para decidir [DECISIÓN DE NEGOCIO]. Hojas: Resumen (cifras clave y tres conclusiones), Desglose por [CATEGORÍA], Tendencia semanal con gráfico, Casos que requieren acción (máximo 20, ordenados por prioridad y con el motivo), y Datos originales. Reglas: si un grupo tiene menos de 5 registros, indícalo en vez de sacar conclusiones; anota cada supuesto en el Resumen; no uses macros. Cuando termine, comprueba que las fórmulas no dan error.06 Paso 4: convertir el flujo en skill
Las skills de Codex siguen el mismo formato que las de Claude: una carpeta con un SKILL.md que incluye name y description, más scripts o referencias opcionales. Codex busca en .agents/skills desde tu carpeta de trabajo hasta la raíz del repositorio y en ~/.agents/skills para las personales. Trae de serie $skill-creator para crearlas y $skill-installer para añadir skills del catálogo de OpenAI.
$skill-creator Convierte el proceso que hemos seguido en esta sesión en una skill de proyecto en .agents/skills/[nombre-en-minusculas]/. Incluye: description clara con cuándo usarla, entradas necesarias, pasos numerados, validaciones, formato de salida y una sección de problemas encontrados y cómo los resolvimos. Si algún paso es determinista, pásalo a un script en scripts/. Dime al final si conviene moverla a ~/.agents/skills para usarla en otros proyectos.07 Paso 5: revisar, automatizar y publicar
/review
Revisión dedicada de cambios sin confirmar, un commit o una rama base. Devuelve hallazgos priorizados sin modificar tu código.
codex exec
Ejecuta una tarea sin interacción, útil en scripts y CI. Admite trabajar en un worktree aislado para no tocar tu copia.
codex resume
Retoma una conversación anterior del mismo repositorio cuando vuelves a una tarea.
Navegador de la app
En la app de escritorio de ChatGPT, el navegador integrado permite revisar tu web local y pedir que la pruebe. No está disponible en la CLI.
Abre la aplicación local en el navegador integrado y recorre estos flujos como un usuario nuevo: [FLUJO 1], [FLUJO 2], [FLUJO 3]. Prueba también entradas vacías, textos muy largos y la vista móvil. Haz una lista de fallos con pasos para reproducirlos y gravedad. Corrige solo los de gravedad alta, vuelve a probarlos y deja el resto anotado. No introduzcas datos reales ni credenciales.08 Cuándo usar Codex y cuándo Claude Code
No hay un ganador universal. Muchos equipos usan los dos: uno para explorar y diseñar y otro para ejecutar o para revisar el trabajo del primero con otra mirada. Una segunda revisión por un modelo distinto detecta errores que el primero pasa por alto.
- ✓Ten un solo archivo de instrucciones de referencia y genera el otro a partir de él para que no diverjan.
- ✓Comparte las skills en formato estándar en vez de duplicarlas.
- ✓Evita que los dos agentes editen la misma rama a la vez; usa worktrees o ramas separadas.
- ✓Compara coste y límites de uso de cada plan antes de repartir el trabajo.
Preguntas frecuentes
No necesariamente. Puedes iniciar sesión con una cuenta de ChatGPT que incluya Codex; los límites dependen del plan. La clave de API es otra opción, facturada por uso.
Sí como base. Codex lee AGENTS.md, así que copia o adapta el contenido. Revisa referencias a comandos o funciones exclusivas de Claude Code.
En .agents/skills dentro del repositorio para compartirlas con el equipo, o en ~/.agents/skills para uso personal. Cada skill es una carpeta con su SKILL.md.
No. El navegador integrado está en la app de escritorio de ChatGPT, no en la CLI ni en la extensión del editor.
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.