- Codex hurtigstart
- Grunnleggende Codex-konfigurasjon
- Egendefinerte model providers i Codex
- Codex-autentisering
- Codex på Windows
Forutsetninger
Velg en oppsettsvei
Vi tilbyr to alternativer for å hjelpe deg med å konfigurere Codex raskt.Alternativ 1: Konfigurer Codex manuelt (anbefalt)
Rediger
~/.codex/config.toml-filen på brukernivå direkte. Dette er den mest pålitelige fremgangsmåten, spesielt for Windows- og WSL-brukere.Alternativ 2: Konfigurer via skript
Kjør oppsettskriptet som en snarvei. Det skriver den samme provider-konfigurasjonen og lagrer CometAPI API key for Codex.
Konfigurer Codex manuelt
Codex leser personlige standardinnstillinger for providere fra filen~/.codex/config.toml på brukernivå. Konfigurer CometAPI-provideren der, ikke i en prosjektfil .codex/config.toml. Codex ignorerer innstillinger for provider og provider-auth i prosjektkonfigurasjonsfiler.
Det anbefalte oppsettet bruker en navngitt cometapi provider og kommandobasert autentisering. Dette holder CometAPI adskilt fra den innebygde OpenAI-provideren, krever ikke arv av shell-miljøvariabler og erstatter ikke ~/.codex/auth.json.
- macOS / Linux / WSL
- Windows PowerShell
Lagre CometAPI API-nøkkelen din i en lokal nøkkelfil:Legg til denne konfigurasjonen i
~/.codex/config.toml:Windows-native Codex bruker
$HOME\.codex, vanligvis C:\Users\<user>\.codex. WSL bruker Linux-distribusjonens ~/.codex. Rediger katalogen som samsvarer med miljøet der Codex-agenten kjører.Bruk autentisering med miljøvariabel
Hvis du foretrekker å beholde CometAPI API-nøkkelen i en miljøvariabel, brukenv_key i stedet for blokken [model_providers.cometapi.auth].
Bruk denne provider-konfigurasjonen bare når COMETAPI_KEY er tilgjengelig i miljøet som starter Codex:
Kjør oppsettsskriptet
Oppsettsskriptet er valgfritt. Det skriver den sammecometapi-leverandørkonfigurasjonen til ~/.codex/config.toml, lagrer CometAPI API-nøkkelen din i ~/.codex/cometapi_key, oppretter sikkerhetskopier før filendringer og verifiserer konfigurasjonen med codex exec når Codex CLI er tilgjengelig.
For macOS, Linux eller WSL, kjør det interaktive installasjonsprogrammet:
Velg eller endre en model ID
Bruk en model ID fra Models-siden. I manuell konfigurasjon endrer dumodel-verdien i ~/.codex/config.toml.
For macOS, Linux eller WSL, oppgi --model når du kjører oppsettsskriptet:
-Model når du kjører oppsettsskriptet:
Skriptet bruker
CODEX_HOME når den er satt. Ellers skriver det til ~/.codex i det gjeldende miljøet.Verifiser oppsettet
For å verifisere oppsettet med Codex CLI, kjør denne skrivebeskyttede kommandoen fra et hvilket som helst lokalt prosjekt:PATH, åpner du Codex-appen og sender en kort Prompt fra et lokalt prosjekt.
Feilsøking
Codex bruker fortsatt standard OpenAI-leverandøren
Codex bruker fortsatt standard OpenAI-leverandøren
Bekreft at
model_provider = "cometapi" finnes i brukerfilen ~/.codex/config.toml.API-nøkkelen er endret
API-nøkkelen er endret
Oppdater
~/.codex/cometapi_key, eller kjør oppsettskriptet på nytt med den oppdaterte verdien for $COMETAPI_KEY.PowerShell-skriptet mislykkes under kontrollene før kjøring
PowerShell-skriptet mislykkes under kontrollene før kjøring
Bruk de manuelle, Windows-native PowerShell-trinnene, og kjør deretter verifiseringskommandoen.
Det oppsatte shell-oppsettet ber ikke om noen API-nøkkel
Det oppsatte shell-oppsettet ber ikke om noen API-nøkkel
Bruk
--key "$COMETAPI_KEY", sett COMETAPI_KEY, eller kjør den interaktive kommandoen sh -c "$(curl ...)".Tilkoblingen får tidsavbrudd eller bruker feil base-URL
Tilkoblingen får tidsavbrudd eller bruker feil base-URL
Bekreft at
base_url er https://api.cometapi.com/v1 i ~/.codex/config.toml.Modellen ble ikke funnet
Modellen ble ikke funnet
Sjekk Models-siden for tilgjengelige model IDs.
Windows-oppsettet påvirker feil miljø
Windows-oppsettet påvirker feil miljø
Rediger
$HOME\.codex for Windows-native modus, eller rediger ~/.codex i WSL for WSL agent-modus.ChatGPT-innloggingen ble endret
ChatGPT-innloggingen ble endret
Ikke bruk
--force-auth-json eller -ForceAuthJson med mindre du ønsker innloggingsmodus med API-nøkkel.