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.
| Oppervlak | Wat je installeert | Waarvoor je het pakt |
|---|---|---|
| Codex CLI | Installer, npm of Homebrew | Werken in je terminal, in scripts en in CI |
| IDE-extensie | De extensie openai.chatgpt, of de eigen integratie van je IDE | Codex naast je code in VS Code, Cursor, Windsurf, Xcode of JetBrains |
| ChatGPT desktop-app | De 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 web | Niets, je logt in op chatgpt.com | Codex bedienen vanaf een machine waar je niets mag installeren |
| Codex cloud | Geen installatie, wel een omgeving en een GitHub-koppeling | Taken parallel laten draaien in afgeschermde cloudomgevingen |
| ChatGPT-app op iOS en Android | De ChatGPT-app plus een gekoppelde desktop-host | Een sessie op je Mac of pc bedienen, of een cloudtaak starten, vanaf je telefoon |
| GitHub, Slack en Linear | Een koppeling vanuit Codex cloud | Werk starten en reviews aanvragen zonder Codex zelf te openen |
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.
| Onderdeel | Wat 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-app | macOS 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 |
| Werkgeheugen | Minimaal 4 GB, 8 GB aanbevolen |
| Git | Versie 2.23 of nieuwer. Optioneel, maar aanbevolen voor de ingebouwde pull-request-helpers |
| WSL-versie | WSL2. WSL1 werd ondersteund tot en met Codex 0.114 en valt daarna af |
| Account | Elk ChatGPT-abonnement, ook Free en Go. Of een OpenAI API-key voor betalen per token |
| Extra voor Codex cloud | Inloggen met je ChatGPT-account plus multi-factor authenticatie |
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.
| Route | Commando | Wanneer je die kiest |
|---|---|---|
| Installer (macOS en Linux) | curl -fsSL https://chatgpt.com/codex/install.sh | sh | De 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 |
| npm | npm install -g @openai/codex | Je beheert je tooling al met npm |
| npm met vaste versie | npm install -g @openai/codex@0.166.0 | Je wilt een versie vastzetten voor je team of je CI |
| Homebrew | brew install --cask codex | Je houdt je Mac-tooling in Homebrew bij |
| WSL2 aanzetten | wsl --install | Windows, in een PowerShell met beheerdersrechten, voordat je de installer draait |

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.

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
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
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
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
Wil je meteen in de Codex-weergave landen, zet die dan als standaardweergave. Je kunt ook het Codex-logo als app-icoon kiezen.
- 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.
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.

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.
| IDE | Wat je installeert | Zo open je Codex |
|---|---|---|
| Visual Studio Code | De extensie openai.chatgpt | Klik het Codex-icoon, of gebruik het Command Palette-commando "Codex: Open Codex Sidebar" |
| Cursor | De extensie openai.chatgpt | Zelfde route als in VS Code |
| Windsurf | De extensie openai.chatgpt | Zelfde route als in VS Code |
| VS Code Insiders | De extensie openai.chatgpt | Zelfde route als in VS Code |
| Xcode | De eigen Xcode-integratie | Open de coding assistant, start een nieuwe chat en kies Codex als agent |
| JetBrains-IDE's | De eigen JetBrains-integratie | Open AI Chat en selecteer Codex |

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
Open een projectmap in je terminal en draai codex. Bij de eerste start kies je "Sign in with ChatGPT" of een andere methode.
- 2
Draai /status. Je ziet je huidige sessieconfiguratie en je resterende limieten, zodat je weet waar je aan begint.
- 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
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
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
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.
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).
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.

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.
| Doel | Wat je installeert of aanroept |
|---|---|
| GitHub Actions | openai/codex-action@v1 |
| Node-SDK | npm install @openai/codex-sdk |
| Python-SDK (beta) | pip install openai-codex |
| Python-prereleases | pip install --pre openai-codex |
| Codex als MCP-server draaien | codex mcp-server |
| Die server inspecteren | npx @modelcontextprotocol/inspector codex mcp-server |
| Externe MCP-servers toevoegen | codex mcp |
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.
| Installatiemethode | Bijwerken 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" |
| npm | npm install -g @openai/codex of npm update -g @openai/codex |
| npm met vaste versie | npm install -g @openai/codex@0.166.0 |
| Homebrew | brew upgrade --cask codex |
| Vanuit de CLI zelf | codex update |

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.
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.
| Wat je ziet | Wat er aan de hand is | Wat je doet |
|---|---|---|
| Codex werkt niet meer na een update in WSL | Vanaf Codex 0.115 draait de Linux-sandbox op bubblewrap en valt WSL1 af | Zet je distributie om naar WSL2. Nieuw opzetten kan met wsl --install vanuit een PowerShell met beheerdersrechten |
| De installer haalt geen bestanden op | Je netwerk blokkeert releases.openai.com | Forceer GitHub Releases met CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false |
| Codex cloud laat je niet toe | Codex cloud vereist multi-factor authenticatie | Zet 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 uit | Een server zonder browser, device code staat uit, of je beheerder heeft een loginmethode vastgelegd | Gebruik codex login --device-auth op een server, en zie de pagina Codex inloggen voor elke foutmelding |
| Cloudfuncties ontbreken na het inloggen | Je bent ingelogd met een API-key in plaats van je ChatGPT-account | Log 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 is | gpt-5.4, gpt-5.4-mini, gpt-5.3-codex-spark en gpt-5.5 zijn bij ChatGPT-login verdwenen | Vervang 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-runner | De action gaat uit van een Linux- of macOS-runner | Wissel naar een Linux- of macOS-runner, of zet safety-strategy op unsafe |
| Je hebt de verkeerde binary gedownload | Er zijn aparte tarballs voor Apple Silicon, Intel-Macs en Linux | Gebruik 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 uit | developers.openai.com/codex geeft sinds 2026 een 308 naar learn.chatgpt.com/docs | Volg de redirect. Plak .md achter de nieuwe URL en je krijgt de pagina als platte markdown terug |
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 CLIDe installatiecommando's per methode en de eerste sessie.
- Codex in je IDEWelke editors worden ondersteund en hoe je Codex daar opent.
- AuthenticatieInloggen, uitloggen, device code, credentials en beheerdersinstellingen.
- De ChatGPT desktop-appDownloaden en wat er sinds de samenvoeging in zit.
- Codex cloudDe vijf stappen naar een werkende cloudomgeving.
- Codex op Windows via WSLWSL2 opzetten en waarom WSL1 afvalt.
- Remote connectionsCodex bedienen vanaf iOS, Android of een tweede machine.
- De Codex GitHub ActionCodex installeren en draaien in CI.
- Systeemeisen in de openbare repoHardware- en OS-eisen voor de CLI; noemt Windows nog alleen via WSL2.
- De Windows-sandbox en de versiematrixNative Windows, de drie sandbox-varianten, de versiematrix en de winget-aanname.
- Het npm-pakket @openai/codexDe registry-pagina waarop je de uitgever en de laatste versie controleert.
- Prijzen en limietenWelke functies je krijgt per plan en per inlogmethode.
Verdieping op Project Impact
- Terug naar de Codex-gidsHet overzicht van alle onderdelen.
- Wat Codex kostAbonnementen, credits en de gedeelde limieten met ChatGPT Work.
- De Codex-app downloadenOfficiële downloadlinks en eisen voor Mac, Windows, Linux en mobiel.
- Codex-modellenWelk model je kiest en welke model-id's verdwenen zijn.
- Codex statusStoring of eigen probleem? Zo check je het.
- Slash commandsElk commando in de CLI, de desktop-app en VS Code.
- Modellen en prijzenAlle ChatGPT-modellen en abonnementen op een rij.
- Apps en interfacesWeb, desktop, mobiel en de rest van het ChatGPT-landschap.
- Privacy en zakelijk gebruikWat er met je code en je bedrijfsdata gebeurt.
- Claude Code, de tegenhangerDezelfde gids voor de coding-agent van Anthropic.
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.