Guía de Codex CLI para principiantes: de la instalación a tu primera tarea de programación con IA

Lo que enseña este tutorial

Codex CLI es el agente de codificación de OpenAI que se ejecuta en tu terminal. Puede inspeccionar tu proyecto, editar archivos, ejecutar comandos y automatizar tareas repetitivas, todo desde la línea de comandos. Al final de este tutorial podrás instalar Codex CLI en Windows, macOS o Linux, iniciar sesión y completar tu primera tarea de codificación asistida por IA.

Tiempo necesario: 15–20 minutos

Dificultad: Principiante

Antes de empezar

¿Qué es una terminal? Una terminal (también llamada línea de comandos) es una ventana donde escribes comandos en lugar de hacer clic en botones. En Windows se llama PowerShell; en macOS se llama Terminal. En este tutorial, los comandos codex se escriben en esta ventana y se ejecutan con Enter.

¿Qué es Node.js? Node.js es un programa gratuito que te permite instalar herramientas con el comando npm. Solo lo necesitas si eliges el método de instalación con npm. Si no lo tienes, instálalo desde nodejs.org (elige la versión LTS).

¿Qué es una clave de API? Una clave de API es un código secreto que identifica tu cuenta cuando pagas por uso. Se genera una vez en platform.openai.com → API keys. Trátala como una contraseña: nunca la compartas.

Cómo abrir tu terminal (paso a paso)

Si no sabes cómo abrir una terminal, sigue los pasos de tu sistema a continuación. La usarás para todos los comandos de este tutorial.

Descarga e instalación

Elige tu versión

¿Qué es Homebrew? Homebrew es un gestor de paquetes gratuito para macOS. Escribes brew install para instalar programas, como una tienda de aplicaciones para la línea de comandos. Solo elige esta opción si ya usas Homebrew.

Instala para tu sistema

Selecciona tu sistema en el panel inferior. Cada pestaña contiene todos los pasos completos para ese sistema.

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

codex --version

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Inicia sesión

1. 1Abre una terminal y ve a una carpeta de proyecto (reemplaza path/to/your/project con tu propia ruta):

cd path/to/your/project

1. 1Inicia Codex:

codex

1. 1La primera vez, elige un método de inicio de sesión:

• Iniciar sesión con ChatGPT — usa tu cuenta de ChatGPT (suscripción). Se abre una ventana del navegador; después de iniciar sesión, el navegador devuelve tus credenciales a Codex automáticamente.
• Usar una clave de API — pega la clave que generaste en platform.openai.com cuando se te pida.

1. 1Después de iniciar sesión, verás el indicador de Codex, listo para tu primera tarea.

Solución de problemas de instalación

Solución para "codex: command not found" — Windows:

1. 1Pulsa la tecla de Windows, escribe variables de entorno y haz clic en Editar las variables de entorno del sistema.
2. 2Haz clic en el botón Variables de entorno....
3. 3En la lista inferior (Variables del sistema), busca Path, selecciónala y haz clic en Editar....
4. 4Haz clic en Nueva, añade la carpeta donde se instaló Codex (por defecto: C:\Users\<tu nombre de usuario>\.local\bin) y haz clic en Aceptar en cada ventana.
5. 5Cierra PowerShell por completo y vuelve a abrirlo, luego ejecuta codex --version.

Solución para "codex: command not found" — macOS/Linux:

1. 1Abre Terminal y ejecuta este comando:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

1. 1Recarga la configuración:

source ~/.zshrc

1. 1Si usas Bash en lugar de Zsh, usa ~/.bashrc en ambos comandos anteriores.
2. 2Ejecuta codex --version para confirmar.

Tu primera tarea

Paso 1: Abre un proyecto

Ve a la carpeta del proyecto en la que quieras que Codex trabaje (reemplaza la ruta con la tuya):

cd path/to/your/project

Paso 2: Inicia Codex

codex

Paso 3: Haz tu primera pregunta

Escribe esta solicitud y pulsa Enter:

Tell me about this project

Codex leerá los archivos del proyecto y explicará lo que encuentra. Prueba algunas más:

• Explain the main function in this file — explica la función principal de este archivo
• Find the bug in this code — encuentra el error en este código
• Add a comment header to every file — añade un encabezado de comentario a cada archivo

Paso 4: Aprueba lo que Codex quiere hacer

Cuando Codex quiera editar archivos o ejecutar comandos, pedirá tu permiso primero. Esto es normal. Escribe y y pulsa Enter para aprobar, o n para rechazar. Revisa cada cambio: tú mantienes el control de lo que ocurre en tu máquina.

Paso 5: Sal de Codex

Cuando termines, escribe /exit y pulsa Enter, o pulsa Ctrl + C dos veces.

Comandos útiles

Preguntas frecuentes

¿Necesito un plan de pago?

Necesitas una suscripción de ChatGPT o una clave de API de OpenAI. El plan gratuito de ChatGPT no incluye acceso a Codex CLI. Consulta la página de precios oficial para ver las opciones actuales.

¿Codex funciona fuera de un repositorio git?

Codex funciona mejor dentro de un proyecto git. Si empiezas desde cero, crea un repositorio primero:

git init

¿Codex puede ejecutar mi código?

Sí, con tu permiso. Codex puede ejecutar comandos y pruebas en tu máquina, y siempre te muestra lo que va a ejecutar antes de preguntar. Usa la configuración de permisos para controlar lo que puede hacer sin preguntar.

¿Mi código se envía a OpenAI?

Cuando usas Codex con modelos de OpenAI, tus solicitudes y el contenido de los archivos se procesan según los controles de datos de tu tipo de cuenta (suscripción o configuración de la organización de API). Consulta la documentación oficial de controles de datos.

Qué sigue

• Añade guía de proyecto: Crea un archivo AGENTS.md en tu repositorio para dar a Codex instrucciones duraderas sobre tu proyecto.
• Automatiza con scripts: Usa codex exec en pipelines de CI y flujos de trabajo repetibles.
• Conecta herramientas con MCP: Usa codex mcp para dar a Codex acceso a datos y servicios externos.
• Prueba Codex cloud: Deja las tareas de larga duración en la nube y vuelve al terminal más tarde.