Codex CLI installeren en je eerste projecttaak kiezen

Codex CLI installeer je als terminalprogramma. Daarna open je de map van een project, start je codex en meld je je aan. Mijn advies: laat de eerste opdracht alleen uitzoeken hoe het project werkt. Zo controleer je de aansluiting voordat je bestanden laat veranderen.

De commando's hieronder zijn gecontroleerd in de officiële documentatie op 27 oktober 2026. Het zijn instructies voor je eigen computer. Voor dit artikel is geen installatie of projecttest uitgevoerd.

De officiële CLI-pagina toont voor macOS en Linux deze zelfstandige installer:

Het commando haalt het installatiescript bij OpenAI op en voert het uit. Volg bij een beheerde werklaptop eerst het softwarebeleid van je organisatie. De installatie start nog geen projecttaak. Open daarna de bedoelde projectmap en start codex.

Gebruik bij een latere update de bijbehorende installatieroute. Een installatiefout is geen reden om een beveiligingsregel uit te schakelen. Controleer eerst de foutmelding en de officiële instructies.

Windows-gebruikers kiezen de Windows-tab op dezelfde officiële pagina. Werk je in WSL2, dan installeer je binnen die Linux-omgeving. Houd die omgeving apart van een installatie in PowerShell.

Open na de installatie zo nodig een nieuwe terminal. Vraag de ingebouwde hulp op:

Daarmee controleer je of de terminal het programma vindt en welke opties jouw versie aanbiedt. Krijg je een melding dat het commando onbekend is, zoek dan eerst uit of de installatie is afgerond en of de juiste terminal opnieuw is geopend. Het programma nogmaals via een tweede pakketbeheerder installeren maakt de oorzaak moeilijker te volgen.

Een terminal is een venster waarin je commando's uitvoert. Je hoeft niet elk commando uit je hoofd te kennen, maar je moet wel weten in welke map je staat. Onze uitleg over de terminal helpt bij dat onderscheid.

Volgens de authenticatiedocumentatie zijn aanmelden met ChatGPT en aanmelden met een API-sleutel aparte routes voor lokaal gebruik. Kies bewust welke account en facturering bij je taak horen. Een API-sleutel is geen manier om ongemerkt hetzelfde abonnement te gebruiken.

Start codex vanuit je oefenproject en volg de aanmeldstappen. Controleer ook de gekozen werkruimte als je meerdere zakelijke en persoonlijke accounts hebt. Kopieer geen inlogbestanden van een collega en plak geen geheime sleutel in je opdracht. Vraag bij zakelijke toegang de beheerder welke route is toegestaan.

Gebruik een project waarvan de huidige staat bewaard is in versiebeheer. Laat bestaand werk van anderen met rust en volg de branch- of worktreeafspraken van het project. Noteer zelf welke bestanden al gewijzigd waren. Anders kun je achteraf moeilijk bepalen welke verandering door jouw taak is ontstaan.

Neem als zelfbedacht voorbeeld een boodschappenlijstje met een invoerveld en een knop. Gebruik verzonnen producten, geen bestanden met klantinformatie. Controleer dat je het project volgens zijn eigen README kunt starten. Codex installeren levert de programmeertaal, database en afhankelijkheden van dat project niet automatisch mee.

Je hoeft voor de eerste verkenning nog geen extra koppelingen of plugins toe te voegen. Eerst begrijpen hoe de bestaande app is opgebouwd is een bruikbaar resultaat op zichzelf.

Open de bedoelde projectmap in je terminal, start Codex en geef bijvoorbeeld deze opdracht:

Dit is een voorbeeldprompt, geen weergave van een uitgevoerde sessie. Beoordeel of de genoemde bestanden werkelijk bestaan en bij het scherm horen. Vraag door als het antwoord alleen algemene uitleg bevat. Met een concreet pad en een beschreven invoersituatie kun je de volgende stap onderbouwen.

Meer hulp bij het formuleren van zo'n vraag vind je in de Nederlandse gids over prompt engineering.

Wil je vervolgens lege producten blokkeren, beschrijf dan het gewenste gedrag en de grens van de wijziging. Bijvoorbeeld: een lege invoer toont een melding; een geldige productnaam blijft werken; het uiterlijk en de opslagstructuur blijven behouden. Laat de agent daarna de wijzigingen en uitgevoerde controles tonen.

Gebruik voor de verkennende fase een passende leesinstelling. De veiligheidsdocumentatie beschrijft /permissions om rechten te bekijken en te wijzigen. Verruim de toegang alleen als de afgesproken vervolgstap dat nodig heeft. Een geblokkeerde netwerkactie moet je eerst begrijpen.

Je installatie is bruikbaar zodra het programma start, de bedoelde account gebruikt en het juiste project kan onderzoeken. Je eerste ontwikkeltaak is pas afgerond als je het gewijzigde gedrag hebt gecontroleerd. Wil je dat proces oefenen met begeleiding, bekijk de Vibe Coding Training.