Master 97% de Codex en 1 hora
Todos los que ya usamos Claude Code estamos a una hora de dominar el 97% de Codex. En una hora dominas el 97% con 5 movimientos — AGENTS.md, plan mode, skills, browser use y deploy en vivo. Esta guía traduce el thread completo de Nate Herk al español, con prompts y comandos copy-paste para arrancar el primer día.
Codex · OpenAI · Mayo 2026
5 movimientos · audience-bridge desde Claude Code
Codex es lo que pasa cuando OpenAI ve a Claude Code y dice "yo también". Misma carpeta, mismo markdown, distinto modelo. Todo el mental model que ya tienes con Claude Code se traslada — solo cambia el nombre del archivo (AGENTS.md en vez de CLAUDE.md), el atajo del plan mode (Shift+Tab) y el modelo que corre por debajo (GPT-5.5). Aquí están los 5 movimientos que cambian todo, los 7 prompts copy-paste y los gotchas de automations que evitan los 40 minutos perdidos.
qué es · 30 segundos
Codex es Claude Code con otra llave
Codex es la respuesta de OpenAI a Claude Code. Misma idea, distinto harness, distinto modelo. Si abres Codex y vienes de ChatGPT en web, la interfaz se siente familiar: proyectos a la izquierda, chats a la izquierda, conversación al centro y un toggle abajo para cambiar modelo (GPT-5.5, 5.4) e intensidad (low, medium, high, extra high).
Lo que cambia es lo que puede hacer. Codex lee tu disco, escribe apps, arma Excel sheets, controla mouse y teclado y automatiza navegadores — cosas que ChatGPT web no hace. La comparación honesta:
Claude Code
Opus, Sonnet, Haiku · CLAUDE.md
Mejor para pensar, brainstormear y explorar. Más conversacional, mejor cuando todavía no sabes exactamente qué quieres.
Codex
GPT-5.5, 5.4 · AGENTS.md
Más pragmático, más ejecutivo, más constante en planes largos. Mejor cuando ya tienes claro qué construir y solo quieres que se construya.
La pregunta no es "cuál es mejor". Es "cuál es el correcto para este trabajo específico". Nate Herk hizo el comparativo lado a lado acá.
el atajo · 5 features
Las 5 cosas que cambian todo
Lo que dominas en una hora si ya usas Claude Code. Cada uno tiene su sección propia más abajo con prompts y comandos copy-paste. Esta es la vista de águila.
AGENTS.md · El CLAUDE.md de Codex.
Le dices quién eres, qué estás construyendo y qué reglas seguir. Codex lo lee en cada chat nuevo y entra al proyecto con contexto desde el primer mensaje.
Plan mode (Shift+Tab) · Piensa antes de jalar.
Codex deja de ejecutar y arma el plan completo: qué archivos toca, en qué orden, con qué riesgos. Tú lo apruebas, después corre. Saltarse este paso es la razón #1 de builds rotos.
Skills en .codex/skills · Recetas reutilizables.
Un workflow que tardó 20 minutos la primera vez se convierte en un comando para la próxima. Markdown, una carpeta, un slash command. Si ya usas skills de Claude Code, el mental model es idéntico.
Browser use built-in · Codex prueba tu app sola.
Le dices «abre el dashboard, intenta romperlo, repórtame». Codex abre el navegador, pica los botones, encuentra los bugs y te los arregla. QA automático antes de devolverte el control.
GitHub + Vercel · URL en vivo en 30 segundos.
Codex empuja a un repo privado, Vercel lo importa, y cada cambio futuro se publica solo. Tres herramientas, un workflow, cero clicks repetidos.
paso 1 · setup
AGENTS.md + plan mode = el setup que casi nadie hace
Un proyecto en Codex es una carpeta. Eso es todo. Cuando creas un proyecto nuevo, Codex abre un picker, eliges la carpeta, y a partir de ahí cualquier archivo adentro lo puede leer, escribir, editar o mover.
Lo primero que necesita esa carpeta es un AGENTS.md en la raíz. Es el equivalente exacto del CLAUDE.md de Claude Code: el archivo que Codex lee al abrir cada chat nuevo. Le dice quién eres, qué construyes, qué reglas siguen. No lo escribas a mano la primera vez — usa el primer starter prompt para que Codex lo redacte por ti, después tú lo editas.
1. Redacta mi AGENTS.md desde cero
El primer prompt que le pegas a Codex en una carpeta nueva. Le explicas el proyecto en lenguaje natural y le pides que arme el archivo de onboarding. Tú lo lees, lo editas, y queda listo para todas las sesiones futuras.
Vas a vivir en esta carpeta. Antes de tocar código, redacta el AGENTS.md de este proyecto en la raíz. Contexto del proyecto: - Quién soy: [describe tu rol y qué construyes] - Qué estoy construyendo: [una línea sobre el proyecto] - Stack actual: [lenguajes, frameworks, servicios] - Restricciones importantes: [reglas que NO se rompen — seguridad, estilo, deploys, etc.] - Cómo se ve el outcome: [qué significa "terminado" para mí] Formato del AGENTS.md: 1. Una sección de contexto en lenguaje natural 2. La meta del proyecto en una sola línea 3. Convenciones del código (cómo nombro variables, cómo estructuro carpetas, cómo escribo commits) 4. Comandos útiles (build, test, lint, deploy) 5. Restricciones que nunca se rompen Cuando termines, no hagas nada más. Solo escribe el archivo y confírmame para que lo revise antes de seguir.
Lo segundo es plan mode. Aprietas Shift+Tab y Codex deja de ejecutar — solo brainstormea, pregunta y produce un plan. Tú lo apruebas, después corre. Saltarse plan mode es la razón #1 por la que builds salen torcidos. Empieza cualquier cosa medianamente seria con plan mode prendido.
Plan mode (atajo de teclado)
Shift + Tab # Codex deja de ejecutar y arma el plan completo antes de tocar nadaAGENTS.md (raíz del proyecto)
./AGENTS.md
# El equivalente de CLAUDE.md. Codex lo lee al abrir cada chat nuevo.
# Lo redactas con el primer prompt y lo editas a mano cuando algo se siente repetitivo.paso 2 · integraciones
Conectar a cualquier cosa (incluso lo que no tiene plugin)
Codex trae plugins built-in para los lugares obvios. Para todo lo demás existe un patrón fijo: entras en plan mode, le explicas el objetivo, y Codex te diseña el setup paso a paso — incluyendo dónde guardar las API keys (siempre en .env.local, con el punto, gitignored).
Plugins built-in (los que ya vienen)
Codex trae conectores nativos para los lugares donde ya vive tu trabajo. No los buscas — están en el menú.
Sin plugin · pídele a Codex que lo arme
Para todo lo que no tiene conector oficial (caso YouTube en el thread), entras a plan mode y le explicas el objetivo. Codex te propone API key vs OAuth, te lleva paso a paso por Google Cloud, te genera el `.env.local` (con el punto, gitignored) y te prueba la conexión hasta que jale.
2. Conéctame a YouTube Data API v3 (sin OAuth)
Caso real del thread. Codex no tiene plugin oficial de YouTube — tú entras en plan mode y le pides el setup completo. Te lleva paso a paso por Google Cloud, genera el `.env.local` y prueba la conexión.
Activa plan mode antes de tocar nada. Objetivo: jalar comentarios recientes de mi canal de YouTube usando YouTube Data API v3 con API key (no OAuth). Lo que necesito que diseñes en el plan: 1. Pasos exactos para crear el proyecto en Google Cloud y habilitar YouTube Data API v3 2. Dónde y cómo guardar la API key — usa siempre .env.local (con el punto, ya está en .gitignore) 3. Qué runtime conviene probar primero (Node, Python, otra cosa) y por qué 4. Una prueba mínima: jalar los últimos 50 comentarios de mi canal y guardarlos en un JSON local 5. Manejo de errores típicos (cuota diaria, key inválida, video privado) 6. Si algo falla, guarda la lección en project memory para no volver a tropezar Datos del canal: - ID del canal: [tu channel ID] - Cuántos comentarios quiero traer en la primera prueba: 50 No empieces a ejecutar. Plan primero, yo apruebo, y después corres.
API keys y secrets
./.env.local # El punto importa: Codex y git lo ignoran por default.
# NUNCA pegues keys en secrets.txt o en archivos sin punto — terminan en commits públicos.El loop que vale: intentas, falla, le pides a Codex que guarde la lección en project memory, y la próxima vez no tropieza igual. Así se va afinando solo.
paso 3 · build
El primer entregable real (lección incluida)
La lección más valiosa del thread está aquí. La primera versión del entregable de Nate fue mediocre — porque su prompt fue vago. La diferencia entre un workbook genérico y uno útil está en cuán específico eres antes de que Codex toque nada: qué categorías te importan, qué métricas, qué tabs.
Este prompt es deliberadamente específico. Si tu caso de uso es otro, copia la estructura y sustituye el contenido — pero mantén el nivel de detalle. Plan mode primero, ejecución después.
3. Excel intelligence con tus datos reales
El entregable estrella del thread. Lección clave: los prompts vagos producen insights genéricos. Este prompt es específico a propósito — categorías, métricas, tabs definidos antes de que Codex toque nada.
Quiero un workbook de Excel con análisis de mis comentarios de YouTube. Input: - Archivo de comentarios: [./data/comments.json o el path donde Codex los guardó] - Cuántos comentarios analizar: los 200 más recientes Tabs que necesito en el workbook: 1. **Resumen** — tarjetas con totales, tasa de preguntas, tasa de "pide contenido", high-priority items 2. **Mix de categorías** — tabla y pie chart con: feedback general, preguntas, comparaciones de herramientas, "pide contenido", elogios, otros 3. **Tools mencionados** — ranking de menciones (Claude Code, Codex, API, OpenAI, Anthropic, etc.) con barra horizontal 4. **Patrones de pregunta** — agrupa preguntas similares y cuenta frecuencia 5. **Reply opportunities** — top 20 comentarios donde responder genera más impacto, ranqueados por prioridad 6. **Ideas de contenido** — temas que la audiencia está pidiendo, sacados directo de los comentarios 7. **Raw** — todos los comentarios tal cual con metadata (autor, video, timestamp, likes) Reglas: - No me devuelvas insights genéricos. Si una categoría tiene <5 comentarios, dilo explícito. - Si un comentario menciona a un competidor por nombre, marcarlo en el tab de Tools. - Cualquier supuesto que hagas, anótalo en una nota dentro del tab Resumen. Plan mode primero. Cuando esté el workbook, ábrelo y preview el tab Resumen.
paso 4 · skills
Skills: convierte un workflow en receta
Skill = receta reutilizable. La primera vez que armas algo (digamos, el workbook de comentarios) tarda 20 minutos. Sin skill, la próxima vez también tarda 20 minutos. Con skill, son 30 segundos: un comando o una orden en lenguaje natural y Codex corre el flujo completo.
Las skills son archivos markdown. Punto. Viven en dos lugares y eliges cuál según cuánto reuso esperas:
Skills (global y project-level)
~/.codex/skills/<nombre>.md # Global — disponible en todos tus proyectos
./.codex/skills/<nombre>.md # Project — solo en esta carpeta
# Para mover una entre las dos carpetas, dile a Codex: 'Mueve esa skill a project level'Después de un workflow que jaló bien, le pides a Codex que lo destile en skill. Reverse-engineerea todo lo que acaba de hacer y lo guarda como receta — incluyendo una sección de "lessons learned" con lo que aprendió arreglando cosas en esa sesión.
4. Convierte este flujo en una skill reusable
Después de un workflow que jaló bien, Codex puede destilarlo en una skill markdown. Decides si vive global (todos los proyectos) o project-level (solo este). Próxima vez: un comando.
El flujo que acabamos de hacer (jalar comentarios → analizar → workbook) jaló bien. Conviértelo en una skill reusable.
Pasos:
1. Reverse-engineer todo lo que hicimos en una skill markdown completa.
2. Guarda la skill en .codex/skills/youtube-comment-insights.md (project-level por ahora).
3. La skill debe poder invocarse con /youtube-comment-insights o con una orden en lenguaje natural ("córreme las insights de comentarios").
4. Al final del archivo, agrega una sección "Lessons learned" con todo lo que aprendiste arreglando cosas en esta sesión — para no tropezar igual la próxima vez.
5. Si crees que la skill sirve para más proyectos, dime explícito qué pasos hay que seguir para subirla a ~/.codex/skills (global).
Formato de la skill: como receta. Inputs claros, pasos numerados, validaciones, output esperado, troubleshooting al final.paso 5 · deploy
De localhost a URL en vivo (con mockup-first)
Antes del código, las imágenes. El truco más subestimado del thread: pídele a Codex que genere mockups con GPT Image 2 antes de tocar UI. Los mockups quedan como project assets, el build los referencia, y el resultado se ve mucho más afilado que cuando dejas a Codex freestylear el diseño.
5. Mockup primero con GPT Image 2, después código
Patrón del thread para que el dashboard no salga genérico. Antes de escribir UI, Codex genera 3 mockups con GPT Image 2 y los guarda como project assets. El build referencia esas imágenes.
Antes de escribir una sola línea de UI del dashboard, genera 3 mockups con GPT Image 2 y guárdalos en ./assets/mockups/. Contexto del dashboard: - Qué visualiza: [descríbelo en una línea — ej. comentarios de YouTube con charts] - Audiencia: [creadores que quieren responder mejor] - Estilo deseado: [moderno, denso pero respirable, paleta neutra con un acento] Pide los 3 mockups así: 1. **Layout principal** — homepage del dashboard, con sidebar de navegación, header con métricas resumen y área central con charts 2. **Comment explorer** — vista detalle: tabla de comentarios + filtros + panel lateral de detalle al hacer click 3. **AI insights view** — sección de insights generados por IA con cards de hallazgos clave Cuando los 3 mockups estén guardados, abre los archivos para verlos y armas un brief corto con paleta, tipografía y spacing antes de tocar código. Después usamos esos mockups como referencia visual del build.
Cuando el dashboard ya jala en localhost, lo siguiente son 5 pasos para subirlo en vivo. La cereza: GitHub y Vercel se hablan entre ellos — cada push futuro de Codex dispara un deploy automático. Trabajas adentro de Codex, Codex empuja a GitHub, Vercel actualiza el sitio. Tres herramientas, un workflow.
- 01
Conecta Codex a GitHub
Un solo paso de auth desde la CLI. Codex queda autorizado para crear repos y empujar commits a tu cuenta.
- 02
Pídele que cree un repo privado y empuje el código
Codex genera el repo, hace el primer commit con todo el código del dashboard y lo manda a GitHub. Tú no abres GitHub ni una vez.
- 03
Conecta Vercel a la misma cuenta de GitHub
Setup de una vez. Vercel lee tus repos privados y queda escuchando push events.
- 04
Importa el repo en Vercel
Click en Import, eliges el repo del dashboard, Vercel detecta el framework y arma el build automático.
- 05
Deploy → URL en vivo en 30 segundos
Cada commit que Codex empuje a partir de aquí se publica solo en Vercel. Trabajas en Codex, Codex empuja a GitHub, Vercel actualiza la URL. Tres herramientas, un workflow.
Pipeline GitHub → Vercel (resumen)
1. codex auth github # auth desde la CLI, una sola vez
2. > 'crea un repo privado y empuja el código'
3. vercel --link # conecta Vercel a la misma cuenta de GitHub
4. > Vercel: import repo del dashboard
5. > deploy # URL en vivo en ~30s, futuros pushes auto-desplieganpaso 6 · QA automático
Browser use: Codex prueba tu app sola
Le dices "abre el dashboard, intenta romperlo, repórtame" y Codex abre el navegador interno, pica botones, valida estados vacíos, prueba mobile y desktop, y te devuelve la lista de bugs. Si los bugs son blockers, los arregla y vuelve a correr el QA antes de pasarte el control. El patrón que hace clic: meter el QA pass adentro de la skill o en project memory para que cada nuevo dashboard pase por el filtro automático.
6. Browser QA antes de devolverme el control
Antes de declarar terminado el dashboard, Codex abre el navegador interno, lo prueba como usuario y reporta bugs. Catch-all que ahorra ciclos de QA manual.
Antes de devolverme el control, abre el dashboard en el navegador integrado (browser use) y haz un QA pass completo. Lo que tienes que probar: 1. Cada link externo abre correctamente (target="_blank" donde toca) 2. Los estados vacíos no se ven rotos (sin datos, sin resultados de búsqueda) 3. La búsqueda jala con typos y queries parciales (fuzzy match si es posible) 4. El estado activo de tabs es accesible (no solo visual — aria-current, contraste, etc.) 5. El layout no se rompe en mobile (375px) ni en desktop ancho (1440px) 6. Los charts se renderizan completos sin overflow Reporta así: - Lista de issues encontrados con captura de pantalla de cada uno - Severidad (blocker / mayor / cosmético) - Para los blocker y mayores: arregla el código directo y vuelve a correr el QA pass - Solo me devuelves el control cuando los blocker estén en cero Si encuentras patrones de bug que crees que se van a repetir en proyectos futuros, anótalos en project memory antes de cerrar.
Browser use no es solo QA. Sirve para loguearte a herramientas sin API, jalar reportes de dashboards que no exponen datos, y automatizar cualquier UI que puedas describir en lenguaje natural.
paso 7 · cron
Automations semanales (y los 3 gotchas que matan tiempo)
Codex tiene un panel de Automations: chats programados que corren con cron. Le pones "cada domingo a las 17:00 corre este flujo" y se ejecuta solo. La primera vez de Nate tardó 40 minutos lo que debió tardar 7 — por estos tres gotchas que casi nadie cuenta:
El model picker NO hereda del chat activo
El default dentro del panel de Automations es GPT-5.2 — más lento que GPT-5.5. Una tarea que debería tardar 7 minutos te tarda 40. Cámbialo a 5.5 high explícitamente cada vez que crees una automation nueva.
Archivos abiertos bloquean overwrite
Si tienes el Excel o el dashboard abierto en tu desktop, Codex no puede sobreescribirlo y la automation se queda esperando. Cierra los archivos antes de programar el cron.
Solo corre con la máquina prendida
Las automations locales viven en tu computadora — si cierras Codex o apagas la laptop, el cron pausa. Para algo 24/7, mueve el workflow a un VPS o usa cloud routines (Claude Code ya las tiene; Codex todavía no).
7. Cron semanal con el modelo correcto
Los gotchas del thread van adentro del prompt. El default de las automations es GPT-5.2 (lento). Hay que pedirlo explícito en 5.5 high y validar que los archivos no estén abiertos.
Quiero programar este flujo como cron semanal en Codex Automations. Tarea: cada domingo a las 17:00 (hora local) jalar comentarios frescos de YouTube, refrescar el Excel intelligence, regenerar la data del dashboard, empujar a GitHub para que Vercel auto-despliegue. Configuración importante (no se hereda del chat activo): - Modelo: GPT-5.5 high. NO uses el default GPT-5.2 — es el doble de lento. - Antes de empezar la tarea, valida que el Excel no esté abierto. Si lo está, espera 60 segundos y reintenta. Si después de 3 intentos sigue abierto, abortas y me mandas notificación. - Trabaja en una rama nueva (ej. data/<fecha>) y abre PR contra main. No empujes directo a main. - Al final, escribe un resumen corto en ./reports/weekly-<fecha>.md con: cuántos comentarios nuevos, top 3 hallazgos, qué cambió en el Excel. Limitación que asumo: - Esto solo corre cuando mi máquina está prendida. Si quiero 24/7 lo paso a un VPS más adelante. Cuando esté creada la automation, dame el link directo en el panel de Codex para revisarla.
extras · QOL
Lo pequeño que cambia todo
Detalles que hacen que Codex se sienta menos como herramienta y más como workspace. No son críticos, pero saberlos cambia el feel del día a día.
La mascota
Personaje animado en la esquina inferior. Eliges entre Codex, Dewey, Sadie, BSOD, Stacky o Fireball. Mientras Codex trabaja, la mascota muestra progreso. Hover para ver la tarea actual; cambias de tab y aparece un punto de notificación cuando algo te necesita.
Side chat
Abres un chat lateral desde tu conversación principal. Mismo contexto del proyecto, hilo distinto. Le preguntas algo rápido sin contaminar la sesión principal y lo cierras cuando terminas.
Personality: Friendly o Pragmatic
Pragmatic por default es la elección obvia: conciso, enfocado en la tarea, directo, sin filler. Friendly cuando quieres más conversación. Cambias con `/personality`.
Slash menu
Tecleas `/` y aparece el menú: `/personality`, `/pets`, `/skills`, `/browseruse`, `/pdf`, `/skillcreator` y más. Más limpio que recordar comandos sueltos.
@ mention para archivos y plugins
En lugar de pegar paths, escribes `@` y eliges el archivo o el plugin que quieres referenciar en el prompt. Mismo move que en GitHub o Linear.
Session bar (abajo del chat)
Te muestra cuánto context window queda y los límites de sesión (5 horas y semanal). Codex auto-compacta el contexto igual que Claude Code, así que rara vez tienes que manejarlo a mano.
Full access mode
Settings → General → Full access. Salta los prompts de aprobación: más rápido, más riesgo. Arranca en default y pásate a full cuando ya confíes en el proyecto.
el atajo real · mindset
La carpeta es portable
La conclusión del thread es la que importa más que todos los tips juntos. Tu carpeta de proyecto — con su AGENTS.md, sus skills en .codex/skills, sus prompts y su .env.local — es portátil. La abres en Codex, en Claude Code, en Cursor, o en cualquier cosa que hable markdown. Cambia el harness; el trabajo no.
Domina el patrón y dominaste el 97% de para qué sirven estas herramientas.
Stop asking which tool is the best. Start asking which tool is right for this specific job.
Fuente original: thread completo de Nate Herk en X. Documentación oficial: developers.openai.com. Para el equivalente del lado Anthropic, ve a la guía Claude Code Best Practices.
Guía de la comunidad
Esta guía es la traducción al español del thread completo de Nate Herk (@nateherk en X) sobre Codex, reorganizada con prompts y comandos copiables. Vive en la bóveda de tododeia, junto a las guías profundas de Claude Code y a los recursos curados para construir con IA todos los días. La idea: un solo lugar donde leer una vez, tener el copy-paste a la mano y poder volver cuando algo se rompa.
Claude Code Best Practices
El equivalente del lado Anthropic
6 Mejores Skills Claude
Skills que se traducen 1:1 a Codex
Awesome GPT Image 2
El mockup-first del paso 5
¿Por dónde empezar?
Si nunca has tocado Codex, abre una carpeta vacía y empieza por el primer starter prompt — el que dice "Redacta mi AGENTS.md desde cero". Codex te genera el archivo de onboarding en lenguaje natural; tú lo lees, lo editas y queda listo para todas las sesiones futuras. Después prende plan mode (Shift+Tab) y haz tu primer pedido real con calma. Si vienes de Claude Code, el mental model ya lo tienes — esta guía solo te marca dónde cambia el nombre del archivo, dónde está el slash menu y qué gotchas te ahorran 40 minutos en la primera automation.