Tutorial de instalación del Codex CLI

Si vas a usar modelos de la serie GPT / Codex, también puedes instalar de antemano el Codex CLI. Una vez instalado, podrás conectarlo a NextHub igualmente a través de CC-Switch.

Pasos de instalación

1. Comprueba el entorno de Node.js

El Codex CLI también necesita un entorno de Node.js; se recomienda comprobar primero la versión:

node -v
npm -v

2. Instala el Codex CLI globalmente

Ejecuta el siguiente comando en la terminal para instalar Codex:

npm install -g @openai/codex

3. Comprueba que Codex se haya instalado correctamente

Ejecuta los siguientes comandos; basta con que muestren el número de versión correctamente o que Codex se inicie:

codex --version
codex

Forma de conexión 1: CC-Switch (recomendada)

Una vez completada la instalación, continúa directamente con el tutorial de CC-Switch. En CC-Switch, selecciona Codex, introduce como dirección de solicitud https://api.nexthub.cc/v1 (el protocolo OpenAI Responses requiere /v1) y, a continuación, tu ApiKey; así podrás usarlo a través del grupo GPT-Azure (0.47x).

Forma de conexión 2: configuración manual

Si no quieres usar una herramienta de configuración, edita a mano los dos archivos de configuración de Codex.

1. Abre el directorio de configuración de Codex

Windows (CMD)

start "" "%USERPROFILE%\.codex"

macOS (Terminal)

open "$HOME/.codex"

Si no encuentras los archivos correspondientes en el directorio, créalos a mano.

2. Configura config.toml

Escribe el siguiente contenido en ~/.codex/config.toml:

model = "gpt-5.6"
model_provider = "nexthub"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.nexthub]
name = "nexthub"
base_url = "https://api.nexthub.cc/v1"
wire_api = "responses"
requires_openai_auth = true

La dirección de solicitud debe llevar /v1

Codex usa el protocolo OpenAI Responses (/v1/responses), por lo que base_url debe incluir /v1. Completa model según necesites con el ID de modelo que ofrezcan los grupos GPT-Azure / GPT-Pro (por ejemplo, gpt-5.6, gpt-6-astra); los datos en tiempo real se rigen por la Plaza de Modelos.

3. Configura auth.json

Escribe tu ApiKey en ~/.codex/auth.json (la clave del grupo GPT-Azure o GPT-Pro):

{
  "OPENAI_API_KEY": "tu ApiKey de NextHub"
}

4. Verificación

Ejecuta codex en la terminal y envía un mensaje de prueba; si en la parte superior de la interfaz se muestra el modelo seleccionado y responde correctamente, la conexión se ha realizado con éxito.

Instrucciones globales

~/.codex/AGENTS.md es el archivo de instrucciones globales de Codex; se crea automáticamente si no existe y puedes escribir en él tus convenciones de trabajo.