OpenAI Codex CLI: Comenzi și configurare — Cheat sheet

OpenAI Codex CLI este agentul de programare nativ pentru terminal al OpenAI care inspectează baze de cod, editează fișiere, rulează teste, se integrează cu sarcini remote în Codex Cloud și se conectează la instrumente externe prin MCP direct din linia de comandă.

Acest cheat sheet acoperă subcomenzile și flag-urile Codex CLI, politicile de sandbox și aprobare, comenzile slash interactive din TUI, scurtăturile de tastatură și configurarea config.toml / AGENTS.md.

🔗 Ghiduri asociate: Comparație CLI-uri pentru agenți de programare IA · Cheat sheet Claude Code CLI · Cheat sheet Antigravity CLI (agy) · Arhitectura și runtime-ul AI Agent Harness

1. Instalare, autentificare și comenzi CLI principale

1.1 Instalare și autentificare

Acțiune	Comandă	Note
Instalare globală npm	`npm install -g @openai/codex`	Instalare standard multiplatformă
Script oficial de instalare	`curl -fsSL https://chatgpt.com/codex/install.sh \| sh`	Instalator într-o singură linie pentru macOS / Linux
Autentificare în browser	`codex login`	Autentificare cu cont ChatGPT Plus / Pro / Team
Autentificare prin cheie API	`export OPENAI_API_KEY="sk-..."`	Ideal pentru medii CI headless sau containere

1.2 Subcomenzi CLI și flag-uri globale

Comandă / Flag	Descriere	Exemplu de utilizare
`codex`	Lansează interfața TUI interactivă în directorul curent	`codex`
`codex "prompt"`	Pornește o sesiune interactivă cu un prompt inițial	`codex "Debug 500 timeout errors on login"`
`codex exec` / `codex e`	Execuție neinteractivă (headless) pentru scripturi și CI	`codex exec "Run all unit tests and fix failures"`
`codex exec --json`	Transmite loguri JSON structurate ale raționamentului și editărilor de fișiere	`codex exec --json "Refactor utils" > run.jsonl`
`codex review`	Revizuire de cod neinteractivă pe diff-ul Git curent	`codex review`
`codex resume`	Deschide selectorul de sesiuni (stocate în `~/.codex/sessions/`)	`codex resume` / `codex resume --last` / `codex resume <id>`
`codex apply` / `codex a`	Aplică în spațiul de lucru local diff-urile generate de sarcini Codex Cloud	`codex apply <task_id>`
`codex cloud`	Inspectează sau gestionează sarcinile remote din Codex Cloud	`codex cloud`
`codex mcp`	Gestionează integrările cu servere Model Context Protocol (MCP)	`codex mcp list` / `codex mcp add <name> ...`
`-m, --model <name>`	Specifică modelul de bază pentru sesiune sau execuție	`codex -m gpt-6.1-sol`
`--strict-config`	Validează strict sintaxa și cheile din `config.toml`	`codex --strict-config`

2. Matricea politicilor de Sandbox și aprobare

Codex CLI separă permisiunile în două straturi ortogonale: ce poate atinge mediul (--sandbox) și când să întrebe utilizatorul (--ask-for-approval).

Flag	Valori valide	Comportament și utilizare recomandată
`--sandbox <mode>` (alias `-s`)	`read-only`	Doar citire: inspectează și caută în cod fără a modifica fișiere
	`workspace-write`	Scriere în spațiul de lucru (implicit recomandat): permite editări doar în arborele de lucru
	`danger-full-access`	Acces nerestricționat: acces complet la sistemul de fișiere/sistem (doar în containere izolate)
`--ask-for-approval <policy>`	`on-request`	Implicit recomandat: modelul solicită confirmare atunci când acțiunile riscante o cer
	`on-failure`	Escalează doar la eșec (folosește `on-request` dacă prompturile de ridicare a sandbox-ului sunt importante)
	`never`	Complet silențios: nu solicită niciodată confirmare interactivă (pentru CI / pipeline-uri automate)

⚠️ Notă privind flag-urile depreciate și retrase:

--full-auto este depreciat începând cu v0.128.0. Specifică explicit politicile de sandbox și aprobare: codex --sandbox workspace-write --ask-for-approval on-request "Fix failing tests"

Politica de aprobare untrusted a fost retrasă în v0.149.0; migrează configurațiile la on-request.

3. Comenzi slash interactive în TUI

Tastează / în promptul interactiv codex TUI pentru a controla contextul, permisiunile și fluxurile de lucru:

3.1 Context, modele și permisiuni

Comandă	Funcție	Note și utilizare
`/init`	Generează un `AGENTS.md` inițial adaptat depozitului	Primul pas recomandat într-un proiect nou
`/status`	Inspectează modelul activ, permisiunile și consumul de tokeni	Monitorizează capacitatea de context rămasă
`/model`	Schimbă interactiv modelul și nivelul de Reasoning Effort	Reglează profunzimea raționamentului fără repornire
`/permissions`	Ajustează modul sandbox și politica de aprobare în timpul sesiunii	Restrânge sau relaxează permisiunile la cerere
`/mcp`	Inspectează și gestionează serverele MCP conectate	Verifică conectivitatea cu instrumente externe și baze de date

3.2 Fluxuri de inginerie și controlul sesiunii

Comandă	Funcție	Note și utilizare
`/plan`	Elaborează și revizuiește un plan de implementare înainte de editarea fișierelor	Aliniază arhitectura înaintea refactorizărilor ample
`/review`	Rulează o revizuire de cod din mai multe perspective pe modificările necomise	Descoperă bug-uri, cazuri limită și riscuri de securitate
`/diff`	Inspectează modificările curente necomise ale fișierelor	Verifică diff-urile linie cu linie înainte de acceptare
`/fork`	Ramifică firul conversației într-un punct de control separat	Explorează o abordare alternativă fără a polua contextul principal
`/compact`	Rezumă istoricul conversației pentru a recupera spațiu de context	Previne deviațiile în sesiunile lungi cu multe ture
`/copy`	Copiază ultimul răspuns finalizat în clipboard	Extrage rapid patch-uri sau rezumate
`/title`	Redenumește firul conversației curente	Face sesiunile ușor de regăsit în `codex resume`
`/statusline` / `/theme`	Personalizează elementele barei de stare din subsol sau tema de culori TUI	Adaptează prezentarea în terminal
`/prompts:<name>`	Invocă un șablon personalizat de prompt Markdown	Execută `~/.codex/prompts/<name>.md`

4. Scurtături de tastatură în terminal și sintaxă de intrare

Scurtătură / Sintaxă	Acțiune	Efect și scenariu
`@<path>`	Referire fuzzy de fișier	Injectează conținutul fișierului inline (ex.: `@src/auth.ts`)
`!<command>`	Comandă shell locală inline	Rulează comenzi shell în limitele regulilor active de sandbox (ex.: `!npm test`)
`Tab`	Pune în coadă următorul prompt	Adaugă în coadă un prompt următor, o comandă slash sau o comandă `!` în timp ce Codex lucrează
`Enter`	Întrerupe / ghidează în timpul execuției	Injectează îndrumări suplimentare în timp ce agentul răspunde activ
`Ctrl + G`	Deschide editorul extern	Redactează prompturi pe mai multe linii în `$VISUAL` / `$EDITOR` (Vim, VS Code etc.)
`Ctrl + R`	Caută în istoricul prompturilor	Căutare inversă în prompturile trimise anterior
`Ctrl + L`	Curăță și redesenează ecranul	Eliberează terminalul de aglomerație păstrând starea conversației
`Ctrl + O`	Copiază ultimul rezultat	Echivalent cu `/copy`
`Ctrl + X`	Deschide meniul de tastatură	Accesează presetările de taste și extensiile
`Ctrl + C`	Anulează / Ieși	Întrerupe sarcina activă sau închide sesiunea Codex

5. Fișiere de configurare și ierarhia memoriei (`config.toml` și `AGENTS.md`)

Setările la nivel de proiect suprascriu valorile implicite globale ale utilizatorului:

Strat	Domeniu global (toate repo-urile)	Domeniu de proiect (repo curent)	Scop
Configurație de bază	`~/.codex/config.toml`	`.codex/config.toml`	Model implicit, sandbox, politică de aprobare, comutator rețea, MCP
Instrucțiuni agent	`~/.codex/AGENTS.md`	`./AGENTS.md` (rădăcina repo)	Comenzi build/test, standarde de codare, reguli de arhitectură
Prompturi personalizate	`~/.codex/prompts/*.md`	—	Șabloane reutilizabile pentru comenzile slash `/prompts:<name>`
Jurnale de sesiune	`~/.codex/sessions/`	—	Jurnale persistente restaurate prin `codex resume`

Fișier `~/.codex/config.toml` minim recomandat

# Model implicit
model = "gpt-6.1-sol"

# Mod sandbox și politică de aprobare implicite
sandbox_mode = "workspace-write"
approval_policy = "on-request"

# Restricționează implicit accesul la rețeaua externă din interiorul sandbox-ului
network_access = false