Saltar al contenido principal
Use una DGrid Model API Key para las solicitudes a los modelos. Una Management API Key es una credencial administrativa y no sirve para este tutorial. Compruebe que la clave tenga saldo disponible y acceso al modelo seleccionado.
Conecte Codex CLI o Codex en la aplicación de escritorio con DGrid mediante su clave API, la URL base de Responses y el ID completo del modelo. La descarga actual es la aplicación ChatGPT que incluye Codex. Algunas instalaciones conservan el nombre Codex. Obtenga la aplicación en la página oficial. Esta guía usa openai/gpt-6-sol. Las capturas y el procedimiento de escritorio corresponden a macOS; también se incluyen instrucciones de instalación y CLI para Windows.

Antes de empezar

  • Una cuenta de DGrid con saldo y acceso a un modelo compatible con la API Responses.
  • Una clave API de DGrid: inicie sesión y cree o copie una clave desde API Keys.
  • Para instalar con npm necesita Node.js y npm. El método de escritorio es independiente de la CLI.
No muestre la clave completa en capturas ni archivos compartidos. Conserve el ID completo, incluido el prefijo openai/.
Si Codex indica un error de metadatos o catálogo, solicite a DGrid los ajustes adecuados para su versión. Los alias personalizados pueden necesitar metadatos correspondientes. No suponga una URL de catálogo. Consulte la guía oficial de configuración de pasarelas.

Elegir el método de configuración

El perfil de CLI selecciona DGrid para las ejecuciones iniciadas con ese perfil. Editar el archivo principal cambia el proveedor predeterminado de los clientes que lo leen. Si depende de su entorno de escritorio actual, siga el procedimiento en otro equipo. Ambos métodos usan estos parámetros de conexión:

1. Instalar Node.js y Codex CLI

Si es necesario, instale la versión LTS actual desde la página de Node.js. Ejecute el instalador de macOS o Windows; los instaladores estándar incluyen npm.Abra Terminal en macOS o PowerShell en Windows y compruebe:
Siga el método oficial de instalación de Codex con npm.macOS: instale en su directorio de usuario.
El comando PATH solo se aplica al terminal actual. Repítalo en nuevos terminales o añada el directorio a la configuración PATH del intérprete.Windows PowerShell:
Si PowerShell bloquea npm.ps1, use npm.cmd en lugar de npm.Las capturas usan codex-cli 0.163.0. El formato de perfil separado se aplica a Codex 0.134.0 y posteriores; consulte los perfiles de configuración.

2. Crear un perfil de DGrid

Cree ~/.codex/dgrid.config.toml en macOS o %USERPROFILE%\.codex\dgrid.config.toml en Windows. Pegue este contenido:
En macOS puede crear y abrir el archivo así:
Si el perfil existe, modifique los ajustes correspondientes. Guarde como texto sin formato y use comillas rectas. env_key es el nombre de la variable: conserve DGRID_API_KEY.
Instalación de Codex CLI y creación de un perfil de DGrid separado en Terminal

Instalación de Codex CLI y creación de un perfil de DGrid separado en Terminal

3. Introducir la clave API

Use el mismo terminal desde el que iniciará Codex.Terminal de macOS con Zsh:
Pegue la clave y pulse Intro. No se mostrará ningún carácter. Espere a que vuelva el indicador antes del siguiente comando.Windows PowerShell: ejecute la primera línea, introduzca la clave en el indicador oculto y ejecute las líneas restantes.
La clave queda definida para esta sesión del terminal. Debe volver a introducirla en un terminal nuevo.

4. Iniciar Codex y enviar un mensaje

En macOS:
En Windows PowerShell:
Si Codex pregunta si confía en la carpeta, confirme para la carpeta de demostración creada. Compruebe el modelo openai/gpt-6-sol. También puede revisar la sesión con /status.Envíe:
La respuesta esperada es:
Respuesta en Codex CLI con el modelo de DGrid seleccionado

Respuesta en Codex CLI con el modelo de DGrid seleccionado

El mensaje Running without the shared background server: --profile requires embedded mode. describe el modo de ejecución del perfil. Pulse F2 para verlo y Esc para cerrarlo; después continúe. Algunos teclados Mac usan Fn + F2.

Verificar la solicitud en DGrid

Busque la hora y el ID completo del modelo en el historial de DGrid. Una solicitud completada muestra Success.
Historial de DGrid con openai/gpt-6-sol y Success; Key Name está difuminado

Historial de DGrid con openai/gpt-6-sol y Success; Key Name está difuminado

Key Name está difuminado por privacidad. Los tokens y los costes varían según el modelo y el contexto enviado por Codex.

Solución de problemas

La referencia de configuración de Codex describe los ajustes de proveedores. Esta guía cubre la conexión y la recepción de una respuesta. Las herramientas, la búsqueda web y las tareas largas dependen del modelo y de la pasarela.

Recursos relacionados