Flag-urile globale codex (referință) în OpenAI Codex CLI

codex [OPȚIUNI] [PROMPT]   |   codex <subcomandă> [OPȚIUNI]

Ce face Flag-urile globale codex (referință)

Flag-urile globale se aplică comenzii codex de bază. Cele mai multe se propagă și la subcomenzi: de exemplu, codex exec --oss ... aplică --oss pentru exec. Pentru excepții, verifică ajutorul subcomenzii.

Codex citește valorile implicite din ~/.codex/config.toml. Orice suprascriere -c cheie=valoare dată în linia de comandă are prioritate pentru acea rulare. Valorile se interpretează ca TOML când se poate; altfel se folosesc ca text.

Pentru lucru local cu puține întreruperi, documentația recomandă --sandbox workspace-write --ask-for-approval on-request. Flag-ul vechi --full-auto nu mai este suportat; folosește --sandbox workspace-write sau --approve-for-me.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
PROMPT	Instrucțiunea opțională cu care pornește sesiunea. Fără ea, TUI-ul pornește fără mesaj precompletat.
--image, -i <cale[,cale...]>	Atașează una sau mai multe imagini la primul prompt. Separi căile prin virgulă sau repeți flag-ul.
--model, -m <model>	Suprascrie modelul din configurație (de exemplu gpt-6.1-sol).
--oss	Folosește un furnizor local de modele open source: cel din --local-provider, cel din oss_provider sau te întreabă (LM Studio ori Ollama).
--local-provider lmstudio|ollama	Alege furnizorul local folosit cu --oss, peste oss_provider, doar pentru această rulare.
--profile, -p <nume>	Adaugă $CODEX_HOME/<nume>.config.toml peste configurația de bază a utilizatorului.
--sandbox, -s read-only|workspace-write|danger-full-access	Politica de sandbox pentru comenzile shell generate de model.
--ask-for-approval, -a on-request|never	Când se oprește Codex să ceară aprobare înainte de o comandă.
--approve-for-me, --not-so-yolo	Revizuire automată a aprobărilor, cu aprobări on-request și sandbox workspace-write. Intră în conflict cu --sandbox și --yolo; CLI-ul interactiv respinge și --ask-for-approval.
--dangerously-bypass-approvals-and-sandbox, --yolo	Rulează orice comandă fără aprobări și fără sandbox. Doar într-un mediu izolat din exterior.
--dangerously-bypass-hook-trust	Rulează hook-urile activate fără încrederea salvată pentru ele, doar pentru această invocare. Gândit pentru automatizări care verifică deja sursa hook-urilor.
--cd, -C <cale>	Directorul de lucru al agentului, setat înainte să înceapă cererea.
--search	Căutare web live (web_search = "live") în loc de modul implicit "cached".
--add-dir <cale>	Acordă drept de scriere în directoare suplimentare, pe lângă workspace. Se repetă pentru mai multe căi.
--no-alt-screen	Dezactivează ecranul alternativ al TUI-ului (suprascrie tui.alternate_screen).
--no-daemon	Pornește CLI-ul interactiv fără serverul comun în fundal. Nu se combină cu --remote sau codex agents.
--worktree	Pornește într-un Git worktree nou, gestionat de Codex. Merge cu sesiuni interactive noi, codex fork <SESSION_ID>, codex exec și codex exec fork; cere execuție locală.
--remote ws://host:port|wss://host:port|unix://|unix://CALE	Se conectează la un app server prin WebSocket sau socket Unix. Suportat de codex, agents, queue, resume, fork, archive, delete și unarchive.
--remote-auth-token-env <VAR>	Citește un bearer token din variabila de mediu dată și îl trimite la conectarea cu --remote (doar pe wss:// sau ws:// local).
--strict-config	Eroare dacă config.toml conține câmpuri necunoscute versiunii curente. Suportat de codex, exec, review, resume, fork, app-server și exec-server.
--enable <funcție>	Activează forțat un feature flag (echivalent cu -c features.<nume>=true). Se poate repeta.
--disable <funcție>	Dezactivează forțat un feature flag (-c features.<nume>=false). Se poate repeta.
--config, -c cheie=valoare	Suprascrie valori din configurație pentru această rulare.

Exemple practice

Exemplul 1: Lucru local cu aprobări la cerere

codex --sandbox workspace-write --ask-for-approval on-request

Exemplul 2: Alt director, alt model și căutare web live

codex -C ~/proiecte/api -m gpt-6.1-sol --search "verifică ce s-a schimbat în ultima versiune a bibliotecii de plăți"

Exemplul 3: Suprascrieri de configurație pentru o rulare

codex -c model_reasoning_effort=high --enable goals

Greșeli frecvente și bune practici

• Folosești --sandbox danger-full-access ca să dai acces la încă un director. Documentația recomandă --add-dir.
• Copiezi --full-auto din tutoriale vechi; nu mai este suportat.
• Pui -a untrusted sau -a on-failure. Politica untrusted nu mai este suportată, iar on-failure este depreciată; folosește on-request sau never.

Comenzi înrudite

• codex
• codex-sandbox
• codex-permissions
• codex-exec