Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Opsæt dit miljø og AGENTS.md

Lektion 3 af 20 Opdateret 3. november 2026 Udvikler
På denne side
  1. Forbered dit projekt til Codex
  2. Trin 1: Din Codex-adgang
  3. Trin 2: Installer editor-udvidelsen
  4. Trin 3: Installer CLI
  5. Filen AGENTS.md – din projektvejledning
  6. Bedste praksis for AGENTS.md
  7. Vigtige pointer

Opdateret 3. november 2026 baseret på Codex-dokumentation (Codex CLI, Autentificering, Codex IDE-udvidelse, Brugerdefinerede instrukser med AGENTS.md): pakken @openai/codex-cli og kommandoen codex auth login eksisterer ikke (brug npm install -g @openai/codex og codex login); udvidelsesidentifikatoren er openai.chatgpt; adressen codex.openai.com og planerne “Team, Enterprise eller API” er erstattet med aktuelle adgangsmetoder; og læserækkefølgen for AGENTS.md er præciseret (projektrod → nuværende mappe). Kilder: Codex CLI · Autentificering · AGENTS.md · Priser.

Forbered dit projekt til Codex

To ting skal være på plads, før du starter din første opgave: din Codex-adgang – din konto og GitHub-forbindelse – og selve dit projekt, defineret gennem filen AGENTS.md, der vil vejlede agenten. Den første del tager ca. 15 minutter og er en engangsopsætning. Den anden afgør kvaliteten af alt, hvad du får ud af Codex, og skiller de teams, der er tilfredse med Codex, fra dem, der finder det skuffende.

Trin 1: Din Codex-adgang

Du kan bruge Codex med en ChatGPT-konto eller en API-nøgle. Planerne Free og Go giver adgang, afhængigt af den aktuelle udrulning, til GPT-6 Luna i skrivebordsappen. Fra og med Plus er Codex tilgængelig på webbet, i CLI’en, i editor-udvidelsen og på iOS, med cloud-integrationer som automatiseret kodegennemgang. En API-nøgle fungerer til automatisering i delte miljøer som CI ved brug af CLI, SDK eller udvidelse – selvom nogle funktioner måske ikke er tilgængelige. Detaljer og brugsgrænser findes på siden for Codex-priser.

For at arbejde i clouden med dine repositories skal du forbinde GitHub, når du opretter dit første Codex Cloud-miljø (Lektion 2). Når du giver tilladelser, så hold det minimalt: begræns adgangen til kun de repositories, du faktisk har brug for.

Trin 2: Installer editor-udvidelsen

I VS Code og dets afledte værktøjer (Cursor, Windsurf) skal du installere Codex-udvidelsen fra marketplace – dens identifikator er openai.chatgpt:

code --install-extension openai.chatgpt

Åbn derefter Codex via ikonet eller gennem kommandopaletten med Codex: Open Codex Sidebar, og log ind. Xcode og JetBrains IDE’er har deres egne integrationer: i JetBrains skal du åbne AI Chat og vælge Codex.

Trin 3: Installer CLI

# Installation (macOS og Linux), eller npm install -g @openai/codex
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Bekræft installationen
codex --version

# Log ind (browser), eller tjek forbindelsesstatus
codex login
codex login status

codex login åbner login-flowet i din browser. For en API-nøgle skal du sende den via standard input (printenv OPENAI_API_KEY | codex login --with-api-key). Codex cacher legitimationsoplysninger enten i en almindelig tekstfil, ~/.codex/auth.json, eller i systemets nøglebund, afhængigt af indstillingen cli_auth_credentials_store (file, keyring, auto eller ephemeral). Hvis filen bruges, skal du behandle den som en adgangskode: den indeholder adgangstokens, så commit den aldrig. CLI’en og udvidelsen deler denne cache.

Filen AGENTS.md – din projektvejledning

AGENTS.md er central for effektiv brug af Codex. Det er en simpel Markdown-fil placeret i roden af dit repository, der samler instrukser, konventioner og kommandoer specifikke for dit projekt. Når Codex kloner repo’et, læser den denne fil først: tænk på det som automatisk onboarding for agenten, præcis det, du ville forklare mundtligt til et nyt teammedlem.

Effekten er øjeblikkelig. Uden AGENTS.md, hvis du beder om en unit-test på et projekt, der bruger Vitest, er der stor sandsynlighed for, at Codex giver dig Jest, fordi det er det mest almindelige valg i økosystemet. En enkelt linje med konvention er nok til at få Vitest rigtigt første gang, hvilket sparer dig for at skulle rette den samme fejl hundrede gange. Her er strukturen på en grundlæggende fil til et SaaS-projekt til fakturahåndtering.

# AGENTS.md

## Projektkontekst
SaaS-applikation til fakturahåndtering.
Stack: Next.js 15, TypeScript, Prisma, PostgreSQL.

## Kodekonventioner
- Brug funktionelle React-komponenter (ingen klasser)
- Navngiv filer i kebab-case
- TypeScript-typer i separate .types.ts-filer
- Tests med Vitest, .test.ts-filer ved siden af koden

## Nyttige kommandoer
- `npm run dev` — udviklingsserver
- `npm run test` — kør tests
- `npm run lint` — tjek linting
- `npm run build` — produktionsbuild

## Projektstruktur
    src/
      app/          → Next.js-sider (App Router)
      components/   → Genanvendelige React-komponenter
      lib/          → Forretningslogik og værktøjer
      prisma/       → DB-skema og migrationer

## Strikte regler
- ALDRIG modificer Prisma-skema uden en migration
- ALDRIG commit .env-filer
- Brug altid Server Actions til mutationer

Hvordan Codex finder AGENTS.md-filer

En enkelt rod-fil bliver hurtigt for generisk. Codex lader dig stable instrukser i en præcis rækkefølge, som du skal kende:

  1. Globalt niveau: I din Codex-mappe (~/.codex, medmindre CODEX_HOME overskriver dette), læser Codex AGENTS.override.md, hvis den eksisterer, ellers AGENTS.md.
  2. Projektniveau: Startende fra projektroden (normalt Git-roden), går Codex ned til den nuværende mappe og læser i hver mappe, den passerer, AGENTS.override.md eller, hvis den ikke findes, AGENTS.md.
  3. Sammenfletning: Filerne sammenkædes fra roden og ned til den nuværende mappe; dem, der er tættest på den nuværende mappe, kommer sidst og overskriver derfor mere generelle instrukser.
my-project/
  AGENTS.md              → Projektinstrukser
  src/
    api/
      AGENTS.md          → "API-ruter bruger Zod til validering"

Praktisk konsekvens: src/api/AGENTS.md læses kun, hvis Codex arbejder fra src/api eller en af dens undermapper, ikke når den startes fra roden. Tomme filer ignoreres, og sammenkædningen stopper ved 32 KiB som standard (project_doc_max_bytes). Hvis dit repo allerede bruger et andet navn, som f.eks. TEAM_GUIDE.md, skal du tilføje det til project_doc_fallback_filenames i ~/.codex/config.toml.

For at verificere, hvad Codex faktisk har indlæst, skal du bare spørge: codex --ask-for-approval never "Summarize the current instructions.". Codex genopbygger instruktionskæden ved hver start: hvis du er i tvivl, så genstart den i den korrekte mappe.

Bedste praksis for AGENTS.md

Det styrende princip er eksplicitthed. “Brug Vitest, ikke Jest” er bedre end “Brug vores testframework”, hvilket forudsætter viden, som agenten ikke har. Medtag altid kommandoer: uden dem ved Codex ikke, hvordan dine tests, linter eller build skal køres, og den vil levere kode, den ikke kunne verificere. Dokumenter strukturen som et directory-træ, hvilket forhindrer den i at udforske blindt og oprette filer det forkerte sted.

List endelig forbuddene op. Regler skrevet som “ALDRIG” er de mest omkostningseffektive i filen, fordi de blokerer for dyre fejl, der er svære at rette: at committe en .env-fil, at modificere et skema uden en migration. Den sværeste disciplin er at holde filen opdateret. En AGENTS.md, der beskriver sidste års projekt, styrer aktivt Codex mod forladte konventioner – langt værre end slet ingen fil at have, da fejlen så bliver systematisk.

Vigtige pointer

  • Den indledende opsætning kræver en OpenAI-konto og en GitHub-forbindelse
  • IDE-udvidelsen og CLI’en installeres på få minutter
  • AGENTS.md er den vigtigste fil for effektiv brug af Codex
  • Den indeholder konventioner, kommandoer og regler specifikke for dit projekt
  • AGENTS.md-filer i undermapper muliggør kontekstuelle instrukser