OpenAI Codex: installeren, gebruiken en toegangsvoorwaarden in 2026

Het woord ‘Codex’ in zoekresultaten verwijst naar drie verschillende dingen, en mensen die er voor het eerst naar zoeken begrijpen meestal niet wat ze hebben gevonden. Er was een Codex-model — dat werd in 2023 stopgezet; tegenwoordig is de naam verbonden aan een agentprogramma, en er zijn nog een tiental andere producten met dezelfde naam.

Ik bespreek slechts één Codex: de programmeeragent van OpenAI. Wat die doet, waar die draait, hoeveel die kost, hoe je die in vijf minuten installeert en wat OpenAI over landen zegt. Alles is gebaseerd op officiële documentatie, met links bij elk cijfer aan het einde.

Aanvullend materiaal over het instellen van tools vind je in de Ailoot-documentatie.

Wat is OpenAI Codex?#

Vergelijk het met een gewone chat. In een chat kopieer je een stukje code, plak je het erin, krijg je een antwoord en kopieer je dat terug. Een agent werkt anders: je beschrijft een taak in gewone taal en de agent opent de relevante bestanden in je projectmap, brengt wijzigingen aan, voert controles uit en laat je het resultaat zien.

OpenAI beschrijft het in één regel in zijn repository:

Lokaal betekent dat het programma naar je computer wordt gedownload, waar het je bestanden kan zien en opdrachten in je map kan uitvoeren. Alleen het verzoek aan het model gaat naar de cloud.

De opensourcecode staat op GitHub onder de Apache-2.0-licentie. Op 1 augustus 2026 heeft de repository 103.000 sterren en is de nieuwste versie, 0.146.0, op 29 juli uitgebracht. Er komen bijna dagelijks updates uit, dus jouw versie kan inmiddels al anders zijn.

Waarin verschilt Codex in 2026 van de oude Codex die is stopgezet?#

Mensen halen ze voortdurend door elkaar omdat beide producten officieel zijn en allebei van OpenAI komen. De datums maken het verschil duidelijk.

De eerste was een reeks modellen: code-davinci-001, code-davinci-002, code-cushman-001, code-cushman-002. Ze deden één ding — code voor je aanvullen — en vormden de basis voor de eerste GitHub Copilot. In OpenAI’s lijst met stopgezette modellen staan ze alle vier op één regel: aangekondigd op 20 maart 2023, stopgezet op 23 maart, met gpt-4o als aanbevolen vervanger.

De tweede is een programma dat je op je computer installeert. Het pakket @openai/codex verscheen op 16 april 2025 in het npm-register. Het model erin wordt na verloop van tijd vervangen door een nieuwer model, terwijl het programma zelf hetzelfde blijft.

Alle instructies over Codex van vóór april 2025 beschrijven een stopgezet product. Vind je materiaal dat Codex een model noemt en aanraadt om het via code-davinci-002 aan te roepen, sluit het dan.

Waar werkt Codex: in de terminal, editor, browser of app?#

Je hoeft er niet één te kiezen. Je gebruikt dezelfde aanmeldmethode en hetzelfde account. Het enige verschil is waar je het prettigst werkt.

De extensie werkt voor Xcode en JetBrains anders dan voor de andere editors:

Cloud werkt anders dan de andere vier. De taak gaat naar een OpenAI-container, waar een kopie van de repository vanuit GitHub wordt uitgecheckt. De agent werkt zonder je computer en jij bekijkt later het resultaat en beslist of je de wijzigingen naar je eigen kopie overneemt. Het instellen bestaat uit drie stappen: GitHub koppelen, een omgeving met de benodigde afhankelijkheden maken en een taak toewijzen.

Als je je aanmeldt met een API-sleutel, werken de terminal, editor en app. Cloud is niet beschikbaar met een sleutel. Ook de functies die eraan gekoppeld zijn, zoals automatische codebeoordeling en taken starten vanuit Slack, zijn dan niet beschikbaar. Daarvoor moet je je aanmelden met een ChatGPT-account.

Welk model draait er in Codex?#

OpenAI vat het in één regel samen:

Naast het model is er een tweede instelling: de redeneerinspanning. Die heeft vier niveaus: Low (in de app en editor Light genoemd), Medium, High en Extra High. OpenAI raadt aan om het laagste niveau te gebruiken waarmee je het gewenste resultaat krijgt en het te verhogen wanneer een taak planning vereist.

Daarboven zijn nog twee modi. Max geeft het model meer tijd voor een taak. Ultra splitst het werk op in delen en wijst die parallel toe aan subagenten. De documentatie zegt expliciet dat de meeste taken geen van beide nodig hebben.

Er is ook een afzonderlijke optie, gpt-5.3-codex-spark — een onderzoeksversie voor snelle iteraties, alleen beschikbaar bij het Pro-abonnement.

Het model en de redeneerinspanning kiezen is al context engineering: je bepaalt hoeveel de agent nadenkt en welke informatie hij voor de taak gebruikt. De combinatie heeft drie pijlers: AI-kloon (jouw methode in de agent), Tweede Brein (de kennisstructuur van het project) en context engineering. Zonder deze combinatie gaat de AI-agent dingen verzinnen.

Wat kost Codex en wat is inbegrepen bij de abonnementen?#

Ik heb de prijzen op 1 augustus 2026 gecontroleerd aan de hand van de officiële prijspagina.

Business kost bij maandelijkse facturering $25 per gebruiker in plaats van $20.

Dan de limieten. OpenAI geeft geen vast aantal:

In plaats van één getal publiceert OpenAI een bereik: hoeveel berichten je in vijf uur krijgt wanneer je op je eigen computer werkt. De cijfers zijn hetzelfde voor Plus en Business:

Bij het Pro-abonnement van $100 worden alle cijfers met vijf vermenigvuldigd; bij het Pro-abonnement van $200 met twintig. OpenAI noemt naast het venster van vijf uur ook wekelijkse limieten, maar publiceert daarvoor geen specifieke cijfers.

De tienvoudige spreiding binnen één model heeft een eenvoudige verklaring. Eén bericht kan één procent of tien procent van je dagelijkse tegoed gebruiken, omdat de hoeveelheid werk telt en het aantal verzoeken weinig invloed heeft. Ik heb uitgebreid uitgelegd hoe tokens in de praktijk worden gebruikt, aan de hand van Claude als voorbeeld, in Claude Pro- en Max-limieten — de werking is precies hetzelfde.

Als je limiet op is, zijn er drie opties: extra credits kopen zonder je abonnement te wijzigen, overstappen op een lichter model of een sessie starten met een API-sleutel en betalen voor de tokens die je gebruikt.

Welke regionale beperkingen gelden voor Codex?#

OpenAI publiceert de officiële lijst met ondersteunde landen en gebieden. Belarus staat niet op de lijst. Kazachstan, Armenië, Georgië, Turkije, Servië en Oekraïne staan er wel op.

De formulering op diezelfde pagina:

Het programma installeren en uitvoeren is één ding; toegang tot het model is iets anders. De landencontrole vindt plaats bij het aanmelden: zowel aanmelden via ChatGPT als aanmelden met een API-sleutel leidt naar een OpenAI-account.

Meldingen op GitHub laten zien hoe een afwijzing vanwege een land eruitziet. In januari 2026 schreef een ontwikkelaar uit Venezuela dat die Codex 0.88.0 in PowerShell gebruikte en bij elke poging hetzelfde kreeg:

{
  "error": {
    "code": "unsupported_country_region_territory",
    "message": "Country, region, or territory not supported",
    "type": "request_forbidden"
  }
}

De code unsupported_country_region_territory en status 403 wijzen op een afwijzing vanwege het land. Als je dit ziet, betekent het dat je bij de installatie niets verkeerd hebt gedaan en dat Node er niets mee te maken heeft.

Er is nog een tweede drempel die nergens in de documentatie wordt beschreven, maar in de praktijk vaker voorkomt: verificatie van het telefoonnummer. De melding ‘Phone number verification doesn’t work’ heeft 206 reacties; een tweede melding over een oud nummer dat niet meer toegankelijk is en niet vervangen kan worden, staat sinds juni 2026 open en heeft 71 reacties. Hetzelfde verhaal komt steeds terug: ChatGPT werkt in de browser met hetzelfde account, maar Codex vraagt om telefoonverificatie en er is geen manier om die eis te omzeilen. OpenAI publiceert geen lijst met landen waarvan de telefoonnummers worden geaccepteerd, dus je kunt dat niet vooraf controleren.

Ik bespreek geen omwegen; dit artikel gaat over hoe de tool werkt.

Anthropic publiceert ook een lijst met ondersteunde landen, en die werkt op dezelfde manier. Materiaal waarin de ene tool als ‘toegestaan’ en de andere als ‘geblokkeerd’ wordt voorgesteld, misleidt lezers simpelweg — formeel bevinden ze zich in dezelfde situatie. Beide lijsten veranderen, dus controleer de actuele versies.

Codex installeren: stap voor stap#

Hier begint het technische gedeelte, voor wie al een actief OpenAI-account heeft.

1. Installeer het programma

   Kies de methode voor jouw systeem. Gebruik later dezelfde methode om het programma bij te werken naar de nieuwste versie.

2. Open de projectmap

   De agent werkt in de map van waaruit je hem hebt gestart. Ga daarheen voordat je de eerste opdracht uitvoert.

3. Meld je aan bij je account

   Wanneer je codex voor het eerst uitvoert, kun je je aanmelden. Er wordt een browser geopend en nadat je je hebt aangemeld, keer je terug naar de terminal.

4. Geef de agent je eerste taak

   Beschrijf in gewone taal wat je nodig hebt. Begin met iets onschadelijks, zoals vragen om het project te beschrijven.

Installatieopdracht voor macOS en Linux:

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

Gebruik op Windows hetzelfde installatieprogramma via PowerShell:

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

Als je Node al hebt, kun je het via npm installeren:

npm install -g @openai/codex

Homebrew werkt op macOS. Gebruik --cask; zonder die optie installeer je het verkeerde programma:

brew install --cask codex

Op Linux en WSL2 is de sandbox gebaseerd op bubblewrap, dat je vooraf moet installeren:

sudo apt install bubblewrap

Gebruik op Fedora en vergelijkbare systemen sudo dnf install bubblewrap. WSL versie 1 werd ondersteund tot en met versie 0.114; vanaf 0.115 is de sandbox overgestapt op bubblewrap en werkte WSL1 niet meer. Op Windows werkt alles ook zonder WSL, met de ingebouwde sandbox.

Wat moet je doen bij de eerste start?#

Ga om te beginnen naar de projectmap en typ codex; er wordt een sessie geopend. Beschrijf de taak daarna in gewone taal, zonder speciale syntaxis.

Vijf opdrachten voor je eerste minuten:

1. /status - het model, het goedkeuringsbeleid en de mappen die de agent als zijn werkruimte beschouwt.
2. /permissions - de huidige toegangsmodus en hoe je tussen modi wisselt.
3. /model - het model en de redeneerinspanning wijzigen.
4. /init - maakt een AGENTS.md-bestand dat het project beschrijft; meer hierover in het volgende gedeelte.
5. /review - een aparte beoordeling van je wijzigingen, zonder bestanden te bewerken.

Naast het gewone codex zijn er drie handige terminalopdrachten:

codex resume                    # return to the previous conversation in this folder
codex exec "fix the tests"      # one-off run without a dialogue, for scripts
codex --image screenshot.png    # attach an image to the task

Op zowel de documentatiepagina’s voor de terminal als die voor de extensie herhaalt OpenAI hetzelfde advies: commit voor en na een taak. De agent bewerkt zelf bestanden en je wilt vanaf de eerste dag wijzigingen met één opdracht kunnen terugdraaien.

Hoe leg je je project aan Codex uit met AGENTS.md?#

De volgorde ligt vast en staat volgens de documentatie in de allereerste regel van het gedeelte:

Eerst leest Codex het algemene bestand ~/.codex/AGENTS.md, waarin je gewoonten vastlegt die voor al je projecten gelden. Daarna leest het de bestanden in het project zelf: één bestand per map, vanaf de hoofdmap van de repository tot aan je huidige map. Ze worden van boven naar beneden samengevoegd en een dichterbij gelegen bestand overschrijft een verder weg gelegen bestand. Dat betekent dat een regel in services/payments voorrang heeft op een algemene regel uit de hoofdmap.

Een eenvoudig bestand ziet er zo uit:

# AGENTS.md

## How to work with this project

- Run tests with `npm test`; don't run them one file at a time.
- Install packages with pnpm.
- Ask me before adding a new production dependency.
- Do not touch the `legacy/` folder at all.

De limiet voor de gecombineerde bestanden is 32 kilobytes. Daarna worden bestanden simpelweg niet meer toegevoegd, zonder melding. Een te groot AGENTS.md-bestand verbruikt bij elke uitvoering een deel van de limiet, omdat het volledige bestand in de context wordt opgenomen.

Als je CLAUDE.md kent, zal de werking vertrouwd aanvoelen: het is dezelfde techniek onder een andere naam. Het bestand met projectregels vormt de basis van een Tweede Brein: de agent leert over je werk voordat je iets hebt kunnen uitleggen. Ik heb beschreven hoe je beide bestanden in één project gebruikt in AGENTS.md en CLAUDE.md samen.

Wat doet Codex zelfstandig en waarvoor is goedkeuring nodig?#

Deze twee instellingen worden vaak door elkaar gehaald. Daarom legt OpenAI het verschil in één regel uit:

Als je de beoordeling op automatisch zet, blijven de grenzen van de werkmap hetzelfde. Automatisering haalt alleen de klikken weg; de machtigingen van de agent veranderen niet.

De app en editor hebben drie toegangsmodi. Ask for approval is altijd beschikbaar en wordt aanbevolen als startpunt. Approve for me en Full access moeten eerst in de instellingen worden ingeschakeld.

De terminal heeft eigen regels: het programma controleert de map en stelt een geschikte set machtigingen voor.

Netwerktoegang is standaard uitgeschakeld in de lokale modus. De agent voert opdrachten uit die hij zelf heeft bedacht, en niemand zou die standaard toegang tot internet geven.

Zelfs binnen de werkmap kan de agent in elke modus bepaalde locaties niet lezen: .git, .agents en .codex. Gebruik /status om te zien welke mappen de agent op dat moment als zijn werkruimte beschouwt.

Er is ook een modus met volledige toegang — de vlag --dangerously-bypass-approvals-and-sandbox. De documentatie markeert die als risicovoller en noemt die ‘niet aanbevolen’. De naam van de vlag zegt genoeg; ik heb er niets aan toe te voegen.

Codex of Claude Code: welke kies je?#

Het verschil tussen de tools is kleiner dan je op basis van discussies online misschien zou denken. Beide lezen je project en bewerken zelfstandig bestanden, en beide vragen toestemming voordat ze buiten de map gaan.

Aan het begin kun je het beste kijken waarvoor je al betaalt. Als je een ChatGPT-abonnement hebt, is Codex al inbegrepen; je hoeft niet apart te betalen. Ik heb een gedetailleerde vergelijking met metingen gemaakt in een apart artikel over Codex versus Claude Code. Wil je je werkinstellingen van de ene naar de andere overzetten, dan is er ook een migratiehandleiding.

Wat gaat er bij de eerste start het vaakst mis?#

Deze lijst is gebaseerd op meldingen in de projectrepository. Er wordt niets geraden; elk punt komt van iemand die het zelf heeft meegemaakt.

1. Het verkeerde pakket is geïnstalleerd. npm install -g codex zonder prefix installeert een generator voor statische websites uit 2011. Het juiste pakket is @openai/codex.
2. bubblewrap is niet geïnstalleerd. Zonder bubblewrap start de sandbox niet op Linux en WSL2. Codex schakelt over naar de ingebouwde terugvaloptie en geeft bij het opstarten een melding. Installeer het met één opdracht.
3. Toegang geweigerd vanwege het land. De code unsupported_country_region_territory en status 403 verschijnen bij het aanmelden. De installatie heeft hier niets mee te maken.
4. Telefoonverificatie is vereist. Dit gebeurt niet bij iedereen en staat niet in de documentatie. Er is geen officiële manier om een ontoegankelijk nummer te vervangen; de melding hierover staat sinds juni 2026 open.
5. Je gebruikslimiet raakt eerder op dan verwacht. De melding ‘Tokens burn up very quickly’ is de meest besproken melding in de hele repository, met 627 reacties. Overschakelen naar een lichter model en de redeneerinspanning verlagen kan helpen.

De taal van de interface heeft geen invloed op het werk van de agent: de taak hoeft niet in dezelfde taal te zijn als de interface.

Wat kun je hierna doen?#

Het eerste uur met een agent besteed je altijd aan hetzelfde: ontdekken hoe ver hij zelfstandig kan gaan. Dat kun je alleen met je eigen project leren; een voorbeeld in de documentatie vertelt het je niet.

Dit is de volgorde die ik aanraad:

1. Installeer het programma en meld je aan bij een actief OpenAI-account.
2. Open een echte projectmap en voer codex uit.
3. Controleer /status en /permissions, kies expliciet alleen-leestoegang voor een inspectietaak en controleer de actieve modus voordat je vraagt hoe het project is georganiseerd.
4. Maak een commit en geef de agent zijn eerste bewerkingstaak.
5. Schrijf een AGENTS.md van drie regels en vergelijk de antwoorden van de agent ervoor en erna.

AI-kloon + Tweede Brein + Context Engineering — vind aanvullend materiaal over werken met tools in de Ailoot-documentatie.