Skip to main content
Codex è l’agente di programmazione di OpenAI e viene in tre forme: Codex CLI nel terminale, l’estensione Codex in VS Code e l’app Codex. Tutte e tre leggono la stessa cartella ~/.codex, quindi una sola configurazione copre tutte e tre.

​
Installazione con un solo comando

Sostituisci sk-xxx con la tua chiave, apri un terminale, incolla e premi Invio. Lo script verifica la chiave, elenca tutti i modelli che la chiave può chiamare e ti permette di scegliere (Invio = consigliato: gpt-astra per Astra, gpt-5.6-sol per GPT, claude-opus-5 per Claude), installa Codex CLI e scrive la configurazione.
Lo script chiede prima la lingua (1 = vietnamita, 2 = inglese; salta con --lang en o --lang vi). Senza --key chiede la chiave. Per forzare un modello aggiungi --model gpt-astra o --model gpt-5.6-sol.
Leggi il sorgente prima di eseguire se vuoi: codex.sh, codex.ps1. Lo script viene eseguito solo sul tuo computer e invia la chiave solo a gpt.teamsoclo.site per la verifica.

​
Cosa fa lo script

  1. Verifica la chiave con il gateway e sceglie il modello per il tuo pacchetto; una chiave errata si ferma qui senza toccare il tuo computer.
  2. Esegue il backup del tuo config.toml esistente, se presente, come config.toml.bak.<timestamp>.
  3. Scrive ~/.codex/config.toml: modello gpt-5.6-sol, il gateway di TeamSocLo, Responses API.
  4. Memorizza la chiave nella variabile di ambiente TEAMSOCLO_API_KEY (in ~/.zshrc / ~/.bashrc, o come variabile utente su Windows). La chiave non è nel file di configurazione, quindi puoi condividere config.toml senza divulgarla.
  5. Installa o aggiorna Codex CLI con npm install -g @openai/codex.
Rieseguilo in qualsiasi momento per cambiare chiavi o pacchetti; la vecchia configurazione viene sempre salvata come backup prima.
Preferisci non usare il terminale? TeamSocLo Key Tool è un’app per Windows e macOS: incolla la tua chiave una volta per configurare Codex, Claude Code e oltre 20 altri strumenti.

​
Dopo l’installazione

1

Apri un nuovo terminale, esegui codex

Il vecchio terminale non ha caricato la nuova variabile; apri una nuova scheda. Chiedi qualcosa a Codex per verificare.
2

VS Code: installa l'estensione, chiudi completamente, riapri

VS Code → Estensioni → cerca Codex (l’agente di programmazione di OpenAI) → Installa. Poi chiudi VS Code completamente: macOS Cmd + Q, Windows chiudi tutte le finestre. Reload Window non è sufficiente; l’estensione legge la configurazione solo all’avvio del processo.
3

App Codex

Riapri l’app dopo aver eseguito il comando. Su macOS il comando ha impostato la variabile per le app GUI tramite launchctl; su Windows setx si applica alle app avviate successivamente.
Non è necessario il login su OpenAI. requires_openai_auth = false dice a Codex di usare la chiave del gateway dalla variabile di ambiente.

​
Configurazione manuale

Se preferisci modificare tu stesso, ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) deve contenere esattamente:
e la variabile di ambiente TEAMSOCLO_API_KEY deve contenere la tua chiave.
Mantieni wire_api = "responses". Codex usa la Responses API; passare a chat lo rompe.
Apri rapidamente la cartella di configurazione:

​
Cambiare il modello

Il pacchetto GPT Astra usa gpt-astra. Modifica la prima riga di config.toml e riavvia Codex:
Una chiave GPT che chiama gpt-astra riceve “no available channel”, e viceversa. Il modello segue il pacchetto che hai acquistato, vedi Modelli e pacchetti.

​
Disinstallare

Per mantenere Codex ma tornare alla configurazione precedente, copia config.toml.bak.<timestamp> su config.toml.

​
Se non funziona

  • Hai aperto un nuovo terminale o chiuso completamente VS Code dopo l’installazione.
  • echo $TEAMSOCLO_API_KEY (Windows: echo %TEAMSOCLO_API_KEY% in cmd) mostra la chiave completa.
  • base_url termina con /v1, wire_api è responses.
  • La chiave è ancora valida e ha credito: verifica qui.
  • Altrimenti vedi Risoluzione dei problemi, che ha una sezione dedicata a Codex.