Saltar al contenido principal

​
Introducción

Codex CLI es el agente de programación de terminal de código abierto de OpenAI, capaz de leer y escribir archivos, ejecutar comandos, corregir errores y completar tareas de programación completas directamente en la línea de comandos. Al conectarse a través de APIMart, puede usar libremente múltiples modelos —incluyendo GPT y Claude— en Codex CLI, con precios más flexibles y competitivos.

​
Requisitos previos

Antes de comenzar, asegúrese de tener:
  1. Node.js instalado Descargue e instale desde el sitio web de Node.js (se recomienda la última LTS, v20 o más reciente) para instalar Codex CLI mediante npm
  2. Una clave de API de APIMart Acceda a la Consola de APIMart para obtener su clave de API (comienza con sk-)
Consejo: Si aún no tiene una cuenta en APIMart, regístrese primero en APIMart y obtenga su clave de API.

​
Paso 1: Instalar Codex CLI

Elija cualquiera de los siguientes métodos para instalar:
Instalación global con npm: funciona en todos los sistemas operativos:
npm install -g @openai/codex
Si tiene problemas de permisos, anteponga sudo (macOS / Linux).

​
Verificar la instalación

Tras instalar, ejecute el siguiente comando para confirmar: 
codex --version
Si se imprime un número de versión, la instalación fue correcta.

​
Paso 2: Configurar la API de APIMart

Codex CLI gestiona los proveedores de modelos mediante archivos de configuración bajo el directorio ~/.codex/. Todo lo que necesitamos hacer es añadir un proveedor personalizado que apunte a APIMart.

​
2.1 Localizar el directorio de configuración

  • macOS / Linux: ~/.codex/
  • Windows: C:\Users\<username>\.codex\
Si el directorio no existe, ejecute codex una vez en su terminal y luego pulse Ctrl + C para salir; se creará automáticamente.

​
2.2 Configurar la clave de API

En el directorio de configuración, cree o edite el archivo auth.json e introduzca su clave de APIMart: 
{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}
CampoDescripción
OPENAI_API_KEYSu clave de API de APIMart (comienza con sk-)

​
2.3 Configurar el proveedor de modelos

En el directorio de configuración, cree o edite el archivo config.toml y añada el proveedor APIMart: 
# Default model
model = "gpt-5.5"
# Default provider — matches [model_providers.apimart] below
model_provider = "apimart"

# APIMart provider configuration
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true
CampoDescripción
modelID del modelo predeterminado: elija uno de la lista de modelos a continuación
model_providerProveedor predeterminado: debe coincidir con el ID dentro de [model_providers.xxx]
nameNombre para mostrar del proveedor: se puede personalizar
base_urlURL compatible con OpenAI de APIMart: fija como https://api.apimart.ai/v1
wire_apiProtocolo de comunicación: las versiones recientes de Codex requieren responses (Responses API)
requires_openai_authEstablezca en true para autenticarse usando la clave de auth.json
Tras guardar ambos archivos, reinicie Codex CLI para que los cambios surtan efecto.
Asegúrese de que auth.json sea JSON válido y config.toml sea TOML válido. No use comillas tipográficas o de ancho completo, de lo contrario la configuración no se aplicará.

​
Paso 3: Comenzar

​
Verificar la configuración

En cualquier directorio de proyecto, ejecute el siguiente comando para confirmar que todo está conectado: 
codex "Introduce yourself in one sentence"
Si obtiene una respuesta de IA, la configuración está funcionando. Si ve una pantalla de inicio de sesión o errores 401 / 403, consulte la sección de preguntas frecuentes a continuación.

​
Modo interactivo

Ejecute codex directamente para entrar en la interfaz interactiva: ideal para tareas de programación completas: 
codex
Una vez dentro, describa lo que necesita en lenguaje natural, p. ej.: 
Create an Express.js server with a JSON-returning health check endpoint
Codex analizará su proyecto, generará código, ejecutará comandos y solicitará confirmación antes de realizar operaciones sensibles.

​
Modos de aprobación

En la primera ejecución, Codex le pedirá que elija un nivel de aprobación:
ModoDescripción
Read OnlySolo se permiten lecturas de archivos: cualquier modificación o comando requiere confirmación
AutoPuede leer/escribir archivos y ejecutar comandos dentro del directorio de trabajo (recomendado)
Full AccessRealiza cualquier operación sin confirmación: usar con precaución
Recomendamos comenzar con el modo Auto. Escriba /approvals en la interfaz interactiva para cambiarlo en cualquier momento.

​
Cambiar de modelo

En la interfaz interactiva, escriba /model para cambiar rápidamente, o cambie el campo model en config.toml y reinicie.

​
Modelos compatibles

Para Codex CLI, se recomiendan los siguientes modelos de la serie GPT-5:
ID del modeloFortalezasCasos de uso recomendados
gpt-5.5Buque insignia más reciente, máxima capacidad de programaciónPrimera opción para Codex, ingeniería compleja
gpt-5.4Buque insignia de generación anterior, muy capazProgramación compleja, diseño de arquitectura
gpt-5.4-miniLigero, rápido, económicoProgramación diaria, iteración rápida
gpt-5.3-codexModelo de programación optimizado para CodexTareas de programación agéntica
gpt-5.2Estable y equilibradoTareas de programación rutinarias
Consejos para elegir un modelo: La serie GPT-5 anterior se combina mejor con Codex CLI. Para la mejor experiencia, prefiera gpt-5.5; gpt-5.3-codex está específicamente optimizado para los escenarios de programación agéntica de Codex.

​
Comandos comunes

Comandos y atajos usados con frecuencia en Codex CLI:
ComandoDescripción
codexEntrar en la interfaz interactiva
codex "task"Comenzar con una instrucción inicial
codex exec "task"Modo no interactivo: ejecutar y salir
codex --model gpt-5.4Comenzar con un modelo especificado
codex --versionMostrar el número de versión
/modelCambiar de modelo dentro de la interfaz interactiva
/approvalsAjustar el modo de aprobación dentro de la interfaz
Ctrl + CSalir de la interfaz interactiva

​
Preguntas frecuentes

​
Q1: ¿Aparece una pantalla de inicio de sesión de ChatGPT después del lanzamiento?

Si ve “Sign in with ChatGPT” o similar después del lanzamiento, la configuración no se aplicó. Solución de problemas:
  1. Asegúrese de que tanto config.toml como auth.json estén dentro de ~/.codex/
  2. Verifique que model_provider en config.toml esté configurado como apimart
  3. Verifique que auth.json sea JSON válido y que la clave esté completamente introducida

​
Q2: ¿Errores 401 / 403?

Código de estadoSignificadoSolución
401 UnauthorizedClave de API ausente o inválidaVerifique la clave en auth.json: debe comenzar con sk-
403 ForbiddenPermisos insuficientes o clave expiradaVaya a la Consola para verificar la clave
Asegúrese también de que base_url esté configurado como https://api.apimart.ai/v1, y no la URL oficial de OpenAI.

​
Q3: ¿Conexión fallida?

  1. Verifique su conexión de red
  2. Asegúrese de que base_url en config.toml sea correcto
  3. Si está detrás de un proxy, asegúrese de que permita el acceso a api.apimart.ai

​
Q4: ¿wire_api = "chat" ya no es compatible?

Las versiones recientes de Codex CLI (0.84.0 y posteriores) han eliminado el protocolo chat. Actualice wire_api en config.toml a responses: 
wire_api = "responses"
APIMart admite la Responses API: simplemente reinicie Codex después del cambio.

​
Q5: ¿Fallan las llamadas a herramientas o las ejecuciones?

Asegúrese de que wire_api en config.toml esté configurado como responses. Si aún tiene problemas de compatibilidad, cambie a un modelo de la serie GPT-5 recomendado (p. ej., gpt-5.5, gpt-5.3-codex): se combinan de forma más fiable con Codex CLI.

​
Q6: ¿Usar variables de entorno en lugar de auth.json?

También puede configurar la clave mediante una variable de entorno. Cambie el bloque del proveedor en config.toml a: 
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
env_key = "APIMART_API_KEY"
Luego establezca la variable de entorno APIMART_API_KEY con su clave de APIMart. auth.json ya no es necesario en esta configuración.

​
Q7: ¿Cómo cambio de modelo?

Dos maneras:
  1. En la interfaz interactiva: Escriba /model para cambiar
  2. Edite la configuración: Cambie el campo model en config.toml y reinicie Codex CLI

​
Q8: ¿Cómo verificar el uso y la facturación?

Acceda a la Consola de APIMart para ver estadísticas de llamadas a la API, detalles de consumo de tokens y tendencias de costos.

​
Soporte y ayuda

Si tiene algún problema al usar Codex CLI:

Comience con APIMart

¡Regístrese en APIMart ahora, obtenga su clave de API y experimente un asistente de programación multimodelo en Codex CLI!