Przejdź do głównej treści
Użyj tego przewodnika, aby uruchomić Codex CLI z CometAPI jako providerem modeli. Oficjalne materiały:
Dostępność modeli często się zmienia. Poniższe przykłady używają your-model-id — zastąp go aktualnym identyfikatorem modelu odpowiednim do kodowania z strony modeli CometAPI.

Wymagania wstępne

WymaganieSzczegóły
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+) lub Windows 11 przez WSL2
Node.js22+ (zalecana wersja LTS)
Gitzalecana wersja 2.23+
Klucz CometAPIPobierz go z CometAPI Dashboard (zaczyna się od sk-)

Zainstaluj Codex CLI

npm i -g @openai/codex
Lub przez Homebrew:
brew install --cask codex
Sprawdź instalację:
codex --version

Skonfiguruj CometAPI

Są dwa sposoby, aby skierować Codex do CometAPI. Wybierz ten, który najlepiej pasuje do Twojego workflow.
Najprostsza opcja — przekieruj wbudowanego providera OpenAI do CometAPI jedną linią. Nie trzeba definiować niestandardowego providera.Utwórz ~/.codex/config.toml:
model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Zapisz swój klucz API

Utwórz ~/.codex/auth.json:
{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
Zastąp sk-your-cometapi-key swoim rzeczywistym kluczem CometAPI.
Ten plik jest wymagany. Bez prawidłowego wpisu OPENAI_API_KEY w auth.json Codex zakończy działanie z błędem API key auth is missing a key.

Uruchom Codex

cd your-project
codex
Przy pierwszym uruchomieniu Codex poprosi Cię o wybór motywu i potwierdzenie ustawień bezpieczeństwa.

Nadpisanie modelu dla pojedynczej sesji

Przełącz się na inny model dla jednego uruchomienia bez edytowania config.toml:
codex --model your-model-id

Alternatywa: zmienna środowiskowa

Zamiast auth.json, wyeksportuj klucz bezpośrednio:
export OPENAI_API_KEY="sk-your-cometapi-key"
codex
To ustawia klucz tylko dla bieżącej sesji terminala. Aby zachować ustawienie na stałe, dodaj linię export do ~/.zshrc lub ~/.bashrc.

Rozwiązywanie problemów

ObjawRozwiązanie
API key auth is missing a keyUpewnij się, że ~/.codex/auth.json zawiera "OPENAI_API_KEY": "sk-..."
Nieoczekiwanie pojawia się monit logowaniaUsuń nieaktualny plik ~/.codex/auth.json i utwórz go ponownie z kluczem CometAPI
Nie znaleziono modeluSprawdź stronę modeli, aby zobaczyć aktualnie dostępne modele
Przekroczenie czasu połączeniaSprawdź, czy openai_base_url lub base_url w config.toml to https://api.cometapi.com/v1
Problemy w WindowsCodex wymaga WSL2 w Windows — natywny CMD/PowerShell nie jest obsługiwany