Menu

Guida all'installazione e alla configurazione di Codex

Insegnamento della versione Windows

Requisiti del sistema

Windows 10 o Windows 11
Node.js 22+
npm 10+
Connessione di rete

Passaggi di installazione

Passaggi preliminari!!!
Per installare Git Bash, visita il sito ufficiale. Git - Downloads Scarica la versione adatta al tuo sistema operativo, poi continua a cliccare su “Avanti” per completare l’installazione.1. Installare Node.js
Access Sito ufficiale di Node.js Scarica e installa la versione LTS più recente.2. Installare Codex
Apri il Prompt dei comandi (CMD) o PowerShell e esegui:
npm install -g @openai/codex
3. Verifica dell'installazione
Apri il Prompt dei comandi (CMD) o PowerShell e esegui:
codex --version

Configurazione dell’API

1. Ottenere il Token di Autenticazione
Access api.airai.cc Esegui le seguenti operazioni sulla pagina del sito:
Clicca Console → Token API Pagina
Clicca Aggiungere token
Per selezionare i gruppi di token,请选择:Eserclusivo per Codex(È obbligatorio selezionare questo gruppo, altrimenti non sarà possibile utilizzarlo)
Il nome del token è arbitrario.
Consiglio per il limite: impostalo su Limiti illimitati
Altre opzioni rimangono impostate per impostazione predefinita.
image.png2. File di configurazione
Avvertenza importantePer favore, sostituisci `sk-xxx` con la vera chiave API che hai generato su api.airai.cc!
Avvertenza importantePor favor, sostituisci `sk-xxx` con la chiave API reale che hai generato su api.airai.cc!
Avvertenza importantePer favore, sostituisci `sk-xxx` con la chiave API reale che hai generato su api.airai.cc!
1.
Entrare nella cartella .codex all’interno della directory dell’utente corrente, ad esempio: C:\Users\testuser\.codex.
(AttenzioneSe non si vede quella directory, significa che non avete attivato la funzione "Mostra elementi nascosti" in Windows. Per abilitarla, iniziate aprendola nel File Explorer.
image.png
2.
Se non esiste la cartella .codex, crea manualmente questa cartella e all'interno di essa crea due file: config.toml e auth.json.
image.png
3. Compila le impostazioni (È necessario sostituire sk-xxx con lo SK reale che avete creato voi).a. La configurazione presente in auth.json:
{"OPENAI_API_KEY": "sk-xxx"}
b. La configurazione presente in config.toml (basta copiare il contenuto seguente direttamente):
I valori opzionali di model_reasoning_effort sono high, medium, low, che rappresentano rispettivamente il livello di impegno nel processo di riflessione del modello (alto, medio, basso).
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://api.airai.cc/v1"
wire_api = "responses"

Avvia il codice

Riavvia il terminale! Riavvia il terminale! Riavvia il terminale!
Poi entrate nel directory del vostro progetto:
cd your-project-folder
Esegui i seguenti comandi per avviare:
codex
image.png

VSCode plugin codex

Dopo aver completato la configurazione, basta cercare e installare l'estensione codex nello store di estensioni di VSCode.image.png
Dopo l'installazione, apparirà nella barra laterale.

image.png

Insegnamento versione Mac

Requisiti del sistema

macOS 12 o versione successiva
Node.js 22+
npm 10+
Connessione di rete

Passaggi di installazione

1. Installare Node.js
Modalità 1Visita diretta Sito ufficiale di Node.js Scarica e installa la versione LTS più recente.
Modalità 2Utilizzare Homebrew (consigliato)
# 如果尚未安装 Homebrew,请先运行此命令/bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"# 安装 Node.jsbrew install node
2. Installare Codex
Aprire il terminale, eseguire (potrebbe essere necessario aggiungere sudo):
npm install -g @openai/codex
3. Verifica dell'installazione
Apri il terminale (Terminal) e esegui:
codex --version

Configurazione dell’API

1. Ottenere il Token di Autenticazione
Access api.airai.cc Esegui le seguenti operazioni sulla pagina del sito:
Clicca Console → Token API Pagina
Clicca Aggiungere token
Per selezionare i gruppi di token,请选择:Codex speciale(È obbligatorio selezionare questo gruppo, altrimenti non sarà possibile utilizzarlo)
Il nome del token è arbitrario.
Consiglio per il limite: impostalo su Limiti illimitati
Altre opzioni rimangono impostate per impostazione predefinita.
image.png
2. File di configurazione
Avvertenza importanteTi prego di mettere sottosk-xxxS ost itu zione per te .api.airai.ccLa chia ve API effettiva gener ata !
Avvertenza importanteTi prego di mettere sottosk-xxxS ost itu zione per te .api.airai.ccLa chia ve API effettiva gener ata !
Avvertenza importanteTi prego di mettere sottosk-xxxS ost itu zione per te .api.airai.ccLa chia ve API effettiva gener ata !
1.
Creazione di directory e file:
mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml
2.
Modificare il file auth.json:
vi ~/.codex/auth.json
Premere i per entrare in modalità inserimento, incollare il seguente (sostituire sk-xxx con la chiave), quindi premere il tasto ESC, digitare :wq e enter per salvare l'uscita.
{"OPENAI_API_KEY": "sk-xxx"}
3.
Modificare il file config.toml:
vi ~/.codex/config.toml
Premere i per entrare in modalità inserimento, incollare il seguente, quindi premere il tasto ESC, digitare :wq e enter per salvare l'uscita.
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://api.airai.cc/v1"
wire_api = "responses"

Avvia il codice

Riavvia il terminale! Riavvia il terminale! Riavvia il terminale!
Poi entrate nel directory del vostro progetto:
cd your-project-folder
Esegui i seguenti comandi per avviare:
codex
[immagini]

VSCode plugin codex

Una volta completata la configurazione, è sufficiente cercare e installare codex nel VSCode Extension Store.
[immagini]Dopo l'installazione, apparirà nella barra laterale.
[immagini]

Insegnamento della versione Linux

Requisiti del sistema

Distribuzioni Linux principali (Ubuntu 20.04 +, Debian 10 +, CentOS 7 +, ecc.)
Node.js 22+
npm 10+
Connessione di rete

Passaggi di installazione

1. Installare Node.js
Ubuntu/Debian
sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x  | 
sudo -E bash -sudo apt-get install -y nodejs
CentOS/RHEL/Fedora
# 使用 dnf (Fedora) 或 yum (CentOS/RHEL)sudo dnf install nodejs npm# 或sudo yum install nodejs npm
Arch Linux
sudo pacman -S nodejs npm
2. Installare Codex
Apri il terminale (Terminal) e esegui:
sudo npm install -g @openai/codex
3. Verifica dell'installazione
Apri il terminale (Terminal) e esegui:
codex --version

Configurazione dell’API

1. Ottenere il Token di Autenticazione
Access api.airai.cc Esegui le seguenti operazioni sulla pagina del sito:
Clicca Console → Token API Pagina
Clicca Aggiungere token
Per selezionare i gruppi di token,请选择:Canali di codex - gpt(È obbligatorio selezionare questo gruppo, altrimenti non sarà possibile utilizzarlo)
Il nome del token è arbitrario.
Consiglio per il limite: impostalo su Limiti illimitati
Altre opzioni rimangono impostate per impostazione predefinita.
[immagini]
2. File di configurazione
Avvertenza importanteTi prego di mettere sottosk-xxxS ost itu zione per te .api.airai.ccLa chia ve API effettiva gener ata !
Avvertenza importanteTi prego di mettere sottosk-xxxS ost itu zione per te .api.airai.ccLa chia ve API effettiva gener ata !
Avvertenza importanteTi prego di mettere sottosk-xxxS ost itu zione per te .api.airai.ccLa chia ve API effettiva gener ata !
1.
Creazione di directory e file:
mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml
2.
Modificare il file auth.json:
vi ~/.codex/auth.json
Premere i per entrare in modalità inserimento, incollare il seguente (sostituire sk-xxx con la chiave), quindi premere il tasto ESC, digitare :wq e enter per salvare l'uscita.
{"OPENAI_API_KEY": "sk-xxx"}
3.
Modificare il file config.toml:
vi ~/.codex/config.toml
Premere i per entrare in modalità inserimento, incollare il seguente, quindi premere il tasto ESC, digitare :wq e enter per salvare l'uscita.
model_provider = "api111"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.api111]
name = "api111"
base_url = "https://api.airai.cc/v1"
wire_api = "responses"

Avvia il codice

Riavvia il terminale! Riavvia il terminale! Riavvia il terminale!
Poi entrate nel directory del vostro progetto:
cd your-project-folder
Esegui i seguenti comandi per avviare:
codex
image.png

VSCode plugin codex

Una volta completata la configurazione, è sufficiente cercare e installare codex nel VSCode Extension Store.image.png
Dopo l'installazione, apparirà nella barra laterale.

image.png

Domande comuni

Se si verifica un errore, si prega di procedere come segue:
1.
Verificare che la chiave API sia stata creata correttamente: selezione delle quoteLimiti illimitatiNon limitare il modello, selezionare il gruppo Canali di codex - gpt。
Per ulteriori informazioni sulla configurazione e l'uso del codex, consultare Codex Tutorial Ufficiale。


È stato utile?

Supporto tecnicoAssistenza online
Torna in alto
简体中文ZH-CNDefault繁體中文ZH-TWEnglishEN日本語JA한국어KOภาษาไทยTHTiếng ViệtVIBahasa IndonesiaIDEspañolESFrançaisFRDeutschDEРусскийRUPortuguêsPTItalianoITالعربيةAR