Installare Codex CLI: configurazione, accesso e prima attività

Installa Codex CLI, verifica l’eseguibile, accedi e inizia con una piccola attività nella directory del progetto. I programmi di installazione ufficiali ora coprono macOS, Linux e Windows; npm e Homebrew restano alternative. Scegli uno dei percorsi seguenti. Un’installazione funzionante è il primo passo; l’accesso all’account e la fatturazione API sono scelte separate.

1. Scegli un metodo di installazione

Questi comandi provengono dalla guida ufficiale all’installazione di Codex CLI. Usa il programma di installazione per l’ambiente in cui eseguirai l’agente. Installare un eseguibile Windows non installa una copia Linux separata dentro WSL, e installare sul laptop non installa il programma su un server remoto a cui ti connetterai in seguito.

curl -fsSL https://chatgpt.com/codex/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Se gestisci già gli strumenti di sviluppo con un gestore di pacchetti, usa la relativa alternativa invece di eseguire entrambi i programmi di installazione:

Il percorso npm richiede un’installazione npm funzionante; verifica prima npm --version. Il percorso standalone è utile se non hai altrimenti bisogno degli strumenti Node. Su una macchina gestita, usa il metodo di installazione supportato dall’amministratore, così gli aggiornamenti successivi resteranno prevedibili.

2. Verifica quale eseguibile viene eseguito

Dopo l’installazione, avvia un terminale nuovo se il comando non viene trovato. Su macOS o Linux, command -v codex mostra l’eseguibile selezionato dalla shell. In PowerShell, usa Get-Command codex. Confronta quel percorso con il metodo di installazione scelto prima di reinstallare. Due copie installate possono farti aggiornare una continuando ad avviare l’altra.

codex --version
codex --help

# Open your own project directory before starting
cd /path/to/your/project
codex login
codex login status
codex --sandbox read-only "Explain this project's structure and how its tests run. Do not modify files."

Sostituisci il percorso di esempio del progetto con il tuo. Il comando finale usa una sandbox di sola lettura per una spiegazione iniziale. È un primo controllo utile perché puoi confermare il repository corretto e l’accesso ai modelli prima di chiedere all’agente di apportare una modifica. Se vuoi ispezionare i flag disponibili, usa la guida della CLI installata o il riferimento dei comandi.

3. Scegli il percorso dell’account corretto

codex login avvia il flusso di accesso all’account. Controlla l’account del browser e l’area di lavoro prima di completarlo. Per la fatturazione diretta dell’API OpenAI, l’alternativa documentata accetta una chiave Platform tramite lo standard input:

# After supplying OPENAI_API_KEY through your credential setup:
printenv OPENAI_API_KEY | codex login --with-api-key

Questo comando API è destinato a una chiave OpenAI Platform. Non costituisce la configurazione completa per un gateway di terze parti. Un provider personalizzato richiede una configurazione, un endpoint, una fonte delle credenziali e un modello supportato propri. La documentazione sull’autenticazione spiega i percorsi, mentre la nostra guida alle chiavi API di Codex illustra la configurazione avanzata del provider.

4. Trasforma la prima risposta in una prima attività utile

1. Chiedi dove si trovano il codice sorgente e i test pertinenti, poi verifica la risposta nel repository.
2. Scegli una modifica piccola e descrivine il comportamento previsto.
3. Usa un branch pulito o un checkpoint e scegli autorizzazioni adeguate alla modifica.
4. Fai eseguire a Codex i controlli pertinenti, poi esamina il diff e la spiegazione.

Per esempio, inizia con un test non riuscito o con una piccola correzione della documentazione. Evita di rendere la prima attività una riscrittura completa dell’applicazione: installazione, credenziali, dipendenze locali e qualità dell’attività sarebbero tutti più difficili da valutare contemporaneamente. Quando il ciclo breve funziona, aggiungi le istruzioni del progetto ed estendi l’ambito.

Se la configurazione si interrompe, correggi il livello corrispondente

«Command not found» indica un problema di installazione o PATH. Un 401 indica un problema di autenticazione. Un errore del modello indica il provider e il modello selezionati. Un avviso di limite indica un problema di utilizzo o fatturazione. Mantieni i livelli funzionanti e segui la checklist 401 o la guida ai limiti di utilizzo secondo necessità; reinstallare l’eseguibile non ricarica il credito dell’account.

Per valutare Kunavo per il lavoro locale con Codex, crea un account e segui l’integrazione di Codex. Usa una configurazione del provider compatibile con Responses. Verifica una piccola attività prima di affidarti al nuovo percorso di fatturazione per un progetto più grande.

Domande frequenti

Documentazione ufficiale di installazione e guida della CLI locale verificate il 17 settembre 2026.