Klucz API Codex VS Code: Użyj niestandardowego endpointu

Konfiguracja

Asystenci programistyczni w VS Code komunikują się z modelem przez HTTP. Większość z nich obsługuje format API OpenAI, co oznacza, że akceptują niestandardowy bazowy URL i klucz zamiast domyślnej konfiguracji dostawcy. Ta usługa jest kompatybilna z OpenAI, więc podłączy się do dowolnego narzędzia oferującego tę opcję.

Bądź świadomy tego, co znajduje się po drugiej stronie. To jeden model o otwartych wagach uruchamiany przez niezależnego dostawcę, dostrojony do odpowiadania bez odmów treści do zgodnego z prawem użytku przez dorosłych. To nie jest model Codex OpenAI ani oficjalne API żadnego innego dostawcy. Obsługuje tylko tekst, ma okno 100 000 tokenów, wywoływanie funkcji i tryb JSON. Jeśli chcesz poznać szczegóły tras w stylu OpenAI, przeczytaj dokumentację; jeśli potrzebujesz tylko adresu, zobacz stronę bazowego URL API Codex.

Oto trzy wartości, których należy używać wszędzie:

Pobierz klucz i przetestuj go najpierw

Utwórz konto na stronie klucza API za pomocą Google lub e-maila i hasła. Nowi użytkownicy mogą jednym kliknięciem uzyskać $0,50 darmowego kredytu próbnego ważnego przez 7 dni, bez karty. Następnie przetestuj klucz w terminalu przed przejściem do VS Code. Działające polecenie curl potwierdza klucz i URL, więc późniejsze błędy będą dotyczyły rozszerzenia.

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

Odpowiedź to JSON ukończeń czatu, a odpowiedź zawiera nagłówek X-Balance-USD z Twoim pozostałym kredytem. Przechowuj klucz w zmiennej środowiskowej lub w tajnym magazynie rozszerzenia, nigdy w repozytorium.

Rozszerzenie i CLI Codex: plik konfiguracyjny

Narzędzia Codex od OpenAI obsługują niestandardowych dostawców modeli poprzez plik konfiguracyjny TOML w katalogu domowym, a rozszerzenie VS Code ma w dokumentacji, że udostępnia tę konfigurację z CLI. Zweryfikuj to w bieżącej dokumentacji Codex dla swojej wersji, ponieważ format uległ zmianie.

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

Punkty do sprawdzenia:

• base_url kończy się na /v1, bez /chat/completions.
• env_key to nazwa zmiennej środowiskowej, a nie sam klucz.
• wire_api wybiera format zapytania. Usługa akceptuje zarówno POST /v1/chat/completions, jak i POST /v1/responses. Spróbuj najpierw "chat"; użyj "responses", jeśli Twoja wersja Codex tego wymaga.
• Uruchom VS Code z powłoki, w której ustawiona jest zmienna, lub zrestartuj ją po dodaniu zmiennej do profilu. Uruchomienie GUI na macOS często nie widzi zmiennych z powłoki.

Narzędzia typu agent polegają na wywoływaniu funkcji. Jest to tutaj obsługiwane, w tym strumieniowane wywoływania funkcji, ale jakość zależy od modelu, więc najpierw uruchom małe zadanie. Powiązana strona o używaniu API w Cursor obejmuje podobną konfigurację w innym edytorze.

Continue, Cline i inne rozszerzenia

Każde rozszerzenie firm trzecich ma swój własny ekran, ale wzorzec jest stały: wybierz dostawcę OpenAI lub "OpenAI-compatible", a następnie wypełnij bazowy URL, klucz i model. Continue używa konfiguracji YAML:

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline i Roo Code oferują dostawcę "OpenAI Compatible" w panelu ustawień z tymi samymi trzema polami. Nazwy i menu często się zmieniają, więc wyszukaj w dokumentacji rozszerzenia "OpenAI compatible" lub "custom base URL". Jeśli rozszerzenie nie ma pola dla bazowego URL, nie może użyć tego endpointu.

Wskazówki oszczędzające czas:

• Wyłącz autouzupełnianie zakładek względem modelu hostowanego, chyba że chcesz wysyłać zapytanie przy każdej pauzie. Czat i akcje edycji są tańsze.
• Ustaw mniejsze okno kontekstu w rozszerzeniu do codziennych edycji. Wysyłanie całych repozytoriów do modelu kosztuje tokeny wejściowe za każdym razem.
• Używaj oddzielnego klucza dla każdego narzędzia, aby wiedzieć, które zużywa Twój kredyt.

Jakie zadania w edytorze pasują do tego modelu

Ogólny model tekstu z dużym oknem jest dobrym dopasowaniem do kilku codziennych zadań: wyjaśniania nieznanego kodu, pisania testów jednostkowych dla funkcji, konwersji skryptu między językami, tworzenia docstringów i regexów oraz przepisywania modułu, gdy wklejasz cały plik. Okno 100 000 tokenów oznacza, że kilka średnich plików plus Twoje instrukcje mieszczą się w jednym zapytaniu, a uzupełnienie może użyć tego, co zostało.

Bądź realistyczny co do reszty. To nie jest wyspecjalizowany model programistyczny z treningiem zorientowanym na edytor, więc długie uruchomienia agentów na wielu plikach mogą wymagać więcej wskazówek i weryfikacji niż w przypadku narzędzi zbudowanych specjalnie do tego celu. Żądaj różnic (diffs) zamiast całych plików, przeglądaj każdą zmianę przed jej zaakceptowaniem i uruchamiaj testy. Jeśli zadanie wymaga treści, której zablokuje asystent z filtrami, np. pisania szkieletu literatury dla dorosłych lub tekstu do badań bezpieczeństwa w celach zgodnych z prawem, endpoint bez odrzuceń treści jest powodem, by wybrać ten.

Koszt w edytorze

Ceny to $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych. Narzędzia kodujące wysyłają dużo kontekstu, więc spójrz najpierw na wejście.

Przykład: zapytanie edycyjne z kontekstem pliku o długości 8 000 tokenów i odpowiedzią 600-tokenową kosztuje 8 000 x $0,15 / 1M + 600 x $0,50 / 1M = $0,0012 + $0,0003 = $0,0015. Dzień 150 takich zapytań kosztuje 150 x $0,0015 = $0,225. Dwadzieścia dni roboczych: $4,50.

Agent, który czyta wiele plików, może wysyłać 40 000 tokenów na krok. Przy takim rozmiarze jeden krok kosztuje $0,006 plus koszt outputu, więc 100 kroków kosztuje około $0,60 plus output. Zwracaj uwagę na pętle agentów. Zapytania nieudane lub odrzucone nie są rozliczane, a kredyt nigdy nie wygasa. Doładowania od $20 do $500 można opłacić kartą (Visa, Mastercard, Apple Pay, Google Pay) lub kryptowalutami. Aktualne plany znajdziesz na stronie z cenami.

Rozwiązywanie problemów

401 Nieautoryzowany

Klucz jest brakujący, ma przypadkową spację lub zmienna środowiskowa nie jest widoczna dla VS Code. Zrestartuj edytor z terminala, w którym ustawiona jest zmienna.

404 lub "model nie znaleziony"

Użyj dokładnego modelu uncensored i bazowego URL z /v1 na końcu.

Błędy 429

Pełny klucz pozwala na 8 równoległych zapytań i 300 na minutę; klucz próbny pozwala na 2 i 60. Rozszerzenie, które wysyła kilka równoległych zapytań, np. autouzupełnianie plus czat, może osiągnąć limit współbieżności. Kod błędu to concurrency za zbyt wiele naraz i rate_limited za limity na minutę. Nagłówek Retry-After: 5 oznacza tymczasowe przeciążenie.

Zawieszenia strumieniowania

Niektóre korporacyjne serw-proxy buforują zdarzenia wysłane przez serwer. Przetestuj z innej sieci lub wyłącz strumieniowanie w rozszerzeniu.

Odpowiedzi różnią się od tego, co widziałeś z innym asystentem

To oczekiwane. To inny model z własnymi mocnymi stronami. Daj mu jasne, konkretne instrukcje i przetestuj go na kodzie z własnego projektu.

Więcej przewodników

• API Codex w Pythonie: Wywoływanie LLM do kodowania
• Base URL API Codex: Jak skierować klienta do naszego