Codex CLI
v0.133.0OpenAI's lichtgewicht terminal coding agent — Rust-powered TUI
Codex CLI is een snelle, lichtgewichte terminal-agent voor agentic coding, met multi-model support en Goal Mode voor autonome workflows.
Installatie
npm install -g @openai/codex
Alternatieven:
brew install openai/codex/codex # Homebrew (macOS)curl -fsSL https://chatgpt.com/codex/install.sh | bash # directcodex update # update bestaande installatiemacOS (Intel/Apple Silicon), Linux (x86_64/ARM64), Windows via WSL2 · Apache 2.0 · 84.7k GitHub-sterren
Gratis inbegrepen bij ChatGPT Plus / Pro / Business / Edu / Enterprise. Sandbox vereist bubblewrap (bwrap) op Linux/WSL2; macOS gebruikt ingebouwd Seatbelt framework.
Authenticatie
| Methode | Setup | Geschikt voor |
|---|---|---|
| ChatGPT OAuth (aanbevolen) | Browser-gebaseerde sign-in | Plus/Pro/Business/Edu/Enterprise abonnees |
| Device code | Terminal device flow | CI-omgevingen |
| API key | CODEX_API_KEY env var | Programmatische toegang |
| Access token via stdin | Gepiped token | Veilige credential-doorgave in scripts |
codex loginAuthenticeer (OAuth flow by default)codex logoutSla opgeslagen credentials opexport CODEX_API_KEY="sk-..."Non-interactieve authenticatieModi & Gebruik
Interactieve TUI (standaard)
- Volledige terminal UI — leest repo-structuur, bewerkt bestanden, voert commando's uit
- Real-time review van elke stap vóór uitvoering
- Conversatiecontext bewaard inclusief uitleg voor wijzigingen
- Sessies persistent opgeslagen — hervatten met `codex resume`
Non-interactieve exec mode
- codex exec "taak" — voert uit en sluit af
- --json vlag voor machine-leesbare JSONL output
- --output-schema voor gestructureerde data-extractie
- Ideaal voor CI/CD-pipelines en scripting
Cloud Tasks
- codex cloud --env REPO_NAME "taak" — delegeer naar cloud container
- Elke taak draait in geïsoleerde container met pre-geladen repo
- codex apply — cloud-resultaten lokaal toepassen
- --attempts 1–4 voor automatische retry
Sandbox & Veiligheid
De sandbox is de grens waarbinnen Codex autonoom kan handelen zonder onbeperkte toegang tot je machine. Drie sandbox-modi bepalen wat Codex mag lezen, schrijven en uitvoeren.
| Sandbox mode | Capabilities | Gebruik |
|---|---|---|
| read-only | Alleen bestanden lezen | Code review, analyse, verkenning |
| workspace-write (standaard) | Lezen + schrijven binnen workspace, routinecommando's | Lokale ontwikkeling |
| danger-full-access | Volledige filesystem + netwerktoegang | Alleen in geïsoleerde omgeving (VM/container) |
codex --sandbox workspace-write --ask-for-approval on-request "taak"Aanbevolen voor lokale ontwikkelingcodex exec --json --sandbox read-only "analyseer repo"CI/CD pipeline (machine-leesbaar)codex --dangerously-bypass-approvals-and-sandbox "taak"Alleen in vertrouwde, hardened omgevingModellen
| Model | Geschikt voor | Snelheid |
|---|---|---|
| gpt-5.5 (aanbevolen) | Complexe taken, planning, multi-step workflows | Standaard |
| gpt-5.4 | Algemene feature-ontwikkeling | Standaard |
| gpt-5.4-mini | Snelle taken, lichte scripting | Snel |
| gpt-5.3-Codex | Code-specifieke taken, cloud tasks | Snel |
Fast Mode verlaagt latency voor tijdkritische taken. Reasoning effort instelbaar via model_reasoning_effort = "low" / "medium" / "high" in config.toml.
Slash Commando's (40+)
/modelModel en reasoning effort wijzigen/fastFast service tier togglen/planPlanningmodus voor implementatie/goal <doel>Persistent doel instellen voor autonome uitvoering/diffGit-wijzigingen inclusief untracked files tonen/reviewWorking tree analyseren (diff-gebaseerd, wijzigt niets)/forkConversatie kloonen naar aparte thread/agent [naam]Actieve agent thread wisselen of aanmaken/compactConversatie samenvatten om context-tokens te bewaren/ideOpen editor-bestanden en selecties meenemen/permissionsGoedkeuringsvereisten mid-sessie aanpassen/sandbox-add-read-dir <pad>Extra leestoegang verlenen/skillsBeschikbare skills en marketplace bekijken/mcpMCP tools weergeven/statusModel, machtigingen, writable roots, token-gebruik/initAGENTS.md scaffold aanmaken voor de repositoryConfiguratie
Configuratie in config.toml op user-niveau (~/.codex/), project-niveau (.codex/) of systeem-niveau (/etc/codex/). CLI-flags en --config overrides hebben de hoogste prioriteit.
# ~/.codex/config.toml model = "gpt-5.5" sandbox_mode = "workspace-write" approval_policy = "on-request" web_search = "cached" model_reasoning_effort = "high" [features] goals = true memories = false [mcp_servers.context7] command = "npx" args = ["-y", "@upstash/context7-mcp"] enabled = true
Named profiles via [profile.naam] — aanroepen met codex --profile naam
Afbeeldingen & MCP
Afbeeldingsinvoer
- --image screenshot.png "implementeer dit ontwerp"
- Meerdere bestanden: --image img1.png,img2.png,img3.png
- Drag-and-drop naar terminal, of plakken in de composer
- Maximaal 5MB per afbeelding · PNG, JPEG, WebP, GIF ondersteund
MCP Integratie
- codex mcp add context7 -- npx -y @upstash/context7-mcp
- codex mcp add figma -- --url https://api.figma.com --token $TOKEN
- STDIO (lokale processen) en HTTP (remote services) ondersteund
- Codex zelf als MCP server: codex mcp-server --listen stdio://
Goal Mode
Goal Mode (release v0.128.0, mei 2026, standaard ingeschakeld) laat Codex autonoom werken aan een doel over langere perioden — uren of zelfs dagen. Codex breekt het doel op, implementeert, valideert en itereert totdat het doel bereikt is.
Gebruik
- /goal Migreer dit Python project van Pydantic v1 naar v2 en laat alle tests slagen
- Codex maakt plan → implementeert → draait tests → analyseert → itereert
- Pauzeer met Ctrl+C (status opgeslagen), hervatten met codex resume
- /goal --clear om actief doel te verwijderen
Goede use cases
- Grote refactors en migraties (bijv. Pydantic v1→v2)
- Feature-implementatie met geautomatiseerde validatielus
- Dependency-upgrades waarbij alle tests moeten slagen
- Codebase-reorganisatie
Prijzen (Mei 2026)
- Beperkte Codex verkenning
- Basisfeatures
- Meerdere wekelijkse sessies
- 15–80 berichten GPT-5.5 per 5u
- 5× Plus gebruik
- Fast Mode
- 80–400 berichten GPT-5.5 per 5u
- 20× Plus gebruik
- Highest limits
- 300–1600 berichten GPT-5.5 per 5u
Alle plannen overgegaan op token-gebaseerde billing per 2 april 2026. Business en Enterprise: pay-as-you-go met extra team features en SLA. Token-kosten: GPT-5.5 = 125 credits/1M input tokens.
Links
Bijgewerkt: 2026-05-23