Codex op Windows: kies bewust tussen native en WSL2

Codex gebruiken op Windows betekent eerst kiezen waar je project draait. Werk je met Windows-gereedschap, dan ligt native gebruik voor de hand. Vereist je project Linux-gereedschap of werk je al volledig in WSL2, dan kan die omgeving beter passen.

Ik zou die keuze laten aansluiten op het project dat je wilt onderhouden. Een tweede omgeving toevoegen terwijl je de eerste nog niet begrijpt, levert vooral extra plekken op waar een fout kan zitten. Deze gids volgt de officiële documentatie, gecontroleerd op 27 oktober 2026.

De huidige documentatie beschrijft Codex in de ChatGPT-desktopapp voor Windows. Daarnaast kun je de terminalinterface Codex CLI gebruiken. De app en de CLI bepalen hoe je met de agent werkt. Native Windows of WSL2 bepaalt waar de opdrachten worden uitgevoerd.

Een grafisch venster betekent dus niet dat alles op afstand draait. En een Linux-terminal in een Windows-venster betekent niet automatisch dat de agent zelf in Linux werkt. Noteer bij problemen altijd beide: de interface die je gebruikt en de uitvoeromgeving van de agent.

Een zelfbedacht voorbeeld: je opent een webproject vanaf je Windows-schijf, maar kopieert een Linux-commando uit een handleiding. De foutmelding kan dan over een onbekend commando gaan, terwijl Codex zelf correct is geïnstalleerd.

Als je project al werkt met Windows-paden, PowerShell en de daar geïnstalleerde ontwikkelgereedschappen, begin dan in diezelfde omgeving. Controleer of je de app zonder agent kunt starten en testen. Zo voorkom je dat een ontbrekende projectafhankelijkheid wordt aangezien voor een Codex-probleem.

De officiële Windows-sandboxdocumentatie beveelt Windows 11 aan. Recente, volledig bijgewerkte Windows 10-systemen krijgen best-effortondersteuning. Welke sandbox beschikbaar is, hangt ook af van de Windows-build en organisatie-instellingen. Een laptop met Windows 11 heeft daarmee niet automatisch elke sandboxmogelijkheid.

Er staat geen aankoopadvies voor een bepaalde processor of hoeveelheid geheugen in deze gids. De lokale belasting hangt mede af van je project: een klein formulier en een complete containeromgeving vragen andere middelen. Kijk naar de eisen van je eigen bouw- en testgereedschap voordat je hardware kiest.

WSL2 geeft je een Linux-omgeving binnen Windows. De Codex-documentatie noemt deze route voor Linux-gereedschap en bestaande WSL-werkwijzen. WSL1 is in de huidige Codex-versies niet meer ondersteund. Controleer daarom welke versie je werkelijk gebruikt voordat je een WSL-handleiding volgt.

Werkt de agent binnen WSL2, houd dan de projectbestanden bij die Linux-werkomgeving. Zo blijven paden, afhankelijkheden en commando's bij elkaar. Een project deels op de Windows-schijf en deels in Linux onderhouden maakt vragen als 'welke versie test ik?' onnodig lastig.

Vraag bij een zakelijke laptop eerst of WSL2 binnen het beheerbeleid past. Een native beperking is geen uitnodiging om buiten dat beleid een tweede route in te richten. De systeembeheerder kan vaak uitleggen welke omgeving wordt ondersteund.

In de Windows-desktopapp kun je de geïntegreerde terminal apart kiezen van de agentomgeving. De appdocumentatie beschrijft dat een wijziging van de agent naar WSL een herstart van de app vereist. Alleen een ander terminalvenster openen verandert de agentomgeving niet.

Maak dit bij je eerste project zichtbaar. Schrijf op: de projectmap, de terminal die je opent, waar de ontwikkelgereedschappen staan en waar de agent zijn opdrachten uitvoert. Dat lijstje voorkomt dat je dezelfde afhankelijkheid in twee omgevingen installeert zonder te weten welke gebruikt wordt.

Zie je een Windows-pad waar je Linux verwacht, stop dan even met veranderen. Controleer eerst hoe het project geopend is. Voor de basisbegrippen kun je onze uitleg over de terminal erbij houden.

Gebruik bijvoorbeeld een zelfbedacht project met een contactformulier en verzonnen adressen. Geef deze eerste opdracht:

Beoordeel het antwoord aan de hand van de README en de echte mappen. Vraag de agent om onzekerheden te benoemen. Als een commando alleen op Linux beschikbaar blijkt, kun je dan bewust besluiten of het project aangepast moet worden of binnen WSL2 hoort.

Pas daarna kies je een kleine wijziging, bijvoorbeeld een duidelijkere foutmelding. Leg vooraf vast hoe je geldige én ongeldige invoer controleert. De algemene werkwijze staat ook in de gids over AI coding.

Een geweigerde maptoegang of sandboxfout los je op door de concrete oorzaak te onderzoeken. Noteer de foutmelding, Windows-versie en gekozen uitvoeromgeving. Deel geen geheimen of complete configuratiemappen wanneer je hulp vraagt. Op een beheerde laptop hoort een beleidsblokkade bij de beheerder.

Schakel beveiliging niet uit om te zien of de fout verdwijnt. Je wilt uiteindelijk een omgeving die je kunt blijven gebruiken en uitleggen. De beste start is daarom één werkend project, één bekende omgeving en één afgebakende opdracht. Wil je die ontwikkelaanpak oefenen, bekijk de Vibe Coding Training.