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. Nagelezen in de officiële documentatie op learn.chatgpt.com op 1 augustus 2026; installatiecommando's, systeemeisen, Windows, mobiel, modellen, inloggen en cloud opnieuw gecontroleerd op 30 oktober 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. Mobiel en de koppelingen met GitHub, Slack en Linear zitten daar bovenop en vragen geen eigen installatie. Officiële downloadlinks per apparaat staan op de Codex-app downloaden. 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 30 oktober 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/download, de Microsoft Store of een Linux-pakket (preview)Chat, 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
ChatGPT-app op iOS en AndroidDe ChatGPT-app plus een gekoppelde desktop-hostEen sessie op je Mac of pc bedienen, of een cloudtaak starten, 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; de eisen voor de desktop-app staan in de Codex-documentatie per platform. Loop deze lijst langs voordat je begint, dan loop je niet halverwege vast.

Codex zit in elk abonnement, ook het gratis

Er is geen apart Codex-abonnement: Codex zit in alle ChatGPT-plannen, ook Free en Go. Op Free en Go krijg je alleen GPT-6 Luna in de desktop-app en geen Codex cloud; wat dat in de praktijk betekent, staat op is Codex gratis. Prijzen en limieten per plan staan op Kosten.

CLI en desktop-app vragen iets anders

De 4 GB werkgeheugen en macOS 12 gelden volgens de repo voor de CLI. De desktop-app vraagt een nieuwer systeem: minimaal macOS 14 of Windows 10 versie 19041. Geheugen en schijfruimte voor de app noemt de documentatie niet. Downloadroutes en eisen per apparaat staan op de Codex-app downloaden.

Systeemeisen voor de Codex CLI (openbare repo) en de desktop-app (Codex-documentatie), stand 30 oktober 2026
OnderdeelWat het moet zijn
Besturingssysteem (CLI)macOS 12 of nieuwer, Ubuntu 20.04 of nieuwer of Debian 10 of nieuwer; op Windows native of via WSL2
Desktop-appmacOS 14 (Apple Silicon of Intel), Windows 10 versie 19041 of nieuwer, of als Linux-preview Ubuntu 24.04 of 26.04, Debian 13 en Fedora 43 of 44
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 30 oktober 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.166.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

Op Windows draaien de desktop-app, de CLI en de IDE-extensie native, met een eigen Windows-sandbox. WSL2 is een alternatief als je wilt dat de agent in Linux werkt, geen voorwaarde.

Native Windows is officieel ondersteund

De Windows-documentatie op learn.chatgpt.com is duidelijk: je gebruikt Codex op Windows met de native desktop-app, de CLI of de IDE-extensie, en de agent draait in PowerShell binnen een Windows-sandbox in plaats van in WSL of een virtuele machine. Er zijn drie sandbox-varianten: mxc (aanbevolen op geschikte Windows 11-apparaten, zonder beheerdersinstallatie), elevated (de voorkeursterugval, vraagt eenmalig goedkeuring van een beheerder) en unelevated (zwakkere netwerkisolatie). De systeemeisen in de openbare repo noemen nog "Windows 11 via WSL2"; die pagina loopt achter op de productdocumentatie. De desktop-app installeer je via de Microsoft Store, zie de Codex-app downloaden.

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 en de Windows-sandbox (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; sinds 11 augustus 2026 is er ook een Linux-preview. Je downloadt hem op chatgpt.com/download. Alle officiële downloadroutes en hoe je nep-apps herkent, staan op de Codex-app downloaden.

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, Computer Use 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.

Een gedeeld configuratiebestand

De desktop-app, de Codex CLI en de IDE-extensie lezen hetzelfde config.toml. Zet je daar bijvoorbeeld model = "gpt-6.1-sol", dan geldt dat op alle drie. Zonder expliciete keuze pakken ze een aanbevolen model. Voor een cloudtaak controleer je het model in de composer van die taak. Meer op Codex-modellen.

  1. 1

    Ga naar https://chatgpt.com/download/ en haal de versie voor macOS of Windows op; op Windows kan het ook via de Microsoft Store. 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: met je ChatGPT-account gebruik je de ruimte van je abonnement, met een OpenAI API-key betaal je per token en vervallen de cloudfuncties. In de CLI typ je codex login (of geef je een key door aan codex login --with-api-key), in de desktop-app en de IDE-extensie kies je de knop op het inlogscherm, en op een server zonder browser gebruik je codex login --device-auth. Codex cloud werkt alleen met een ChatGPT-login, en de CLI en de IDE-extensie delen dezelfde opgeslagen login. Beheerders kunnen de route vastleggen met forced_login_method en in Business- en Enterprise-werkruimtes access tokens toestaan voor scripts en CI. Wat je per interface klikt of typt en wat elke foutmelding betekent, staat op Codex inloggen.

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

Codex beveelt vier modellen uit de GPT-6-familie aan: GPT-6.1 Sol als startpunt voor de meeste taken, GPT-6 Astra voor het zwaarste werk, GPT-6.1 Terra voor schrijven en beeld, en GPT-6 Luna voor afgebakend volumewerk; op Free en Go is Luna het enige model. Welk model je per taak kiest en wat het kost, staat op Codex-modellen.

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 begin je met de standaard Power-stand van je account. Bij het starten van de CLI kan het ook direct: codex --model gpt-6.1-sol.

  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

Voor Codex cloud installeer je niets. Je opent ChatGPT, kiest Work in > Cloud (of Settings > Codex Cloud > Environments), koppelt GitHub, laat Codex het project voorbereiden en klikt Publish; daarna start je taken. Het zit in Plus, Pro, Business, Enterprise en Edu, werkt alleen met een ChatGPT-login en vraagt MFA als je met e-mail en wachtwoord inlogt. Cloudtaken delen het tegoed van je plan en kunnen er meer van vragen dan lokale berichten. Environments, secrets, kosten en AVG staan op Codex cloud.

Code review in GitHub aanzetten

Codex-reviews in GitHub vragen twee dingen: Codex cloud voor de betreffende repository, en de instelling op chatgpt.com/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 review 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; die draait nog op Codex Cloud (Legacy).

Codex cloud (officieel)

Mobiel

Op je telefoon: geen aparte app, wel de ChatGPT-app

Er bestaat geen zelfstandige Codex-app voor iOS of Android. In de gewone ChatGPT-app open je het onderdeel Codex (in oudere versies heet het Remote) en bedien je daarmee een gekoppelde Mac of Windows-pc, of start je een taak in de cloud. Stap voor stap staat het op de Codex-app downloaden.

Hoe het werkt

De host draait de ChatGPT desktop-app op macOS of Windows; een Linux-machine kan geen host zijn. Het werk gebeurt daar, dus je projecten, bestanden, credentials, plugins en lokale tools blijven beschikbaar. Kies je in de app een cloudomgeving, dan hoeft je computer niet aan te staan.

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.

Voor welke plannen

De feature-matrix noemt mobile remote control beschikbaar op Plus, Pro, Business en Enterprise, en onbeschikbaar bij authenticatie met een API-key. Je kunt een computer bedienen vanaf iOS en vanaf Android. In een zakelijke werkruimte moet je beheerder de functie mogelijk eerst aanzetten.

Remote connections (officieel)
De officiële Codex-documentatie over remote connections met de vereisten om vanaf je telefoon een sessie op je computer te besturen (opname augustus 2026).
De officiële Codex-documentatie over remote connections met de vereisten om vanaf je telefoon een sessie op je computer te besturen (opname augustus 2026).

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. Op 1 augustus 2026 stond de CLI op 0.146.0; op 30 oktober 2026 staat 0.166.0 op npm. Bijwerken gaat per installatiemethode.

Let bij het bijwerken op je modelnamen

Bij ChatGPT-login zijn gpt-5.4 en gpt-5.4-mini op 31 augustus 2026 verdwenen, gpt-5.3-codex-spark op 14 september en gpt-5.5 op 14 oktober; gpt-5.2 en gpt-5.3-codex waren al deprecated. Vervang ze in je config.toml, custom agents, geplande taken en codex exec --model-aanroepen, bijvoorbeeld door gpt-6.1-sol of op Free en Go gpt-6-luna. Met een eigen API-key blijft gpt-5.5 beschikbaar. De vervanger per oud model staat op Codex-modellen.

Een versie vastzetten voor je team

Wil je niet dat iedereen op een andere build zit, pin de versie dan via npm: npm install -g @openai/codex@0.166.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 een compatibele Responses-API biedt. Huidige Codex-releases ondersteunen geen Chat Completions-only endpoints meer (wire_api = "chat"). Er zijn ingebouwde providers voor Amazon Bedrock en voor lokale modellen via Ollama en LM Studio.

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.166.0
Homebrewbrew upgrade --cask codex
Vanuit de CLI zelfcodex update
Modellen in Codex (officieel)
Historische opname van de releasespagina van de Codex CLI op GitHub met versie 0.146.0 van 29 juli 2026; op 30 oktober 2026 staat 0.166.0 op npm.
Historische opname van de releasespagina van de Codex CLI op GitHub met versie 0.146.0 van 29 juli 2026; op 30 oktober 2026 staat 0.166.0 op npm.

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; elke inlogfoutmelding met de oplossing staat op Codex inloggen. Werkt Codex na een geslaagde installatie ineens niet meer, kijk dan eerst op Codex status of er een storing is.

De documentatie is verhuisd

Handig om te weten als je zelf gaat zoeken: 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. De index op https://learn.chatgpt.com/llms.txt, die in augustus nog op een 404 uitkwam, werkt op 30 oktober 2026 weer en leidt naar learn.chatgpt.com/docs/llms.txt.

Waar deze pagina bewust geen antwoord op geeft

Eén ding konden wij ook op 30 oktober 2026 niet met zekerheid vaststellen, en dat verzinnen we niet: een officieel verwijdercommando voor de standalone installer. Loop je daartegenaan, stel de vraag dan 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, of Codex logt je meteen uitEen server zonder browser, device code staat uit, of je beheerder heeft een loginmethode vastgelegdGebruik codex login --device-auth op een server, en zie de pagina Codex inloggen voor elke foutmelding
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.4, gpt-5.4-mini, gpt-5.3-codex-spark en gpt-5.5 zijn bij ChatGPT-login verdwenenVervang het model-id in je config, je scripts en je scheduled tasks, bijvoorbeeld door gpt-6.1-sol
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 komt ergens anders uitdevelopers.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

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?

Voor de CLI noemt de openbare repo macOS 12 of nieuwer, Ubuntu 20.04 of nieuwer of Debian 10 of nieuwer, minimaal 4 GB werkgeheugen (8 GB aanbevolen) en optioneel Git 2.23 of nieuwer; op Windows draait de CLI native of via WSL2. De desktop-app vraagt macOS 14 of Windows 10 versie 19041 of nieuwer, en is op Linux als preview beschikbaar. Daarnaast heb je een ChatGPT-account nodig, ook Free of Go volstaat, of een OpenAI API-key.

Is Codex gratis?

Installeren is gratis en Codex zit in alle ChatGPT-abonnementen, ook Free en Go, maar daar krijg je alleen GPT-6 Luna in de desktop-app en geen Codex cloud. Wat gratis precies inhoudt, lees je op onze pagina "Is Codex gratis?".

Werkt Codex op Windows?

Ja. De desktop-app, de CLI en de IDE-extensie draaien native op Windows, met een eigen Windows-sandbox in PowerShell; WSL2 is een alternatief als je de agent in Linux wilt laten werken. De desktop-app installeer je via de Microsoft Store of winget, de CLI met de PowerShell-installer. Windows 11 is de aanbevolen basis. WSL1 valt 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, en sinds 11 augustus 2026 is er een Linux-preview. Downloadlinks en hoe je nep-apps herkent, staan op onze pagina over de Codex-app.

Hoe log je in bij Codex?

Met je ChatGPT-account (abonnement) of met een API-key (betalen per gebruik): in de CLI met codex login, in de desktop-app en de IDE-extensie met de knop op het inlogscherm. De stappen per interface en de foutmeldingen staan op de pagina Codex inloggen.

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

Ja, voor lokaal werk in de CLI, de SDK, de IDE-extensie en de desktop-app; je betaalt dan API-tarieven via je Platform-account en levert cloudfuncties in zoals Codex cloud, GitHub-reviews en Slack. Het verschil staat uitgewerkt op de pagina Codex inloggen.

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. In de gewone ChatGPT-app op iOS of Android open je het onderdeel Codex (in oudere versies Remote) en bedien je een gekoppelde Mac of Windows-pc of start je een cloudtaak; dat kan op Plus, Pro, Business en Enterprise, niet met een API-key.

Hoe log je in op een server zonder browser?

Met codex login --device-auth, nadat device code-authenticatie in je ChatGPT-beveiligingsinstellingen of werkruimte is aangezet; als fallback kopieer je ~/.codex/auth.json of stuur je poort 1455 door met ssh -L. Zie de pagina Codex inloggen.

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 naar je modelnamen: gpt-5.4, gpt-5.4-mini, gpt-5.3-codex-spark en gpt-5.5 zijn bij ChatGPT-login uit Codex verdwenen; vervang ze bijvoorbeeld door gpt-6.1-sol.

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 index learn.chatgpt.com/llms.txt werkt op 30 oktober 2026 weer.

Bronnen

Bronnen die we bijhouden

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

Officiële documentatie

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.795.

Bekijk de masterclass