Codex CLI es un asistente de programación con IA de código abierto que se ejecuta localmente en tu terminal mientras se conecta a modelos de IA remotos a través de APIs. Creado en Rust para ofrecer rendimiento y seguridad, puede leer, modificar y ejecutar código en el directorio que elijas, manteniendo estrictas protecciones de sandbox.
Esta guía te muestra cómo configurar Codex CLI con modelos de IA avanzados a través de Novita AI, incluyendo modelos especializados en programación como Qwen Coder, modelos centrados en razonamiento como DeepSeek y modelos agenticos como Kimi K2.
¿Qué es Codex CLI?
Codex CLI es un agente de programación basado en terminal que combina la ejecución local con capacidades de IA en la nube. A diferencia de las herramientas de generación de código que solo producen fragmentos de código, Codex CLI puede entender todo tu proyecto, ejecutar el código que crea, depurar errores e iterar hasta que las soluciones funcionen correctamente.
Características clave
Arquitectura primero local: Se ejecuta completamente en tu máquina mientras realiza llamadas a APIs de modelos de IA. Tu código se mantiene local mientras aprovechas las potentes capacidades de IA en la nube.
Comprensión de proyectos: Lee toda tu base de código, entiende los patrones existentes, las dependencias y el estilo de programación para generar código que se integre perfectamente en tu proyecto.
Operación autónoma: Puede trabajar de forma independiente durante períodos prolongados, descomponiendo tareas complejas y ejecutándolas de forma sistemática con una supervisión mínima.
Modos de aprobación flexibles:
- Modo de sugerencia: Solicita aprobación en cada paso (predeterminado)
- Modo de edición automática: Edita archivos automáticamente pero pregunta antes de ejecutar comandos
- Modo completamente automático: Autonomía total sin solicitar confirmaciones
Características de seguridad: Se ejecuta en entornos con red deshabilitada y sandbox de directorio para proteger tu sistema manteniendo toda la funcionalidad.
Codex CLI frente a Claude Code: Diferencias clave
Antes de profundizar en la configuración de Codex CLI, es importante entender en qué se diferencia de Claude Code, otro popular asistente de programación con IA:
Codex CLI
- Soporte de modelos: Es compatible con modelos de OpenAI y APIs compatibles con OpenAI, con soporte para múltiples proveedores
- Arquitectura: Agente local que se ejecuta en tu terminal con llamadas a APIs de modelos remotos
- Código abierto: Totalmente de código abierto con contribuciones de la comunidad
Claude Code
- Soporte de modelos: Se centra en los modelos Claude de Anthropic y APIs compatibles con Anthropic
- Arquitectura: Experiencia integrada en plataformas web, de escritorio e IDE
- Desarrollo: Núcleo propietario con acceso a API
Codex CLI es superior por su precisión y capacidad para manejar tareas complejas, especialmente en bases de código existentes. Claude Code suele ser preferido por su experiencia de usuario y configuraciones iniciales de proyectos. Algunos usuarios obtienen los mejores resultados combinando ambas herramientas.
Para flujos de trabajo específicos de Claude, consulta nuestra guía para usar Claude Code con Novita AI.
¿Por qué usar APIs de terceros con Codex CLI?
Aunque Codex CLI es compatible de forma nativa con los modelos de OpenAI, las APIs de terceros como Novita AI ofrecen ventajas clave:
Modelos especializados: Accede a modelos de vanguardia como DeepSeek V3.1 para razonamiento, Qwen Coder para programación y Kimi K2 para flujos de trabajo agenticos.
Coste y rendimiento: Precios competitivos con modelos optimizados para tareas específicas, desde respuestas ligeras hasta resolución de problemas complejos.
Modelos personalizados: Con Novita AI, incluso puedes usar tus propios modelos personalizados rápidamente en Codex CLI para requisitos especializados.
Fiabilidad: Los proveedores alternativos reducen los límites de tasa y garantizan acceso constante durante fallos o restricciones regionales.
Cómo acceder a los modelos de Novita AI en Codex CLI
Requisitos previos
- Crea una cuenta: Visita el sitio web de Novita AI y regístrate para obtener una cuenta.
- Genera tu clave de API: Después de iniciar sesión, ve a la página de Gestión de claves para generar tu clave de API.
- Selecciona un nombre de modelo: Tendrás que copiar el nombre del modelo que quieras usar de la Biblioteca de modelos de Novita AI. Algunos modelos disponibles incluyen:
deepseek/deepseek-v3.1qwen/qwen3-coder-480b-a35b-instructmoonshotai/kimi-k2-0905openai/gpt-oss-120bzai-org/glm-4.5google/gemma-3-12b-it
- Guárdala de forma segura: La necesitarás para la configuración.
Instalación
Instalar vía npm (Recomendado)
npm install -g @openai/codex
Instalar vía Homebrew (macOS)
brew install codex
Verificar la instalación
codex --version
Configuración de modelos de Novita AI
Configurar el archivo de configuración
Codex CLI usa un archivo de configuración TOML ubicado en:
- macOS/Linux:
~/.codex/config.toml - Windows:
%USERPROFILE%\.codex\config.toml
Plantilla de configuración básica
model = "MODEL_NAME"
model_provider = "novitaai"
[model_providers.novitaai]
name = "Novita AI"
base_url = "https://api.novita.ai/openai"
http_headers = {"Authorization" = "Bearer YOUR_NOVITA_API_KEY"}
wire_api = "chat"
Modelos disponibles y cuándo usarlos
| Modelo | Ideal para | Puntos fuertes |
|---|---|---|
deepseek/deepseek-v3.1 |
Algoritmos complejos y arquitectura | Razonamiento y resolución de problemas superiores |
qwen/qwen3-coder-480b-a35b-instruct |
Generación de código y refactorización | Especializado en tareas de programación |
moonshotai/kimi-k2-0905 |
Flujos de trabajo agenticos y automatización | Ejecución rápida, manejo de contexto largo |
openai/gpt-oss-120b |
Tareas generales de desarrollo | Rendimiento base fiable |
zai-org/glm-4.5 |
Integración de herramientas y depuración | Alta tasa de éxito en llamadas a herramientas |
google/gemma-3-12b-it |
Tareas de desarrollo ligeras | Respuestas eficientes y rápidas |
Primeros pasos
Iniciar Codex CLI
codex
Ejemplos de uso básico
Generación de código:
> Create a Python class for handling REST API responses with error handling
Análisis de proyectos:
> Review this codebase and suggest improvements for performance
Corrección de errores:
> Fix the authentication error in the login function
Pruebas:
> Generate comprehensive unit tests for the user service module
Trabajar con proyectos existentes
Navega al directorio de tu proyecto antes de iniciar Codex CLI:
cd /path/to/your/project
codex
Codex CLI entenderá automáticamente la estructura de tu proyecto, leerá los archivos existentes y mantendrá el contexto sobre tu base de código durante toda la sesión.
Conclusión
Codex CLI con modelos de Novita AI proporciona un entorno de desarrollo potente y flexible que combina el control local con las capacidades de la IA en la nube. Al elegir el modelo adecuado para cada tarea y configurar tu entorno correctamente, puedes acelerar significativamente tu flujo de trabajo de desarrollo manteniendo la calidad y seguridad del código.
Comienza con la configuración básica usando Qwen Coder para tareas generales de desarrollo, luego experimenta con modelos especializados como DeepSeek para razonamiento complejo o Kimi K2 para flujos de trabajo autónomos a medida que evolucionen tus necesidades.
Sobre Novita AI
Novita AI es una plataforma de IA en la nube que ofrece a los desarrolladores una forma sencilla de desplegar modelos de IA usando nuestra API simple, además de proporcionar una nube de GPU asequible y fiable para construir y escalar.
Lecturas recomendadas
