OpenAI Codex CLI: Comandi e Configurazione (Cheat Sheet)

OpenAI Codex CLI è l'agente di coding nativo da terminale di OpenAI che ispeziona codebase, modifica file, esegue test, si integra con le attività remote Codex Cloud e si connette a strumenti esterni tramite MCP direttamente dalla riga di comando.

Questo cheat sheet copre sottocomandi e flag di Codex CLI, criteri sandbox e di approvazione, comandi slash TUI interattivi, scorciatoie da tastiera e configurazione config.toml / AGENTS.md.

🔗 Cheat Sheet correlati: Confronto CLI di coding IA da terminale · Cheat Sheet CLI di Claude Code · Cheat Sheet Antigravity CLI (agy) · Ingegneria dell'AI Agent Harness

1. Installazione, autenticazione e comandi CLI principali

1.1 Installazione e autenticazione

Azione	Comando	Note
Installazione globale npm	`npm install -g @openai/codex`	Installazione standard multipiattaforma
Script di installazione ufficiale	`curl -fsSL https://chatgpt.com/codex/install.sh \| sh`	Installer in una riga per macOS / Linux
Accesso via browser	`codex login`	Autenticazione con account ChatGPT Plus / Pro / Team
Autenticazione API key	`export OPENAI_API_KEY="sk-..."`	Ideale per CI headless o ambienti container

1.2 Sottocomandi CLI e flag globali

Comando / Flag	Descrizione	Esempio d'uso
`codex`	Avvia la TUI interattiva nella directory corrente	`codex`
`codex "prompt"`	Avvia una sessione interattiva con un prompt iniziale	`codex "Debug 500 timeout errors on login"`
`codex exec` / `codex e`	Esecuzione non interattiva (headless) per script e CI	`codex exec "Run all unit tests and fix failures"`
`codex exec --json`	Trasmette log JSON strutturati di ragionamento e modifiche ai file	`codex exec --json "Refactor utils" > run.jsonl`
`codex review`	Code review non interattiva sul diff Git corrente	`codex review`
`codex resume`	Apre il selettore di sessioni (salvate in `~/.codex/sessions/`)	`codex resume` / `codex resume --last` / `codex resume <id>`
`codex apply` / `codex a`	Applica al workspace locale i diff generati da attività Codex Cloud	`codex apply <task_id>`
`codex cloud`	Ispeziona o gestisce attività remote su Codex Cloud	`codex cloud`
`codex mcp`	Gestisce le integrazioni dei server Model Context Protocol (MCP)	`codex mcp list` / `codex mcp add <name> ...`
`-m, --model <name>`	Specifica il modello sottostante per la sessione o l'esecuzione	`codex -m gpt-6.1-sol`
`--strict-config`	Valida rigorosamente la sintassi e le chiavi di `config.toml`	`codex --strict-config`

2. Matrice sandbox e criteri di approvazione

Codex CLI separa i permessi in due livelli ortogonali: cosa può toccare l'ambiente (--sandbox) e quando chiedere conferma all'utente (--ask-for-approval).

Flag	Valori validi	Comportamento e uso consigliato
`--sandbox <mode>` (alias `-s`)	`read-only`	Sola lettura: ispeziona e cerca nel codice senza modificare i file
	`workspace-write`	Scrittura nel workspace (predefinito consigliato): consente modifiche solo nell'albero di lavoro
	`danger-full-access`	Accesso senza restrizioni: accesso completo a filesystem/sistema (solo in container isolati)
`--ask-for-approval <policy>`	`on-request`	Predefinito consigliato: il modello chiede conferma quando azioni rischiose la richiedono
	`on-failure`	Escalation solo in caso di errore (usa `on-request` se contano le richieste di elevazione della sandbox)
	`never`	Completamente silenzioso: non chiede mai interattivamente (per CI / pipeline automatizzate)

⚠️ Avviso su flag deprecati e ritirati:

--full-auto è deprecato dalla versione v0.128.0. Specifica esplicitamente sandbox e criterio di approvazione: codex --sandbox workspace-write --ask-for-approval on-request "Fix failing tests"

Il criterio di approvazione untrusted è stato ritirato nella versione v0.149.0; migra le configurazioni a on-request.

3. Comandi slash interattivi nella TUI

Digita / nel prompt interattivo della TUI di codex per controllare contesto, permessi e flussi di lavoro:

3.1 Contesto, modelli e permessi

Comando	Funzione	Note e utilizzo
`/init`	Genera un file `AGENTS.md` iniziale su misura per il repository	Primo passo consigliato in un nuovo progetto
`/status`	Ispeziona modello attivo, permessi e consumo di token	Monitora la capacità residua del contesto
`/model`	Cambia interattivamente modello e livello di Reasoning Effort	Regola la profondità di ragionamento senza riavviare
`/permissions`	Modifica la modalità sandbox e il criterio di approvazione a sessione in corso	Restringi o amplia i permessi su richiesta
`/mcp`	Ispeziona e gestisce i server MCP connessi	Verifica la connettività di tool esterni e database

3.2 Flussi di ingegneria e controllo sessione

Comando	Funzione	Note e utilizzo
`/plan`	Redige e rivede un piano di implementazione prima di modificare i file	Allinea l'architettura prima di refactoring estesi
`/review`	Esegue una code review multi-prospettiva sulle modifiche non committate	Individua bug, casi limite e rischi di sicurezza
`/diff`	Ispeziona le modifiche correnti ai file non ancora committate	Rivedi i diff riga per riga prima di accettare
`/fork`	Dirama il thread di conversazione in un checkpoint separato	Esplora un approccio alternativo senza inquinare il contesto principale
`/compact`	Riassume la cronologia della conversazione per recuperare margine di contesto	Previene la deriva in sessioni lunghe multi-turno
`/copy`	Copia negli appunti l'ultima risposta completata	Estrai rapidamente patch o riepiloghi
`/title`	Rinomina il thread di conversazione corrente	Rende le sessioni facili da ritrovare in `codex resume`
`/statusline` / `/theme`	Personalizza gli elementi della barra di stato o il tema colori della TUI	Adatta la visualizzazione nel terminale
`/prompts:<name>`	Richiama un template di prompt Markdown personalizzato	Esegue `~/.codex/prompts/<name>.md`

4. Scorciatoie da terminale e sintassi di input

Scorciatoia / Sintassi	Azione	Effetto e scenario
`@<path>`	Riferimento file fuzzy	Inietta inline il contenuto del file (es. `@src/auth.ts`)
`!<command>`	Comando shell locale inline	Esegue comandi shell rispettando le regole sandbox attive (es. `!npm test`)
`Tab`	Accoda il prompt successivo	Accoda un prompt successivo, comando slash o comando `!` mentre Codex lavora
`Enter`	Interrompi / orienta in corsa	Inserisce indicazioni aggiuntive mentre l'agente sta rispondendo
`Ctrl + G`	Apri editor esterno	Scrivi prompt multilinea in `$VISUAL` / `$EDITOR` (Vim, VS Code, ecc.)
`Ctrl + R`	Cerca nella cronologia prompt	Ricerca inversa nei prompt inviati in precedenza
`Ctrl + L`	Pulisci e ridisegna lo schermo	Ripulisce il terminale preservando lo stato della conversazione
`Ctrl + O`	Copia l'ultimo output	Equivalente a `/copy`
`Ctrl + X`	Apri il menu scorciatoie	Accedi a preset di tastiera ed estensioni
`Ctrl + C`	Annulla / Esci	Interrompe l'attività in corso o esce dalla sessione Codex

5. File di configurazione e gerarchia della memoria (`config.toml` e `AGENTS.md`)

Le impostazioni a livello di progetto sovrascrivono i valori predefiniti globali dell'utente:

Livello	Ambito globale (tutti i repo)	Ambito di progetto (repo corrente)	Scopo
Configurazione core	`~/.codex/config.toml`	`.codex/config.toml`	Modello predefinito, sandbox, criterio di approvazione, toggle rete, MCP
Istruzioni per l'agente	`~/.codex/AGENTS.md`	`./AGENTS.md` (root del repo)	Comandi di build/test, standard di coding, regole architetturali
Prompt personalizzati	`~/.codex/prompts/*.md`	—	Template riutilizzabili per comandi slash `/prompts:<name>`
Log di sessione	`~/.codex/sessions/`	—	Log persistenti ripristinati da `codex resume`

`config.toml` minimo consigliato (`~/.codex/config.toml`)

# Modello predefinito
model = "gpt-6.1-sol"

# Modalità sandbox e criterio di approvazione predefiniti
sandbox_mode = "workspace-write"
approval_policy = "on-request"

# Limita per impostazione predefinita l'accesso alla rete in uscita dentro la sandbox
network_access = false