Din første Codex-opgave
På denne side
Opdateret 3. november 2026 baseret på Codex-kommandoreferencen (CLI 0.166.0): indstillingerne
--show-diffog--applyfindes ikke. Lokalt modificerer Codex filer direkte i sin sandbox; gennemgå ændringer ved hjælp af/diffellergit diff. Udvidelseskommandoen “Codex: New Task” er blevet erstattet af Codex: Open Codex Sidebar. Kilder: Udviklerkommandoer · Codex IDE-udvidelse.
Start din første opgave
Din konto er opsat, GitHub er forbundet, og AGENTS.md er på plads: det er tid til at se agenten i aktion. Her er en tommelfingerregel for alle færdighedsniveauer – start med en opgave, hvor du allerede kender det korrekte svar. Du lærer ikke meget ved at se Codex løse et problem, du ikke kan evaluere, men du vil lære enormt meget ved at se den operere på kendt grund.
Fra Codex Cloud
På nettet eller i skrivebordsappen vælger du Work in › Cloud, vælger det publicerede miljø til dit repository (Lektion 2) og indtaster din opgave i inputfeltet. Noget bevidst beskedent fungerer perfekt.
Task: "Add a .gitignore file suitable for a Node.js/TypeScript
project if one doesn't already exist."
Denne formulering inkluderer en betingelse – “if one doesn’t already exist” – hvilket er præcis det, der gør det interessant at observere. I Codex Cloud kører opgaven i det miljø, du har publiceret til dette repository: Codex tjekker, om en .gitignore findes, verificerer, at den dækker Node.js og TypeScript, hvis den gør, opretter eller opdaterer filen efter behov og viser dig derefter resultatet som en diff. Eksekveringsloggen streames i realtid: her vil du se, om agenten overholdt betingelsen eller overskrev din eksisterende fil.
Fra IDE’en
Åbn dit projekt i VS Code (eller Cursor, Windsurf) og start Codex via dens ikon eller kommandopaletten:
Ctrl+Shift+P → "Codex: Open Codex Sidebar"
Formulér derefter en anmodning, der udnytter lokal kontekst ved at nævne den specifikke fil:
"Add email validation to the contact form
in src/components/ContactForm.tsx"
Udvidelsen viser en oversigt og de modificerede linjer ved siden af koden; du beholder de ændringer, du ønsker, og beder om opfølgninger inden for samme samtale. Dokumentationen anbefaler at oprette et Git-checkpoint før og efter opgaven, så du kan rulle tilbage, hvis det bliver nødvendigt.
Fra 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"
Lokalt modificerer Codex filer direkte i dit arbejdskatalog, inden for grænserne for sandboxen og godkendelsespolitikken: den spørger om tilladelse, før den udfører handlinger, der kræver det. For at gennemgå, hvad der er ændret, før du committer, skal du taste /diff i sessionen: kommandoen viser Git-diffen, inklusive ikke-sporede filer. /review beder Codex om at gennemgå dit arbejdstræ selv. Til scriptet brug kører codex exec den samme opgave uden interaktion (Lektion 14) – i det tilfælde er det op til Git og din pipeline at afgøre, hvad der beholdes.
Anatomien af et Codex-resultat
Uanset indgangspunktet returnerer en afsluttet opgave altid de samme fire elementer. Gennemgå dem i denne rækkefølge: diffen fortæller, hvad der er ændret, loggen fortæller hvorfor, testene fortæller, om det er sikkert, og handlingerne giver kontrollen tilbage til dig.
| Leveret element | Hvad det indeholder |
|---|---|
| Change diff | Hver tilføjet, modificeret eller slettet linje, fil for fil |
| Execution log | Alle trin: filer læst, kommandoer kørt, agentens ræsonnement |
| Test results | Hvis der findes tests, kører Codex dem for at verificere, at intet er gået i stykker |
| Available actions | Godkend, modificér, opret en PR, eller kør igen med andre instrukser |
Nybeggere overser ofte eksekveringsloggen, men det er elementet, der lærer dig, hvordan du formulerer dine opgaver. Ved at se, hvilke filer Codex åbnede, før den traf en beslutning, opdager du, hvad den ledte efter, men ikke kunne finde – ofte en konvention, der burde have stået i AGENTS.md.
Skriv gode instrukser
Resultatkvaliteten afhænger direkte af instrukskvaliteten, og kløften mellem de to nedenstående formuleringer er langt større end kløften mellem to modeller.
"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."
Den anden version fungerer, fordi den besvarer fire spørgsmål, som agenten alligevel stiller sig selv. Den specificerer de involverede filer, hvilket sparer den for at udforske og målrette det forkerte sted. Den definerer det forventede resultat – adfærd, grænseflade, format – så den ved, hvornår den skal stoppe. Den sætter begrænsninger, her bevarelse af den offentlige grænseflade, hvilket forhindrer den i at “forbedre” ting ved at bryde kaldere; andetsteds kunne dette være “bryd ikke tests”. Og når indsatsen berettiger det, tilføjer den forretningskontekst: at specificere “dette er en betalingsformular, sikkerhed er kritisk” ændrer genuint dens afvejninger.
For at gøre dette til dit eget skal du tage et eksisterende projekt og kæde tre opgaver af forskellig art sammen: en analyse uden modificering, “List all TypeScript files that lack associated tests”; en målrettet generering, “Generate a unit test for this file”; en begrænset fejlrettelse, “Fix ESLint warnings in src/utils/”. For hver af dem skal du notere, hvad du burde have specificeret på forhånd: denne liste over fortrydelser er dit første udkast til AGENTS.md.
Vigtige pointer
- Start dine første opgaver med enkle, målrettede anmodninger
- Codex leverer en komplet eksekveringslog for hver opgave
- Resultatkvaliteten afhænger af præcisionen i dine instrukser
- Du beholder altid kontrollen: godkend, modificér eller afvis
- Start med lavrisiko opgaver, før du går videre til kritiske ændringer