Din första Codex-uppgift
På denna sida
Uppdaterat 3 november 2026 baserat på referensen för Codex-kommandon (CLI 0.166.0): alternativen
--show-diffoch--applyfinns inte. Lokalt modifierar Codex filer direkt inom sin sandlåda; granska ändringar med/diffellergit diff. Tilläggsbefalet “Codex: New Task” har ersatts av Codex: Open Codex Sidebar. Källor: Developer commands · Codex IDE extension.
Starta din första uppgift
Ditt konto är konfigurerat, GitHub är anslutet och AGENTS.md är på plats: det är dags att se agenten i aktion. Här är en tumregel för alla kompetensnivåer – börja med en uppgift där du redan vet det korrekta svaret. Du lär dig inte mycket genom att se Codex lösa ett problem du inte kan utvärdera, men du lär dig enormt mycket genom att observera hur det opererar på bekant mark.
Från Codex Cloud
På webben eller i skrivbordsappen väljer du Work in › Cloud, väljer den publicerade miljön för ditt arkiv (Lektion 2) och skriver din uppgift i inmatningsfältet. Något medvetet blygsamt fungerar utmärkt.
Task: "Add a .gitignore file suitable for a Node.js/TypeScript
project if one doesn't already exist."
Denna formulering inkluderar ett villkor – “om en inte redan finns” – vilket är precis det som gör det intressant att observera. I Codex Cloud körs uppgiften i miljön du publicerade för detta arkiv: Codex kontrollerar om en .gitignore finns, verifierar att den täcker Node.js och TypeScript om den gör det, skapar eller uppdaterar filen efter behov och visar sedan resultatet som en diff. Exekveringsloggen strömmas i realtid: här ser du om agenten respekterade villkoret eller skrev över din befintliga fil.
Från IDE:t
Öppna ditt projekt i VS Code (eller Cursor, Windsurf) och starta Codex via dess ikon eller kommandopaletten:
Ctrl+Shift+P → "Codex: Open Codex Sidebar"
Formulera sedan en begäran som utnyttjar lokal kontext genom att namnge den specifika filen:
"Add email validation to the contact form
in src/components/ContactForm.tsx"
Tillägget visar en sammanfattning och de modifierade raderna bredvid koden; du behåller de ändringar du vill ha och ber om uppföljningar inom samma konversation. Dokumentationen rekommenderar att du skapar en Git-kontrollpunkt före och efter uppgiften så att du kan rulla tillbaka vid behov.
Från 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 modifierar Codex filer direkt i din arbetskatalog, inom gränserna för sandlådan och godkännandepolicyn: det ber om tillstånd innan det vidtar åtgärder som kräver det. För att granska vad som ändrats innan du commitar, skriv /diff i sessionen: kommandot visar Git-diffen, inklusive ospårade filer. /review ber Codex granska din arbetskatalog själv. För skriptad användning kör codex exec samma uppgift utan interaktion (Lektion 14) – i det fallet är det upp till Git och din pipeline att avgöra vad som behålls.
Anatomin av ett Codex-resultat
Oavsett ingångspunkt returnerar en avslutad uppgift alltid samma fyra element. Granska dem i denna ordning: diffen säger vad som ändrades, loggen säger varför, testen säger om det är säkert och åtgärderna lämnar tillbaka kontrollen till dig.
| Levererat element | Vad det innehåller |
|---|---|
| Ändringsdiff | Varje tillagd, modifierad eller raderad rad, fil för fil |
| Exekveringslogg | Alla steg: lästa filer, körda kommandon, agentens resonemang |
| Testresultat | Om tester finns kör Codex dem för att verifiera att inget gått sönder |
| Tillgängliga åtgärder | Godkänn, modifiera, skapa en PR eller kör igen med andra instruktioner |
Nybörjare försummar ofta exekveringsloggen, men det är elementet som lär dig hur du formulerar dina uppgifter. Genom att se vilka filer Codex öppnade innan det fattade ett beslut upptäcker du vad det letade efter men inte kunde hitta – ofta en konvention som borde ha funnits i AGENTS.md.
Att skriva bra instruktioner
Resultatkvaliteten beror direkt på instruktionskvaliteten, och gapet mellan de två formuleringarna nedan är mycket större än gapet mellan två 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 andra versionen fungerar eftersom den svarar på fyra frågor som agenten ändå ställer sig själv. Den specificerar vilka filer som är inblandade, vilket sparar den från att utforska och rikta in sig på fel plats. Den definierar det förväntade resultatet – beteende, gränssnitt, format – så den vet när den ska sluta. Den sätter begränsningar, här att bevara det publika gränssnittet, vilket förhindrar att den “förbättrar” saker genom att bryta anropare; på andra ställen kan detta vara “bryt inte testen”. Och när insatserna motiverar det, lägger den till affärskontext: att specificera “detta är ett betalningsformulär, säkerheten är kritisk” ändrar faktiskt dess avvägningar.
För att göra detta till ditt eget, ta ett befintligt projekt och länka samman tre uppgifter av olika karaktär: en analys utan modifiering, “Lista alla TypeScript-filer som saknar tillhörande tester”; en målinriktad generering, “Generera ett enhetstest för denna fil”; en fix med begränsat omfång, “Åtgärda ESLint-varningar i src/utils/”. För varje uppgift, notera vad du borde ha specificerat från början: denna lista över ånger är ditt första utkast till AGENTS.md.
Viktiga punkter
- Starta dina första uppgifter med enkla, målinriktade begäranden
- Codex tillhandahåller en komplett exekveringslogg för varje uppgift
- Resultatkvaliteten beror på precisionen i dina instruktioner
- Du behåller alltid kontrollen: godkänn, modifiera eller avvisa
- Börja med lågrisk-uppgifter innan du går vidare till kritiska ändringar