Alle Codex-commands, subcommands, flags en sneltoetsen, met voorbeelden

De basis

Vier tekens besturen Codex: /, @, $ en !

Alles wat je in Codex kunt aansturen zonder een zin te typen, hangt aan vier tekens. Ze werken alle vier op dezelfde plek: het eerste teken dat je in de composer typt bepaalt welk menu opengaat. Wie deze vier kent, hoeft de rest van deze pagina alleen nog als naslagwerk te gebruiken.

Het slash-menu bevat meer dan alleen ingebouwde commands

Naast de vaste commands uit de broncode verschijnen er drie soorten dynamische regels in hetzelfde menu. Ten eerste je skills: elke ingeschakelde skill komt in de lijst te staan en is ook aan te roepen met een dollarteken. Ten tweede je oude custom prompts uit ~/.codex/prompts, die als /prompts:naam in de lijst blijven staan zolang ze bestaan. Ten derde de service-tiers van je model: die komen niet uit de commandolijst maar uit de modelcatalogus, en verschijnen direct onder /model. /fast is daar het bekendste voorbeeld van. Beide eigen routes staan uitgewerkt in de sectie Je eigen commando's.

De volgorde in de popup is geen toeval

Boven de commandolijst in slash_command.rs staat letterlijk de instructie om de lijst niet alfabetisch te sorteren, omdat de volgorde van de opsomming de volgorde in de popup is en de meestgebruikte commands vooraan horen. Bovenaan staan dus /model, /ide en /permissions, onderaan de zeldzame en de debug-commands. Handig om te weten als je een command zoekt en denkt dat het niet bestaat: scrollen helpt, of typ gewoon de eerste letters achter de slash.

Hoeveel commands zijn het er precies?

De enum in de broncode telt 55 commands. Wat jij ziet is altijd minder, om drie redenen. Twee commands zitten achter een debug-build (/rollout en /test-approval). Drie commands zijn platformgebonden: /sandbox-add-read-dir alleen op Windows, /app alleen op macOS en Windows, /copy overal behalve Android. En zeven commands zitten achter een feature-flag of een voorwaarde, uitgelegd in de sectie Waarom mist een command. Praktisch komt dat neer op 52 op macOS, 53 op Windows en 51 op Linux, voordat de feature-flags eraf gaan. Elk getal dat je elders leest, telt bijna zeker de aliassen of de debug-commands anders mee.

Omgevingen

Waar Codex-commands werken: terminal, IDE, desktop en cloud

Codex draait op vier plekken, en de commandolijst verschilt per plek. OpenAI zegt daar zelf alleen over dat de beschikbare commands varieren op basis van je omgeving en je toegang; een officiele tabel per omgeving bestaat niet. Wat wel vaststaat, is welke set waar hoort.

Op chatgpt.com werken deze commands niet

De webversie heeft een eigen composer-menu met instellingen-snelkoppelingen (model kiezen, dicteren, tijdelijke chat). De officiele documentatie is er duidelijk over dat de Codex-commands niet gelden voor ChatGPT op het web. Zoek je /plan of /review op chatgpt.com, dan zoek je in de verkeerde omgeving. Het complete overzicht van web, desktop en VS Code staat op Slash commands in ChatGPT; deze pagina gaat over de terminal.

Nog geen Codex geinstalleerd?

De CLI installeer je in een paar minuten en werkt met hetzelfde ChatGPT-account waar je al mee inlogt. De stappen per besturingssysteem, inclusief de IDE-extensie en de desktop-app, staan op Codex installeren. De rest van deze pagina gaat ervan uit dat je een werkende sessie hebt.

Sessies

Sessies: starten, splitsen, hervatten en opruimen

Codex bewaart je chats per map. Deze elf commands beheren die lijst. Nieuw sinds eind juli 2026: je geeft een sessie meteen een naam mee. De changelog noemt bij CLI 0.145.0 (21 juli 2026) het benoemen van sessies met /new of /clear, het vastpinnen van belangrijke threads en het wisselen tussen zijgesprekken zonder ze te sluiten; release 0.146.0 (29 juli 2026) bevestigt het benoemen nog eens expliciet.

/new, /clear of /fork: wat kies je?

Kies /new als je onderwerp echt verandert en de oude context alleen maar tokens kost. Kies /clear als je vooral van je scherm af wilt en met een schone lei verder wilt in dezelfde terminal. Kies /fork als je de opgebouwde context juist wilt houden maar twee kanten op wilt: de fork neemt de hele voorgeschiedenis mee, waarna je beide takken los verder werkt. Voor een korte tussenvraag pak je /side of /btw, dat is een tijdelijke aftakking die je hoofdlijn niet raakt. Let op: in zo'n zijgesprek werken nog maar zeven commands, zie Waarom mist een command.

Namen geven loont bij lange klussen

Sessies zonder naam zijn na een dag niet meer uit elkaar te houden. Geef ze bij het starten een naam mee (/new betaalmodule-tests), of hernoem achteraf met /rename. Buiten de chat om beheer je hetzelfde lijstje met de subcommands codex resume, codex archive, codex unarchive en codex delete; die staan in de sectie Subcommands.

Context

Context en geheugen: wat je doet als het gesprek vol raakt

Elke Codex-sessie heeft een eindig contextvenster. Loopt dat vol, dan wordt de agent trager en vergeetachtiger. Deze zes commands beheren wat er in dat venster zit en wat Codex over sessies heen onthoudt.

Compacten is samenvatten, geen backup

Bij /compact vat Codex het gesprek samen en gooit het de rest weg. Details die je later nog nodig hebt (een exacte foutmelding, een besluit over de aanpak) kunnen dus verdwijnen. Zet zulke dingen daarom in je projectbestand of in de opdracht zelf voordat je compact. Is het onderwerp echt afgerond, dan is /new schoner dan /compact: dat begint zonder samenvattingsruis.

Context toevoegen doe je gerichter dan je denkt

Een hele map meesturen kost veel tokens en levert zelden beter werk. Wijs met @ het bestand aan waar het om draait, of stuur met /ide precies de regels mee die je in je editor hebt geselecteerd. Werk je met een repo die Codex vaker ziet, dan is een AGENTS.md-bestand (te genereren met /init) de goedkoopste manier om projectafspraken permanent mee te geven.

Sturen

Model, plan, doel en toon: waar je aan draait

Deze vijf commands bepalen hoe Codex denkt en antwoordt. Ze werken per chat, dus je kunt binnen dezelfde sessie opschalen voor een lastige analyse en daarna weer terugschakelen voor het opruimwerk.

Eerst plannen, dan het doel zetten

De officiele documentatie adviseert om /plan te gebruiken om het doel te vormen en daarna pas /goal te zetten. Dat is niet ceremonieel: een doel dat je in een halve zin formuleert, wordt vaak anders uitgelegd dan je bedoelt. Laat Codex eerst het plan opschrijven, corrigeer dat plan, en zet daarna het doel. Bij langere klussen is dit het verschil tussen een agent die de goede kant op werkt en een agent die drie uur de verkeerde kant op werkt.

Fast kost tegoed, denkkracht kost tijd

Er zijn twee knoppen die tegen elkaar in werken. /fast maakt de verwerking sneller maar verbruikt meer van je limiet. De tooltip in de broncode zegt het zelf: gebruik /fast voor de snelste inference, met verhoogd verbruik van je plan. Meer denkkracht via /model levert betere redeneringen maar kost wachttijd. Voor de meeste dagelijkse taken staat de standaardstand prima; zet bewust bij, niet standaard. Wat dat betekent voor je maandlimiet staat op Kosten van Codex.

Waarom /fast anders werkt dan de rest

Alle andere commands op deze pagina staan als vaste regel in de commandolijst van de broncode. /fast niet. Codex bouwt dat command op uit de service-tiers die je model aanbiedt en zet ze direct onder /model in de popup. Gevolg: het command verdwijnt als je naar een model wisselt dat geen fast-tier heeft, en het accepteert geen argumenten achter de naam. Zie je /fast dus niet staan, dan is er niets stuk aan je installatie.

Code

Uitvoeren en controleren: review, diff en achtergrondprocessen

Codex schrijft niet alleen code, het draait ook processen. Deze vijf commands laten je zien wat er is veranderd, wat er nog draait en wat er tegengehouden is.

/diff en /review doen niet hetzelfde

/diff is een weergave: je ziet welke regels er veranderd zijn, inclusief nieuwe bestanden die nog niet in git staan. /review is een beoordeling: Codex leest de wijzigingen na en meldt wat er mis is of mist. In de praktijk gebruik je ze achter elkaar. Eerst /diff om te zien of de agent binnen de lijntjes is gebleven, daarna /review om de inhoud te laten controleren. Wil je hetzelfde in een script of een pipeline, dan is codex review het non-interactieve equivalent.

Wat /approve wel en niet doet

De broncode is hier letterlijk over: /approve keurt een herkansing goed na een recente weigering van de auto-review. Het is nadrukkelijk een enkelvoudige goedkeuring, geen schakelaar die de review uitzet. Gebruik het pas als je zelf hebt gekeken waarom de actie tegengehouden werd. Wie het reflexmatig indrukt, heeft de review net zo goed uit kunnen zetten. Wil je juist alle goedkeuringen via die automatische review laten lopen, dan is de vlag --approve-for-me daarvoor bedoeld.

Permissies

Permissies en sandbox: wat Codex mag zonder te vragen

Dit is het gedeelte waar je het langst bij stil moet staan. Codex draait commando's op jouw machine, en hoeveel het zonder tussenkomst mag, stel je hier in. Er zijn drie commands in de chat en twee vlaggen op de commandoregel die hetzelfde regelen. Twee van die drie commands zie je alleen op Windows, dus op macOS en Linux blijft /permissions over.

De drie sandboxstanden

Op de commandoregel zet je de sandbox met --sandbox (kort: -s). De drie waarden staan als enum in de broncode: read-only (Codex mag lezen, niets wijzigen), workspace-write (schrijven binnen je werkmap) en danger-full-access (geen sandboxbeperking). Voor verkennen en analyseren is read-only genoeg. Voor echt werk is workspace-write de normale stand. De derde stand hoort thuis in een wegwerpomgeving, niet op de laptop waar ook je klantbestanden staan.

De drie goedkeuringsniveaus

Daarnaast bepaalt --ask-for-approval (kort: -a) wanneer Codex je iets vraagt. Ook hier drie waarden uit de broncode, met de toelichting die er letterlijk bij staat: untrusted draait alleen vertrouwde commando's zoals ls, cat en sed zonder te vragen en escaleert bij de rest; on-request laat het model beslissen wanneer het vraagt; never vraagt nooit en geeft mislukte uitvoeringen meteen terug aan het model. De combinatie doet ertoe: never samen met read-only is een prima leesmodus voor een codebase die je nog niet kent, terwijl never samen met danger-full-access betekent dat je niets meer te zeggen hebt over wat er gebeurt.

Een tussenstand die weinig mensen kennen

Naast die twee vlaggen zit er een derde in de broncode: --approve-for-me (alias --not-so-yolo). Die zet je goedkeuringsverzoeken door de automatische review heen en draait daarbij in de workspace-write-sandbox. Praktisch stelt de vlag drie dingen tegelijk in: reviewer op auto_review, goedkeuring op on-request en sandbox op workspace-write. Het is de tussenstand tussen zelf elke vraag beantwoorden en alles uitzetten. Hij botst bewust met --sandbox en met --dangerously-bypass-approvals-and-sandbox, dus combineren kan niet.

Waar dit verder over gaat

Sandboxinstellingen zijn ook een privacy- en compliancekwestie: welke mappen mag de agent lezen, wat gaat er naar OpenAI en wat blijft lokaal. Die kant staat uitgewerkt op Privacy bij Codex. Werk je met klantcode onder een geheimhoudingsafspraak, lees die pagina dan voordat je iets op danger-full-access zet.

Uitbreiden

Uitbreiden: skills, apps, plugins, MCP, hooks en subagents

Codex uit de doos kent je bedrijf niet. Deze acht commands koppelen er kennis, tools en automatismen aan vast. Ze zijn ook de opstap naar je eigen commando's: skills verschijnen namelijk gewoon in hetzelfde slash-menu. Twee ervan (/apps en /plugins) zitten achter een feature-flag en staan dus niet standaard in ieders lijst.

Skills, apps en plugins zijn drie verschillende dingen

Een skill is instructie: een mapje met een SKILL.md waarin staat hoe iets bij jullie hoort te gebeuren. Een app (connector) is een verbinding met een externe dienst, die je met $app-slug in je prompt zet. Een plugin is de verpakking waarmee je skills, hooks en configuratie buiten je eigen repo deelt met anderen. Wat je precies waarvoor gebruikt, staat uitgewerkt op Functies van Codex en, voor de ChatGPT-kant, op Plugins en skills.

AGENTS.md is je goedkoopste stuk context

Met /init zet Codex een AGENTS.md-basisbestand in je map. Wat erin komt bepaal je zelf: buildcommando's, teststrategie, codeconventies, mappen waar de agent van af moet blijven. Het scheelt je iedere sessie dezelfde uitleg opnieuw, en het staat in versiebeheer, dus je hele team profiteert ervan. Doe dit een keer goed en je gebruikt daarna merkbaar minder /compact.

Terminal

De terminal naar je hand zetten: toetsen, thema en statusregel

Zes commands die niets met de agent te maken hebben en alles met de manier waarop jij in de terminal werkt. Ze lijken cosmetisch, maar wie de hele dag in de CLI zit, verdient ze binnen een week terug.

De statusregel is de goedkoopste foutpreventie

De meeste ongelukken met agents beginnen met een verkeerde aanname: je dacht in read-only te zitten, of op het lichte model, of op de verkeerde branch. Zet die velden met /statusline permanent in beeld en dat soort vergissingen verdwijnt vanzelf. Wie liever per sessie checkt, gebruikt /status.

Diagnose

Overstappen, kopieren en uitzoeken waarom iets niet werkt

Deze acht commands vallen buiten de dagelijkse routine, maar precies daarom is het handig dat je weet dat ze bestaan. Ze gaan over overstappen vanuit een andere tool, output eruit halen en uitzoeken waarom je configuratie zich anders gedraagt dan je verwacht.

Vier commands die je beter met rust laat

De broncode heeft nog vier commands die niet voor jou bedoeld zijn. /debug-m-drop en /debug-m-update staan onder het kopje debugging-commands, maar zijn niet achter een debug-build gezet: ze staan gewoon in jouw popup, met als omschrijving letterlijk "DO NOT USE". Ze horen bij onderhoud aan het geheugen van Codex. /rollout (print het pad van het rollout-bestand) en /test-approval (test een goedkeuringsverzoek) zitten wel achter een debug-build en zie je in een normale installatie dus nooit.

Waarom de lijst niet op alle machines even lang is

Van de 55 commands in de broncode zijn er drie platformgebonden. /sandbox-add-read-dir staat alleen op Windows. /app staat alleen op macOS en Windows. /copy staat overal behalve op Android. Samen met de twee debug-only commands kom je op 52 zichtbare commands op macOS, 53 op Windows en 51 op Linux, voordat de feature-flags uit de volgende sectie er nog eens vanaf gaan.

Overstappen vanuit Claude Code

Het bestaan van /import zegt iets over de markt: OpenAI bouwt een importroute voor mensen die van Claude Code komen. De commandosets lijken op elkaar maar zijn niet inwisselbaar, en de verschillen zitten precies in de namen die je het vaakst typt. Wil je ze naast elkaar zien, dan staat de tegenhanger van deze pagina op Claude Code-commands.

Beperkingen

Waarom een command bij jou niet in de lijst staat

De meestgestelde vraag over Codex-commands is niet wat ze doen, maar waarom een command er bij jou niet is. Daar zijn drie oorzaken voor, en alle drie staan ze hard in de broncode. Ten eerste je platform. Ten tweede een feature-flag of een voorwaarde. Ten derde het moment: sommige commands verdwijnen terwijl de agent bezig is of terwijl je in een zijgesprek zit.

Deze commands werken niet terwijl de agent bezig is

De broncode houdt per command bij of je het midden in een lopende beurt mag draaien. Negentien gewone commands mogen dat niet: /new, /clear, /archive, /delete, /fork, /init, /compact, /review, /plan, /import, /memories, /experimental, /keymap, /vim, /theme, /pets, /logout, /setup-default-sandbox en /sandbox-add-read-dir. De twee debug-memory-commands staan ook in die lijst, waarmee het er eenentwintig zijn. Wat wel gewoon werkt tijdens een run: /diff, /status, /usage, /model, /permissions, /ps, /stop, /copy, /goal, /mcp en de rest. Wil je toch een van die negentien inzetten, dan zet je hem met Tab in de wachtrij voor de volgende beurt.

In een zijgesprek blijven er zeven over

Open je met /side of /btw een tijdelijk zijgesprek, dan krimpt het menu tot zeven commands: /copy, /raw, /diff, /mention, /status, /usage en /ide. Alles wat de sessie zelf verandert valt weg, want een zijgesprek is per definitie tijdelijk. Dat is geen bug maar een expliciete lijst in de broncode. Moet je iets doen wat er niet bij staat, sluit dan eerst het zijgesprek.

Zeventien commands accepteren tekst achter de naam

Bij de meeste commands is de naam het hele verhaal. Zeventien nemen ook direct een argument aan: /review, /rename, /new, /clear, /fork, /plan, /goal, /ide, /keymap, /mcp, /raw, /usage, /pets, /side, /btw, /resume en /sandbox-add-read-dir. Daarom werkt "/plan Migreer de auth-module" in een keer, en werkt "/status kort" niet. Aan /fast kun je niets meegeven, omdat dat command uit de modelcatalogus komt en niet uit de commandolijst.

Een grap in de broncode die echt werkt

Codex herkent /goal ook als je er extra letters o in typt. De code strip letterlijk een g aan het begin en al aan het eind, en accepteert alles daartussen zolang het alleen maar o's zijn. /goooooooooooal komt dus gewoon uit op /goal, en er staat een test in de repo die dat bewaakt. Handig is het niet, maar het is wel een goede manier om te controleren of je echt naar de commandolijst kijkt en niet naar een blogpost.

Sneltoetsen

De sneltoetsen die je uren schelen: Tab, Esc Esc en Ctrl+R

De grootste tijdwinst zit niet in nog een command, maar in hoe je de composer bedient terwijl de agent bezig is. Deze toetsen staan in de officiele referentie en worden verrassend weinig gebruikt.

Queuen met Tab: de onderschatte held

De meeste mensen zitten te wachten tot de agent klaar is en typen dan pas hun volgende stap. Dat hoeft niet. Typ /review terwijl Codex nog bouwt, druk Tab in plaats van Enter, en de review start automatisch zodra de huidige beurt af is. Zo rijg je een hele reeks stappen aan elkaar terwijl je zelf iets anders doet. Werkt ook voor gewone prompts en voor shellcommando's met een uitroepteken ervoor.

Esc Esc: terug naar het punt waar het misging

Ging de vorige beurt de verkeerde kant op, dan is doorpraten de duurste oplossing: de foute context blijft namelijk staan. Druk in plaats daarvan twee keer Esc op een lege composer, pas je vorige bericht aan en werk verder vanaf een fork op precies dat punt. Je houdt alles wat wel goed ging en gooit alleen de verkeerde afslag weg.

Sneltoetsen buiten de terminal

De ChatGPT desktop-app waar Codex sinds 9 juli 2026 in zit, heeft een eigen, aanpasbare set: het commandomenu opent met Cmd/Ctrl+K of Cmd/Ctrl+Shift+P, de terminal met Ctrl+` en het sneltoetsenoverzicht met Cmd/Ctrl+Shift+/. Die lijst staat op Slash commands in ChatGPT.

Syntax

De composer-syntax: @ voor bestanden, $ voor apps en skills, ! voor je shell

Naast slash commands kent de composer drie tekens die je midden in een zin gebruikt, plus een streepje dat alleen op de commandoregel bestaat. Ze schelen meer typwerk dan alle commands bij elkaar.

Het verschil met ChatGPT op het web

Op chatgpt.com is @ het universele aanroepteken: bestanden, apps, skills en Custom GPT's zitten allemaal achter dat ene teken. In Codex is de rolverdeling strikter: @ is alleen voor bestanden in je workspace, en apps en skills roep je met $ aan. Wie tussen beide omgevingen heen en weer schakelt, typt dit gegarandeerd een paar keer verkeerd. Het menu dat opengaat verraadt meteen in welke omgeving je zit.

Een uitroepteken is geen ontsnapping uit de sandbox

Een regel die met ! begint, voert je shellcommando uit binnen dezelfde regels die op dat moment gelden. Staat de sandbox op read-only, dan faalt een commando dat wil schrijven, ook al typte je het zelf. Dat is bedoeld gedrag en het is precies waarom je de sandbox laag zet als je alleen aan het verkennen bent. Draaiende processen die je zo start, vind je terug met /ps en stop je met /stop.

Subcommands

Buiten de chat: alle codex-subcommands

Naast de commands in de chat heeft de CLI subcommands die je vanaf je gewone terminalprompt draait. Dit is de stabiele set, met de officiele omschrijving en de alias waar die bestaat.

De vier die je in scripts gebruikt

In de praktijk draaien de meeste teams maar vier subcommands buiten de chat. codex exec voor alles wat zonder mens moet kunnen ("codex exec 'werk de changelog bij vanaf de laatste tag'"), codex review voor een geautomatiseerde review in een pipeline, codex apply om het resultaat van een cloudchat lokaal binnen te halen, en codex sandbox om zelf een commando te draaien met dezelfde beperkingen als de agent. De rest gebruik je een keer bij het inrichten.

Nog niet stabiel, wel al zichtbaar

Een paar subcommands dragen in de broncode zelf het label experimenteel: codex cloud (taken uit Codex Cloud bekijken en lokaal toepassen, met de oude naam cloud-tasks als alias), codex app-server, codex remote-control en codex exec-server. Daarnaast staat codex debug met de varianten models, app-server en prompt-input, plus twee verborgen varianten voor traces en geheugen. Ze zijn handig om te kennen, maar bouw er geen werkproces op dat morgen moet blijven werken.

En wat je in codex --help niet ziet staan

Drie subcommands zijn in de broncode expliciet verborgen en duiken dus niet op in de helptekst: codex execpolicy (regelbestanden voor het uitvoerbeleid nakijken), codex responses-api-proxy en codex stdio-to-uds. De laatste twee zijn intern. Kom je ze tegen in een tutorial, dan kijk je naar iets wat OpenAI niet als publieke functie ondersteunt.

Flags

De globale vlaggen en hun waarden

Deze vlaggen werken op de commandoregel, voor of achter je opdracht, en overschrijven wat er in je configuratie staat. De eerste vier bepalen samen hoe vrij de agent op je machine is; die kies je bewust, niet uit gewoonte. De omschrijvingen hieronder komen uit shared_options.rs en cli.rs, niet uit de documentatie.

Drie combinaties die je kunt overnemen

Verkennen zonder risico:
codex --sandbox read-only --ask-for-approval never "leg uit hoe de betaalmodule in elkaar zit"

Normaal werk aan een repo:
codex --sandbox workspace-write --ask-for-approval on-request

Een eenmalige instelling meegeven zonder je configuratie aan te passen:
codex -c model_reasoning_effort=high "analyseer waarom deze test soms faalt"

Vlaggen voor scripts en pipelines

Draai je Codex zonder mens erbij, dan hoort daar codex exec bij plus twee vlaggen die de output bruikbaar maken: --json print de events als JSONL naar stdout, en --output-last-message (kort: -o) schrijft het laatste bericht van de agent naar een bestand. Combineer dat met --sandbox en --ask-for-approval never zodat de run niet blijft hangen op een vraag die niemand beantwoordt. Codex exec heeft nog vier eigen vlaggen die in CI van pas komen: --skip-git-repo-check om buiten een git-repo te mogen draaien, --ephemeral om geen sessiebestanden weg te schrijven, --ignore-user-config om config.toml te negeren en --output-schema om het antwoord aan een JSON Schema te binden.

Zelf maken

Je eigen commando's: skills nu, promptbestanden nog even

Er zijn twee routes naar een eigen commando in Codex, en OpenAI heeft duidelijk gekozen welke de toekomst heeft. De officiele documentatie zet inmiddels bij custom prompts: "Custom prompts are deprecated. Use skills for reusable instructions that Codex can invoke explicitly or implicitly." Skills zijn sinds 9 juli 2026 algemeen beschikbaar.

Een complete skill om te kopieren

Maak deze twee paden aan:

~/.agents/skills/pr-omschrijving/
~/.agents/skills/pr-omschrijving/SKILL.md

De volledige inhoud van SKILL.md:

---
name: pr-omschrijving
description: Schrijft de omschrijving van een pull request op basis van de diff. Gebruik bij pull requests, PR-teksten, changelog-regels en release-notities.
---
Je schrijft de omschrijving van een pull request voor een Nederlands ontwikkelteam.
Begin met een zin die zegt wat er verandert en waarom.
Daarna een lijst met de belangrijkste wijzigingen per bestand of module.
Sluit af met een testplan van maximaal vijf stappen.
Geen marketingtaal, geen superlatieven, maximaal 250 woorden.

Aanroepen doe je daarna met $pr-omschrijving. Omdat "pull requests" en "PR-teksten" vooraan in de description staan, kan Codex de skill ook uit zichzelf pakken zodra je over een PR begint.

Het oude promptbestand, met alle placeholders

Maak het bestand ~/.codex/prompts/draftpr.md met deze inhoud:

---
description: Schrijft een PR-omschrijving voor een ticket
argument-hint: TICKETNUMMER [FILE=pad]
---
Schrijf een pull-request-omschrijving voor ticket $1.
Als $FILE is meegegeven, beperk je dan tot dat bestand; beschrijf anders de volledige diff.
Sluit af met een kort testplan.

Aanroepen: /prompts:draftpr PI-421 FILE=src/checkout.ts. De placeholders werken zo: $1 tot en met $9 pakken losse argumenten op volgorde, $ARGUMENTS plakt alles in een keer in, een eigen naam in hoofdletters zoals $FILE vul je bij het aanroepen met KEY=value, en $$ levert een letterlijk dollarteken op. Ombouwen naar een skill is klein werk: de promptregels gaan naar de body van SKILL.md en de informatie uit argument-hint gaat naar de description.

Waarom de description belangrijker is dan de body

De body van je skill bepaalt hoe goed het resultaat is, maar de description bepaalt of de skill uberhaupt wordt ingezet. Codex leest alle descriptions en kiest daarop. Schrijf hem dus in de woorden die jij en je collega's gebruiken als het onderwerp langskomt, en niet in de woorden die op de knop in je interne tool staan. Twijfel je of hij aanslaat, roep hem dan gewoon expliciet aan met $naam en kijk of het resultaat klopt.

Oude namen

Hernoemd, vervangen of verdwenen: waar oude tutorials stuklopen

Codex verandert snel, en tutorials van een half jaar oud noemen dus commands die niet meer bestaan. Dit is de vertaaltabel, met de datum waar die vaststaat. Let op het verschil tussen een echte alias (parseert naar hetzelfde command en staat niet apart in de popup) en twee losse commands die toevallig hetzelfde doen (beide staan in de popup). De broncode maakt dat onderscheid heel expliciet.

Waar de twee grootste wijzigingen vandaan komen

De verdwijning van /approvals en de hernoeming van /autoreview naar /approve staan in een gemergde pull request in de Codex-broncode van 4 mei 2026, getiteld "tui: retire /approvals and rename /autoreview to /approve". Dat is de reden dat /approvals geen foutmelding met een verwijzing geeft maar simpelweg niet meer bestaat. In de huidige broncode heet het command intern nog steeds AutoReview, maar de naam die je typt is /approve, en daar staat een test bij die precies dat controleert. De samenvoeging van de Codex-app in de ChatGPT desktop-app staat in de release notes van 9 juli 2026, dezelfde dag waarop de App Directory de Plugin Directory werd en skills algemeen beschikbaar werden.

Waarom dat verschil tussen alias en dubbel command uitmaakt

Bij een echte alias, zoals /clean en /pet, ziet Codex maar een regel in de popup en typ je de tweede naam blind. Bij twee losse commands, zoals /side en /btw of /agent en /subagents, staan er twee regels met dezelfde omschrijving onder elkaar. Dat is geen fout in je installatie en ook geen dubbele functie: het zijn gewoon twee ingangen naar hetzelfde gedrag. Handig om te weten als je de lijst aan het tellen bent of als je collega's een andere naam gebruiken dan jij.

Open punten

Wat we niet met zekerheid konden vaststellen

Deze pagina bevat alleen wat we in de broncode of de officiele documentatie konden nalezen. Twee punten die hier eerder als open stonden, zijn met de broncode opgelost; die staan er ook bij, met wat het antwoord blijkt te zijn. Op drie punten blijft er ruimte, en dat schrijven we liever op dan dat we het gladstrijken.

Opgelost: de sandbox-commands zijn wel degelijk Windows-only

De documentatie noemt zowel /setup-default-sandbox als /sandbox-add-read-dir Windows-only, terwijl de zichtbaarheidsregel in slash_command.rs alleen /sandbox-add-read-dir aan Windows bindt. Dat zag er lang uit als een conflict. Het gaat om twee lagen: het tweede filter zit in de commandopopup, en daar wordt de vlag voor /setup-default-sandbox buiten Windows hard op onwaar gezet. Op Windows verschijnt het command bovendien alleen als je Windows-sandbox op restricted token draait. De docs hebben dus gelijk, en op macOS en Linux zie je het command nooit.

Opgelost: --remote en --oss hebben wel een omschrijving

Eerder stond hier dat we bij --remote en --oss geen omschrijving konden vinden. In de broncode staan ze allebei. --oss gebruikt een open-source provider, met --local-provider ernaast om tussen lmstudio en ollama te kiezen. --remote verbindt de TUI met een app-server op afstand en accepteert ws://host:poort, wss://host:poort, unix:// of unix://PAD, met --remote-auth-token-env voor het token. Beide staan nu gewoon in de vlaggentabel.

Twee commands staan in je lijst die er niet horen

De commands /debug-m-drop en /debug-m-update staan in de broncode onder het kopje debugging-commands, maar anders dan /rollout en /test-approval zijn ze niet achter een debug-build gezet. Ze staan dus in een normale installatie gewoon in je popup, met als omschrijving letterlijk "DO NOT USE". Of dat bewust is of een omissie kunnen wij niet zien. Wat je moet doen wel: laat ze staan.

De officiele lijst loopt achter op de broncode

Bij onze controle van 31 juli 2026 documenteerde de officiele pagina ongeveer 35 CLI-commands, terwijl de broncode er meer bevatte. Bij de controle van 1 augustus stonden onder andere /new, /usage, /theme en /app wel in de docs, maar nog steeds niet alles. De documentatie loopt dus achter op de build en haalt met sprongen in. Daarom telt deze pagina de enum en niet de documentatie. Zie je een command dat jouw sessie niet toont, kijk dan eerst naar de feature-flags in de sectie Waarom mist een command en pas daarna naar codex update.

Beschikbaarheid per omgeving is niet officieel vastgelegd

OpenAI publiceert geen tabel die per omgeving (CLI, desktop-app, IDE-extensie) zegt welk command bestaat. De enige officiele uitspraak is dat de beschikbare commands varieren op basis van je omgeving en je toegang. Voor de CLI konden we het per platform uit de broncode halen; voor de desktop-app en de IDE-extensie is er geen equivalent dat wij kunnen inzien, dus daar leunen we op de losse referentiepagina's.

Geen datum bij de deprecatie van custom prompts

De docs zetten wel een deprecation-melding bij custom prompts en verwijzen door naar skills, maar er staat geen datum bij waarop /prompts:naam stopt met werken. Wij noemen er dan ook geen. Ombouwen kan wanneer het jou uitkomt; wachten tot het breekt is alleen een gok op timing.