
guía en español
Codex para diseño
Instalarlo, abrir tu primera sesión y darle el contexto de diseño que necesita para no entregar interfaces genéricas.
Qué es Codex
Codex es el agente de código de OpenAI. Lee tu proyecto, edita archivos y corre comandos mientras le hablas en lenguaje natural. Funciona en la terminal, en la app de escritorio de ChatGPT, como extensión de VS Code y en la nube. La CLI es open source.
Para quien diseña, el cambio es el mismo que con cualquier agente: trabajas directo sobre el material final, el código, sin esperar un handoff. Esta guía cubre lo justo para empezar; la documentación oficial tiene el resto.
Antes de empezar
- Cuenta
- Un plan de ChatGPT. La CLI viene con Plus, Pro, Business, Edu o Enterprise; también funciona con una API key.
- Sistema
- macOS, Linux o Windows, con instalador nativo en cada uno.
- Sin terminal
- Si nunca usaste una, empieza con la app de escritorio de ChatGPT, elige Codex y vuelve a esta guía para el contexto de diseño.
Instalar Codex
Abre una terminal y pega el comando de tu sistema. En Windows, hazlo desde una ventana nueva de PowerShell.
curl -fsSL https://chatgpt.com/codex/install.sh | sh
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
brew install --cask codex
npm install -g @openai/codex
Para actualizar, vuelve a correr el mismo instalador. Con Homebrew es brew upgrade --cask codex.
Abre una terminal nueva y comprueba la instalación.
codex --version
Fuente: Codex CLI en la documentación de OpenAI, revisada el 22 de noviembre de 2026.
Tu primera sesión
Entra a la carpeta de tu proyecto y arranca Codex. La primera vez elige Sign in with ChatGPT.
cd <carpeta de tu proyecto>codex
- Pregunta antes de pedir: “¿qué hace este proyecto?” o “¿dónde están los componentes?”. Lee los archivos que necesita, no hace falta pegarle código.
/permissionsdefine qué puede hacer sin preguntarte. Haz un commit antes de cada tarea para poder volver atrás./newempieza una conversación nueva,/statusmuestra el modelo y los permisos, ycodex resume --lastretoma la última. El resto está en la lista de comandos.
Darle contexto de diseño
Sin contexto, cualquier agente entrega lo mismo: el gris de siempre, tarjetas en todas partes, la tipografía por defecto. Cuatro piezas lo evitan.
1. AGENTS.md
Es el archivo de instrucciones que Codex lee antes de empezar. Escribe /init y genera uno a partir de tu proyecto. Agrega solo lo que el agente no puede descubrir solo.
2. DESIGN.md
Tu sistema de diseño en un archivo: tokens, reglas y ejemplos. Nómbralo en una regla de AGENTS.md para que lo lea antes de tocar la interfaz. Cómo escribirlo, con casos reales, está en la guía de DESIGN.md.
# AGENTS.md
Antes de cambiar cualquier interfaz, lee DESIGN.md y usa sus tokens.
Antes de crear un componente, revisa si ya existe uno en components/.
Revisa cada pantalla en tema claro y oscuro, y en mobile.
3. Skills
Una skill es una carpeta con un SKILL.md en .agents/skills/<nombre>/. Sirve para tareas que repites, como revisar accesibilidad o preparar assets. Escribe $ para mencionarla o /skills para ver la lista.
4. Imágenes
Codex acepta imágenes: pega una captura en la sesión o pásala con codex --image. Una referencia visual vale más que tres párrafos de “que se vea moderno”.
Primeros pedidos de diseño
Pedidos concretos, con el resultado que esperas y lo que no debe cambiar, funcionan mejor que “mejóralo”.
- Antes de cambiar nada, explícame cómo está organizado este proyecto y qué componentes de interfaz ya existen.
- Lee DESIGN.md y rehace la página de ajustes con sus tokens. Muéstrame el plan antes de editar.
- Te paso una captura de la referencia. Nombra la tipografía, el espaciado y la animación antes de construirla.
- Revisa esta pantalla en tema claro y oscuro y lista los textos con contraste insuficiente.
Preguntas frecuentes
¿Codex es gratis?
En parte. Los planes Free y Go de ChatGPT lo incluyen en la app de escritorio, según disponibilidad. La CLI viene con Plus, Pro, Business, Edu y Enterprise, o con una API key que se cobra aparte.
¿Necesito saber programar?
No para empezar, pero ayuda entender qué cambió. Codex te pide permiso antes de editar o correr comandos según el modo que elijas. Si nunca usaste una terminal, empieza con la app de escritorio.
¿Funciona en Windows?
Sí. Tiene un instalador nativo para PowerShell, y la app de escritorio de Windows trae su propio sandbox.
¿Puedo pasarle una captura o un diseño?
Sí. Pega la imagen en la sesión o usa codex --image con el primer pedido. Sirve para referencias visuales, capturas de errores y pantallas a recrear.
¿Cómo hago que respete mi diseño?
Escribe tu sistema de diseño en un DESIGN.md y pon en AGENTS.md la regla de leerlo antes de tocar la interfaz. Codex lee AGENTS.md al inicio de cada sesión.
Sigue leyendo
DESIGN.md en españolEl formato abierto para describirle tu sistema de diseño a un agente, con los casos de Crafter, Vercel y Supabase.
Claude Code para diseñoInstalarlo en macOS, Windows o Linux, la primera sesión y cómo darle contexto de diseño.
O vuelve a la guía de design engineering.
Instalarlo es el paso uno
Lo que no está en la documentación es cómo pedirle lo que admiras. Taste hacking es un curso en vivo, en español, para construir con agentes de IA interfaces, animaciones y videos con criterio. Las skills funcionan igual en Codex.
Anótate a la edición 02