Instala Codex CLI en tu entorno local

Qué es Codex CLI y por qué debería importarte

Codex CLI integra la asistencia de IA que conoces de ChatGPT directamente en tu flujo de trabajo local: puede inspeccionar tu repositorio, ejecutar comandos en la terminal y colaborar con tus pruebas y herramientas. Para equipos de desarrollo en Latinoamérica esto significa llevar sugerencias y automatizaciones de código al entorno donde realmente se escribe y prueba el software, sin depender exclusivamente de la interfaz web.

Aunque la instalación es rápida, las decisiones en el primer arranque —cuál carpeta confiar, cómo autenticarte, y qué permisos dar— son fundamentales para mantener la seguridad del proyecto y la privacidad de tu organización.

Antes de comenzar

Requisitos básicos:

Windows: PowerShell en una versión soportada. WSL2 es opcional.
macOS o Linux: un terminal con curl disponible.
Cuenta: una cuenta de ChatGPT o una clave de la OpenAI Platform API.
Workspace: un directorio de proyecto que ustedes controlen y confíen.

Si prefieren administrar herramientas con Homebrew o npm, existen instaladores alternativos (más abajo verán los comandos). Para entornos corporativos o con restricción de internet, consideren la ruta de autenticación por código de dispositivo.

Instalación: un comando para empezar

Abra un terminal y ejecute el instalador correspondiente a su sistema operativo.

macOS y Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows (PowerShell):

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

El instalador para Windows agrega Codex al PATH y, al finalizar, puede ofrecer iniciar la aplicación. Si les pregunta si desean arrancar Codex de inmediato y su terminal no está dentro del proyecto, respondan N hasta que estén en la carpeta correcta.

Métodos alternativos con gestores de paquetes

Si prefieren usar un package manager:

# Homebrew
brew install --cask codex

# npm
npm install -g @openai/codex

Homebrew es apropiado si ya usan Brew en macOS; npm es útil si Node.js administra sus herramientas globales.

Primer inicio: pasos que no deben saltarse

Abrir la carpeta del proyecto

Naveguen al repositorio donde quieren que Codex actúe y ejecuten el comando codex desde allí. Codex considerará el directorio actual como su workspace.

Windows PowerShell:

cd C:\Users\tu-usuario\code\mi-proyecto
codex

macOS o Linux:

cd ~/code/mi-proyecto
codex

Elegir cómo iniciar sesión

En el primer lanzamiento tendrán tres opciones de autenticación:

Sign in with ChatGPT: usa la cuota y los límites de su plan de ChatGPT.
Sign in with Device Code: útil para servidores SSH, contenedores o máquinas sin acceso directo al navegador.
Proporcionar una API key: facturación a través de la cuenta de la OpenAI Platform vinculada a esa clave.

Tengan en cuenta que OpenAI lista planes como Free, Go, Plus, Pro, Business, Edu y Enterprise, y que el uso por API se factura aparte.

Autorizar en el navegador

Si eligen la opción de ChatGPT, Codex imprimirá una URL que también puede abrir automáticamente en el navegador. Si no se abre, copien el enlace y péguenlo manualmente. Asegúrense de iniciar sesión con la cuenta correcta y confirmar la pantalla de autorización antes de regresar al terminal.

Revisar el aviso de primer arranque

De vuelta en el terminal, Codex confirmará la cuenta y mostrará un aviso sobre los niveles de autonomía. Léalo con atención; podrán ajustar estas preferencias más adelante con el comando /permissions.

Confiar en la carpeta adecuada

Codex pedirá confirmar la ruta que va a confiar. Esto habilita configuración específica del proyecto, hooks y políticas de ejecución. Verifiquen que la ruta sea la del repositorio correcto; si no lo es, salgan, cambien al directorio correcto y vuelvan a iniciar Codex.

Configurar el sandbox en Windows

En Windows nativo se solicitará cómo crear el sandbox. La opción recomendada es el sandbox por defecto (requiere aprobar un prompt de administrador). Ese modo usa usuarios con privilegios reducidos, límites en el sistema de archivos y reglas locales para minimizar riesgos. Si no hay posibilidad de elevación, existe un modo sin admin, pero ofrece menor aislamiento.

Primer prompt seguro

Una vez completada la autenticación y la configuración de carpeta/sandbox, empiezan con una tarea de solo lectura. Por ejemplo: “Explícame la estructura de este repositorio sin modificar archivos y enumera tres comandos para verificarlo localmente.” Esto confirma que Codex puede inspeccionar el repo sin efectuar cambios.

Comandos útiles después de la configuración

/status: muestra el modelo, directorio, cuenta y ajustes activos.
/permissions: revisa o cambia los permisos de lectura, edición y ejecución de Codex.
/model: selecciona el modelo y el esfuerzo de razonamiento disponible.
/init: crea un archivo AGENTS.md para instrucciones específicas del repositorio.
/review: permite revisar cambios antes de confirmarlos en el control de versiones.
/exit: cierra el CLI de forma ordenada.

Mantengan el límite de workspace por defecto a menos que la tarea requiera acceso adicional; consulten la documentación de permisos para entender los perfiles read-only, workspace y full-access.

Actualizaciones

Si instalaron Codex con el instalador independiente, pueden actualizar reutilizando el mismo comando de instalación. El instalador sirve tanto para instalar como para actualizar.

macOS o Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows (PowerShell):

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

Si usaron Homebrew o npm, actualicen mediante esos gestores.

Consejos prácticos para equipos en Latinoamérica

Revisen políticas de seguridad locales y de la empresa antes de conectar herramientas que ejecuten código en su entorno de desarrollo.
Para desarrolladores que trabajen desde conexiones móviles o con restricciones de red, la autenticación por Device Code puede evitar problemas con callbacks en el navegador.
En entornos de infraestructura compartida (servidores remotos o contenedores), piensen en usar cuentas y llaves API gestionadas por el equipo para controlar la facturación y el acceso.

Conclusión

Codex CLI acerca capacidades de IA al mismo lugar donde se escribe código, pero su potencia exige decisiones conscientes sobre permisos y confianza en directorios. Siguiendo los pasos de esta guía podrán instalarlo y realizar un primer arranque seguro en Windows, macOS o Linux. Mantengan siempre la precaución sobre qué carpetas confían y utilicen prompts de solo lectura al comenzar.

Preguntas frecuentes rápidas

¿Puedo usar Codex en servidores sin navegador? Sí: el método de Device Code está pensado para SSH y contenedores.
¿La facturación es la misma que en ChatGPT web? Depende: usar la sesión de ChatGPT comparte la cuota del plan; usar una API key factura a la cuenta de la OpenAI Platform.
¿Es obligatorio usar sandbox en Windows? No, hay un modo sin admin, pero ofrece menos aislamiento; el modo recomendado usa elevación para crear un sandbox más seguro.