OpenAI Codex CLI är OpenAIs terminalbaserade kodningsagent som inspekterar kodbaser, redigerar filer, kör tester, integrerar med fjärrjobb i Codex Cloud och ansluter till externa verktyg via MCP direkt från kommandoraden.
Den här snabbguiden täcker Codex CLI:s underkommandon och flaggor, sandlåde- och godkännandepolicyer, interaktiva slash-kommandon i TUI, kortkommandon samt konfiguration via config.toml / AGENTS.md.
🔗 Relaterade snabbguider: Jämförelse av AI-kodningsverktyg för terminalen Snabbguide · Claude Code CLI Snabbguide · Antigravity CLI (agy) Snabbguide · AI Agent Harness Engineering Snabbguide
1. Installation, Autentisering & Grundläggande CLI-kommandon
1.1 Installation & Autentisering
| Åtgärd | Kommando | Anteckningar |
|---|---|---|
| Global npm-installation | npm install -g @openai/codex |
Standardinstallation för alla plattformar |
| Officiellt installationsskript | curl -fsSL https://chatgpt.com/codex/install.sh | sh |
Enradsinstallerare för macOS / Linux |
| Webbläsarinloggning | codex login |
Autentisera med ChatGPT Plus / Pro / Team-konto |
| API-nyckelautentisering | export OPENAI_API_KEY="sk-..." |
Perfekt för headless CI eller containermiljöer |
1.2 CLI-underkommandon & Globala flaggor
| Kommando / Flagga | Beskrivning | Exempel på användning |
|---|---|---|
codex |
Starta det interaktiva TUI:t i aktuell katalog | codex |
codex "prompt" |
Starta en interaktiv session med en inledande prompt | codex "Debug 500 timeout errors on login" |
codex exec / codex e |
Icke-interaktiv (headless) körning för skript och CI | codex exec "Run all unit tests and fix failures" |
codex exec --json |
Strömma strukturerade JSON-loggar över resonemang och filändringar | codex exec --json "Refactor utils" > run.jsonl |
codex review |
Icke-interaktiv kodgranskning av aktuell Git-diff | codex review |
codex resume |
Öppna sessionsväljare (lagras i ~/.codex/sessions/) |
codex resume / codex resume --last / codex resume <id> |
codex apply / codex a |
Applicera diffar skapade av Codex Cloud-uppgifter i lokal arbetsyta | codex apply <task_id> |
codex cloud |
Inspektera eller hantera fjärruppgifter i Codex Cloud | codex cloud |
codex mcp |
Hantera serverintegrationer för Model Context Protocol (MCP) | codex mcp list / codex mcp add <name> ... |
-m, --model <name> |
Ange underliggande modell för sessionen eller körningen | codex -m gpt-6.1-sol |
--strict-config |
Validera syntax och nycklar i config.toml strikt |
codex --strict-config |
2. Matris för Sandlåde- & Godkännandepolicyer
Codex CLI delar upp behörigheter i två ortogonala lager: vad miljön får röra (--sandbox) och när användaren ska tillfrågas (--ask-for-approval).
| Flagga | Giltiga värden | Beteende & rekommenderad användning |
|---|---|---|
--sandbox <mode>(alias -s) |
read-only |
Skrivskyddad: inspektera och sök i kod utan att ändra filer |
workspace-write |
Skrivning i arbetsyta (Rekommenderad standard): tillåt ändringar endast inom arbetskatalogen | |
danger-full-access |
Obegränsad åtkomst: full filsystem-/systemåtkomst (endast isolerade containrar) | |
--ask-for-approval <policy> |
on-request |
Rekommenderad standard: modellen ber om bekräftelse när riskfyllda åtgärder kräver det |
on-failure |
Eskalera endast vid fel (använd on-request om sandlådeeskalering ska bekräftas) |
|
never |
Helt tyst: fråga aldrig interaktivt (för CI / automatiserade pipelines) |
⚠️ Meddelande om utfasade & borttagna flaggor:
--full-autoär utfasad (deprecated) från och medv0.128.0. Ange sandlåde- och godkännandepolicyer explicit:codex --sandbox workspace-write --ask-for-approval on-request "Fix failing tests"- Godkännandepolicyn
untrustedtogs bort iv0.149.0; migrera konfigurationer tillon-request.
3. Interaktiva Slash-kommandon i TUI
Skriv / i den interaktiva codex-TUI-prompten för att styra kontext, behörigheter och arbetsflöden:
3.1 Kontext, Modeller & Behörigheter
| Kommando | Funktion | Anteckningar & användning |
|---|---|---|
/init |
Generera en startfil för AGENTS.md anpassad till arkivet |
Rekommenderat första steg i ett nytt projekt |
/status |
Inspektera aktiv modell, behörigheter och tokenförbrukning | Övervaka återstående kontextutrymme |
/model |
Byt modell och nivå för Reasoning Effort interaktivt | Justera resonemangsdjup utan omstart |
/permissions |
Justera sandlådeläge och godkännandepolicy mitt i sessionen | Skärp eller lätta på behörigheter vid behov |
/mcp |
Inspektera och hantera anslutna MCP-servrar | Verifiera anslutning till externa verktyg och databaser |
3.2 Utvecklingsarbetsflöden & Sessionskontroll
| Kommando | Funktion | Anteckningar & användning |
|---|---|---|
/plan |
Utforma och granska en implementeringsplan före filredigering | Säkerställ enighet om arkitektur före stora refaktoreringar |
/review |
Kör flerperspektivs kodgranskning på ej incheckade ändringar | Hitta buggar, gränsfall och säkerhetsrisker |
/diff |
Inspektera aktuella ej incheckade filändringar | Granska diffar rad för rad innan godkännande |
/fork |
Förgrena konversationstråden till en separat kontrollpunkt | Utforska alternativa lösningar utan att smutsa ned huvudkontexten |
/compact |
Sammanfatta konversationshistorik för att frigöra kontextutrymme | Förhindra kontextglidning i långa flerturssessioner |
/copy |
Kopiera det senast slutförda svaret till urklipp | Extrahera patchar eller sammanfattningar snabbt |
/title |
Byt namn på aktuell konversationstråd | Gör sessioner lätta att hitta i codex resume |
/statusline / /theme |
Anpassa statusfält i sidfot eller färgtema i TUI | Skräddarsy terminalpresentationen |
/prompts:<name> |
Anropa en anpassad Markdown-promptmall | Kör ~/.codex/prompts/<name>.md |
4. Kortkommandon i terminalen & Inmatningssyntax
| Kortkommando / Syntax | Åtgärd | Effekt & scenario |
|---|---|---|
@<path> |
Fuzzy filreferens | Infoga filinnehåll direkt i prompten (t.ex. @src/auth.ts) |
!<command> |
Inbäddat lokalt skalkommando | Kör skalkommandon inom aktiva sandlåderegler (t.ex. !npm test) |
Tab |
Köa nästa prompt | Köa en uppföljande prompt, slash-kommando eller !-kommando medan Codex arbetar |
Enter |
Avbryt / styr under körning | Skjut in ytterligare vägledning medan agenten aktivt svarar |
Ctrl + G |
Öppna extern redigerare | Skriv flerradiga prompter i $VISUAL / $EDITOR (Vim, VS Code etc.) |
Ctrl + R |
Sök i prompthistorik | Omvänd sökning bland tidigare inskickade prompter |
Ctrl + L |
Rensa & rita om skärmen | Rensa terminalvyn med bibehållet konversationstillstånd |
Ctrl + O |
Kopiera senaste utdata | Motsvarar /copy |
Ctrl + X |
Öppna tangentbordsmeny | Få åtkomst till tangentbordsförinställningar och tillägg |
Ctrl + C |
Avbryt / Avsluta | Avbryt aktiv uppgift eller avsluta Codex-sessionen |
5. Konfigurationsfiler & Minneshierarki (config.toml & AGENTS.md)
Inställningar på projektnivå åsidosätter globala användarstandarder:
| Lager | Global omfattning (alla arkiv) | Projektomfattning (aktuellt arkiv) | Syfte |
|---|---|---|---|
| Grundkonfiguration | ~/.codex/config.toml |
.codex/config.toml |
Standardmodell, sandlåda, godkännandepolicy, nätverksväxel, MCP |
| Agentinstruktioner | ~/.codex/AGENTS.md |
./AGENTS.md (arkivets rot) |
Bygg-/testkommandon, kodstandarder, arkitekturregler |
| Anpassade prompter | ~/.codex/prompts/*.md |
— | Återanvändbara mallar för slash-kommandot /prompts:<name> |
| Sessionsloggar | ~/.codex/sessions/ |
— | Beständiga loggar som återställs av codex resume |
Minimal rekommenderad ~/.codex/config.toml
# Standardmodell
model = "gpt-6.1-sol"
# Standardläge för sandlåda och godkännandepolicy
sandbox_mode = "workspace-write"
approval_policy = "on-request"
# Begränsa utgående nätverksåtkomst i sandlådan som standard
network_access = false