Użyj Codex z CometAPI

Skorzystaj z tego przewodnika, aby uruchomić Codex z CometAPI jako dostawcą modeli. Oficjalne materiały:

Wymagania wstępne

Wymaganie	Szczegóły
OS	macOS, Linux, natywny Windows PowerShell lub Windows z WSL
Git	Zalecana wersja 2.23+
Codex	Zainstaluj aplikację Codex lub Codex CLI zgodnie z Codex quickstart
CometAPI API key	Pobierz go z panelu CometAPI
Model ID	Użyj model ID ze strony modeli

Wybierz sposób konfiguracji

Udostępniamy dwie opcje, aby pomóc Ci szybko skonfigurować Codex.

Opcja 1: Skonfiguruj Codex ręcznie (zalecane)

Edytuj bezpośrednio plik ~/.codex/config.toml na poziomie użytkownika. To najbardziej niezawodna ścieżka, szczególnie dla użytkowników Windows i WSL.

Opcja 2: Skonfiguruj za pomocą skryptu

Uruchom skrypt konfiguracyjny jako skrót. Zapisuje on tę samą konfigurację dostawcy i przechowuje CometAPI API key dla Codex.

Skonfiguruj Codex ręcznie

Codex odczytuje domyślne ustawienia dostawcy z pliku ~/.codex/config.toml na poziomie użytkownika. Skonfiguruj tam dostawcę CometAPI, a nie w projektowym pliku .codex/config.toml. Codex ignoruje ustawienia provider i provider-auth w projektowych plikach konfiguracyjnych. Zalecana konfiguracja używa nazwanego dostawcy cometapi oraz uwierzytelniania opartego na poleceniu. Dzięki temu CometAPI pozostaje oddzielone od wbudowanego dostawcy OpenAI, nie wymaga dziedziczenia zmiennych środowiskowych powłoki i nie zastępuje ~/.codex/auth.json.

macOS / Linux / WSL
Windows PowerShell

Zapisz swój klucz API CometAPI w lokalnym pliku z kluczem:

mkdir -p "$HOME/.codex"
printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
chmod 600 "$HOME/.codex/cometapi_key"

Dodaj tę konfigurację do ~/.codex/config.toml:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "sh"
args = ["-c", "cat \"$HOME/.codex/cometapi_key\""]

Zapisz swój klucz API CometAPI w katalogu domowym Codex w systemie Windows:

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY

Dodaj tę konfigurację do $HOME\.codex\config.toml:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "powershell.exe"
args = [
  "-NoProfile",
  "-Command",
  "$p=Join-Path $HOME '.codex/cometapi_key'; (Get-Content -Raw $p).Trim()",
]

Natywny Codex w systemie Windows używa $HOME\.codex, zwykle C:\Users\<user>\.codex. WSL używa ~/.codex z dystrybucji Linux. Edytuj katalog odpowiadający środowisku, w którym działa agent Codex.

Użyj uwierzytelniania za pomocą zmiennej środowiskowej

Jeśli wolisz przechowywać klucz API CometAPI w zmiennej środowiskowej, użyj env_key zamiast bloku [model_providers.cometapi.auth]. Używaj tej konfiguracji dostawcy tylko wtedy, gdy COMETAPI_KEY jest dostępny w środowisku uruchamiającym Codex:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"
env_key = "COMETAPI_KEY"

Nie łącz env_key z [model_providers.cometapi.auth]. Codex obsługuje jedną metodę uwierzytelniania na niestandardowego dostawcę.

Uruchom skrypt konfiguracji

Skrypt konfiguracji jest opcjonalny. Zapisuje tę samą konfigurację providera cometapi do ~/.codex/config.toml, przechowuje Twój klucz API CometAPI w ~/.codex/cometapi_key, tworzy kopie zapasowe przed zmianami plików i weryfikuje konfigurację za pomocą codex exec, gdy dostępny jest Codex CLI. W przypadku macOS, Linux lub WSL uruchom interaktywny instalator:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"

W przypadku konfiguracji nieinteraktywnej przekaż klucz API jawnie:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"

W przypadku natywnego Windows PowerShell uruchom interaktywny instalator:

powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"

W przypadku nieinteraktywnej konfiguracji w Windows przekaż klucz API jawnie:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"

Domyślnie skrypt nie zastępuje ~/.codex/auth.json i nie usuwa logowania ChatGPT. Używaj --force-auth-json lub -ForceAuthJson tylko wtedy, gdy chcesz, aby skrypt zarządzał logowaniem Codex z użyciem klucza API przez auth.json.

Wybierz lub zmień model ID

Użyj model ID ze strony Models. W konfiguracji ręcznej zmień wartość model w ~/.codex/config.toml. W przypadku macOS, Linux lub WSL przekaż --model podczas uruchamiania skryptu konfiguracji:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id

W przypadku natywnego Windows PowerShell przekaż -Model podczas uruchamiania skryptu konfiguracji:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"

Skrypt używa CODEX_HOME, jeśli jest ustawione. W przeciwnym razie zapisuje do ~/.codex bieżącego środowiska.

Zweryfikuj konfigurację

Aby zweryfikować konfigurację za pomocą Codex CLI, uruchom to polecenie tylko do odczytu z dowolnego lokalnego projektu:

codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"

Jeśli Codex CLI nie jest dostępny w PATH, otwórz aplikację Codex i wyślij krótki Prompt z lokalnego projektu.

Rozwiązywanie problemów

Codex nadal używa domyślnego dostawcy OpenAI

Upewnij się, że model_provider = "cometapi" znajduje się w pliku ~/.codex/config.toml na poziomie użytkownika.

Klucz API się zmienił

Zaktualizuj ~/.codex/cometapi_key albo ponownie uruchom skrypt konfiguracji ze zaktualizowaną wartością $COMETAPI_KEY.

Skrypt PowerShell kończy się niepowodzeniem podczas kontroli wstępnych

Użyj ręcznych natywnych kroków PowerShell dla Windows, a następnie uruchom polecenie weryfikacyjne.

Konfiguracja shella przez potok nie prosi o klucz API

Użyj --key "$COMETAPI_KEY", ustaw COMETAPI_KEY albo uruchom interaktywne polecenie sh -c "$(curl ...)".

Połączenie przekracza limit czasu lub używa nieprawidłowego base URL

Upewnij się, że base_url ma wartość https://api.cometapi.com/v1 w ~/.codex/config.toml.

Model nie został znaleziony

Sprawdź stronę Models, aby zobaczyć dostępne model IDs.

Konfiguracja Windows wpływa na niewłaściwe środowisko

Edytuj $HOME\.codex dla natywnego trybu Windows albo edytuj ~/.codex wewnątrz WSL dla trybu agenta WSL.

Zmieniło się logowanie ChatGPT

Nie używaj --force-auth-json ani -ForceAuthJson, chyba że chcesz korzystać z trybu logowania za pomocą klucza API.

Przegląd

Agenci AI do programowania

Agenci AI

Klienci czatu AI

Tłumaczenie i język

Platformy automatyzacji

Obserwowalność i ewaluacja

Frameworki AI

Wymagania wstępne

Wybierz sposób konfiguracji

Opcja 1: Skonfiguruj Codex ręcznie (zalecane)

Opcja 2: Skonfiguruj za pomocą skryptu

Skonfiguruj Codex ręcznie

Użyj uwierzytelniania za pomocą zmiennej środowiskowej

Uruchom skrypt konfiguracji

Wybierz lub zmień model ID

Zweryfikuj konfigurację

Rozwiązywanie problemów

​Wymagania wstępne

​Wybierz sposób konfiguracji

Opcja 1: Skonfiguruj Codex ręcznie (zalecane)

Opcja 2: Skonfiguruj za pomocą skryptu

​Skonfiguruj Codex ręcznie

​Użyj uwierzytelniania za pomocą zmiennej środowiskowej

​Uruchom skrypt konfiguracji

​Wybierz lub zmień model ID

​Zweryfikuj konfigurację

​Rozwiązywanie problemów

Wymagania wstępne

Wybierz sposób konfiguracji

Skonfiguruj Codex ręcznie

Użyj uwierzytelniania za pomocą zmiennej środowiskowej

Uruchom skrypt konfiguracji

Wybierz lub zmień model ID

Zweryfikuj konfigurację

Rozwiązywanie problemów