> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Guida all'uso di Codex per VS Code > Codex 集成指南 - Ace Data Cloud 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](https://platform.acedata.cloud/console/applications), da conservare come backup. ![](https://cdn.acedata.cloud/5hmkdg.jpg) 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 è: ```text theme={null} openai.chatgpt ``` Puoi anche installarla tramite terminale: ```bash theme={null} 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: ```text theme={null} 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: ```bash theme={null} npm install -g @openai/codex ``` Su macOS, puoi usare anche Homebrew: ```bash theme={null} brew install --cask codex ``` Dopo l'installazione, verifica che il comando funzioni: ```bash theme={null} 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`: ```bash theme={null} 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: ```bash theme={null} 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: ```bash theme={null} mkdir -p ~/.codex touch ~/.codex/config.toml ``` Inserisci questa configurazione: ```toml theme={null} 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: ```toml theme={null} 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. ## Pulizia della cache di login di OpenAI 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: ```bash theme={null} codex logout ``` Se il comando non funziona, puoi eliminare manualmente il file di cache: ```bash theme={null} 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: ```text theme={null} 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: ```text theme={null} Riferisciti a @src/App.vue, aiutami a suddividere questa pagina in componenti più chiari. ``` Se selezioni un blocco di codice, puoi usare il comando: ```text theme={null} Codex: Add to Codex Thread ``` Oppure: ```text theme={null} 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](https://platform.acedata.cloud/documents/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: ```bash theme={null} codex exec --model gpt-4.1-mini "Reply with exactly: ADC_Codex_OK" ``` Se tutto funziona, riceverai: ```text theme={null} ADC_Codex_OK ``` Poi, torna in VS Code e nel pannello Codex inserisci una domanda semplice: ```text theme={null} 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](https://platform.acedata.cloud/console/usages) e i crediti residui in [Applicazioni](https://platform.acedata.cloud/console/applications). ## Come funziona L'estensione Codex per VS Code non è un modello indipendente, ma utilizza la CLI Codex locale e condivide la configurazione: 1. L'estensione avvia Codex e legge `~/.codex/config.toml` utente. 2. Se il progetto è trustato e contiene `.codex/config.toml`, viene caricata anche questa configurazione. 3. Quando `model_provider` è `acedatacloud`, Codex legge l'API Token da `ACEDATACLOUD_API_KEY`. 4. Le richieste vengono inviate tramite protocollo Responses all'endpoint `https://api.acedata.cloud/v1/responses`. 5. 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. ## Per saperne di più * [Documentazione ufficiale dell'estensione Codex IDE](https://developers.openai.com/codex/ide) * [Impostazioni di configurazione dell'estensione Codex](https://developers.openai.com/codex/ide/settings) * [Configurazione di base di Codex CLI](https://developers.openai.com/codex/config-basic) * [Documentazione dei servizi OpenAI di Ace Data Cloud](https://platform.acedata.cloud/documents/openai)