← Torna all'elenco

Guida all'installazione del Codice

Installa Codex, aggiungi la tua chiave API e avvia una conversazione tramite Starsg.

ImportantePrima di iniziare, prepara una chiave API creata nel file consolle. Se non ne hai ancora uno, segui il collegamento per crearlo.

1. Controllo dell'ambiente

Se utilizzi i comandi npm riportati di seguito, esegui prima node --version in un terminale. Se il comando non viene trovato, visitare il file Pagina di download Node.js e installare Node.js. Apri un nuovo terminale, quindi esegui entrambi i controlli di seguito.

bash
node --version
npm --version

Guide ufficiali all'installazione: Codex CLI

Installa solo lo strumento che desideri utilizzare; salta qualsiasi strumento che hai già. comandi npm:

bash
npm i -g @openai/codex@latest
Importante: esegui il comando --version per lo strumento installato per verificare l'installazione.
bash
codex --version

Un numero di versione indica che l'installazione ha funzionato. Se il comando non viene trovato, riapri il terminale e riprova.

2. Configura Codice

Modificare ~/.codex/config.toml — questo file contiene l'endpoint del gateway, i valori predefiniti del modello e lo sforzo di ragionamento:

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"

Quindi scrivi la tua chiave API in ~/.codex/auth.json:

json
{
  "OPENAI_API_KEY": "sk-abc...xyz"
}
Nota: Se manca un file di configurazione o la sua cartella, crealo prima di incollare l'esempio sopra. Su Windows, la tua cartella Inizio è %USERPROFILE%.

3. Verifica

Correre codex in un terminale. Una risposta in chat conferma la connessione.