Strona głównaPrzewodnik
Konfiguracja endpointu dla Claude Code API w Cursor
Szukasz konfiguracji Claude Code API dla Cursor, która nie zależy od jednego dostawcy? Cursor może komunikować się z każdym endpointem kompatybilnym z OpenAI, a ten poradnik pokaże Ci wszystkie potrzebne ustawienia.
Zaktualizowano

Konfiguracja
Cursor to edytor z wbudowanymi funkcjami AI. W jego ustawieniach modeli znajduje się pole, które pozwala zastąpić bazowy URL OpenAI własnym, oraz miejsce na wpisanie własnego klucza. Dzięki temu możliwe jest wysyłanie zapytań do dowolnej usługi obsługującej format chat-completions OpenAI. Ta usługa go obsługuje, więc Cursor może go używać jako modelu do czatu i edycji inline.
Wartości, które wpiszesz, są stałe. Bazowy URL: https://api.claudecodeapikey.com/v1. Nazwa modelu: uncensored. Klucz: ten z Twojego konta, wysyłany jako token Bearer. Nic więcej nie wymaga konfiguracji po stronie serwera.
Bądź jasny co do tego, czym to jest. Modelem za endpointem jest model o otwartych wagach od niezależnego dostawcy. To nie jest model Claude ani nie jest oficjalnym API Anthropic ani nikogo innego. Jeśli przyszedłeś tu oczekując Claude wewnątrz Cursor, to inna rzecz, a końcowe sekcje wyjaśniają, jak ocenić, czy jest wystarczająco dobry do Twojej pracy.
Zanim otworzysz Cursor
Przygotuj to najpierw, żeby nie zatrzymać się w połowie.
- Utwórz konto z Google lub e-mailem i hasłem.
- Otwórz stronę klucza API i utwórz klucz. przewodnik po kluczu pokazuje, gdzie znajduje się każdy przycisk.
- Zdobądź $0,50 kredytu próbnego, jeśli chcesz przetestować bez płacenia. To jedno kliknięcie, nie wymaga karty i trwa 7 dni.
- Wykonaj szybki test z terminala, aby upewnić się, że klucz działa, zanim obwinisz edytor.
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
Odpowiedź JSON z wiadomością oznacza, że klucz i URL są dobre. HTTP 401 oznacza, że klucz jest zły lub ma przypadkową spację. Napraw to tutaj, ponieważ komunikaty błędów Cursor są mniej szczegółowe niż curl.
Konfiguracja krok po kroku w Cursor
Nazwy menu zmieniają się między wersjami Cursor, więc traktuj poniższe etykiety jako przewodnik i szukaj najbliższego dopasowania.
- Otwórz ustawienia Cursora i przejdź do sekcji modeli.
- Znajdź pole na klucz API OpenAI i wklej swój klucz z tej usługi.
- Włącz opcję nadpisania bazowego URL OpenAI i wpisz
https://api.claudecodeapikey.com/v1. Uwzględnij/v1na końcu i usuń dowolną ścieżkę końcową taką jak/chat/completions. - Użyj opcji dodania niestandardowego modelu i wpisz
uncensoreddokładnie, małymi literami. - Naciśnij przycisk weryfikacji lub zapisu obok pola klucza. Cursor wysyła małe zapytanie testowe.
- Otwórz panel czatu, wybierz
uncensoredw rozwijanej liście modeli i wyślij krótki prompt.
Jeśli krok weryfikacji się nie powiedzie, ale test curl przeszedł pomyślnie, sprawdź, czy wpisałeś URL w pole Base URL, a nie w pole klucza, oraz czy wersja Cursora nie zresetowała nadpisania po aktualizacji. Przewodnik quickstart zawiera aktualne kroki dla tego edytora.
Jedna rzecz warta poznania: pojedyncze nadpisanie dotyczy slotu dostawcy OpenAI. Jeśli używasz również prawdziwych modeli OpenAI przez ten slot, będą teraz kierowane na ten endpoint też. Wiele osób utrzymuje osobny profil Cursor lub wyłącza nadpisanie, gdy chcą przełączyć się z powrotem.
Test z prawdziwym promptem kodowania
Pozdrowienie niewiele dowodzi. Użyj promptu, który wykorzystuje kontekst i instrukcje. Wybierz funkcję w swoim projekcie, otwórz czat i poproś o coś konkretnego, np. dodanie walidacji wejścia i testu jednostkowego. Śledź trzy rzeczy.
- Strumieniowanie. Odpowiedź powinna pojawiać się token po tokenie. Endpoint strumieniuje przez SSE, więc długie oczekiwanie, po którym następuje blok tekstu, sugeruje, że proxy lub ustawienie buforuje go.
- Użycie kontekstu. Dołącz dwa lub trzy pliki i zadaj pytanie, które wymaga wszystkich z nich. Okno kontekstu ma 100 000 tokenów, co mieści dużo kodu źródłowego, ale Twój edytor decyduje, ile faktycznie wysyła.
- Podążanie za instrukcjami. Poproś o odpowiedź tylko z diffem lub o ścisły format wyjściowy i sprawdź, czy model się go trzyma. Modele o otwartych wagach różnią się w tym zakresie, a chcesz go poznać od pierwszego dnia.
Utrzymuj krótką listę pięciu prawdziwych zadań ze swojego repozytorium i uruchamiaj je ponownie, gdy zmieniasz takie ustawienia jak temperatura. Ocena na podstawie własnego kodu bije dowolne ogólne twierdzenie, w tym nasze.
Naprawianie typowych błędów
401 lub nieprawidłowy klucz
Klucz jest zły, wygasł w schowku lub ma wokół siebie białe znaki. Wklej go ponownie. Upewnij się, że schemat Authorization to Bearer, co Cursor robi za Ciebie, gdy używasz pola klucza OpenAI.
404 lub model nie znaleziony
Prawie zawsze problem z bazowym URL. Brakujący /v1 lub dodatkowy /chat/completions psuje ścieżkę. Nazwa modelu musi być też uncensored, bez wielkich liter ani spacji.
429 z rate_limited lub concurrency
Osiągnąłeś limit. Klucz próbny pozwala na 2 równoległe zapytania i 60 na minutę, a pełny klucz na 8 równoległych i 300 na minutę. Edytor może wysłać kilka zapytań naraz, np. czat plus edycje w tle, a strumienie zajmują slot, aż się skończą. Kod błędu mówi Ci, który limit: rate_limited to zapytania na minutę, concurrency to za dużo naraz. Tymczasowe przeciążenie zwraca też 429 z Retry-After: 5, więc czekanie pięć sekund i ponowna próba jest poprawna.
Odpowiedź się urywa
Okno kontekstu ma 100 000 tokenów, prompt plus uzupełnienie. Bardzo duży załącznik zostawia mało miejsca na odpowiedź. Wyślij mniej plików lub zacznij nowy czat.
Funkcje, które nic nie robią
API jest tylko tekstowe i nie oferuje embeddingów. Jeśli funkcja Cursor wymaga modelu embedding lub wejścia obrazu, nie zadziała przez ten endpoint.
Ustawienia do dostrajania po działaniu
Po pierwszym udanym czacie kilka dostosowań sprawia, że codzienne użytkowanie jest płynniejsze.
Obniż temperaturę dla zadań edycyjnych. Jeśli Twój edytor ją udostępnia, wartość około 0,2 daje stabilniejszy kod. Do brainstormingu podnieś ją. Następnie zwracaj uwagę, ile kontekstu dołączasz. Okno jest hojne, ale każdy dołączony plik jest rozliczany jako input, więc zamykanie niepowiązanych kart i wykluczanie folderów buildowych obniża koszty i skupia odpowiedzi.
Jeśli używasz trybu agenta lub wieloetapowego, pamiętaj o obsłudze wywoływania funkcji: endpoint akceptuje tools i tool_choice oraz strumieniuje tool_calls. To, czy dana funkcja Cursora ich używa, zależy od wersji, więc wykonaj małe zadanie agenta i przeczytaj, co się dzieje, zanim zaufasz mu dużą zmianę. Na koniec od czasu do czasu sprawdź nagłówek X-Balance-USD w teście terminalowym, aby niskie saldo nigdy Cię nie zaskoczyło w trakcie pracy.
Używanie tego samego klucza w skryptach
Jedną z zalet endpointu kompatybilnego z OpenAI jest to, że klucz skonfigurowany w Cursor działa również w kodzie. Oto przykład w Node.js, przydatny w skryptach budujących lub narzędziach do komunikatów commit.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
Przechowuj klucz w zmiennej środowiskowej, nie w pliku, który commitujesz. Każda odpowiedź zawiera nagłówek X-Balance-USD, więc skrypt może Cię ostrzec, gdy kredyt się kończy.
Koszt i kiedy zostać przy obecnym rozwiązaniu
Użycie edytora jest wymagające pod kątem inputu, ponieważ każde zapytanie zawiera kontekst pliku. Przy cenie $0,15 za 1M tokenów inputu i $0,50 za 1M tokenów outputu, zapytanie z 15 000 tokenami inputu i 1000 tokenami outputu kosztuje 0,015 x $0,15 + 0,001 x $0,50 = $0,00225 + $0,0005 = $0,00275. Sto takich to $0,275. Na stronie z cenami znajdziesz kwoty do doładowania, zaczynając od $20, z bonusami od $50.
Zostaw obecny setup, jeśli zależy Ci na modelu konkretnego dostawcy do trudnych refaktoryzacji lub jeśli Twój przepływ pracy opiera się na funkcjach, których nie oferuje zwykły endpoint czatu. Skorzystaj z tego rozwiązania, gdy chcesz niskiej ceny za token, prostego API i mniejszej liczby odrzuceń treści przy legalnej pracy. Wielu programistów konfiguruje oba rozwiązania i przełącza się w zależności od zadania.
Więcej przewodników
Pytania i odpowiedzi
Jaki Base URL wpisać w Cursor?
Wpisz https://api.claudecodeapikey.com/v1 wraz z /v1. Nie dodawaj /chat/completions na końcu.
Jaką nazwę modelu powinienem dodać?
Dodaj niestandardowy model o nazwie uncensored, małymi literami. To jedyny model ID, jaki API obsługuje.
Czy to daje mi modele Claude w Cursor?
Nie. Endpoint obsługuje jeden model o otwartych wagach od niezależnego dostawcy. Nie jest to oficjalne API Anthropic ani żadnego innego dostawcy.
Dlaczego w edytorze pojawiają się błędy 429?
Przekroczyłeś limit zapytań na minutę lub masz zbyt wiele żądań jednocześnie. Klucz próbny pozwala na 2 równoległe zapytania i 60 na minutę, klucz pełny na 8 i 300.
Czy mogę przetestować bez płacenia?
Tak. Nowi użytkownicy mogą uzyskać $0,50 darmowego kredytu próbnego na stronie klucza API. Nie wymaga podania karty i jest ważny przez 7 dni.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.