Project Impact
Kennisbank/AI-CLI’s & terminal-agents/OpenAI Codex

OpenAI Codex CLI installeren op Mac, Windows en Linux

7 min leestijdOpenAI Codex · 2 van 4

De snelste manier om de OpenAI Codex CLI te installeren is met één regel in je terminal. Op macOS en Linux plak je curl -fsSL https://chatgpt.com/codex/install.sh | sh en druk je op enter; op Windows draai je in PowerShell powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". Daarna start je de agent met het commando codex, log je de eerste keer in met je ChatGPT-account, en ben je klaar (developers.openai.com/codex/cli, github.com/openai/codex). Wil je liever je vertrouwde package manager gebruiken, dan kan dat ook: npm install -g @openai/codex of brew install --cask codex. Hieronder loop ik elke methode, het Windows-verhaal en de eerste inlog stap voor stap met je door.

Key Takeaways

  • •Codex CLI is een open-source terminal-agent van OpenAI, geschreven in Rust — een zelfstandige binary die geen Node-runtime nodig heeft om te draaien (developers.openai.com/codex/cli).
  • •Drie installmethodes op Mac en Linux: het curl-installerscript, npm (@openai/codex) of Homebrew (brew install --cask codex) (github.com/openai/codex).
  • •Op Windows draai je het PowerShell-installerscript óf je gebruikt WSL2; OpenAI ondersteunt beide officieel (developers.openai.com/codex/windows).
  • •De eerste keer dat je codex start, kies je tussen inloggen met je ChatGPT-account (Plus, Pro, Business, Edu of Enterprise) of een API-key (developers.openai.com/codex/cli).
  • •Updaten doe je door dezelfde installer opnieuw te draaien; per juni 2026 is de laatste npm-versie 0.137.0 (npm-registry, gecontroleerd 5 juni 2026).

Wat je installeert: een Rust-binary, geen Node-pakket

Voordat je begint, is het handig te weten wat Codex CLI eigenlijk is. Het is OpenAI's coding-agent voor de command line: een tool die je codebase leest, bestanden bewerkt en commando's draait — een echte terminal-agent, geen chatvenster. OpenAI omschrijft het kernachtig als "open source and built in Rust for speed and efficiency" (developers.openai.com/codex/cli). De broncode op GitHub bestaat voor ruim 96% uit Rust en staat onder de Apache-2.0-licentie (github.com/openai/codex).

Dat Rust-detail heeft een praktisch gevolg voor je installatie. Codex wordt verspreid als een vooraf gecompileerde, zelfstandige binary — voor macOS (Apple Silicon/arm64 én Intel/x86_64) en Linux (x86_64 en arm64). Je hebt dus geen Node-runtime nodig om Codex te draaien, ook niet als je het via npm binnenhaalt: het npm-pakket levert simpelweg de juiste binary voor jouw systeem af. Dat onderscheidt Codex van pure JavaScript-CLI's en houdt de start snel en licht.

Methode 1 — Het curl-installerscript (Mac en Linux)

De methode die OpenAI als eerste noemt, is een installerscript dat je via curl ophaalt en uitvoert. In je terminal:

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

Het script detecteert je besturingssysteem en architectuur, downloadt de juiste binary en zet codex op je pad (developers.openai.com/codex/cli). Werkt op zowel macOS als Linux. Na afloop controleer je of het gelukt is met:

codex --version

Krijg je een versienummer terug, dan staat de installatie. Een script vanaf internet rechtstreeks naar sh pipen vraagt om wat vertrouwen in de bron — het script komt hier van OpenAI's eigen chatgpt.com-domein. Wil je het eerst inzien, open de URL dan gewoon in je browser voordat je hem uitvoert.

Methode 2 — npm (@openai/codex)

Heb je Node.js al staan en beheer je je tools het liefst met npm, dan installeer je Codex globaal:

npm install -g @openai/codex

Let op één belangrijk detail: het officiële pakket heet @openai/codex — een scoped pakket onder de @openai-organisatie. Installeer níet het oude, ongescopete codex van een andere uitgever; dat is niet OpenAI's coding-agent. Het juiste pakket vind je terug op de npm-registry (npmjs.com/package/@openai/codex). Zoals gezegd levert npm hier alleen de Rust-binary af — je gebruikt npm dus puur als distributiekanaal.

Methode 3 — Homebrew (Mac)

Voor wie op macOS met Homebrew werkt, is er een cask:

brew install --cask codex

Dit haalt dezelfde binary binnen via je vertrouwde package manager (github.com/openai/codex). Het voordeel van Homebrew is dat updates meelopen met je normale brew upgrade-routine, zodat Codex netjes naast je andere tools wordt bijgehouden.

Codex installeren op Windows

Op Windows zijn er twee routes, en OpenAI ondersteunt ze allebei officieel. De documentatie noemt drie praktische manieren om Codex op Windows te draaien: native met de sterkere elevated-sandbox, native met de unelevated-fallback-sandbox, of binnen Windows Subsystem for Linux 2 (WSL2) (developers.openai.com/codex/windows).

Route A — native via PowerShell. Open PowerShell en draai het installerscript:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Deze regel haalt het PowerShell-installerscript op en voert het direct uit (github.com/openai/codex). OpenAI adviseert Windows 11; Windows 10 vanaf versie 1809 werkt mogelijk met beperkingen, en voor de native installatie moet winget beschikbaar zijn (developers.openai.com/codex/windows).

Route B — via WSL2. Geef je de voorkeur aan een Linux-omgeving, installeer dan eerst WSL met wsl --install, en draai daarna binnen WSL gewoon het Mac/Linux-script:

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

Eén tip uit de docs: bewaar je projecten in dat geval in je Linux-home (~/code/...) en niet op een gemount Windows-pad (/mnt/c/...), dat is merkbaar sneller (developers.openai.com/codex/windows). Werk je liever volledig in een Linux-achtige shell — bijvoorbeeld omdat je git-worktrees of andere Unix-tooling intensief gebruikt — dan is WSL2 vaak de prettigste route.

De eerste keer starten: inloggen

Installeren is stap één; de eerste sessie is stap twee. Ga met je terminal naar de map van het project waar je aan wilt werken en typ:

codex

De allereerste keer vraagt Codex je om in te loggen. Je hebt twee opties (developers.openai.com/codex/cli):

  1. •Sign in with ChatGPT — log in met je ChatGPT-account. Dit werkt voor abonnementen op Plus, Pro, Business, Edu en Enterprise. Voor de meeste mensen is dit de eenvoudigste weg: zit je al op een betaald ChatGPT-plan, dan zit Codex daar feitelijk bij in.
  2. •API-key — authenticeer met een OpenAI API-key. Dit is handig als je gebruik los van een ChatGPT-abonnement wilt afrekenen of in een geautomatiseerde omgeving draait.

Na het inloggen ben je binnen en kun je Codex je eerste opdracht geven in gewone taal. Geef Codex toegang met beleid: zoals bij elke AI-CLI is het verstandig om eerst te begrijpen welke sandbox- en goedkeuringsmodi er zijn voordat je hem vrij over je bestanden laat gaan. We behandelen dat apart in Veilig werken met AI-agents.

Codex updaten

Een nieuwe versie installeren werkt het simpelst door dezelfde installer opnieuw te draaien. Heb je via curl geïnstalleerd, dan draai je het curl-script nogmaals; het overschrijft de oude binary met de nieuwste (developers.openai.com/codex/cli). Bij npm gebruik je npm install -g @openai/codex opnieuw (of npm update -g @openai/codex), en bij Homebrew loopt de update mee met brew upgrade.

Een woord over versienummers, want die verouderen snel. Per juni 2026 is de laatste gepubliceerde npm-versie 0.137.0, volgens de npm-registry gepubliceerd op 4 juni 2026 (npmjs.com/package/@openai/codex). Codex kent een hoog releasetempo, dus dit nummer is bij het lezen vrijwel zeker alweer hoger. Behandel het als een momentopname, niet als een eis: zolang je codex --version een nummer teruggeeft en de installer recent draaide, zit je goed.

Klaar — en wat nu?

Je hebt Codex CLI nu geïnstalleerd via de methode die bij jouw systeem past, je weet hoe Windows en WSL2 werken, en je bent ingelogd met je ChatGPT-account of API-key. De installatie zelf is bewust eenvoudig gehouden; de echte winst zit in hóe je de agent vervolgens aanstuurt en begrenst.

De logische vervolgstap is leren werken binnen verstandige grenzen. Lees daarom verder in Veilig werken met AI-agents over sandboxing en goedkeuringen, en bekijk de overige hoofdstukken in de Codex-gids voor de diepte per onderwerp. Twijfel je nog of Codex de juiste keuze is naast bijvoorbeeld Claude Code, dan helpt De juiste AI-CLI kiezen je verder. En wil je agentic coding gestructureerd onder de knie krijgen met je team, dan is onze Claude Code Masterclass het hands-on startpunt — de werkwijze die je daar leert, vertaalt rechtstreeks naar Codex.

Bronnen

Veelgestelde vragen

Hoe installeer ik de OpenAI Codex CLI op een Mac?

Je hebt drie opties op macOS. De snelste is het curl-installerscript: draai in je terminal `curl -fsSL https://chatgpt.com/codex/install.sh | sh`. Heb je Node.js, dan kun je ook `npm install -g @openai/codex` gebruiken (let op het scoped pakket @openai/codex, niet het oude ongescopete 'codex'). Werk je met Homebrew, dan installeer je met `brew install --cask codex`. Alle drie leveren dezelfde Rust-binary af. Controleer daarna met `codex --version`. Bron: developers.openai.com/codex/cli en github.com/openai/codex, gecontroleerd 5 juni 2026.

Werkt Codex CLI op Windows?

Ja. OpenAI ondersteunt Codex op Windows op drie manieren: native met de elevated-sandbox, native met de unelevated-fallback-sandbox, of binnen WSL2. Native installeer je via PowerShell met `powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"`. Voor de WSL2-route draai je eerst `wsl --install` en daarna binnen WSL het Mac/Linux-script `curl -fsSL https://chatgpt.com/codex/install.sh | sh`. Windows 11 wordt aanbevolen; Windows 10 vanaf 1809 werkt mogelijk met beperkingen. Bron: developers.openai.com/codex/windows, gecontroleerd 5 juni 2026.

Welk npm-pakket is de echte Codex CLI?

Het officiële pakket heet `@openai/codex` — een scoped pakket onder de @openai-organisatie. Installeer het globaal met `npm install -g @openai/codex`. Verwar het niet met het oude, ongescopete pakket 'codex' van een andere uitgever; dat is niet OpenAI's coding-agent. Het npm-pakket levert overigens alleen de vooraf gecompileerde Rust-binary af; je hebt geen draaiende Node-runtime nodig om Codex te gebruiken. Bron: npmjs.com/package/@openai/codex en github.com/openai/codex, gecontroleerd 5 juni 2026.

Hoe log ik in nadat ik Codex heb geïnstalleerd?

De eerste keer dat je `codex` start in een projectmap, vraagt de tool om in te loggen. Je kiest tussen 'Sign in with ChatGPT' — inloggen met je ChatGPT-account, wat werkt voor Plus, Pro, Business, Edu en Enterprise — of authenticeren met een OpenAI API-key. Voor de meeste gebruikers is inloggen met het ChatGPT-account het eenvoudigst: zit je al op een betaald plan, dan is Codex daarbij inbegrepen. Bron: developers.openai.com/codex/cli, gecontroleerd 5 juni 2026.

Hoe update ik Codex CLI naar de nieuwste versie?

Updaten doe je door dezelfde installer opnieuw te draaien. Heb je via curl geïnstalleerd, draai dan het curl-script nogmaals; het overschrijft de oude binary. Bij npm gebruik je opnieuw `npm install -g @openai/codex`, en bij Homebrew loopt de update mee met `brew upgrade`. Per juni 2026 is de laatste npm-versie 0.137.0 (gepubliceerd 4 juni 2026 volgens de npm-registry), maar Codex heeft een hoog releasetempo, dus dat nummer ligt waarschijnlijk alweer hoger. Bron: developers.openai.com/codex/cli en npmjs.com/package/@openai/codex, gecontroleerd 5 juni 2026.