Guida all'uso di Codex per VS Code

Codex è l’Agent di programmazione lanciato da OpenAI. Oltre alla CLI terminale, offre anche un’estensione per VS Code, che permette di chattare, leggere file, fare riferimenti contestuali, generare modifiche e visualizzare in anteprima le variazioni direttamente nella barra laterale dell’editor. Questo documento illustra come configurare e utilizzare l’estensione Codex in VS Code tramite un proxy compatibile con OpenAI Responses di Ace Data Cloud. L’estensione Codex per VS Code e la CLI Codex condividono lo stesso sistema di configurazione locale, quindi basta puntare ~/.codex/config.toml verso Ace Data Cloud affinché Codex in VS Code utilizzi https://api.acedata.cloud/v1.

Processo di richiesta

Per usare Codex, puoi prima ottenere il tuo API Token dal Pannello di controllo di Ace Data Cloud, da conservare come backup.

Se non hai ancora effettuato l’accesso o registrato, verrai automaticamente reindirizzato alla pagina di login per registrarti e accedere, e dopo il login verrai riportato alla pagina corrente. Al primo utilizzo, viene assegnato un credito gratuito per provare il servizio Codex senza costi.

Installazione dell’estensione Codex

Nel marketplace di VS Code, cerca Codex e installa l’estensione Codex - OpenAI’s coding agent pubblicata da OpenAI. Il suo ID nel Marketplace è:

openai.chatgpt

Puoi anche installarla tramite terminale:

code --install-extension openai.chatgpt

Dopo l’installazione, riavvia o ricarica VS Code. Se non vedi l’icona di Codex, apri la palette comandi (Cmd+Shift+P su macOS, Ctrl+Shift+P su Windows/Linux), cerca e avvia:

Codex: Open Codex Sidebar

Di default, Codex apparirà nella barra laterale destra di VS Code. Puoi anche trascinarlo nella barra delle attività a sinistra.

Installazione di Codex CLI (per verifica)

La documentazione ufficiale indica che l’estensione VS Code e la CLI Codex condividono la stessa configurazione. Per verificare che l’API Token e il modello siano corretti prima di configurare VS Code, si consiglia di installare anche la CLI. Uno dei metodi raccomandati è tramite npm, richiede Node.js versione 18 o superiore:

npm install -g @openai/codex

Su macOS, puoi usare anche Homebrew:

brew install --cask codex

Dopo l’installazione, verifica che il comando funzioni:

codex --version

Se preferisci usare solo l’estensione VS Code, puoi saltare questa verifica CLI; in ogni caso, continuerai a usare la stessa configurazione in ~/.codex/config.toml.

Configurazione dell’API di Ace Data Cloud

L’estensione Codex per VS Code e la CLI condividono il file di configurazione. Per impostazione predefinita, Codex richiede di effettuare il login con un account ufficiale OpenAI o di configurare una chiave API ufficiale. Per usare invece Ace Data Cloud, bisogna configurare l’API Token e il file ~/.codex/config.toml.

Primo passo: impostare le variabili d’ambiente

Si consiglia di inserire l’API Token nel file di configurazione della shell, ad esempio ~/.zshrc, ~/.bashrc o ~/.bash_profile:

export ACEDATACLOUD_API_KEY="{token}"

Sostituisci {token} con l’API Token copiato dal pannello di controllo di Ace Data Cloud. Dopo aver modificato il file, riapri il terminale o esegui:

source ~/.zshrc

Se hai già VS Code aperto, riavvialo o ricaricalo per permettere all’estensione di leggere le nuove variabili d’ambiente.

Secondo passo: modificare il file di configurazione di Codex

Il file di configurazione utente di Codex si trova in ~/.codex/config.toml. Se non esiste, crealo:

mkdir -p ~/.codex
touch ~/.codex/config.toml

Inserisci questa configurazione:

model_provider = "acedatacloud"
model = "gpt-5"
model_reasoning_effort = "high"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[model_providers.acedatacloud]
name = "Ace Data Cloud"
base_url = "https://api.acedata.cloud/v1"
env_key = "ACEDATACLOUD_API_KEY"
wire_api = "responses"

Spiegazione dei campi:

Campo	Descrizione
`model_provider`	Provider di modelli di default, corrisponde a `[model_providers.acedatacloud]`
`model`	ID del modello di default
`model_reasoning_effort`	Livello di ragionamento, valori comuni sono `low`, `medium`, `high`
`approval_policy`	Politica di conferma prima dell’esecuzione di comandi, si consiglia `on-request`
`sandbox_mode`	Modalità sandbox per l’esecuzione di comandi, si consiglia `workspace-write`
`base_url`	URL dell’API compatibile con OpenAI di Ace Data Cloud
`env_key`	Variabile d’ambiente da cui Codex legge l’API Token
`wire_api`	Tipo di protocollo, per OpenAI Responses API deve essere `responses`

Puoi anche cliccare sull’icona dell’ingranaggio in alto a destra nell’estensione Codex e scegliere Codex Settings > Open config.toml per aprire direttamente questa configurazione in VS Code.

Configurazione a livello di progetto

Se vuoi usare configurazioni diverse per un progetto specifico, crea il file .codex/config.toml nella radice del progetto. Codex leggerà questa configurazione prioritarmente, ma solo se il progetto è contrassegnato come trusted. Esempio:

model = "gpt-4.1-mini"
model_reasoning_effort = "medium"

Si consiglia di mettere le configurazioni contenenti token personali nelle variabili d’ambiente e non nel repository. La configurazione .codex/config.toml a livello di progetto può essere condivisa o meno, a seconda delle policy del team. Se hai già effettuato login con l’account ufficiale OpenAI nell’estensione Codex, potrebbe rimanere una cache locale. Prima di passare al proxy Ace Data Cloud, puoi eseguire:

codex logout

Se il comando non funziona, puoi eliminare manualmente il file di cache:

rm -f ~/.codex/auth.json

Poi riavvia o ricarica VS Code.

Uso di base

Dopo aver configurato, apri il pannello Codex a sinistra o a destra e inserisci le richieste. Ad esempio:

Spiega la struttura di directory del progetto corrente e indica il file di ingresso principale.

L’estensione Codex può usare i file aperti e il testo selezionato come contesto. Puoi anche citare file usando @, ad esempio:

Riferisciti a @src/App.vue, aiutami a suddividere questa pagina in componenti più chiari.

Se selezioni un blocco di codice, puoi usare il comando:

Codex: Add to Codex Thread

Oppure:

Codex: Add File to Codex Thread

per aggiungere l’intero file corrente come contesto.

Cambio di modello e livello di ragionamento

L’estensione Codex in VS Code permette di cambiare modello tramite il selettore sotto la casella di input, e di regolare il livello di ragionamento. Quando si usa Ace Data Cloud come provider, il metodo più stabile è impostare il modello di default nel ~/.codex/config.toml e poi switchare se necessario. Ecco alcune raccomandazioni:

Scenario	Modello consigliato	Livello di ragionamento
Lettura quotidiana del codice e piccole modifiche	`gpt-4.1-mini`	`medium`
Task di sviluppo generale	`gpt-5`	`high`
Ristrutturazioni complesse e ragionamento approfondito	`gpt-5.5` o `gpt-5.5-pro`	`high`
Task di ragionamento potenziato	`o3`	`high`

Se il modello desiderato non appare nel menu, puoi modificarlo direttamente nel ~/.codex/config.toml e riavviare VS Code. La lista completa dei modelli è disponibile nella documentazione di Ace Data Cloud OpenAI.

Modalità di lavoro

L’estensione Codex supporta diverse modalità di lavoro:

Modalità	Scenario di utilizzo
`Chat`	Solo discussione, spiegazioni, pianificazione, senza modificare i file
`Agent`	Lettura, modifica e esecuzione di comandi sui file, raccomandato per uso quotidiano
`Agent (Full Access)`	Permette accesso elevato e accesso alla rete, per scenari con rischi noti

Per uso quotidiano, si consiglia Agent con approval_policy = "on-request". In questo modo, Codex chiederà conferma prima di eseguire comandi sensibili o accedere a risorse esterne.

Verifica della configurazione

Puoi verificare che Codex funzioni correttamente con Ace Data Cloud eseguendo:

codex exec --model gpt-4.1-mini "Reply with exactly: ADC_Codex_OK"

Se tutto funziona, riceverai:

ADC_Codex_OK

Poi, torna in VS Code e nel pannello Codex inserisci una domanda semplice:

Spiega in una frase lo scopo di questa workspace.

Puoi anche controllare le richieste e i costi nel Pannello di controllo di Ace Data Cloud - Storico utilizzi e i crediti residui in Applicazioni.

Come funziona

L’estensione Codex per VS Code non è un modello indipendente, ma utilizza la CLI Codex locale e condivide la configurazione:

L’estensione avvia Codex e legge ~/.codex/config.toml utente.
Se il progetto è trustato e contiene .codex/config.toml, viene caricata anche questa configurazione.
Quando model_provider è acedatacloud, Codex legge l’API Token da ACEDATACLOUD_API_KEY.
Le richieste vengono inviate tramite protocollo Responses all’endpoint https://api.acedata.cloud/v1/responses.
Ace Data Cloud verifica identità, controlla i limiti e inoltra le richieste, registrando l’utilizzo.

In sostanza, CLI e estensione condividono la stessa configurazione, quindi una verifica in terminale garantisce che anche l’estensione funzioni correttamente.

Inizia

Chat AI

Immagine AI

Video AI

Audio AI

Web e Dati

CAPTCHA

Identità

Proxy

Avanzato

Coding

Guida all'uso di Codex per VS Code

Processo di richiesta

Installazione dell’estensione Codex

Installazione di Codex CLI (per verifica)

Configurazione dell’API di Ace Data Cloud

Primo passo: impostare le variabili d’ambiente

Secondo passo: modificare il file di configurazione di Codex

Configurazione a livello di progetto

Uso di base

Cambio di modello e livello di ragionamento

Modalità di lavoro

Verifica della configurazione

Come funziona

Per saperne di più

​Processo di richiesta

​Installazione dell’estensione Codex

​Installazione di Codex CLI (per verifica)

​Configurazione dell’API di Ace Data Cloud

​Primo passo: impostare le variabili d’ambiente

​Secondo passo: modificare il file di configurazione di Codex

​Configurazione a livello di progetto

​Pulizia della cache di login di OpenAI

​Uso di base

​Cambio di modello e livello di ragionamento

​Modalità di lavoro

​Verifica della configurazione

​Come funziona

​Per saperne di più

Processo di richiesta

Installazione dell’estensione Codex

Installazione di Codex CLI (per verifica)

Configurazione dell’API di Ace Data Cloud

Primo passo: impostare le variabili d’ambiente

Secondo passo: modificare il file di configurazione di Codex

Configurazione a livello di progetto

Pulizia della cache di login di OpenAI

Uso di base

Cambio di modello e livello di ragionamento

Modalità di lavoro

Verifica della configurazione

Come funziona

Per saperne di più