Cómo usar Codex: instalar, iniciar sesión y primera tarea

En resumen

• Instala Codex, ejecuta codex en tu proyecto e inicia sesión con ChatGPT.
• Describe una tarea pequeña, revisa los cambios y acéptalos o recházalos.
• Pon tus reglas en un archivo AGENTS.md para que Codex las siga siempre.

¿Qué es Codex?

Somos RocketLauncher, una empresa de software, y usamos tanto Codex como Claude Code. Codex es el agente de programación de OpenAI. Le das una tarea con palabras normales. Lee tu proyecto, hace un plan, edita archivos y puede ejecutar comandos. Puedes usarlo en varios sitios:

• La CLI, en tu terminal.
• Una extensión de IDE para VS Code, Cursor y Windsurf, además de soporte nativo en Xcode y en los IDE de JetBrains.
• Una app de escritorio.
• Codex en la web, para tareas que delegas y revisas más tarde.

Esta guía usa la CLI, porque las demás opciones funcionan igual una vez que la conoces. Nuestro centro de Codex reúne más recursos.

Lo que necesitas

• Un ordenador con terminal. En Windows puedes usar la app de Windows, el sandbox de Windows o WSL. Mira la documentación de OpenAI para ver las opciones actuales.
• Una cuenta de ChatGPT. Qué planes incluyen Codex, y cuánto uso tienen, cambia con el tiempo. Mira la página de precios actual de Codex.
• Una carpeta de proyecto, mejor si está bajo git.

Cómo instalar y empezar

1. Abre la página actual de la CLI de Codex en OpenAI y copia el comando de instalación de tu sistema. En macOS y Linux es un script de una línea. Allí también aparecen las opciones para Windows, npm y Homebrew.
2. Abre una terminal y entra en la carpeta de tu proyecto.
3. Ejecuta codex.
4. En la primera ejecución, elige Sign in with ChatGPT, u otro método de inicio de sesión si prefieres.
5. Espera al prompt. Ya está listo.

Nunca pegues una clave de API en un chat ni la subas a git. Guarda las claves en variables de entorno.

Tu primera tarea

1. Haz un commit de tu trabajo primero. Un checkpoint de git antes y después de una tarea te permite deshacer cualquier cosa.
2. Empieza con una petición de solo lectura, por ejemplo: "Cuéntame sobre este proyecto."
3. Lee la respuesta. Comprueba que Codex entendió la estructura.
4. Pide un cambio pequeño: "Añade una sección al README que explique cómo ejecutar los tests."
5. Revisa lo que propone Codex. Aprueba la edición o pide algo distinto.
6. Pídele que ejecute los tests o el build y lee el resultado.
7. Haz commit si estás conforme.

Mantén las tareas pequeñas

Las tareas pequeñas dan mejores resultados. "Arregla el formato de fecha en la página de facturas" funciona mejor que "mejora toda la app". Si la tarea es grande, pide primero un plan a Codex y avanza paso a paso.

Controla lo que Codex puede hacer

Usa el comando /permissions para elegir cuándo Codex puede editar archivos o ejecutar comandos sin preguntar. Un patrón seguro:

• Empieza con Codex preguntando antes de cada edición y cada comando.
• Permite las ediciones dentro de la carpeta del proyecto cuando confíes en la tarea.
• Deja bajo aprobación manual los comandos que tocan la red, borran archivos o hacen deploy.

Configura AGENTS.md

AGENTS.md es un archivo markdown en la raíz de tu proyecto. Les dice a los agentes de programación cómo trabajar en tu repositorio. Codex lo lee antes de empezar.

1. En Codex, ejecuta /init. Crea un AGENTS.md inicial.
2. Edítalo. Mantenlo corto y concreto.
3. Haz commit para que todo el equipo comparta las mismas reglas.

Cosas útiles para incluir:

• Cómo instalar, compilar y probar, con los comandos exactos.
• Reglas de estilo de código y carpetas prohibidas.
• Palabras o patrones que se deben evitar.
• Qué significa "terminado", por ejemplo "los tests pasan y el lint está limpio".

Otras herramientas también leen este formato. Claude Code puede usar un archivo AGENTS.md si tu repositorio lo tiene, y muchos equipos mantienen un solo archivo para las dos herramientas.

Usa Codex en tu editor

Para VS Code, Cursor o Windsurf, instala la extensión de Codex y haz clic en el icono de Codex, o ejecuta "Codex: Open Codex Sidebar" desde la paleta de comandos. Inicia sesión y empieza un chat. Puedes añadir archivos abiertos o selecciones a tu prompt, revisar los diffs en el sitio y enviar trabajos más grandes a Codex en la web.

Prompts que funcionan bien

• "Explica cómo funciona el login en este proyecto. No cambies ningún archivo."
• "Escribe un plan para añadir un formulario de contacto. Lista los archivos que vas a tocar."
• "Arregla el test que falla en el módulo de facturas y vuelve a ejecutar los tests."
• "Revisa mi último commit en busca de errores y tests que falten."

Un buen prompt indica el objetivo, el lugar en el código y cómo comprobar el resultado. Si Codex va por mal camino, páralo, dile lo que querías y prueba otra vez. También puedes pedirle que deshaga su último cambio.

Errores comunes

• Dar una tarea enorme en un solo prompt.
• Saltarse git y luego no tener forma de volver atrás.
• Aprobar todos los comandos sin leerlos.
• Dejar AGENTS.md vacío y repetir las mismas reglas en cada prompt.

Conviértelo en un servicio con GoHighLevel

Mucha gente usa Codex para crear cosas pequeñas para negocios locales, como una página de reservas, un formulario de leads o un conjunto de automatizaciones de seguimiento, y luego las ejecuta en GoHighLevel. Codex ayuda a escribir y corregir el código, y GoHighLevel se encarga de contactos, mensajes, calendarios y pagos. Nuestro kit Claude Code + GoHighLevel muestra el proceso completo, y los mismos pasos sirven con Codex. También puedes ver los demás kits para crear y vender. No prometemos ingresos. Los resultados dependen de tu trabajo y de tus clientes.