Skip to main content
Codex är en programmeringsagent från OpenAI. Förutom terminal-CLI erbjuder den även ett VS Code-tillägg som låter dig chatta, läsa filer, referera kontext, generera ändringar och förhandsgranska dem i sidopanelen i editorn. Denna guide beskriver hur du konfigurerar och använder Codex-tillägget i VS Code via Ace Data Cloud:s OpenAI Responses-kompatibla proxy. Codex VS Code-tillägget och Codex CLI använder samma lokala konfigurationssystem, så genom att peka ~/.codex/config.toml till Ace Data Cloud kan Codex i VS Code använda https://api.acedata.cloud/v1.

Ansökningsprocess

För att använda Codex kan du först gå till Ace Data Cloud-konsolen och hämta din API-token för framtida bruk. Om du inte är inloggad eller registrerad omdirigeras du automatiskt till inloggningssidan där du kan registrera dig och logga in. Efter inloggning återvänder du automatiskt till aktuell sida. Vid första ansökan får du en gratis kvot för att prova Codex-tjänsten kostnadsfritt.

Installera Codex-tillägget

Sök efter Codex i VS Codes tilläggsmarknad och installera OpenAI:s Codex - OpenAI’s coding agent-tillägg. Marketplace-ID är:
Du kan även installera via kommandoraden:
När installationen är klar, starta om eller ladda om VS Code. Om du inte ser Codex-ikonen kan du öppna kommandopaletten (macOS: Cmd+Shift+P, Windows/Linux: Ctrl+Shift+P) och köra:
Codex visas som standard i högra sidopanelen i VS Code. Du kan även dra den till vänstra aktivitetsfältet.

Installera Codex CLI (för verifiering)

Enligt officiell dokumentation använder Codex VS Code-tillägget och Codex CLI samma konfigurationslager. För att verifiera API-token och modell innan du konfigurerar VS Code rekommenderas att installera Codex CLI. Ett rekommenderat sätt är att installera via npm, vilket kräver Node.js 18 eller senare:
macOS-användare kan även installera via Homebrew:
Efter installation, kontrollera att kommandot fungerar:
Om du endast vill använda VS Code-tillägget kan du hoppa över CLI-verifieringen; samma ~/.codex/config.toml används ändå.

Konfigurera Ace Data Cloud API

Codex VS Code-tillägget och Codex CLI delar konfigurationsfil. Som standard uppmanar Codex att logga in med OpenAI-konto eller konfigurera officiell API-nyckel. För att använda Ace Data Cloud behöver du konfigurera API-token och ~/.codex/config.toml.

Steg 1: Sätt miljövariabel

Det rekommenderas att skriva API-token i din shell-konfigurationsfil, t.ex. ~/.zshrc, ~/.bashrc eller ~/.bash_profile:
Byt ut {token} mot din API-token från Ace Data Cloud-konsolen. Efter konfiguration, öppna terminalen på nytt eller kör source för att ladda inställningarna omedelbart:
Om VS Code redan är öppet, starta om eller ladda om det för att tillägget ska läsa in den nya miljövariabeln.

Steg 2: Redigera Codex-konfigurationsfilen

Användarkonfigurationsfilen för Codex finns i ~/.codex/config.toml. Om filen inte finns, skapa den:
Skriv in följande konfiguration:
Fältförklaringar: Du kan också klicka på kugghjulet uppe till höger i Codex-tillägget och välja Codex Settings > Open config.toml för att öppna konfigurationsfilen direkt i VS Code.

Projekt-specifik konfiguration

Om du vill använda en annan konfiguration för ett specifikt projekt kan du skapa .codex/config.toml i projektets rotmapp. Codex prioriterar projektkonfiguration, men projektet måste vara markerat som trusted för att ladda .codex/-konfigurationen. Exempel:
Det rekommenderas att lägga personliga tokens i miljövariabler och inte i projektets repository. Projektets .codex/config.toml bör hanteras enligt teamets policy.

Rensa cachad OpenAI-inloggning

Om du tidigare loggat in med OpenAI-konto i Codex-tillägget kan lokal inloggningsstatus finnas kvar. Innan du byter till Ace Data Cloud-proxy kan du köra i terminalen:
Om kommandot inte finns kan du ta bort cachefilen manuellt:
Starta om eller ladda om VS Code efteråt.

Grundläggande användning

När konfigurationen är klar, öppna Codex-panelen i VS Code (vänster eller höger sida) och skriv in din fråga eller uppgift, t.ex.:
Codex-tillägget kan använda filer och markerad kod i editorn som kontext. Du kan även referera filer i inmatningsfältet med @, t.ex.:
Om du markerar kod kan du via kommandopaletten köra:
Eller:
för att lägga till hela filen i kontexten.

Byta modell och inferensintensitet

Codex VS Code-tillägget låter dig byta modell och justera reasoning effort via en modellväljare under inmatningsfältet. Vid användning av Ace Data Cloud rekommenderas att först ange standardmodell i ~/.codex/config.toml och sedan byta vid behov i gränssnittet. Rekommenderade standarder: Om önskad modell inte visas i gränssnittet kan du ändra model i ~/.codex/config.toml och starta om eller ladda om VS Code. Komplett modellista finns i Ace Data Cloud OpenAI-dokumentation.

Välj arbetsläge

Codex-tillägget stödjer olika arbetslägen. Vanliga lägen: För dagligt bruk rekommenderas Agent med approval_policy = "on-request". Då frågar Codex om bekräftelse innan känsliga kommandon, åtkomst utanför arbetsytan eller nätverksanrop.

Verifiera konfiguration

Du kan verifiera att Codex fungerar med Ace Data Cloud i terminalen:
Om konfigurationen är korrekt bör du få svaret:
Gå sedan tillbaka till VS Code, öppna Codex-panelen och skriv en enkel fråga:
Du kan även se förfrågningshistorik och kostnadsdetaljer i Ace Data Cloud-konsolen - Användningshistorik och återstående kvot i Ace Data Cloud-konsolen - Applikationslista.

Hur det fungerar

Codex VS Code-tillägget är inte en separat modellkonfiguration. Det använder den lokala Codex CLI:n och delar konfigurationslager:
  1. VS Code-tillägget startar Codex och läser användarens ~/.codex/config.toml.
  2. Om projektet är trusted och innehåller .codex/config.toml laddas även projektkonfiguration.
  3. Om model_provider är acedatacloud läser Codex API-token från ACEDATACLOUD_API_KEY.
  4. Förfrågningar skickas via OpenAI Responses-protokollet till https://api.acedata.cloud/v1/responses.
  5. Ace Data Cloud verifierar identitet, kontrollerar kvot, vidarebefordrar förfrågningar och loggar användning.
Därför behöver du normalt bara konfigurera en gång. När terminal-CLI är verifierad använder VS Code-tillägget samma inställningar.

Läs mer