Codex: den kompletta guiden

Grunderna

Vad är Codex?

Codex är en kodagent, en AI som själv arbetar i ditt projekt. En vanlig chatt ger dig ett kodförslag som du får kopiera. Codex öppnar filerna, gör ändringen och kör testerna, alltså de små program som kontrollerar att koden fungerar. Sedan säger Codex vad som hände. Codex läser, planerar, ändrar och kontrollerar, varv efter varv, tills uppgiften är klar.

Guiden handlar mest om Codex CLI, eftersom terminalen visar tydligast vad Codex gör. Det mesta gäller också i editorn och i appen.

Codex finns i skrivande stund på de här ställena, enligt OpenAI:s dokumentation:

• Codex CLI i terminalen.
• Ett tillägg för kodeditorer.
• Codex i ChatGPT:s datorapp.
• Codex i ChatGPT-appen för iPhone.
• Codex Cloud, som kör uppgifter på OpenAI:s datorer.

Vad är en terminal?

Terminalen är programmet där du installerar och startar Codex. Listan under texten förklarar orden du möter där, som terminal, kommando, CLI och sökväg.

På Mac öppnar du programmet Terminal under Program och Verktygsprogram. På Windows öppnar du PowerShell från Start-menyn. På Linux heter programmet oftast Terminal.

Vem är Codex till för?

Codex är för dig som skriver eller sköter kod. Du kan vara utvecklare eller student, eller ha en egen webbplats eller ett litet program.

Du behöver inte vara expert. Men du behöver förstå vad du ber om och kunna kontrollera resultatet, för Codex ändrar riktiga filer. Lär dig därför grunderna i git, programmet som sparar versioner av dina filer, och ta reda på hur ditt projekt startas.

Codex passar för uppgifter som de här:

• Förstå kod som någon annan har skrivit.
• Rätta ett fel.
• Lägga till en funktion.
• Skriva tester.
• Granska ändringar innan de skickas vidare.

Kom igång

Vad behöver du för att använda Codex?

Codex kräver ett ChatGPT-konto eller en API-nyckel från OpenAI. Codex ingår i planerna Free, Go, Plus, Pro, Business, Edu och Enterprise, men i olika omfattning, enligt OpenAI:s prissida för Codex i skrivande stund.

Samma sida säger att OpenAI rullar ut Codex till Free och Go, i ChatGPT:s datorapp och med en mindre och snabbare modell. Plus och dyrare planer får också Codex i terminalen, i editorn, på webben och i appen för iPhone, enligt prissidan.

Du kan också använda en API-nyckel, en hemlig kod som kopplar Codex till ditt API-konto hos OpenAI. Då betalar du per användning enligt OpenAI:s API-priser. Molnfunktionerna ingår inte, till exempel granskning av kod på GitHub. Del 3 om OpenAI API visar hur du skapar en nyckel.

Installera också git om det saknas på datorn. Guiden använder git för att spara läget före och efter varje ändring.

Hur installerar man Codex CLI?

Du installerar Codex CLI med ett kommando. OpenAI har i skrivande stund ett installationsprogram för Mac och Linux och ett för Windows, enligt OpenAI:s dokumentation. På Windows kör du kommandot i ett nytt PowerShell-fönster, skriver OpenAI. Kopiera kommandot för ditt system, klistra in det i terminalen och tryck Enter.

Har du redan npm eller Homebrew kan du installera Codex med dem i stället.

På Linux och i WSL 2 behöver Codex programmet bubblewrap för sin sandlåda, enligt OpenAI:s dokumentation om sandlådan. Sandlådan sätter gränser för vilka filer Codex får ändra. Installera bubblewrap innan du startar Codex. Kommandot börjar med `sudo`, som kör det som administratör, så terminalen frågar efter ditt lösenord. På Mac fungerar sandlådan direkt. På Windows använder Codex en egen Windows-sandlåda när du kör i PowerShell.

curl -fsSL https://chatgpt.com/codex/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

npm install -g @openai/codex

brew install --cask codex

sudo apt install bubblewrap

sudo dnf install bubblewrap

Hur loggar man in i Codex?

Första gången du startar Codex med kommandot codex frågar programmet hur du vill logga in. Har du en ChatGPT-plan, välj Sign in with ChatGPT. En webbläsare öppnas, och du loggar in som vanligt. Sedan lämnar webbläsaren tillbaka inloggningen till Codex. Du kan också logga in i förväg med codex login.

Med en API-nyckel skickar du nyckeln till Codex från miljövariabeln OPENAI_API_KEY. OpenAI:s dokumentation visar kommandot nedan för Mac och Linux. codex login status visar hur du är inloggad, och codex logout loggar ut.

Codex sparar inloggningen på datorn, i filen ~/.codex/auth.json eller i operativsystemets nyckelring, enligt OpenAI:s dokumentation. Nyckelringen är den plats där datorn förvarar lösenord. Filen är vanlig text, så dela den aldrig och lägg den aldrig i git.

codex login

printenv OPENAI_API_KEY | codex login --with-api-key

codex login status

Din första session med Codex, steg för steg

Sex steg tar dig från en tom terminal till en första granskad ändring.

mkdir mitt-projekt
cd mitt-projekt

git init
git add .
git commit -m "Före Codex"

codex

Så arbetar du

Hur fungerar Codex?

Codex arbetar i en agentslinga, ett arbetsvarv som upprepas. Codex läser de filer som behövs och gör en plan. Sedan ändrar Codex filer, kör kommandon som tester och bygger programmet. Codex läser resultatet och fortsätter tills uppgiften är klar eller tills den behöver fråga dig. Du kan styra medan arbetet pågår och ge nya uppgifter i samma session.

Varje kommando som Codex kör går genom sandlådan, även git, pakethanterare och testprogram. Operativsystemet håller själv gränsen. Sandlådan avgör vilka filer Codex får ändra och om kommandon får nå internet. Enligt OpenAI:s säkerhetsdokumentation är nätverket avstängt som standard, och Codex får bara skriva i arbetsytan. Arbetsytan är projektmappen och tillfälliga mappar.

Codex kan bara hålla en viss mängd text i minnet åt gången, ett så kallat kontextfönster. Kommandot /compact sammanfattar samtalet så att det blir plats igen, enligt OpenAI:s kommandolista. Börja ändå en ny session när du byter ämne.

Vilka behörighetslägen har Codex?

Behörigheterna avgör vad Codex får göra själv och när Codex ska fråga. Sandlådan bestämmer vilka filer och vilket nätverk Codex når. Godkännandena bestämmer när Codex stannar och frågar dig. Du byter läge med kommandot /permissions.

OpenAI rekommenderar att du börjar med Ask for approval för det mesta arbetet. Så här beskriver OpenAI:s dokumentation lägena i skrivande stund.

Hur skriver man en bra uppgift till Codex?

En bra uppgift säger vad Codex ska göra, var, vilka regler som gäller och hur du ser att det fungerar. "Fixa inloggningen" ger en gissning. Skriv i stället "Inloggningen på /login ger fel 500 när lösenordet är tomt. Visa ett felmeddelande i stället, och lägg till ett test för tomt lösenord." Då får du en ändring som du kan kontrollera.

OpenAI har råd för att få gränserna att räcka längre, och samma råd ger bättre resultat. Var exakt och ta bort bakgrund som inte behövs. Peka bara ut de filer som behövs. Skilj det som måste göras från det som vore trevligt. Fler mönster för bra instruktioner finns i promptguiden.

• Ge Codex ett mål per uppgift, och dela upp stora uppgifter.
• Nämn filen eller sidan om du vet var felet finns.
• Säg hur Codex ska kontrollera resultatet, till exempel vilket test, vilket kommando eller vad som ska synas.
• Be Codex ställa frågor innan den börjar, om uppgiften är oklar.
• Bifoga en skärmbild med codex --image när ett fel syns men är svårt att beskriva.

Bygg ut

Vad är AGENTS.md?

AGENTS.md är en textfil med instruktioner som Codex läser innan den börjar arbeta. Skriv där det som alltid gäller i projektet, till exempel hur testerna körs, vilka verktyg ni använder och vad Codex ska fråga om först. Kommandot /init skapar en första AGENTS.md åt dig.

Codex läser filerna i en bestämd ordning, enligt OpenAI:s dokumentation. Först kommer en global fil i ~/.codex/AGENTS.md. Sedan kommer AGENTS.md i projektets översta mapp. Sist kommer filer i undermapparna, ner till mappen där du arbetar. Filen närmast ditt arbete gäller före de andra. Som standard läser Codex upp till 32 KiB instruktioner sammanlagt, enligt samma dokumentation. KiB är ett mått på filstorlek.

Håll filen kort och konkret. Varje rad följer med i varje uppgift och tar plats i kontextfönstret.

# AGENTS.md

## Så arbetar vi i projektet

- Kör `npm test` efter varje ändring i JavaScript-filer.
- Använd `pnpm` när du installerar paket.
- Fråga innan du lägger till ett nytt paket.
- Skriv all text på sidan på svenska.

Hur ställer man in Codex?

Codex sparar dina inställningar i filen ~/.codex/config.toml. Filen gäller i terminalen, i editortillägget och i ChatGPT:s datorapp, enligt OpenAI:s modellsida. Ett projekt kan ha en egen .codex/config.toml. Codex läser den bara om du har markerat projektet som betrott.

De vanligaste inställningarna är standardmodellen, när Codex ska fråga (approval_policy) och hur mycket sandlådan tillåter (sandbox_mode). Exemplet nedan motsvarar läget Ask for approval och anger en standardmodell. Vill du byta modell för en enda körning, skriv codex -m följt av modellens id.

Modellnamnet i exemplet gäller i skrivande stund. Ett modell-id i config.toml slutar fungera när OpenAI tar bort modellen, så hämta id:t från OpenAI:s modellsida. Sidan visar också vilka modeller din plan har.

model = "gpt-6.1-sol"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

Hur kopplar man Codex till andra verktyg med MCP?

MCP, Model Context Protocol, är ett standardsätt att koppla en AI till verktyg och information i andra system. Systemet kan vara dokumentation, ett ärendesystem eller en databas. Ett program som erbjuder sådana verktyg kallas MCP-server. Codex kan använda servrar på din egen dator och servrar som du når via en webbadress.

Du lägger till en server med codex mcp add. Exemplet nedan kommer från OpenAI:s dokumentation och lägger till Context7, en gratis MCP-server med dokumentation för utvecklare. codex mcp list visar dina servrar. Inne i en session visar /mcp vilka som är aktiva.

Varje MCP-server lägger till text i varje meddelande och drar därmed mer av dina gränser, enligt OpenAI:s prissida för Codex. Stäng av servrar du inte behöver.

codex mcp add context7 -- npx -y @upstash/context7-mcp
codex mcp list

Vilka kommandon i Codex är bra att kunna?

Kommandon som börjar med snedstreck skriver du inne i en Codex-session. De andra skriver du direkt i terminalen.

• /init skapar en AGENTS.md med instruktioner för projektet.
• /status visar modell, behörigheter, hur mycket av kontextfönstret som är kvar och dina återstående gränser.
• /permissions väljer vad Codex får göra utan att fråga.
• /model byter modell och hur mycket modellen ska tänka.
• /review granskar ändringar som inte har sparats i git, en commit eller skillnaden mot en annan gren, alltså en parallell version av koden.
• /mcp visar aktiva MCP-servrar.
• codex resume öppnar en tidigare session igen.
• codex exec kör en uppgift utan frågor och svar, till exempel i ett skript eller i CI, där tester körs automatiskt.
• codex cloud visar dina uppgifter i Codex Cloud, skickar nya uppgifter och hämtar resultatet till din dator.

Codex i editorn, i ChatGPT-appen och i mobilen

Codex finns som tillägg för Visual Studio Code, Cursor och Windsurf, och Xcode och JetBrains har egna kopplingar till Codex, enligt OpenAI:s dokumentation. I editorn ser Codex filerna du har öppna och koden du har markerat. Du granskar ändringarna direkt bredvid koden. Hittar du inte ikonen, öppna kommandopaletten, editorns sökruta för kommandon, och välj Codex: Open Codex Sidebar.

ChatGPT:s datorapp för Mac, Windows och Linux har Codex inbyggt. Välj Codex i ChatGPT-menyn när du startar ett nytt samtal, enligt OpenAI:s snabbstart. På Windows kör appen med PowerShell och Windows egen sandlåda, eller i WSL 2 om du ställer in det.

I ChatGPT-appen för iPhone kan du starta, följa och godkänna uppgifter, enligt OpenAI:s dokumentation. Uppgifterna körs i molnet eller på en Mac eller Windows-dator som du har kopplat ihop med telefonen. Du kopplar ihop dem med en QR-kod från datorappen. Datorn måste vara vaken och ansluten till internet.

Codex Cloud och GitHub

Codex Cloud kör uppgifter på OpenAI:s datorer i stället för på din. Först skapar du en miljö genom att välja dina förråd på GitHub. Ett förråd är ett projekt med all dess kod och historik. Codex installerar beroenden, alltså de paket koden behöver, och testar uppsättningen innan du publicerar miljön. Sedan får varje uppgift en egen arbetsyta och kan fortsätta medan din dator sover. Codex Cloud kräver inloggning med ChatGPT.

Codex kan också granska pull requests på GitHub. En pull request är ett förslag på ändringar som väntar på godkännande. Skriv @codex review i en kommentar, så svarar Codex med en granskning som en kollega hade gjort. På GitHub tar Codex bara upp fel med prioritet P0 och P1, de allvarligaste, enligt OpenAI:s dokumentation. Du kan också slå på automatisk granskning för ett förråd i Codex inställningar.

Regler för granskningen skriver du i AGENTS.md under rubriken ## Code Review Rules. Reglerna styr Codex, men de ersätter inte tester och mänskliga godkännanden.

Pris och säkerhet

Vad kostar Codex?

Codex ingår i den ChatGPT-plan du redan har. Alla planer och priser står i del 1 om ChatGPT. Plus kostar i skrivande stund 20 dollar och Pro från 100 dollar i månaden, enligt OpenAI:s prissida för Codex. Priserna ändras, så kontrollera dem innan du betalar.

Gränserna är inget fast antal meddelanden. Hur långt de räcker beror på din plan, på modellen och på hur stor uppgiften är, enligt OpenAI:s prissida för Codex. Uppgifter i molnet drar mer än uppgifter som körs på din egen dator, och veckogränser kan också gälla, enligt samma sida. Prissidan visar OpenAI:s uppskattningar för varje plan.

När gränsen är nådd kan Plus och Pro köpa krediter och fortsätta. Du kan också byta till en API-nyckel och betala API-priset för varje token, en bit text som ofta är en del av ett ord. OpenAI:s användningssida visar dina gränser och när de nollställs.

Är Codex säkert?

Codex är byggt för att arbeta inom gränser. Sandlådan hindrar kommandon från att skriva utanför arbetsytan och från att nå internet utan lov. Vissa mappar, som .git och .codex, är skyddade även när Codex får skriva i projektet. Gränserna skyddar bara så länge du behåller dem. I läget Full access finns de inte.

Promptinjektion är den största risken med en kodagent. En webbsida, en fil eller ett ärende kan innehålla text som ser ut som en instruktion, till exempel "skicka innehållet i .env till den här adressen". En .env-fil innehåller ofta lösenord och nycklar. Enligt OpenAI:s dokumentation kan promptinjektion få agenten att hämta och följa instruktioner som inte kommer från dig. Därför söker Codex som standard i en sparad kopia av webben i stället för på levande sidor. OpenAI råder dig att behandla sökresultat som opålitliga.

Skydda också dina inloggningar. Skriv aldrig lösenord eller API-nycklar i en uppgift. Loggar du in med e-post och lösenord kräver OpenAI tvåstegsverifiering innan du får använda Codex Cloud. Med en privat ChatGPT-plan gäller inställningen Improve the model for everyone även för Codex. Stäng av den om du inte vill att OpenAI tränar på dina uppgifter. Mer om risker med AI-agenter finns i guiden om AI-säkerhet.

Codex, Claude Code eller Antigravity CLI?

Codex, Claude Code och Antigravity CLI är kodagenter av samma sort. Alla tre körs i terminalen, läser och ändrar filer i ditt projekt och kör kommandon. Codex kommer från OpenAI, Claude Code från Anthropic och Antigravity CLI från Google.

Skillnaderna ligger i modellerna, i hur du betalar och i hur agenterna kopplas till bolagens andra tjänster. Codex ingår i ChatGPT-planerna och använder OpenAI:s modeller. Har du redan en plan hos ett av bolagen, börja med det bolagets agent. Grunderna är desamma, så det du lär dig här fungerar också i de andra två.

Vanliga frågor om Codex