Codex: installeren en instellen

Codex: ReviewInstalleren & instellenNieuwsTechnische tutorial

Stand september 2026, samengesteld uit onze eigen notities en nieuwsarchief; tekst machinaal opgesteld en redactioneel gecontroleerd. Controleer versies en commando's in de officiële documentatie.

In deze handleiding installeer je Codex CLI, de coding-agent van OpenAI voor de terminal, op macOS, Linux of Windows. Je logt in, kiest een model en een veiligheidsniveau, en controleert of alles werkt. De commando's komen uit de officiële documentatie en de repository van OpenAI (stand september 2026).

Wat je nodig hebt

• Besturingssysteem: macOS, Linux of Windows. Op Windows kan Codex native in PowerShell draaien of binnen WSL 2.
• Account: een ChatGPT-account met Codex-toegang, of een OpenAI API-sleutel. Met een abonnement gelden de gebruikslimieten van je plan; met een API-sleutel betaal je per token.
• Linux/WSL 2: het pakket bubblewrap voor de sandbox (zie verderop).

Installeren op macOS en Linux

De officiële installer:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Alternatieven:

brew install --cask codex          # Homebrew
npm install -g @openai/codex       # npm

Je kunt ook een kant-en-klare binary downloaden van de GitHub-releasepagina van openai/codex, bijvoorbeeld codex-aarch64-apple-darwin.tar.gz voor een Mac met Apple-chip.

Controleer daarna:

codex --version

Installeren op Windows

In PowerShell:

irm https://chatgpt.com/codex/install.ps1 | iex

Werk je vooral met Linux-tools, installeer Codex dan in WSL 2 met het Linux-commando van hierboven. Codex gebruikt op beide plekken een sandbox: de native Windows-sandbox in PowerShell, de Linux-sandbox in WSL 2.

Inloggen

Start Codex in je projectmap:

cd ~/mijn-project
codex

Bij de eerste start kies je tussen inloggen met je ChatGPT-account of een API-sleutel. Wil je met een sleutel werken, zet die dan in de omgevingsvariabele OPENAI_API_KEY en commit hem nooit.

Sandbox op Linux

Op macOS werkt de sandbox meteen (via Seatbelt). Op Linux en WSL 2 heeft Codex bubblewrap nodig:

sudo apt-get install bubblewrap      # Debian/Ubuntu
sudo dnf install bubblewrap          # Fedora

De eerste instellingen die ertoe doen

1. Kies een model. Typ in de sessie /model. Per september 2026 raadt OpenAI drie modellen aan:

• gpt-6-sol: voor complex programmeerwerk en agent-taken.
• gpt-6-luna: het zuinigste model, voor veel kleine, gerichte taken.
• gpt-6-astra: het zwaarste model, voor het lastigste werk.

In hetzelfde menu stel je ook het redeneerniveau in. De oudere gpt-5.5 verdwijnt op 14 oktober 2026 voor wie met een ChatGPT-account inlogt.

2. Kies een veiligheidsniveau. Codex combineert een sandbox met een goedkeuringsbeleid. Voor beginners is dit de verstandige combinatie:

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

Codex mag dan bestanden in je project bewerken en gewone commando's draaien, maar vraagt het eerst voor alles daarbuiten, zoals internettoegang. Wil je alleen laten meekijken, gebruik dan --sandbox read-only.

3. Leg de instellingen vast. Zet je keuzes in ~/.codex/config.toml, dan hoef je ze niet steeds mee te geven:

model = "gpt-6-sol"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

4. Geef projectinstructies. Maak in de root van je project een AGENTS.md met buildcommando's, testcommando's en afspraken. Codex leest dat bestand bij elke sessie.

# AGENTS.md
- Build: `npm run build`
- Tests: `npm test` — draai ze voor elke commit
- Wijzig niets buiten `src/` zonder te vragen

Controleren of het werkt

Een eenmalige, onschuldige opdracht zonder interactieve sessie:

codex exec "Leg in drie zinnen uit wat dit project doet."

Komt er een zinnig antwoord, dan werken installatie en login.

Bijwerken

• Officiële installer: voer het installatiecommando opnieuw uit.
• Homebrew: brew upgrade --cask codex.
• npm: npm install -g @openai/codex@latest.

Update regelmatig. In september 2026 verschenen fixes voor twee sandbox-ontsnappingen, Heapjack en Overpatch; gebruik minstens CLI-versie 0.149.0.