Qué es Codex
Codex es el agente de programación de OpenAI para desarrollo de software. Puede usar Capriole AI mediante un proveedor de modelo personalizado configurado para enviar solicitudes a la API compatible con Responses de Capriole AI.
Requisitos previos
Antes de empezar, asegúrate de tener:
Instalación
Codex CLI
Codex app
Descarga la app desde OpenAI Codex.
Configuración
Crea o actualiza ~/.codex/config.toml:
Ejecutar Codex
Define tu clave API y luego inicia Codex:
Modelos compatibles
Codex usa los modelos OpenAI de Capriole AI a través de la API Responses. Usa los ID nativos de abajo con el selector de modelos y los ajustes de razonamiento integrados de Codex. No necesitas un model_catalog_json personalizado. Solo puedes invocar modelos compatibles con Capriole AI.
gpt-6-astragpt-6.1-solgpt-6-solgpt-6-lunagpt-5.6-terragpt-5.6-lunagpt-5.5
Usa Codex 0.159.2 o posterior para gpt-6.1-sol. Las versiones anteriores no incluyen sus metadatos de modelo y recurren a una configuración genérica.
La API también acepta los ID con el prefijo openai/ y openai-latest. El alias openai-latest sigue el modelo insignia de OpenAI recomendado por Capriole AI.
Solución de problemas
¿Por qué Codex devuelve un error de autenticación?
Confirma que CAPRIOLE_AI_API_KEY está exportada en el mismo shell antes de ejecutar codex.
¿Por qué Codex no encuentra el modelo?
Confirma que model_provider = "capriole_ai" está definido y que model es openai-latest o un ID de modelo OpenAI compatible de Capriole AI.
¿Por qué las solicitudes fallan con errores de endpoint o de protocolo?
Confirma que base_url = "https://api.caprioletech.com/v1" y wire_api = "responses" están definidos bajo [model_providers.capriole_ai].
¿Por qué Codex ignora el proveedor de Capriole AI?
No uses un ID de proveedor integrado reservado como openai; mantén el ID de proveedor personalizado como capriole_ai.
¿Por qué no se aplican los cambios de configuración?
Confirma que ~/.codex/config.toml es el archivo de configuración de usuario activo, confía en el proyecto antes de depender de un .codex/config.toml a nivel de proyecto y luego reinicia Codex.
Notas
Última modificación el 30 de septiembre de 2026
