Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Uw eerste Codex-taak

Les 4 van 20 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Start uw eerste taak
  2. Vanuit Codex Cloud
  3. Vanuit de IDE
  4. Vanuit de CLI
  5. Anatomie van een Codex-resultaat
  6. Goede instructies schrijven
  7. Belangrijkste punten

Bijgewerkt op 3 november 2026 op basis van de Codex-commandoreferentie (CLI 0.166.0): de opties --show-diff en --apply bestaan niet. Lokaal wijzigt Codex bestanden direct binnen zijn sandbox; bekijk wijzigingen met /diff of git diff. De extensieopdracht “Codex: New Task” is vervangen door Codex: Open Codex Sidebar. Bronnen: Developer commands · Codex IDE extension.

Start uw eerste taak

Uw account is ingesteld, GitHub is verbonden en AGENTS.md staat op zijn plek: het is tijd om de agent in actie te zien. Hier is een vuistregel voor elk ervaringsniveau: begin met een taak waarvan u het juiste antwoord al kent. U leert weinig door toe te kijken hoe Codex een probleem oplost dat u niet kunt evalueren, maar u steekt enorm veel op door te observeren hoe het opereert op vertrouwd terrein.

Vanuit Codex Cloud

Kies op het web of in de desktopapp Work in › Cloud, selecteer de gepubliceerde omgeving voor uw repository (Les 2) en typ uw taak in het invoerveld. Iets bewust bescheiden werkt prima.

Task: "Add a .gitignore file suitable for a Node.js/TypeScript 
       project if one doesn't already exist."

Deze formulering bevat een voorwaarde—“if one doesn’t already exist”—en precies dat maakt het interessant om te observeren. In Codex Cloud wordt de taak uitgevoerd in de omgeving die u voor deze repository hebt gepubliceerd: Codex controleert of .gitignore bestaat, verifieert dat het Node.js en TypeScript afdekt als dat zo is, maakt het bestand aan of werkt het bij naar behoefte, en toont u vervolgens het resultaat als een diff. Het uitvoeringslogboek streamt in real-time: hier ziet u of de agent de voorwaarde heeft gerespecteerd of uw bestaande bestand heeft overschreven.

Vanuit de IDE

Open uw project in VS Code (of Cursor, Windsurf) en start Codex via het pictogram of het Command Palette:

Ctrl+Shift+P → "Codex: Open Codex Sidebar"

Formuleer vervolgens een verzoek dat gebruikmaakt van lokale context door het specifieke bestand te benoemen:

"Add email validation to the contact form 
 in src/components/ContactForm.tsx"

De extensie toont een samenvatting en de gewijzigde regels naast de code; u behoudt de wijzigingen die u wilt en vraagt vervolgstappen binnen hetzelfde gesprek. De documentatie adviseert om voor en na de taak een Git-checkpoint te maken, zodat u indien nodig kunt terugrollen.

Vanuit de CLI

# Navigate to the project directory
cd my-project

# Start a session with an initial instruction
codex "Add a README.md with the project description, installation instructions, and available commands"

Lokaal wijzigt Codex bestanden direct in uw werkmap, binnen de grenzen van de sandbox en het goedkeuringsbeleid: het vraagt om toestemming voordat het acties onderneemt die dit vereisen. Om te bekijken wat er is veranderd voordat u commit, typt u /diff in de sessie: het commando toont de Git-diff, inclusief niet-bijgehouden bestanden. /review vraagt Codex om uw working tree zelf te beoordelen. Voor scripted gebruik voert codex exec dezelfde taak uit zonder interactie (Les 14); in dat geval is het aan Git en uw pipeline om te beslissen wat behouden blijft.

Anatomie van een Codex-resultaat

Ongeacht het toegangspunt levert een voltooide taak altijd dezelfde vier elementen op. Beoordeel ze in deze volgorde: de diff vertelt wat er is veranderd, het logboek vertelt waarom, de tests zeggen of het veilig is, en de acties geven de controle terug aan u.

Geleverd elementInhoud
Change diffElke toegevoegde, gewijzigde of verwijderde regel, bestand per bestand
Execution logAlle stappen: gelezen bestanden, uitgevoerde commando’s, redenering van de agent
Test resultsAls er tests bestaan, voert Codex ze uit om te verifiëren dat niets kapot is
Available actionsGoedkeuren, wijzigen, een PR aanmaken, of opnieuw uitvoeren met andere instructies

Beginners verwaarlozen vaak het uitvoeringslogboek, terwijl dit juist het element is dat u leert hoe u uw taken moet formuleren. Door te zien welke bestanden Codex opende voordat het een beslissing nam, ontdekt u wat het zocht maar niet kon vinden—vaak een conventie die in AGENTS.md had moeten staan.

Goede instructies schrijven

De kwaliteit van het resultaat hangt direct af van de kwaliteit van de instructie, en het verschil tussen de onderstaande twee formuleringen is veel groter dan het verschil tussen twee modellen.

"Improve the code"
"In src/lib/auth.ts, replace manual JWT handling 
with the jose library. Keep the same public interface 
(signToken, verifyToken). Update the corresponding tests."

De tweede versie werkt omdat deze vier vragen beantwoordt die de agent zichzelf toch al stelt. Het specificeert de betrokken bestanden, waardoor het niet hoeft te zoeken en de verkeerde locatie target. Het definieert het verwachte resultaat—gedrag, interface, formaat—zodat het weet wanneer het moet stoppen. Het stelt beperkingen, hier het behoud van de publieke interface, wat voorkomt dat het dingen “verbetert” door aanroepers te breken; elders zou dit “breek geen tests” kunnen zijn. En wanneer de stakes het rechtvaardigen, voegt het bedrijfscontext toe: specificeren dat “dit een betaalformulier is, beveiliging is cruciaal” verandert daadwerkelijk de afwegingen.

Om dit eigen te maken, neemt u een bestaand project en koppelt u drie taken van verschillende aard aan elkaar: een analyse zonder wijziging, “List all TypeScript files that lack associated tests”; een gerichte generatie, “Generate a unit test for this file”; een fix met beperkte scope, “Fix ESLint warnings in src/utils/”. Noteer voor elk wat u vooraf had moeten specificeren: deze lijst met spijt is uw eerste concept voor AGENTS.md.

Belangrijkste punten

  • Start uw eerste taken met eenvoudige, gerichte verzoeken
  • Codex levert voor elke taak een compleet uitvoeringslogboek
  • De kwaliteit van het resultaat hangt af van de nauwkeurigheid van uw instructies
  • U behoudt altijd de controle: goedkeuren, wijzigen of afwijzen
  • Begin met laag-risico taken voordat u overgaat tot kritieke wijzigingen