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