← Volver a la lista

guía de configuración del códice

Instale Codex, agregue su clave API e inicie una conversación a través de Starsg.

ImportanteAntes de comenzar, prepare una clave API creada en el consola. Si aún no tienes uno, sigue el enlace para crearlo.

1. Control ambiental

Si usa los siguientes comandos npm, primero ejecute node --version en una terminal. Si no se encuentra el comando, visite el Página de descarga de Node.js e instale Node.js. Abra una nueva terminal, luego ejecute ambas comprobaciones a continuación.

bash
node --version
npm --version

Guías oficiales de instalación: Codex CLI

Instale sólo la herramienta que desee utilizar; omita cualquier herramienta que ya tenga. comandos npm:

bash
npm i -g @openai/codex@latest
Importante: ejecute el comando --version para la herramienta que instaló para verificar la instalación.
bash
codex --version

Un número de versión significa que la instalación funcionó. Si no se encuentra el comando, vuelva a abrir su terminal e inténtelo nuevamente.

2. Configurar Códice

Editar ~/.codex/config.toml — este archivo contiene el punto final de la puerta de enlace, los valores predeterminados del modelo y el esfuerzo de razonamiento:

toml
disable_response_storage = true
model = "gpt-5.5"
model_provider = "novamaas"
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.novamaas]
base_url = "https://api.starsg.ai/v1"
name = "novamaas"
requires_openai_auth = true
wire_api = "responses"

Luego escriba su clave API en ~/.codex/auth.json:

json
{
  "OPENAI_API_KEY": "sk-abc...xyz"
}
Nota: Si falta un archivo de configuración o su carpeta, créelo antes de pegar el ejemplo anterior. En Windows, su carpeta de inicio es %USERPROFILE%.

3. verificar

Correr codex en una terminal. Una respuesta de chat confirma la conexión.