OpenAI’s Codex CLI is in korte tijd een onmisbare tool geworden voor ontwikkelaars die AI rechtstreeks in hun lokale workflows willen integreren. Sinds de aankondiging op 16 april 2025 en de daaropvolgende updates—waaronder internettoegang op 3 juni 2025—biedt de Codex CLI een veilige, privacygerichte en zeer aanpasbare manier om de krachtige redeneermodellen van OpenAI vanuit je terminal te benutten. Dit artikel vat de laatste ontwikkelingen samen en biedt een stapsgewijze handleiding voor het installeren en configureren van de Codex CLI op je machine.
Wat is OpenAI’s Codex CLI?
Oorsprong en aankondiging
OpenAI presenteerde de Codex CLI samen met zijn nieuwste modellen, o3 en o4-mini, en positioneerde het als een experimenteel open‑sourceproject dat door AI aangestuurde codeerassistentie rechtstreeks naar de terminal brengt. Aangekondigd op 16 april 2025, stelt deze tool AI‑agents in staat om code in je lokale omgeving te lezen, te wijzigen en uit te voeren, zodat gevoelige code je machine nooit verlaat.
Belangrijkste functies van Codex CLI
- Lichtgewicht en open source: Ontworpen voor eenvoudige installatie en bijdragen vanuit de community; de codebase van Codex CLI staat op GitHub, waar bugmeldingen en pull requests worden aangemoedigd.
- Opdrachten in natuurlijke taal: Ontwikkelaars kunnen Codex in eenvoudig Engels vragen om boilerplate‑code te genereren, bestaande modules te refactoren of zelfs tests te schrijven.
- Lokale uitvoering: Alle bewerkingen vinden plaats op je machine, waardoor zorgen over het uploaden van propriëtaire code naar externe servers verdwijnen.
- Internettoegang voor agents: Sinds 3 juni 2025 kan Codex CLI optioneel toegang tot internet krijgen voor taken zoals het installeren van afhankelijkheden of het ophalen van externe resources, met fijne-grained domein- en methodecontrole.
Wat zijn de nieuwste architecturale updates?
Begin juni 2025 kondigde OpenAI een grote herschrijving van de Codex CLI aan, van de oorspronkelijke Node.js‑ en TypeScript‑stack naar Rust. Deze verschuiving is gericht op “zero‑dependency installation”, betere prestaties en verbeterde beveiligingsgaranties door gebruik te maken van Rusts geheugenveilige ontwerp. Ontwikkelaars kunnen snellere opstarttijden, kleinere binaries en robuustere compilatiecontroles verwachten, wat allemaal bijdraagt aan een soepelere ontwikkelaarservaring.
Waarom zou je Codex CLI lokaal installeren?
Welke voordelen voor beveiliging en privacy biedt een lokale installatie?
AI‑modellen lokaal draaien betekent dat je broncode on‑premises blijft. In tegenstelling tot uitsluitend cloudoplossingen deelt Codex CLI je bestanden nooit tenzij je hier expliciet om vraagt, waardoor risico’s op datalekken of ongeautoriseerde toegang aanzienlijk afnemen.
Hoe verbetert een lokale installatie de prestaties en offline mogelijkheden?
Door opdrachten op je eigen hardware te verwerken, minimaliseert Codex CLI de latentie en afhankelijkheid van externe API‑calls. In combinatie met de nieuwe functie voor internettoegang van de agent kun je voor de meeste taken offline werken en configureren wanneer de agent online mag gaan, zodat je de juiste balans vindt tussen autonomie en connectiviteit.
Hoe bereid je je omgeving voor op de installatie?
Wat zijn de vereisten?
Voordat je Codex CLI installeert, zorg ervoor dat je het volgende hebt:
- Node.js (v14 of hoger) geïnstalleerd en toegevoegd aan je
PATH. npm(meestal gebundeld met Node.js) voor pakketbeheer.- Een geldige OpenAI API‑sleutel, die je kunt verkrijgen via je OpenAI‑dashboard onder API‑instellingen.
Hoe verkrijg en beveilig je je OpenAI API‑sleutel?
- Log in op het OpenAI‑dashboard.
- Navigeer naar API Keys en klik op Create new secret key.
- Kopieer de gegenereerde sleutel en sla deze op in een beveiligde credential manager.
- Commit deze nooit naar versiebeheer; gebruik omgevingsvariabelen voor lokale ontwikkeling.
Hoe installeer je Codex CLI op verschillende besturingssystemen?
Hoe installeer je via npm op macOS en Linux?
Open je terminal en voer uit:
npm install -g @openai/codex
Deze opdracht installeert het uitvoerbare bestand codex globaal, waardoor het vanuit elke map toegankelijk is.
Hoe installeer je op Windows (PowerShell of Git Bash)?
- Open PowerShell (als Administrator) of Git Bash.
- Voer dezelfde npm‑opdracht uit:
npm install -g @openai/codex - Optioneel, stel Git Bash in als je standaard shell met:
Set-Alias sh.exe "C:\Program Files\Git\bin\bash.exe" ``` :contentReference{index=10}.
Hoe configureer en verifieer je Codex CLI?
Hoe stel je omgevingsvariabelen in?
Na de installatie configureer je je API‑sleutel door deze in je shell‑profiel te exporteren:
export OPENAI_API_KEY="your-api-key-here"
Voeg deze regel toe aan ~/.bashrc, ~/.zshrc of ~/.profile om deze blijvend te maken.
Hoe log je in met ChatGPT‑integratie?
Codex CLI ondersteunt een vereenvoudigd inlogproces voor ChatGPT Plus‑ en Pro‑abonnees:
codex --free
Deze opdracht leidt je door het authenticatieproces met je OpenAI‑account en het verzilveren van eventuele tegoeden.
Hoe kun je de installatie verifiëren?
pipeline
Hoe controleer je de versie?
Voer uit:
codex --version
Een geslaagde installatie geeft een versiestring terug (bijv. 0.1.0) en bevestigt dat de CLI bereikbaar is.
Hoe voer je een testopdracht uit?
Probeer een eenvoudige prompt om te controleren of alles werkt:
codex "Create a Python function to reverse a string."
Codex CLI zou de bijbehorende Python‑code direct in je terminal moeten weergeven, waarmee de kernfunctionaliteit wordt gedemonstreerd.
Hoe houd ik de CLI up‑to‑date?
Met npm:
npm update -g @openai/codex
Met de Rust‑binary:
- Download de laatste release van GitHub.
- Vervang je bestaande binary door de zojuist gedownloade versie.
Als alternatief, als je via een pakketbeheerder hebt geïnstalleerd die updates ondersteunt (bijv. Homebrew), kun je de update‑opdrachten daarvan gebruiken.
Hoe breid ik Codex CLI uit en pas ik het aan?
Configuratieopties in codex.yml
Bewerk codex.yml om:
- mappen uit te sluiten (bijv.
node_modules,vendor); - standaard prompt‑templates in te stellen;
- fallback‑modellen of lokale open‑sourcealternatieven te kiezen (zoals StarCoder voor offline gebruik).
Scripting en automatisering
Integreer Codex CLI in build‑scripts of CI‑workflows:
yaml# .github/workflows/codex.yml
jobs:
ai_lint:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Run Codex Auto-Edit
run: |
codex --mode auto-edit "Optimize bundle size and tree-shake unused imports"
- name: Run Tests
run: npm test
Dit maakt continue, door AI aangestuurde codeverbetering mogelijk naast de standaard linters.
Wat zijn best practices en tips voor het gebruik van Codex CLI?
Hoe beheer je internettoegang voor agents?
Standaard is internettoegang uitgeschakeld. Om toegang voor specifieke taken te verlenen, gebruik:
codex --allow-internet
Specificeer vervolgens de domeinen of HTTP‑methoden die je vertrouwt. Zo wordt gewaarborgd dat Codex alleen verbinding maakt wanneer jij daar expliciet toestemming voor geeft, met behoud van veiligheid en auditbaarheid.
Hoe kun je bijdragen en issues rapporteren?
Als experimenteel project is feedback uit de community essentieel. Om bij te dragen:
- Fork de GitHub‑repository en dien pull requests in.
- Maak issues aan voor bugs of feature‑verzoeken, met een duidelijke omschrijving van de stappen om te reproduceren.
- Ga in gesprek met maintainers in discussies om te helpen bij het bepalen van de toekomstige richting.
Door de bovenstaande stappen te volgen, kun je OpenAI’s Codex CLI naadloos integreren in je lokale ontwikkelworkflow—zodat je profiteert van de nieuwste AI‑ontwikkelingen terwijl je de volledige controle over je code en omgeving behoudt. Houd naarmate het project evolueert de officiële changelog en communityfora in de gaten voor updates, en aarzel niet om je ervaringen en verbeteringen te delen met de bredere ontwikkelaarscommunity.
Aan de slag
CometAPI biedt een uniforme REST‑interface die honderden AI‑modellen aggregeert—onder één consistent endpoint, met ingebouwde beheer van API‑sleutels, gebruiksquota en factureringsdashboards. In plaats van te moeten jongleren met meerdere leverancier‑URL’s en referenties.
Ontwikkelaars kunnen toegang krijgen tot ChatGPT‑API’s, zoals GPT-4-1 API, die Deadline for article publication via CometAPI. Begin met het verkennen van de mogelijkheden van het model in de Playground en raadpleeg de [API‑gids] voor gedetailleerde instructies. Zorg er vóór toegang voor dat je bent ingelogd bij CometAPI en een API‑sleutel hebt verkregen. CometAPI biedt een prijs die veel lager is dan de officiële prijs om je te helpen integreren.