Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Konfigurera din miljö och AGENTS.md

Lektion 3 av 20 Uppdaterad 3 november 2026 Utvecklare
På denna sida
  1. Förbered ditt projekt för Codex
  2. Steg 1: Din Codex-åtkomst
  3. Steg 2: Installera editortillägget
  4. Steg 3: Installera CLI
  5. Filen AGENTS.md – din projektguide
  6. Bästa praxis för AGENTS.md
  7. Viktiga punkter

Uppdaterat den 3 november 2026 baserat på Codex-dokumentation (Codex CLI, Autentisering, Codex IDE-tillägg, Anpassade instruktioner med AGENTS.md): paketet @openai/codex-cli och kommandot codex auth login finns inte (använd npm install -g @openai/codex och codex login); tilläggsidentifieraren är openai.chatgpt; adressen codex.openai.com och planerna “Team, Enterprise eller API” har ersatts med aktuella åtkomstmetoder; och läsandet av AGENTS.md har förtydligats (projektkatalog → aktuell katalog). Källor: Codex CLI · Autentisering · AGENTS.md · Prissättning.

Förbered ditt projekt för Codex

Två saker måste vara på plats innan din första uppgift: din Codex-åtkomst – ditt konto och din GitHub-anslutning – samt ditt själva projekt, definierat genom filen AGENTS.md som kommer att styra agenten. Den första delen tar cirka 15 minuter och görs endast en gång. Den andra avgör kvaliteten på allt du får ut av Codex, och skiljer team som är nöjda med Codex från de som blir besvikna.

Steg 1: Din Codex-åtkomst

Du kan använda Codex med ett ChatGPT-konto eller en API-nyckel. Planerna Free och Go ger åtkomst, beroende på aktuell distribution, till GPT-6 Luna i skrivbordsappen. Från och med Plus är Codex tillgängligt på webben, i CLI, i editortillägget och på iOS, med molnintegrationer som automatisk kodgranskning. En API-nyckel fungerar för automatisering i delade miljöer som CI, via CLI, SDK eller tillägg – även om vissa funktioner kanske inte är tillgängliga. Detaljer och användningsgränser finns på sidan för Codex-prissättning.

För att arbeta i molnet med dina arkiv kopplar du till GitHub när du skapar din första Codex Cloud-miljö (Lektion 2). När du beviljar behörigheter, håll det minimalt: begränsa åtkomsten till endast de arkiv du faktiskt behöver.

Steg 2: Installera editortillägget

I VS Code och dess derivat (Cursor, Windsurf) installerar du Codex-tillägget från marknadsplatsen – dess identifierare är openai.chatgpt:

code --install-extension openai.chatgpt

Öppna sedan Codex via dess ikon, eller genom kommandopaletten med Codex: Open Codex Sidebar, och logga in. Xcode och JetBrains IDE:er har sina egna integrationer: i JetBrains öppnar du AI Chat och väljer Codex.

Steg 3: Installera CLI

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

# Verifiera installationen
codex --version

# Logga in (webbläsare), eller kontrollera anslutningsstatus
codex login
codex login status

codex login öppnar inloggningsflödet i din webbläsare. För en API-nyckel skickar du den via standardinmatning (printenv OPENAI_API_KEY | codex login --with-api-key). Codex cachelagrар autentiseringsuppgifter antingen i en vanlig textfil, ~/.codex/auth.json, eller i systemets nyckelring, beroende på inställningen cli_auth_credentials_store (file, keyring, auto eller ephemeral). Om filen används, behandla den som ett lösenord: den innehåller åtkomsttoken, så committa den aldrig. CLI och tillägget delar denna cache.

Filen AGENTS.md – din projektguide

AGENTS.md är central för att använda Codex effektivt. Det är en enkel Markdown-fil som placeras i roten av ditt arkiv och samlar instruktioner, konventioner och kommandon specifika för ditt projekt. När Codex klonar arkivet läser den denna fil först: tänk på det som en automatisk introduktion för agenten, exakt det du skulle förklara muntligt för en ny teammedlem.

Effekten är omedelbar. Utan AGENTS.md, om du ber om ett enhetstest på ett projekt som använder Vitest, är det stor chans att Codex ger dig Jest, eftersom det är det vanligaste valet i ekosystemet. En enda rad med konvention räcker för att få rätt Vitest från början, vilket sparar dig från att göra samma korrigering hundra gånger. Här är strukturen för en grundläggande fil för ett SaaS-projekt för fakturahantering.

# AGENTS.md

## Projektkontext
SaaS-applikation för fakturahantering.
Stack: Next.js 15, TypeScript, Prisma, PostgreSQL.

## Kodkonventioner
- Använd React-funktionella komponenter (inga klasser)
- Namnge filer i kebab-case
- TypeScript-typer i separata .types.ts-filer
- Tester med Vitest, .test.ts-filer bredvid koden

## Användbara kommandon
- `npm run dev` — utvecklingsserver
- `npm run test` — kör tester
- `npm run lint` — kontrollera linting
- `npm run build` — produktionsbygge

## Projektstruktur
    src/
      app/          → Next.js-sidor (App Router)
      components/   → Återanvändbara React-komponenter
      lib/          → Affärslogik och verktyg
      prisma/       → DB-schema och migrationer

## Strikta regler
- ÄNDRA ALDRIG Prisma-schema utan en migration
- COMMITTA ALDRIG .env-filer
- Använd alltid Server Actions för mutationer

Hur Codex hittar AGENTS.md-filer

En enda rotfil blir snabbt för generell. Codex låter dig stapla instruktioner i en exakt ordning du behöver känna till:

  1. Global nivå: I din Codex-mapp (~/.codex, om inte CODEX_HOME åsidosätter detta), läser Codex AGENTS.override.md om den finns, annars AGENTS.md.
  2. Projektnivå: Från projektkatalogen (vanligtvis Git-roten) går Codex ner till den aktuella katalogen och läser, i varje mapp som passeras, AGENTS.override.md eller, i andra fall, AGENTS.md.
  3. Sammanslagning: Filerna slås samman från roten ner till den aktuella katalogen; de som ligger närmast den aktuella katalogen kommer sist och åsidosätter därmed mer generella instruktioner.
my-project/
  AGENTS.md              → Projektinstruktioner
  src/
    api/
      AGENTS.md          → "API-rutter använder Zod för validering"

Praktisk konsekvens: src/api/AGENTS.md läses endast om Codex arbetar från src/api eller en av dess underkataloger, inte när den startas från roten. Tomma filer ignoreras, och sammanslagningen stoppas vid 32 KiB som standard (project_doc_max_bytes). Om ditt arkiv redan använder ett annat namn, som TEAM_GUIDE.md, lägg till det i project_doc_fallback_filenames i ~/.codex/config.toml.

För att verifiera vad Codex faktiskt har laddat, fråga helt enkelt: codex --ask-for-approval never "Summarize the current instructions.". Codex bygger om instruktionskedjan vid varje start: vid tvekan, starta om den i rätt katalog.

Bästa praxis för AGENTS.md

Den ledande principen är tydlighet. “Använd Vitest, inte Jest” är bättre än “Använd vårt testramverk”, vilket förutsätter kunskap som agenten inte har. Inkludera alltid kommandon: utan dem vet inte Codex hur dina tester, linter eller byggen ska köras, och den kommer att leverera kod den inte kunde verifiera. Dokumentera strukturen som ett katalogträd, vilket förhindrar att den utforskar blindt och skapar filer på fel plats.

Lista slutligen förbuden. Regler skrivna som “ALDRIG” är de mest kostnadseffektiva i filen, eftersom de blockerar dyra misstag som är svåra att åtgärda: att committa en .env-fil, att modifiera ett schema utan en migration. Den svåraste disciplinen är att hålla filen uppdaterad. En AGENTS.md som beskriver förra årets projekt styr aktivt Codex mot övergivna konventioner – långt värre än att inte ha någon fil alls, eftersom felet då blir systematiskt.

Viktiga punkter

  • Den initiala konfigurationen kräver ett OpenAI-konto och en GitHub-anslutning
  • IDE-tillägget och CLI installeras på några minuter
  • AGENTS.md är den viktigaste filen för effektiv användning av Codex
  • Den innehåller konventioner, kommandon och regler specifika för ditt projekt
  • AGENTS.md-filer i underkataloger möjliggör kontextuella instruktioner