Uw omgeving en AGENTS.md instellen
Op deze pagina
Bijgewerkt op 3 november 2026 op basis van de Codex-documentatie (Codex CLI, Authenticatie, Codex IDE-extensie, Aangepaste instructies met AGENTS.md): het pakket
@openai/codex-clien de opdrachtcodex auth loginbestaan niet (gebruiknpm install -g @openai/codexencodex login); de extensie-identifier isopenai.chatgpt; het adres codex.openai.com en de abonnementen “Team, Enterprise, of API” zijn vervangen door de huidige toegangsmethoden; en de leesvolgorde van AGENTS.md is verduidelijkt (projectroot → huidige map). Bronnen: Codex CLI · Authentication · AGENTS.md · Pricing.
Uw project voorbereiden voor Codex
Twee dingen moeten geregeld zijn voordat u aan uw eerste taak begint: uw Codex-toegang (uw account en GitHub-koppeling) en uw project zelf, gedefinieerd via het AGENTS.md-bestand dat de agent zal sturen. Het eerste deel duurt ongeveer 15 minuten en is een eenmalige installatie. Het tweede bepaalt de kwaliteit van alles wat u uit Codex haalt; het maakt het verschil tussen teams die tevreden zijn met Codex en teams die het teleurstellend vinden.
Stap 1: Uw Codex-toegang
U kunt Codex gebruiken met een ChatGPT-account of een API-sleutel. De abonnementen Free en Go bieden, afhankelijk van de huidige implementatie, toegang tot GPT-6 Luna in de desktop-app. Vanaf het Plus-abonnement is Codex beschikbaar op het web, in de CLI, in de editor-extensie en op iOS, met cloudintegraties zoals geautomatiseerde codebeoordeling. Een API-sleutel werkt voor automatisering in gedeelde omgevingen zoals CI, via de CLI, SDK of extensie, hoewel sommige functies mogelijk niet beschikbaar zijn. Details en gebruikslimieten vindt u op de Codex-prijs pagina.
Om in de cloud aan uw repositories te werken, koppelt u GitHub wanneer u uw eerste Codex Cloud-omgeving maakt (Les 2). Houd bij het verlenen van machtigingen de toegang minimaal: beperk deze tot alleen de repositories die u daadwerkelijk nodig hebt.
Stap 2: De editor-extensie installeren
Installeer in VS Code en afgeleiden daarvan (Cursor, Windsurf) de Codex-extensie vanuit de marketplace; de identifier is openai.chatgpt:
code --install-extension openai.chatgpt
Open vervolgens Codex via het pictogram, of via het opdrachtenpalet met Codex: Open Codex Sidebar, en log in. Xcode en JetBrains IDE’s hebben hun eigen integraties: open in JetBrains AI Chat en selecteer Codex.
Stap 3: De CLI installeren
# Installatie (macOS en Linux), of npm install -g @openai/codex
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Installatie verifiëren
codex --version
# Inloggen (browser), of verbindingsstatus controleren
codex login
codex login status
codex login opent de inlogprocedure in uw browser. Voor een API-sleutel geeft u deze door via standaardinput (printenv OPENAI_API_KEY | codex login --with-api-key). Codex cacheert referenties in een platte tekstbestand, ~/.codex/auth.json, of in de systeem-sleutelhanger, afhankelijk van de instelling cli_auth_credentials_store (file, keyring, auto of ephemeral). Als het bestand wordt gebruikt, behandel het dan als een wachtwoord: het bevat toegangstokens, dus commit het nooit. De CLI en de extensie delen deze cache.
Het AGENTS.md-bestand: uw projectgids
AGENTS.md is centraal voor effectief gebruik van Codex. Het is een eenvoudig Markdown-bestand dat u in de root van uw repository plaatst en dat instructies, conventies en opdrachten specifiek voor uw project verzamelt. Wanneer Codex de repo cloneert, leest het dit bestand als eerste: zie het als automatische onboarding voor de agent, precies wat u mondeling aan een nieuw teamlid zou uitleggen.
Het effect is direct. Zonder AGENTS.md is de kans groot dat Codex, als u om een unit-test vraagt voor een project dat Vitest gebruikt, Jest levert, omdat dat de meest voorkomende keuze in het ecosysteem is. Een enkele regel over conventie volstaat om Vitest meteen goed te krijgen, waardoor u honderd keer dezelfde correctie bespaart. Hier is de structuur van een basisbestand voor een SaaS-project voor factuurbeheer.
# AGENTS.md
## Projectcontext
SaaS-toepassing voor factuurbeheer.
Stack: Next.js 15, TypeScript, Prisma, PostgreSQL.
## Codeconventies
- Gebruik React functionele componenten (geen classes)
- Noem bestanden in kebab-case
- TypeScript-types in aparte .types.ts-bestanden
- Tests met Vitest, .test.ts-bestanden naast de code
## Nuttige opdrachten
- `npm run dev` — ontwikkelingsserver
- `npm run test` — tests uitvoeren
- `npm run lint` — linting controleren
- `npm run build` — productiebuild
## Projectstructuur
src/
app/ → Next.js-pagina's (App Router)
components/ → Herbruikbare React-componenten
lib/ → Bedrijfslogica en hulpprogramma's
prisma/ → DB-schema en migraties
## Strikte regels
- NOOIT Prisma-schema wijzigen zonder migratie
- NOOIT .env-bestanden committen
- Gebruik altijd Server Actions voor mutaties
Hoe Codex AGENTS.md-bestanden vindt
Eén enkel root-bestand wordt al snel te generiek. Codex laat u instructies stapelen in een precieze volgorde die u moet kennen:
- Globaal niveau: In uw Codex-map (
~/.codex, tenzijCODEX_HOMEdit overschrijft), leest CodexAGENTS.override.mdals dit bestaat, andersAGENTS.md. - Projectniveau: Beginnend bij de projectroot (meestal de Git-root), daalt Codex af naar de huidige map en leest in elke doorkruiste map
AGENTS.override.mdof, bij gebreke daarvan,AGENTS.md. - Samenvoegen: Bestanden worden van de root tot aan de huidige map aaneengeschakeld; die het dichtst bij de huidige map komen laatst en overschrijven dus meer algemene instructies.
my-project/
AGENTS.md → Projectinstructies
src/
api/
AGENTS.md → "API-routes gebruiken Zod voor validatie"
Praktisch gevolg: src/api/AGENTS.md wordt alleen gelezen als Codex werkt vanuit src/api of een van de submappen daarvan, niet wanneer het vanaf de root wordt gestart. Lege bestanden worden genegeerd en de samenvoeging stopt standaard bij 32 KiB (project_doc_max_bytes). Als uw repo al een andere naam gebruikt, zoals TEAM_GUIDE.md, voegt u deze toe aan project_doc_fallback_filenames in ~/.codex/config.toml.
Om te verifiëren wat Codex daadwerkelijk heeft geladen, vraagt u het gewoon: codex --ask-for-approval never "Summarize the current instructions.". Codex herbouwt de instructieketen bij elke start: bij twijfel start u het opnieuw in de juiste map.
Best practices voor AGENTS.md
Het leidende principe is explicietheid. “Gebruik Vitest, geen Jest” is beter dan “Gebruik ons testframework”, wat kennis veronderstelt die de agent niet heeft. Vermeld altijd opdrachten: zonder deze weet Codex niet hoe het uw tests, linter of build moet uitvoeren, en levert het code die het niet heeft kunnen verifiëren. Documenteer de structuur als een directory-boom; dit voorkomt dat het blindelings verkent en bestanden op de verkeerde plaats aanmaakt.
Vermeld tot slot de verboden. Regels geformuleerd als “NOOIT” zijn het meest kosteneffectief in het bestand, omdat ze dure fouten blokkeren die moeilijk te herstellen zijn: het committen van een .env-bestand, het wijzigen van een schema zonder migratie. De moeilijkste discipline is het bestand up-to-date houden. Een AGENTS.md dat het project van vorig jaar beschrijft, stuurt Codex actief naar verlaten conventies—veel erger dan helemaal geen bestand hebben, aangezien de fout dan systematisch wordt.
Belangrijkste punten
- De initiële installatie vereist een OpenAI-account en een GitHub-koppeling
- De IDE-extensie en CLI zijn binnen enkele minuten geïnstalleerd
- AGENTS.md is het belangrijkste bestand voor effectief Codex-gebruik
- Het bevat conventies, opdrachten en regels specifiek voor uw project
- AGENTS.md-bestanden in submappen maken contextuele instructies mogelijk