Que es OpenAI Codex CLI?
Codex CLI es el agente de IA de OpenAI para la terminal. Corre localmente, edita archivos, ejecuta comandos, y se integra con tu editor. Es la herramienta oficial de OpenAI para desarrollo asistido por IA, sucesora de GitHub Copilot en el ecosistema OpenAI.
En esta guia completa te enseñaremos a instalarlo desde cero, configurarlo con diferentes proveedores de IA, asegurarlo correctamente, y sacarle el maximo partido con consejos profesionales y flujos de trabajo reales. Al final, como bonus, te explicamos como potenciarlo con las 1136 skills de SKILLSBUNDLE.
Requisitos del sistema
Antes de empezar, asegurate de que tu sistema cumple estos requisitos:
- Sistema operativo: macOS 12+, Windows 10+ (64-bit) o Ubuntu 20+ / Debian 11+ / Fedora 38+
- RAM: 8 GB minimo (16 GB recomendado para proyectos grandes)
- Disco: 500 MB para la herramienta + espacio para tus proyectos
- Node.js 18+ (si la instalacion es via npm)
- Python 3.9+ (para herramientas como Aider y Hermes Agent)
- Git (para herramientas que trabajan con repositorios)
- Conexion a internet (para descargar e instalar; para IA en la nube)
- Terminal: bash, zsh o PowerShell
Metodos de instalacion
Hay varias formas de instalar OpenAI Codex CLI. Elige la que mejor se adapte a tu sistema y preferencias:
Instalador oficial (recomendado)
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Este comando funciona en macOS y Linux. Codex CLI también se puede instalar desde la web de OpenAI.
npm
npm install -g openai-codex
Requiere Node.js 18+.
Homebrew (macOS)
brew install openai-codex
VS Code / Cursor / Windsurf
Codex está disponible como extensión para VS Code, Cursor y Windsurf. Búscalo en el marketplace de cada editor.
Verificar la instalacion
Una vez instalado, verifica que todo funciona:
codex --version o ejecuta: codex (debería abrir la interfaz CLI interactiva).
Si ves un error, revisa la seccion de solucion de problemas al final de la guia.
Configurar autenticacion y proveedores de IA
La mayoria de herramientas de IA requieren configurar al menos un proveedor de modelos. Aqui tienes las opciones disponibles para OpenAI Codex CLI:
Cuenta ChatGPT (recomendado)
codex login abre el navegador para autenticarte con OAuth de ChatGPT. Es el método más simple y seguro.
API Key de OpenAI
export OPENAI_API_KEY=sk-...
codex login --api-key # usa la API key directamente.
La API key se puede configurar en ~/.codex/config.toml.
Access Token
codex login --token ghp_... # para CI/CD y entornos headless
Enterprise SSO
Para equipos: autenticación SAML/SSO con políticas centralizadas desde el panel de administración de OpenAI.
Proveedores alternativos
No tienes por que limitarte a un solo proveedor. Aqui tienes una comparativa de los principales proveedores de IA que puedes usar:
| Proveedor | Autenticacion | Coste | Calidad | Notas |
|---|---|---|---|---|
| OpenAI GPT-5.6 | API directa | $$$$ | Excelente | Modelo más potente de OpenAI |
| OpenAI GPT-4.5 | API directa | $$$ | Excelente | Buen balance calidad/precio |
| OpenRouter | API key | $$ | Buena | Acceso a 300+ modelos |
| DeepSeek | API key | $ | Buena | Económico para tareas técnicas |
| Ollama | local | Gratis | Variable | Privacidad total, requiere GPU |
Seguridad: mejores practicas
La seguridad es critica cuando usas herramientas de IA que tienen acceso a tu sistema. Sigue estas recomendaciones:
- Modo sandbox: codex opera con sandbox_mode = 'workspace-write' por defecto. Solo escribe dentro del directorio del proyecto.
- Aprobación de acciones: approval_policy = 'untrusted' requiere aprobación para cada acción potencialmente destructiva.
- Shell environment policy: configura shell_environment_policy para filtrar variables de entorno sensibles (API keys, tokens, passwords).
- Audit hooks: Codex soporta hooks que registran cada acción del agente para auditoría.
- OTLP tracing: para entornos regulados, activa OpenTelemetry para trazabilidad completa.
- requirements.toml: los admins pueden forzar políticas de seguridad que los desarrolladores no pueden sobrescribir.
- No expongas el gateway de Codex a internet. Usa Tailscale para acceso remoto.
- Actualiza siempre: CVE-2025-61260 (CVSS 9.8) parcheado en v0.23.0. Mantén Codex actualizado.
Consejos profesionales
Una vez que OpenAI Codex CLI funciona, estos consejos te ayudaran a usarlo como un experto:
- Usa /model para cambiar de modelo sin salir de la sesión. Codex soporta gpt-5.6-sol, gpt-4.5, y más.
- /init crea un AGENTS.md con instrucciones para Codex sobre tu proyecto.
- /status muestra la configuración actual de la sesión: modelo, sandbox, permisos.
- /permissions configura lo que Codex puede hacer sin preguntar.
- /review antes de hacer commit para que Codex revise los cambios.
- Codex puede importar configuraciones de Claude Code: /import para migrar.
- Para CI/CD: usa codex exec con --sandbox workspace-write y --approval-policy never.
- El modo sandbox en Windows requiere configuración extra: /setup-default-sandbox como administrador.
Flujos de trabajo recomendados
Estos son los casos de uso mas potentes de OpenAI Codex CLI:
- Desarrollo guiado: describe una feature completa y Codex la implementa archivo por archivo
- Code review automatizado: /review 'encuentra bugs, vulnerabilidades y problemas de rendimiento'
- Refactorización: 'moderniza este código manteniendo la API pública y añadiendo tipos'
- Debugging: pega el error y pide 'encuentra la causa raíz y propon una solución'
- Documentación: 'genera documentación técnica completa para este proyecto'
- Automatización de CI/CD: 'crea un pipeline de GitHub Actions que ejecute tests, lint y deploy'
- Análisis de seguridad: 'revisa este código por vulnerabilidades OWASP Top 10'
- Migración: 'migra este proyecto de JavaScript a TypeScript progresivamente'
Solucion de errores comunes
command not found: codex
El binario no está en el PATH. Solución: reinstala con el instalador oficial o añade npm global al PATH.
Error de autenticación: 401
Tu API key o sesión han expirado. Solución: codex login de nuevo.
Codex no puede escribir archivos
El sandbox_mode está en 'read-only'. Solución: cambia a 'workspace-write' con /permissions.
El sandbox no funciona en Windows
Windows requiere configuración especial. Ejecuta /setup-default-sandbox como administrador.
Codex se niega a ejecutar un comando
La approval_policy está en 'untrusted'. Cambia a 'on-request' si confías en el contexto actual.
Error: modelo no encontrado
El modelo especificado no está disponible en tu plan. Usa /model para ver los modelos disponibles.
Codex consume muchos tokens
Las sesiones largas acumulan contexto. Usa codex -p para consultas rápidas (modo non-interactive).
Error de conexión a API
Verifica tu conexión a internet y que api.openai.com no esté bloqueado por tu firewall.
Preguntas frecuentes
¿Puedo usar varios proveedores a la vez?
Si, la mayoria de herramientas permiten configurar multiples modelos. Puedes usar uno rapido (Haiku, GPT-4o-mini) para tareas simples y uno potente (Opus, GPT-5) para tareas complejas.
¿Funciona sin conexion a internet?
Solo si usas modelos locales con Ollama, LM Studio o llama.cpp. Los modelos en la nube requieren conexion permanente.
¿Cual es el mejor proveedor para empezar?
OpenRouter: una sola API key, 300+ modelos, facturación consolidada. Puedes probar todos los modelos sin comprometerte con uno.
¿Como protejo mis API keys?
Usa variables de entorno (export CLAVE=valor), nunca las incluyas en el codigo, anade .env a .gitignore, y usa un gestor de secrets como 1Password o Bitwarden.
¿Puedo compartir mi configuracion con el equipo?
Comparte el archivo de configuracion sin las API keys. Usa variables de entorno para los secrets y documenta que variables necesita cada miembro del equipo.
Comparativa: como se compara con otras herramientas
| Caracteristica | Codex CLI | Claude Code | Aider |
|---|---|---|---|
| Tipo | Agente de terminal | Agente de terminal | Pair programming |
| Precio | ChatGPT Plus $20/mes | Pro $20/mes + API | Gratis + API key |
| Sandbox | read-only / workspace-write | Auto / Plan mode | Git commits |
| Auditoria | Hooks + OTLP traces | Logs nativos | Git log completo |
| Seguridad | requirements.toml, env policy | Binarios firmados | Revertible por Git |
| Ideal para | Entornos regulados | Desarrollo profesional | Refactorizacion |
Configuracion avanzada
Codex CLI ofrece opciones de seguridad y configuracion avanzadas:
- sandbox_mode: read-only (solo lectura), workspace-write (recomendado), danger-full-access (solo contenedor).
- approval_policy: untrusted (maxima seguridad), on-request, granular, never (solo CI/CD).
- shell_environment_policy: control granular de que variables de entorno ve el agente. Filtra API keys, tokens, passwords.
- requirements.toml: los admins pueden forzar politicas de seguridad que los desarrolladores no pueden sobrescribir.
- OTLP tracing: envia trazas estructuradas a un collector para auditoria centralizada.
- Hooks: scripts que se ejecutan en cada accion del agente para logging y auditoria.
- AGENTS.md: define el comportamiento y las reglas del agente para cada proyecto.
Ejemplos de uso reales
Estos son prompts reales que puedes usar para empezar a trabajar inmediatamente con tu herramienta recien instalada. Copia y pega, adapta segun tu proyecto:
# 1. Desarrollo de feature completo codex "Implementa un sistema de cache distribuido con Redis: - Conexion con reintentos y circuit breaker - Estrategia de invalidacion por tiempo y por evento - Tests de integracion con TestContainers - Documentacion de uso" # 2. Code review con sandbox codex --sandbox workspace-write "Revisa el directorio src/ en busca de: vulnerabilidades OWASP Top 10, code smells, y problemas de concurrencia" # 3. Automatizacion CI/CD codex "Crea un pipeline de GitHub Actions que: - Ejecute tests en paralelo para Node 18, 20, 22 - Haga linting y type checking - Construya la imagen Docker - Despliegue a staging si es main branch" # 4. Migracion de codigo codex "Traduce el modulo de autenticacion de Python a TypeScript: - Misma funcionalidad y casos de uso - Tipos estrictos de TypeScript - Tests equivalentes en Jest" # 5. Documentacion de API codex -p "Genera documentacion OpenAPI completa para src/routes/*.ts"
Bonus: Potencia OpenAI Codex CLI con 1136 skills de SKILLSBUNDLE
Ahora que OpenAI Codex CLI funciona perfectamente con tu proveedor de IA favorito, es momento de llevarlo al siguiente nivel. SKILLSBUNDLE te ofrece 1136 skills profesionales listos para usar.
Los skills son archivos de instrucciones que tu herramienta carga automaticamente segun el contexto. Con SKILLSBUNDLE obtienes:
- 40 verticales: marketing, finanzas, desarrollo web, SEO, diseno, y mas
- 15 tipos de uso: creacion de contenido, analisis de datos, automatizacion
- Skills transversales: code review, testing, documentacion, seguridad
- Optimizados y probados: cada skill ha sido refinado para dar resultados consistentes
Instalar los skills es directo:
# 1. Compra SKILLSBUNDLE en skillsbundle.com # 2. Descarga skills.zip # 3. Descomprime y copia las skills al directorio de tu herramienta unzip skills.zip -d ~/skillsbundle-pack cp -r ~/skillsbundle-pack/skills/* ~/codex/skills/ # 4. Verifica ls ~/codex/skills/ | wc -l # Deberias ver 1136
Una vez copiados, cada vez que uses OpenAI Codex CLI con un prompt que toque una vertical, la skill correspondiente se cargara automaticamente.
Incluye 1136 skills, actualizaciones gratuitas y soporte prioritario