Laatst bijgewerkt:

Codex installeren: terminal, IDE, desktop-app en cloud in de juiste volgorde

Codex is geen losse app meer. Het is de coding-agent die OpenAI over zes oppervlakken uitsmeert, en welke installatie jij nodig hebt hangt af van waar je wilt werken. Deze pagina loopt ze allemaal langs in de volgorde waarin je ze tegenkomt: eerst wat je eigenlijk installeert, dan de systeemeisen, dan de commando's per platform, het inloggen, de IDE-extensies, je eerste sessie, bijwerken en verwijderen. Met aan het eind een tabel van de dingen die het vaakst misgaan. Alles nagelezen in de officiële documentatie op learn.chatgpt.com op 1 augustus 2026.

Oppervlakken

Eerst dit: "Codex installeren" betekent zes verschillende dingen

Wie in 2026 zoekt op Codex installeren, komt oude uitleg tegen over een losse Codex-app. Die bestaat niet meer: op 9 juli 2026 is de Codex-app opgegaan in de ChatGPT desktop-app voor macOS en Windows. OpenAI schrijft het zelf zo op: "On July 9, the Codex app merged into the ChatGPT desktop app for macOS and Windows." Wat er wel is, staat hieronder. Kies eerst je oppervlak, dan weet je welk commando je nodig hebt.

De vijf die OpenAI zelf opsomt

De feature-matrix op de pricingpagina noemt onder "Access and surfaces" precies vijf hoofdoppervlakken: de ChatGPT desktop-app, ChatGPT op het web, de Codex CLI, de Codex IDE-extensie en Codex cloud. Remote op mobiel en de koppelingen met GitHub, Slack en Linear zitten daar bovenop en vragen geen eigen installatie. Codex houdt overal een eigen weergave en een eigen geschiedenis aan, los van ChatGPT Chat en ChatGPT Work.

De snelste route, afhankelijk van wat je wilt

Wil je alleen even proberen wat Codex met je repo doet, dan is de CLI de kortste weg: een commando, inloggen, klaar. Werk je liever met diffs en knoppen, installeer dan de desktop-app en sla de terminal over. Wil je dat taken doorlopen terwijl je laptop dicht is, dan heb je Codex cloud nodig en daarvoor installeer je niets, maar koppel je GitHub. De rest van deze pagina behandelt ze in die volgorde.

De oppervlakken waarop Codex draait en wat je daarvoor installeert, stand 1 augustus 2026
OppervlakWat je installeertWaarvoor je het pakt
Codex CLIInstaller, npm of HomebrewWerken in je terminal, in scripts en in CI
IDE-extensieDe extensie openai.chatgpt, of de eigen integratie van je IDECodex naast je code in VS Code, Cursor, Windsurf, Xcode of JetBrains
ChatGPT desktop-appDe download van chatgpt.com/downloadChat, Work en Codex in een venster, met diffs en pull-request-review
ChatGPT op het webNiets, je logt in op chatgpt.comCodex bedienen vanaf een machine waar je niets mag installeren
Codex cloudGeen installatie, wel een omgeving en een GitHub-koppelingTaken parallel laten draaien in afgeschermde cloudomgevingen
Remote op iOS en AndroidDe ChatGPT-app plus een gekoppelde desktop-hostEen sessie op je Mac of pc bedienen vanaf je telefoon
GitHub, Slack en LinearEen koppeling vanuit Codex cloudWerk starten en reviews aanvragen zonder Codex zelf te openen
Codex-documentatie (officieel)
Beslisboom die aan de hand van je werkwijze bepaalt welke Codex-variant je installeert: de CLI, de IDE-extensie, de desktop-app, de cloud of Remote.Wat wil je met Codex doen?Werk je in een terminal?JaNeeCodex CLIinstaller, npm of brewWil je een grafische diff?JaNeeIDE-extensiein je editorDesktop-appin een eigen vensterWil je vanaf je telefoonbijsturen?JaNeeRemote op mobieltelefoon plus host-pcMag het werk in de clouddraaien?JaNeeCodex cloudgeen installatie nodigGitHub Actionstarten vanuit je repoBlijf lokaalmet de CLI of de desktop-app

Vereisten

Wat je machine en je account moeten kunnen

De eisen zijn laag. De openbare repo van OpenAI zet ze op een rij voor de CLI; voor de desktop-app konden wij geen gedocumenteerde eisen vinden. Loop deze lijst langs voordat je begint, dan loop je niet halverwege vast.

Codex zit in elk abonnement, ook het gratis

Het Help Center is er kort over: "Codex is included across ChatGPT plans, including Free and Go. Usage limits vary by plan." Er is dus geen apart Codex-abonnement dat je eerst moet afsluiten. Wat je vanuit Nederland op chatgpt.com/pricing betaalt, gemeten op 1 augustus 2026: Free €0, Go €8, Plus €23 en Pro vanaf €103 per maand. De Amerikaanse docs noemen 0, 8, 20 en vanaf 100 dollar, dus de europrijzen liggen voor Plus en Pro hoger dan de dollarbedragen die je in de documentatie ziet staan. Wat je daarvoor aan gebruik krijgt, en waarom Codex zijn limieten deelt met ChatGPT Work, staat op Kosten.

Wat we niet konden vaststellen

De 4 GB werkgeheugen en macOS 12 gelden volgens de repo voor de CLI. Voor de ChatGPT desktop-app noemen de docs die wij nalazen geen minimale macOS- of Windows-versie, geen geheugen en geen schijfruimte. Draai je op oude hardware, houd er dan rekening mee dat dit een open punt is.

Systeemeisen voor de Codex CLI volgens de openbare repo, stand 1 augustus 2026
OnderdeelWat het moet zijn
BesturingssysteemmacOS 12 of nieuwer, Ubuntu 20.04 of nieuwer, Debian 10 of nieuwer, of Windows 11 via WSL2
WerkgeheugenMinimaal 4 GB, 8 GB aanbevolen
GitVersie 2.23 of nieuwer. Optioneel, maar aanbevolen voor de ingebouwde pull-request-helpers
WSL-versieWSL2. WSL1 werd ondersteund tot en met Codex 0.114 en valt daarna af
AccountElk ChatGPT-abonnement, ook Free en Go. Of een OpenAI API-key voor betalen per token
Extra voor Codex cloudInloggen met je ChatGPT-account plus multi-factor authenticatie
Systeemeisen in de openbare repo

Installeren

De Codex CLI installeren: vier routes, een commando

Kies er een. De standalone installer is de route die OpenAI zelf bovenaan zet, en hetzelfde commando werkt later ook als updatecommando. Gebruik je al npm of Homebrew voor je tooling, dan houd je dat gewoon aan.

Waar de installer zijn bestanden vandaan haalt

Standaard downloaden de installers van releases.openai.com/codex, met GitHub Releases als terugvaloptie. Blokkeert je netwerk het eerste adres, dan forceer je de tweede route met de omgevingsvariabele CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false. Handig om te weten als je achter een bedrijfsproxy zit en de installatie stilvalt zonder duidelijke melding.

Let op de pakketnaam: @openai/codex, niet codex

Het officiële npm-pakket heet @openai/codex, een scoped pakket onder de @openai-organisatie. Het ongescopete codex op npm komt van een andere uitgever en is niet OpenAI's coding-agent. Installeer je dat per ongeluk, dan krijg je geen foutmelding maar simpelweg een ander programma. Controleer bij twijfel de uitgever op de npm-registry. Let er ook op dat npm hier alleen de Rust-binary aflevert: je gebruikt npm puur als distributiekanaal, niet omdat Codex een Node-pakket zou zijn.

Liever handmatig een binary

Er staan losse tarballs klaar voor vier platformen: codex-aarch64-apple-darwin.tar.gz voor Apple Silicon, codex-x86_64-apple-darwin.tar.gz voor Intel-Macs, en codex-x86_64-unknown-linux-musl.tar.gz plus codex-aarch64-unknown-linux-musl.tar.gz voor Linux. Twijfel je over je processor, gebruik dan gewoon de installer: die kiest zelf.

Controleren of het gelukt is

Open een projectmap in je terminal en draai codex. Krijg je de interactieve weergave, dan staat de installatie goed. Met codex --version zie je welk versienummer er nu draait; zolang dat een nummer teruggeeft en je installer recent liep, zit je goed. Behandel een versienummer uit een artikel altijd als momentopname, niet als eis, want Codex kent een hoog releasetempo. Wil je meer zekerheid, dan geeft codex doctor een lokaal diagnoserapport en toont /status binnen een sessie je actieve configuratie en je resterende limieten. De volledige lijst met commando's staat op Slash commands.

Installatiecommando's voor de Codex CLI per methode, stand 1 augustus 2026
RouteCommandoWanneer je die kiest
Installer (macOS en Linux)curl -fsSL https://chatgpt.com/codex/install.sh | shDe standaardroute. Ditzelfde commando werkt ook om bij te werken
Installer (Windows)powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"De Windows-variant, eveneens ook voor updates
npmnpm install -g @openai/codexJe beheert je tooling al met npm
npm met vaste versienpm install -g @openai/codex@0.146.0Je wilt een versie vastzetten voor je team of je CI
Homebrewbrew install --cask codexJe houdt je Mac-tooling in Homebrew bij
WSL2 aanzettenwsl --installWindows, in een PowerShell met beheerdersrechten, voordat je de installer draait
Codex CLI (officieel)
De officiele Codex CLI-documentatie met het installatiecommando via curl en de alternatieven via Homebrew en npm.
De officiele Codex CLI-documentatie met het installatiecommando via curl en de alternatieven via Homebrew en npm.

Windows

Windows: native of via WSL2, en waarom dat nog niet helemaal helder is

Op Windows moet je een keuze maken, en de documentatie spreekt zichzelf op dit punt tegen. Wij laten dat hieronder staan zoals het is, want je installatiekeuze hangt ervan af.

Het open punt: spreekt de repo of de productdocumentatie?

De systeemeisen in de openbare repo noemen als besturingssysteem "Windows 11 via WSL2", wat suggereert dat native Windows niet wordt ondersteund. De productdocumentatie op learn.chatgpt.com beschrijft juist een native PowerShell-installer, een native Windows-sandbox waarbij WSL2 een alternatief is in plaats van een voorwaarde, en een native Windows-app die in maart 2026 uitkwam. Wij beslechten dat niet: mogelijk is het installatiebestand in de repo verouderd. Praktisch advies: begin met de PowerShell-installer, en wijk uit naar WSL2 als je tegen sandbox- of compatibiliteitsproblemen aanloopt.

WSL2 opzetten

Draai vanuit een PowerShell met beheerdersrechten:

wsl --install

Open daarna je WSL-shell en installeer Codex daarbinnen met het gewone Linux-commando:

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

Je installeert Codex dus binnen je Linux-distributie, niet in Windows zelf.

De Windows-versiematrix

OpenAI noemt Windows 11 de aanbevolen basis, en de versie om op te standaardiseren bij een uitrol over een team. Een recente, volledig bijgewerkte Windows 10 staat op "best effort": het kan werken, maar minder betrouwbaar. De ondergrens is Windows 10 versie 1809, omdat Codex leunt op moderne consoleondersteuning waaronder ConPTY. Oudere Windows 10-builds worden afgeraden; die missen vaker de benodigde consolecomponenten en vallen eerder om in bedrijfsomgevingen. Daarnaast gaat de documentatie ervan uit dat winget beschikbaar is. Ontbreekt die, werk dan Windows bij of installeer de Windows Package Manager voordat je begint.

Zet je projecten in je Linux-home, niet op een gemount Windows-pad

Werk je via WSL2, bewaar je repositories dan in je Linux-home (~/code/my-app) en niet op een gemount Windows-pad (/mnt/c/...). OpenAI noemt daar twee redenen voor: snellere I/O, en minder gedoe met symlinks en bestandsrechten. Wil je vanuit Windows toch bij die map, typ dan \\wsl$ in de Verkenner of in een bestandskiezer en navigeer naar de home-map van je distributie.

WSL1 valt af

WSL1 werd ondersteund tot en met Codex 0.114. Vanaf 0.115 draait de Linux-sandbox op bubblewrap en is alleen WSL2 nog ondersteund. Zit je nog op WSL1 en werkt Codex niet meer na een update, dan is dat vrijwel zeker de reden.

Twee sandbox-commando's die alleen op Windows bestaan

Binnen een sessie stel je met /setup-default-sandbox de verhoogde agent-sandbox in en geef je met /sandbox-add-read-dir een extra leesmap vrij wanneer een commando iets buiten de leesroots moet lezen. Beide staan in de officiële CLI-referentie als Windows-only; zie Slash commands voor de rest van de set.

Codex op Windows via WSL (officieel)
De officiele Codex-documentatie over WSL2 op Windows met het advies om repositories in je Linux-thuismap te houden in plaats van in gemounte Windows-paden.
De officiele Codex-documentatie over WSL2 op Windows met het advies om repositories in je Linux-thuismap te houden in plaats van in gemounte Windows-paden.

Desktop-app

De ChatGPT desktop-app: hier woont Codex sinds 9 juli 2026

Zoek je in een appstore naar een Codex-app, dan zoek je naar iets wat niet meer bestaat. Sinds 9 juli 2026 zit Codex in de ChatGPT desktop-app voor macOS en Windows, naast Chat en Work. Je downloadt hem op chatgpt.com/download.

Wat de app extra doet ten opzichte van de CLI

De desktop-app geeft je inline bewerken in diffs, pull-request-review in het zijpaneel, snellere Computer Use op GPT-5.6 en projecten die meerdere repositories omvatten. Sinds 23 juli 2026 kan een lokaal project bovendien meerdere gerelateerde mappen bevatten: je kiest een primaire map voor nieuwe chats, Git-operaties en het automatisch vinden van AGENTS.md, skills en config.toml, en de secundaire mappen blijven beschikbaar om in te zoeken, lezen en bewerken. Op 30 juli 2026 stond de app op versie 26.727.

Een gedeeld configuratiebestand

De desktop-app, de Codex CLI en de IDE-extensie lezen hetzelfde config.toml. Zet je daar bijvoorbeeld model = "gpt-5.6", dan geldt dat op alle drie. Zonder expliciete keuze pakken ze een aanbevolen model. Voor cloud-chats kun je het standaardmodel op dit moment niet wijzigen.

  1. 1

    Ga naar https://chatgpt.com/download/ en haal de versie voor macOS of Windows op. De bijgewerkte app is volgens OpenAI "available globally on every ChatGPT plan, including Free".

  2. 2

    Had je de oude Codex-app al staan, dan hoef je niets opnieuw te installeren: die update gewoon door. De oude app heet sindsdien Classic.

  3. 3

    Log in op het uitgelogde scherm via Continue to sign in, of kies Sign in another way als je een API-key wilt gebruiken.

  4. 4

    Wil je meteen in de Codex-weergave landen, zet die dan als standaardweergave. Je kunt ook het Codex-logo als app-icoon kiezen.

  5. 5

    Werk je al in de terminal, dan open je de app vanuit de CLI met codex app, bijvoorbeeld om een sessie in de grafische diff-weergave af te maken.

De ChatGPT desktop-app (officieel)

Inloggen

Inloggen: met je ChatGPT-account of met een API-key

Codex kent twee inlogmethodes voor OpenAI-modellen: "Sign in with ChatGPT for subscription access" en "Sign in with an API key for usage-based access". De desktop-app, de CLI en de IDE-extensie ondersteunen beide voor lokaal werk. Codex cloud vereist altijd de ChatGPT-login.

Wat je keuze verder bepaalt

Log je in met ChatGPT, dan volgt Codex je workspace-permissies, je RBAC-rollen en de retentie- en residency-instellingen van ChatGPT Enterprise. Log je in met een API-key, dan factureert OpenAI via je Platform-account tegen de standaard API-tarieven in plaats van via je inbegrepen ChatGPT-gebruik, en volgt je verbruik de retentie- en data-sharing-instellingen van je API-organisatie. Meer over die tweede kant staat op Privacy en zakelijk gebruik.

Wat je met een API-key niet krijgt

De API-key-kaart in de pricingdocs is er duidelijk over: je krijgt Codex in de CLI, de SDK en de IDE-extensie, en geen cloud-gebaseerde features. In de feature-matrix staan onder meer Codex cloud, ChatGPT Work op het web, cloud-chats, cloudomgevingen, GitHub-delegatie en -reviews, Slack, Linear, connectors, het delen van plugins, voice en mobile remote control als onbeschikbaar bij een API-key. Ook je modelbeschikbaarheid volgt dan de API-modellen van je key, niet de Codex-catalogus.

Waar je credentials belanden

Je login wordt lokaal gecachet, in een plaintext-bestand op ~/.codex/auth.json of in de credential-store van je besturingssysteem. Welke van de twee bepaal je met cli_auth_credentials_store = "file" | "keyring" | "auto" in config.toml. De CLI en de IDE-extensie delen die cache: log je bij een van beide uit, dan moet je bij de ander opnieuw inloggen. De documentatie waarschuwt expliciet: behandel ~/.codex/auth.json als een wachtwoord.

Inloggen op een machine zonder browser

Voor remote en headless omgevingen is device code-authenticatie (beta) de aangeraden weg. Kies Sign in with Device Code in het interactieve inlogscherm, of draai codex login --device-auth. Het moet wel eerst aanstaan in je ChatGPT-beveiligingsinstellingen of in de workspace-permissies. Werkt dat niet, dan zijn de fallbacks: je ~/.codex/auth.json kopieren, of de localhost-callback doorsturen met ssh -L 1455:localhost:1455 user@remote (poort 1455 is de standaard).

Status, uitloggen en multi-factor

Met codex login status zie je welke authenticatiemethode actief is, met codex logout wis je je credentials. In de desktop-app en de IDE-extensie loopt dat via het profielmenu. Let op de MFA-eis: Codex cloud vereist multi-factor authenticatie. Log je in met e-mail en wachtwoord, dan moet je MFA instellen voor je cloud kunt gebruiken, en dat geldt ook als je account meerdere loginmethodes kent waarvan een e-mail plus wachtwoord is. Log je uitsluitend in via Google, Microsoft of Apple, dan is MFA op het ChatGPT-account niet verplicht.

Voor beheerders: de loginmethode vastleggen

In config.toml kun je de route afdwingen met forced_login_method = "chatgpt" of "api", en gebruikers aan een workspace binden met forced_chatgpt_workspace_id. Komen de actieve credentials daar niet mee overeen, dan logt Codex de gebruiker uit en sluit af. In ChatGPT Enterprise-workspaces kunnen admins daarnaast access tokens toestaan voor vertrouwde, niet-interactieve workflows: printenv CODEX_ACCESS_TOKEN | codex login --with-access-token. Dat is bedoeld voor scripts, schedulers en private CI-runners; voor gewone API-calls blijven Platform-keys de aanbevolen weg.

Inloggen per oppervlak, met ChatGPT-account of met API-key
OppervlakMet je ChatGPT-accountMet een API-key
Codex CLIcodex login, daarna de browserflowprintenv OPENAI_API_KEY | codex login --with-api-key
ChatGPT desktop-appContinue to sign in op het uitgelogde schermSign in another way
IDE-extensieSign in with ChatGPTUse API Key
Codex cloudVerplicht, plus multi-factor authenticatieNiet beschikbaar
Authenticatie (officieel)
De officiele Codex-documentatie over inloggen waarin het verschil staat tussen inloggen met je ChatGPT-account en inloggen met een API-sleutel.
De officiele Codex-documentatie over inloggen waarin het verschil staat tussen inloggen met je ChatGPT-account en inloggen met een API-sleutel.

IDE

Codex in je IDE: een extensie voor de meeste, eigen integraties voor twee

De Codex IDE-extensie ondersteunt Visual Studio Code, Cursor, Windsurf, VS Code Insiders, Xcode en de JetBrains-IDE's. VS Code en de daarop gebaseerde editors gebruiken dezelfde extensie, openai.chatgpt. Xcode en JetBrains hebben hun eigen integratie.

Je login is gedeeld met de terminal

De extensie en de CLI gebruiken dezelfde credential-cache. Handig als je beide draait: een keer inloggen is genoeg. Onhandig als je vergeet dat het zo werkt, want een codex logout in je terminal betekent dat je extensie de volgende keer ook om een login vraagt.

Welke commands werken hier

De extensie draait in het chatpaneel bijna de hele desktop-set aan slash commands, plus eigen commando's via het Command Palette. De complete lijst per omgeving staat op Slash commands.

Wat wel en niet open source is

De CLI, de SDK, de Codex App Server, de skills en de universele cloudomgeving staan publiek op GitHub. De IDE-extensie en Codex cloud niet. Wil je een bug melden of een feature aanvragen, dan gaat dat via de issues in openai/codex.

De Codex IDE-extensie per editor: wat je installeert en hoe je hem opent
IDEWat je installeertZo open je Codex
Visual Studio CodeDe extensie openai.chatgptKlik het Codex-icoon, of gebruik het Command Palette-commando "Codex: Open Codex Sidebar"
CursorDe extensie openai.chatgptZelfde route als in VS Code
WindsurfDe extensie openai.chatgptZelfde route als in VS Code
VS Code InsidersDe extensie openai.chatgptZelfde route als in VS Code
XcodeDe eigen Xcode-integratieOpen de coding assistant, start een nieuwe chat en kies Codex als agent
JetBrains-IDE'sDe eigen JetBrains-integratieOpen AI Chat en selecteer Codex
Codex in je IDE (officieel)
De officiele Codex-documentatie over de IDE-integratie met de lijst van ondersteunde editors en extensies.
De officiele Codex-documentatie over de IDE-integratie met de lijst van ondersteunde editors en extensies.

Eerste run

Je eerste sessie: zes stappen die de rest makkelijker maken

De installatie is klaar in een paar minuten. De vijf minuten daarna bepalen of Codex daadwerkelijk iets nuttigs doet in jouw project. Doorloop deze stappen een keer per repository.

Welk model je kiest bij de start

De GPT-5.6-familie kent drie aanbevolen modellen. Sol is het vlaggenschip voor complex, open werk met veel analyse en afwerking. Terra is de allrounder en het logische startpunt voor werk dat je eerder aan GPT-5.5 gaf. Luna is de snelle en goedkope optie voor duidelijke, herhaalbare taken met veel volume. De docs zijn kort over de twijfelgevallen: "If you are unsure, start with Sol." Meer over de keuze staat op Modellen en prijzen.

Kom je van Claude Code of een andere agent?

Sinds juni 2026 kent Codex migratieflows die tijdens de onboarding een ondersteunde setup van een andere coding-agent importeren, en in de CLI haalt /import je Claude Code-setup, projectbestanden en recente chats binnen. Wil je de twee eerst naast elkaar leggen, dan staat de tegenhanger van deze pagina in onze Claude Code-gids.

  1. 1

    Open een projectmap in je terminal en draai codex. Bij de eerste start kies je "Sign in with ChatGPT" of een andere methode.

  2. 2

    Draai /status. Je ziet je huidige sessieconfiguratie en je resterende limieten, zodat je weet waar je aan begint.

  3. 3

    Draai /init. Codex maakt een AGENTS.md aan met projectinstructies. Houd dat bestand klein en nest het per map: grote instructiebestanden kosten context bij elke opdracht.

  4. 4

    Kies met /permissions wat Codex mag doen zonder eerst te vragen. Dit is het moment om bewust te zijn, niet als de agent al halverwege een refactor zit.

  5. 5

    Kies met /model je model en je reasoning effort. In de desktop-app, in ChatGPT Work op het web en in de IDE-extensie zit die keuze onder de composer; daar is Power de standaard, oftewel gpt-5.6-sol met medium reasoning. Bij het starten van de CLI kan het ook direct: codex --model gpt-5.6.

  6. 6

    Wil je Codex non-interactief gebruiken, gebruik dan codex exec, bijvoorbeeld: codex exec "summarize the repository structure and list the top 5 risky areas". Met --sandbox workspace-write mag hij bewerken, met --json wordt stdout een JSON Lines-stream.

Codex CLI (officieel)

Cloud

Codex cloud: niets installeren, wel iets instellen

Codex cloud draait taken in afgeschermde cloudomgevingen, parallel, en je kunt werk starten vanaf het web, vanuit GitHub, Linear of Slack. Er is niets te installeren, maar wel wat op te zetten. OpenAI beschrijft het in vijf stappen.

Code review in GitHub aanzetten

Codex-reviews in GitHub vragen twee dingen: Codex cloud voor de betreffende repository, en de instelling op chatgpt.com/codex/settings/code-review. Daarna vraag je een review aan met de comment @codex review. Codex reageert met een oogjes-emoji en plaatst vervolgens een gewone GitHub-review, waarin hij alleen P0- en P1-issues markeert. Zet je Automatic reviews aan, dan reviewt hij elke nieuwe pull request zonder dat je iets hoeft te typen. Reviewregels leg je vast in een sectie "## Code Review Rules" in AGENTS.md, en die kun je per map nesten. Laten fixen kan ook: @codex fix the P1 issue. Elke andere @codex-comment start een cloud-chat met de pull request als context.

Een open punt in de documentatie

In alle vijf de limiettabellen op de pricingpagina staat bij de kolom "Cloud chats / 5h" voor elk model "Not available", terwijl de voetnoot onder diezelfde tabellen zegt dat lokale berichten en cloud-chats een venster van vijf uur delen, en de feature-matrix cloud-chats juist als beschikbaar markeert voor Plus, Pro, Business en Enterprise. De modellenpagina voegt daar nog aan toe dat alleen GPT-5.6 Sol Codex cloud ondersteunt. Wij beslechten die tegenspraak niet; ga er bij het inrichten van je workflow van uit dat de cloud-capaciteit onduidelijk gedocumenteerd is en check je eigen usage-dashboard.

  1. 1

    Log in op chatgpt.com/codex met je ChatGPT-account. Denk aan de MFA-eis: zonder multi-factor authenticatie komt je account hier niet doorheen.

  2. 2

    Koppel je GitHub-account of -organisatie.

  3. 3

    Maak een omgeving aan op chatgpt.com/codex/settings/environments.

  4. 4

    Start een taak.

  5. 5

    Bekijk het resultaat, of laat Codex er direct een pull request van openen.

Codex cloud (officieel)

Mobiel

Op je telefoon: geen Codex-app, wel Remote

Er bestaat geen zelfstandige Codex-app voor iOS of Android. Wat er wel is, heet Remote: in de gewone ChatGPT-app bedien je ChatGPT- of Codex-chats op een gekoppelde Mac of Windows-machine.

Hoe het werkt

De host draait de ChatGPT desktop-app op macOS of Windows. Het werk gebeurt daar, dus je projecten, bestanden, credentials, plugins, Computer Use, je browser-setup en je lokale tools blijven allemaal beschikbaar. Je telefoon is het bedieningspaneel, niet de machine die werkt.

De setup begint altijd op de desktop

Koppelen doe je vanuit de desktop-app via een QR-code. Dat kan niet vanuit de Codex CLI en niet vanuit de IDE-extensie. Naast je telefoon kun je een host ook bedienen vanaf een andere Mac of Windows-machine, wanneer "Control other devices" beschikbaar is.

Waar het bij hoort en wat onduidelijk blijft

De feature-matrix noemt mobile remote control beschikbaar op Plus, Pro, Business en Enterprise, en onbeschikbaar bij authenticatie met een API-key. De Plus-kaart noemt expliciet "Codex on the web, in the CLI, in the IDE extension, and on iOS". Een open punt: de docs noemen iOS en Android allebei als besturend apparaat, maar alle release-aantekeningen over Remote-functies (branch kiezen, een worktree maken, een setup-script draaien, inline review-comments) gaan expliciet over iOS. Of Android exact hetzelfde kan, konden wij niet vaststellen.

Remote connections (officieel)
De officiele Codex-documentatie over remote connections met de vereisten om vanaf je telefoon een sessie op je computer te besturen.
De officiele Codex-documentatie over remote connections met de vereisten om vanaf je telefoon een sessie op je computer te besturen.

CI en SDK

Installeren in CI, in scripts en als MCP-server

Wil je Codex niet zelf bedienen maar laten draaien, dan installeer je iets anders. Dit zijn de routes die OpenAI documenteert.

Wat de GitHub Action nodig heeft

De action installeert zelf de Codex CLI, start de Responses API-proxy als je een API-key meegeeft, en draait daarna codex exec onder de permissies die jij opgeeft. Drie voorwaarden: je OpenAI-key staat als GitHub-secret klaar, je gebruikt een Linux- of macOS-runner, en je doet een checkout voordat je de action aanroept. Voor een Windows-runner moet safety-strategy op unsafe staan.

De Python-SDK is nog beta

Na de installatie importeer je met from openai_codex import Codex, Sandbox, en voor asynchroon gebruik is er AsyncCodex. Houd er rekening mee dat OpenAI de Python-SDK zelf als beta labelt. In de maturity-niveaus die OpenAI hanteert betekent beta: klaar voor brede tests, met kleine wijzigingen die je nog kunt verwachten. Alleen bij "stable" belooft OpenAI volledige ondersteuning en een deprecatieproces voordat iets verdwijnt.

MCP werkt op elk plan

Anders dan de meeste cloudfuncties is MCP beschikbaar op alle plannen, ook bij authenticatie met een API-key. Wat je daarmee kunt aansluiten en hoe je dat beheert, staat op Plugins en skills.

Codex installeren buiten je eigen machine: CI, SDK en MCP
DoelWat je installeert of aanroept
GitHub Actionsopenai/codex-action@v1
Node-SDKnpm install @openai/codex-sdk
Python-SDK (beta)pip install openai-codex
Python-prereleasespip install --pre openai-codex
Codex als MCP-server draaiencodex mcp-server
Die server inspecterennpx @modelcontextprotocol/inspector codex mcp-server
Externe MCP-servers toevoegencodex mcp
De Codex GitHub Action (officieel)

Bijwerken

Bijwerken en vastzetten

Codex beweegt hard. In juli 2026 alleen al kwamen de CLI-versies 0.142.0 tot en met 0.146.0 uit, en op 1 augustus 2026 stond de teller op CLI 0.146.0 (29 juli) en desktop-app 26.727 (30 juli). Bijwerken gaat per installatiemethode.

Let bij het bijwerken op je modelnamen

Op 31 augustus 2026 verdwijnen gpt-5.4 en gpt-5.4-mini uit Codex voor iedereen die met een ChatGPT-account inlogt. Vervang gpt-5.4 door gpt-5.6-terra en gpt-5.4-mini door gpt-5.6-luna, en doe dat in je workspace-defaults, je opgeslagen modelinstellingen, je managed configurations, je custom agents en je scheduled tasks. Twee modellen zijn al eerder vervallen: gpt-5.2 en gpt-5.3-codex. Scripts, configuratiebestanden en codex exec --model-aanroepen die daar nog naar wijzen, moet je bijwerken. De OpenAI API en Codex met een eigen API-key vallen buiten deze wijziging.

Een versie vastzetten voor je team

Wil je niet dat iedereen op een andere build zit, pin de versie dan via npm, zoals in de changelog getoond wordt: npm install -g @openai/codex@0.146.0. Dat geeft je een reproduceerbare setup in CI en op teamlaptops, ten koste van nieuwe functies.

Een andere provider onder dezelfde installatie

Je kunt Codex ook op een ander model of een andere provider richten, mits die de Chat Completions- of Responses-API ondersteunt. Twee kanttekeningen: de ondersteuning voor de Chat Completions-API is deprecated en verdwijnt in een toekomstige release, en sinds medio juli 2026 is er een ingebouwde amazon-bedrock-provider voor GPT-5.6 Sol, Terra en Luna via Amazon Bedrock, bruikbaar met een Bedrock API-key of de AWS SDK credential chain.

De Codex CLI bijwerken per installatiemethode
InstallatiemethodeBijwerken met
Installer (macOS en Linux)curl -fsSL https://chatgpt.com/codex/install.sh | sh
Installer (Windows)powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm install -g @openai/codex of npm update -g @openai/codex
npm met vaste versienpm install -g @openai/codex@0.146.0
Homebrewbrew upgrade --cask codex
Vanuit de CLI zelfcodex update
Modellen in Codex (officieel)
De releasespagina van de Codex CLI op GitHub met versie 0.146.0 van 29 juli 2026 als laatste stabiele release.
De releasespagina van de Codex CLI op GitHub met versie 0.146.0 van 29 juli 2026 als laatste stabiele release.

Verwijderen

Codex verwijderen, en wat er dan achterblijft

Hier moeten we eerlijk zijn: de documentatie die wij nalazen geeft wel installatie- en updatecommando's, maar geen officieel verwijdercommando voor de standalone installer. Dit is wat je wel met zekerheid kunt doen.

Via je pakketbeheerder

Installeerde je via Homebrew of npm, dan verwijder je Codex met de gewone commando's van die pakketbeheerders zelf:

brew uninstall --cask codex
npm uninstall -g @openai/codex

Dit zijn de standaardcommando's van Homebrew en npm, geen Codex-specifieke commando's. Ze horen bij de installatiecommando's brew install --cask codex en npm install -g @openai/codex die OpenAI wel documenteert.

Je credentials wissen

Wil je alleen loskoppelen en niet verwijderen, dan is codex logout genoeg: dat wist je credentials. Denk eraan dat de CLI en de IDE-extensie dezelfde cache delen, dus je logt bij beide tegelijk uit. Je login staat in ~/.codex/auth.json of in de credential-store van je besturingssysteem, afhankelijk van je instelling cli_auth_credentials_store.

Wat er in ~/.codex achterblijft

In die map staat naast auth.json ook je config.toml met je modelkeuze, je toetsbindingen, je feature-flags en je profielen. Verwijder je dat, dan begin je bij een volgende installatie weer helemaal opnieuw. Draaien de desktop-app of de IDE-extensie nog, dan blijven zij die configuratie gebruiken, want alle drie de oppervlakken lezen hetzelfde bestand.

De desktop-app

De ChatGPT desktop-app verwijder je zoals elke andere applicatie op macOS of Windows. Ook hiervoor documenteert OpenAI geen eigen route; het is een open punt in de documentatie, niet iets wat wij voor je kunnen invullen.

Codex CLI (officieel)

Problemen

De installatieproblemen die je het vaakst tegenkomt

Bijna alles wat misgaat gaat over vier dingen: je Windows-omgeving, je netwerk, je login, of een verwijzing naar iets wat inmiddels is veranderd. Zoek je situatie op in deze tabel.

De documentatie is verhuisd, en de index is stuk

Twee dingen om te weten als je zelf gaat zoeken. Ten eerste: developers.openai.com/codex geeft een 308 Permanent Redirect naar learn.chatgpt.com/docs, en developers.openai.com/codex/cli naar learn.chatgpt.com/docs/codex/cli. Achter elke docs-URL kun je .md plakken voor verbatim markdown, bijvoorbeeld https://learn.chatgpt.com/docs/pricing.md, wat handig is als je een pagina aan een AI-assistent wilt voeren. Ten tweede: de docs verwijzen naar https://learn.chatgpt.com/llms.txt als volledige index, maar die URL geeft een 307 naar https://learn.chatgpt.com/docs/llms.txt en die pagina levert een 404. Ook developers.openai.com/codex/llms.txt loopt dood. De index die wel werkt is https://developers.openai.com/llms.txt, en de sitemap https://learn.chatgpt.com/chatgpt-sitemap-0.xml met 246 URL's.

Waar deze pagina bewust geen antwoord op geeft

Vier dingen konden wij op 1 augustus 2026 niet met zekerheid vaststellen, en die verzinnen we niet: de systeemeisen van de ChatGPT desktop-app, een officieel verwijdercommando voor de standalone installer, of native Windows nu wel of niet volledig ondersteund is, en of cloud-chats echt op elk plan onbeschikbaar zijn zoals de limiettabellen suggereren. Loop je tegen een van die vier aan, kijk dan in je eigen usage-dashboard op chatgpt.com/codex/settings/usage of stel de vraag in de issues van de openbare repo.

Veelvoorkomende problemen bij het installeren en inloggen van Codex, met de oplossing
Wat je zietWat er aan de hand isWat je doet
Codex werkt niet meer na een update in WSLVanaf Codex 0.115 draait de Linux-sandbox op bubblewrap en valt WSL1 afZet je distributie om naar WSL2. Nieuw opzetten kan met wsl --install vanuit een PowerShell met beheerdersrechten
De installer haalt geen bestanden opJe netwerk blokkeert releases.openai.comForceer GitHub Releases met CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false
Codex cloud laat je niet toeCodex cloud vereist multi-factor authenticatieZet MFA aan op je ChatGPT-account. Bij een account met e-mail plus wachtwoord is dat verplicht, ook als je normaal via Google, Microsoft of Apple inlogt
Inloggen lukt niet op een server zonder browserDe gewone flow opent een browser en luistert op localhost:1455Gebruik codex login --device-auth, of stuur de callback door met ssh -L 1455:localhost:1455 user@remote
Sign in with Device Code staat er niet bijDevice code-authenticatie moet eerst worden aangezetZet het aan in je ChatGPT-beveiligingsinstellingen of in de workspace-permissies
Codex logt je meteen uit en sluit afforced_login_method of forced_chatgpt_workspace_id komt niet overeen met je actieve credentialsLog in met de methode of in de workspace die je beheerder heeft vastgelegd
De IDE-extensie vraagt opnieuw om inloggenDe CLI en de extensie delen dezelfde credential-cacheLog opnieuw in bij een van de twee. Waar die cache staat regel je met cli_auth_credentials_store in config.toml
Cloudfuncties ontbreken na het inloggenJe bent ingelogd met een API-key in plaats van je ChatGPT-accountLog in met ChatGPT. Met een API-key vervallen onder meer Codex cloud, GitHub-reviews, Slack, Linear, voice en mobile remote control
Je script draait op een model dat er niet meer isgpt-5.2 en gpt-5.3-codex zijn al vervallen, gpt-5.4 en gpt-5.4 mini volgen op 31 augustus 2026Vervang gpt-5.4 door gpt-5.6-terra en gpt-5.4-mini door gpt-5.6-luna in je config, je scripts en je scheduled tasks
De GitHub Action faalt op een Windows-runnerDe action gaat uit van een Linux- of macOS-runnerWissel naar een Linux- of macOS-runner, of zet safety-strategy op unsafe
Je hebt de verkeerde binary gedownloadEr zijn aparte tarballs voor Apple Silicon, Intel-Macs en LinuxGebruik de installer, die kiest zelf de juiste variant, of pak het tarball dat bij je processor hoort
De docs-link uit een oude tutorial doet nietsdevelopers.openai.com/codex geeft sinds 2026 een 308 naar learn.chatgpt.com/docsVolg de redirect. Plak .md achter de nieuwe URL en je krijgt de pagina als platte markdown terug
De Codex-repo op GitHub
De 404-pagina op learn.chatgpt.com/docs/llms.txt die bewijst dat de documentatie-index waarnaar OpenAI verwijst niet bestaat.
De 404-pagina op learn.chatgpt.com/docs/llms.txt die bewijst dat de documentatie-index waarnaar OpenAI verwijst niet bestaat.

FAQ

Veelgestelde vragen

Hoe installeer je Codex?

Dat hangt af van waar je wilt werken. Voor de Codex CLI draai je op macOS en Linux het commando curl -fsSL https://chatgpt.com/codex/install.sh | sh, en op Windows powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". Beheer je je tooling met npm of Homebrew, dan kan het ook met npm install -g @openai/codex of brew install --cask codex. De ChatGPT desktop-app haal je op via chatgpt.com/download, de IDE-extensie installeer je in je editor, en voor Codex cloud installeer je niets maar log je in op chatgpt.com/codex en koppel je GitHub.

Wat heb je nodig om Codex te draaien?

Volgens de openbare repo van OpenAI: macOS 12 of nieuwer, Ubuntu 20.04 of nieuwer, Debian 10 of nieuwer, of Windows 11 via WSL2. Verder minimaal 4 GB werkgeheugen, met 8 GB als aanbeveling. Git 2.23 of nieuwer is optioneel maar aan te raden, want de ingebouwde pull-request-helpers leunen erop. En je hebt een account nodig: elk ChatGPT-abonnement volstaat, ook Free en Go, of anders een OpenAI API-key. Voor de desktop-app zijn geen systeemeisen gedocumenteerd.

Is Codex gratis?

Codex zit in alle ChatGPT-abonnementen, ook in Free en Go, maar de gebruikslimieten verschillen sterk per plan. Vanuit Nederland toonde chatgpt.com/pricing op 1 augustus 2026 deze bedragen: Free 0 euro, Go 8 euro, Plus 23 euro en Pro vanaf 103 euro per maand. De Amerikaanse documentatie noemt 0, 8, 20 en vanaf 100 dollar, dus de europrijzen voor Plus en Pro liggen hoger dan de dollarbedragen uit de docs. In de vergelijkingstabel staat Codex-toegang bij Free en Go als Limited, bij Plus als Expanded en bij Pro als maximaal.

Werkt Codex op Windows?

Ja, maar de documentatie is hier niet eenduidig. De openbare repo noemt als systeemeis Windows 11 via WSL2, wat suggereert dat native Windows niet wordt ondersteund. De productdocumentatie beschrijft juist een native PowerShell-installer, een native Windows-sandbox waarbij WSL2 een alternatief is in plaats van een voorwaarde, en een native Windows-app uit maart 2026. Praktisch: begin met de PowerShell-installer en wijk uit naar WSL2 als je tegen sandbox-problemen aanloopt. WSL1 valt sowieso af vanaf Codex 0.115, omdat de Linux-sandbox toen naar bubblewrap ging.

Bestaat er nog een aparte Codex-app?

Nee. Op 9 juli 2026 is de losse Codex-app opgegaan in de ChatGPT desktop-app voor macOS en Windows. Codex heeft daarbinnen een eigen weergave en een eigen geschiedenis naast Chat en Work, en je kunt Codex als standaardweergave instellen en het Codex-logo als app-icoon kiezen. Had je de oude app al staan, dan update die gewoon door; die heet sindsdien Classic. De bijgewerkte app is wereldwijd beschikbaar op elk ChatGPT-plan, inclusief Free.

Hoe log je in bij Codex?

Er zijn twee methodes: inloggen met je ChatGPT-account voor toegang via je abonnement, of inloggen met een API-key voor betalen per gebruik. In de CLI draai je codex login en volg je de browserflow, of gebruik je printenv OPENAI_API_KEY | codex login --with-api-key. In de desktop-app kies je Continue to sign in, of Sign in another way voor de API-key. In de IDE-extensie heten die twee Sign in with ChatGPT en Use API Key. Met codex login status zie je welke methode actief is, met codex logout wis je je credentials.

Kun je Codex met een API-key gebruiken in plaats van een abonnement?

Ja, voor lokaal werk in de CLI, de SDK en de IDE-extensie. Je betaalt dan via je OpenAI Platform-account tegen de standaard API-tarieven in plaats van uit je inbegrepen ChatGPT-gebruik, en je verbruik volgt de retentie- en data-sharing-instellingen van je API-organisatie. Je levert wel functies in: Codex cloud, ChatGPT Work op het web, cloud-chats, cloudomgevingen, GitHub-delegatie en -reviews, Slack, Linear, connectors, het delen van plugins, voice en mobile remote control staan in de feature-matrix als onbeschikbaar bij een API-key. Ook je modelbeschikbaarheid volgt dan de API-modellen van je key.

Hoe installeer je Codex in VS Code?

Je installeert de extensie openai.chatgpt. Diezelfde extensie werkt in Visual Studio Code, Cursor, Windsurf en VS Code Insiders. Openen doe je met het Codex-icoon, of via het Command Palette met het commando Codex: Open Codex Sidebar. Xcode en de JetBrains-IDEs hebben een eigen integratie: in Xcode open je de coding assistant, start je een nieuwe chat en kies je Codex als agent, en in JetBrains open je AI Chat en selecteer je daar Codex. Let op dat de extensie en de CLI dezelfde login delen.

Kun je Codex op je telefoon gebruiken?

Niet als zelfstandige app, want die bestaat niet. Wel via Remote in de gewone ChatGPT-app: daarmee bedien je ChatGPT- of Codex-chats op een gekoppelde Mac of Windows-machine die de ChatGPT desktop-app draait. Het werk gebeurt op die host, dus je projecten, bestanden, credentials, plugins, Computer Use, browser-setup en lokale tools blijven beschikbaar. De koppeling zet je altijd op vanuit de desktop-app met een QR-code, niet vanuit de CLI of de IDE-extensie. Mobile remote control is beschikbaar op Plus, Pro, Business en Enterprise, en niet bij inloggen met een API-key.

Hoe log je in op een server zonder browser?

Met device code-authenticatie, die OpenAI zelf de voorkeursmethode noemt voor remote en headless omgevingen en die nog in beta is. Kies Sign in with Device Code in het interactieve inlogscherm, of draai codex login --device-auth. Het moet wel eerst aanstaan in je ChatGPT-beveiligingsinstellingen of in de workspace-permissies. Werkt dat niet, dan zijn er twee fallbacks: je bestand ~/.codex/auth.json kopieren naar de server, of de localhost-callback doorsturen met ssh -L 1455:localhost:1455 user@remote.

Hoe werk je Codex bij?

Met hetzelfde commando waarmee je installeerde. Op macOS en Linux is dat curl -fsSL https://chatgpt.com/codex/install.sh | sh, op Windows de PowerShell-variant, via npm npm install -g @openai/codex en via Homebrew brew upgrade --cask codex. Vanuit de CLI zelf kan het met codex update. Kijk bij het bijwerken ook even naar je modelnamen: gpt-5.4 en gpt-5.4-mini verdwijnen op 31 augustus 2026 uit Codex voor wie met een ChatGPT-account inlogt, en gpt-5.2 en gpt-5.3-codex zijn al eerder vervallen.

Hoe verwijder je Codex?

Installeerde je via Homebrew of npm, dan gebruik je de gewone verwijdercommando's van die pakketbeheerders: brew uninstall --cask codex of npm uninstall -g @openai/codex. Voor de standalone installer documenteert OpenAI in de bronnen die wij nalazen geen verwijderroute; dat is een open punt. Wil je alleen loskoppelen, dan is codex logout genoeg, al log je daarmee ook uit in de IDE-extensie omdat die dezelfde credential-cache gebruikt. Je instellingen staan in ~/.codex, samen met auth.json en config.toml.

Waarom werkt de link developers.openai.com/codex niet meer?

Die is verhuisd. developers.openai.com/codex geeft een 308 Permanent Redirect naar learn.chatgpt.com/docs, en developers.openai.com/codex/cli naar learn.chatgpt.com/docs/codex/cli. Achter elke docs-URL kun je .md plakken om de pagina als verbatim markdown te krijgen, bijvoorbeeld learn.chatgpt.com/docs/pricing.md. De llms.txt-index waarnaar de docs verwijzen werkt niet: learn.chatgpt.com/llms.txt leidt via een 307 naar een 404. De index die wel werkt is developers.openai.com/llms.txt.

Bronnen

Bronnen die we bijhouden

Elke claim op deze pagina is te herleiden; de officiële artikelen zijn op de bijwerkdatum nagelezen.

Codex uitrollen over je hele team?

In de masterclass zetten we het op jullie machines op en werken we meteen met echte taken. Vanaf €1.397.

Bekijk de masterclass