Claude Desktop

Uruchom Claude Code w aplikacji Claude Desktop (zakładka Code) przez OneProvider, bez konta Claude.

Aplikacja Claude Desktop z zakładką Code

Co działa

Zakładka Code (Claude Code z interfejsem graficznym) i Cowork działają przez OneProvider dzięki wbudowanemu trybowi bramki Claude Desktop, który Anthropic nazywa third-party inference. Nie jest potrzebne konto Claude ani Anthropic. Działa w macOS 14+ oraz Windows 10 (2004) lub nowszym, w tym Windows 11.

Ograniczenie klienta

Tryb bramki jest wyłącznie lokalny: sesje działają na twoim komputerze, bez sesji w chmurze, SSH i Remote Control. Desktop bierze bramkę z poniższego formularza, a nie z ANTHROPIC_BASE_URL ani ~/.claude/settings.json (te dotyczą wiersza poleceń Claude Code). Bez formularza Desktop uruchomi się tylko z płatną subskrypcją Claude.

Konfiguracja

1. Zainstaluj Claude Desktop i nie loguj się

   Pobierz aplikację z claude.com/download (macOS: .dmg, przeciągnij Claude do Programów; Windows: instalator .msix) i uruchom ją. Zostań na ekranie logowania: nie loguj się i nie zakładaj konta Anthropic.

2. Włącz Developer Mode

   macOS: w pasku menu wybierz Help → Troubleshooting → Enable Developer Mode. Windows: kliknij menu aplikacji ☰ w lewym górnym rogu ekranu logowania, potem Help → Troubleshooting → Enable Developer Mode. Aplikacja uruchomi się ponownie i pojawi się menu Developer; pozostaje włączone po kolejnych restartach.

3. Otwórz Configure Third-Party Inference

   Wybierz Developer → Configure Third-Party Inference…. W sekcji Connection ustaw Inference provider na Gateway i wypełnij kartę Gateway credentials według wzoru. Adres base URL ma być dokładnie taki, bez /v1 i bez dalszej ścieżki; wklej swój klucz OneProvider w pole Gateway API key.

   Inference provider: Gateway
   Gateway base URL: https://api.oneprovider.dev
   Gateway API key: sk-your-key-here
   Credential kind: Static API key
   Gateway auth scheme: Bearer (x-api-key też działa)

4. Sprawdź listę modeli

   Najpierw zostaw Models puste: Desktop zapyta https://api.oneprovider.dev/v1/models i pokaże modele Claude z katalogu. Jeśli lista wyboru pozostaje pusta, otwórz sekcję Models i dodaj dokładne ID modelu Claude (<your-compatible-model-id>) z katalogu modeli; pierwszy wpis jest domyślny w nowych sesjach Code.

5. Zastosuj, uruchom ponownie i wystartuj w trybie bramki

   Kliknij Apply Changes, potem Save & Restart. Po ponownym uruchomieniu ekran logowania zaproponuje start z konfiguracją twojego dostawcy inferencji: wybierz tę opcję, a nie logowanie do Anthropic. Otwórz zakładkę Code, wybierz lokalny folder projektu i wyślij wiadomość.

Sprawdź połączenie

Potwierdź zapytanie w Panelu

Wyślij krótką wiadomość w nowej sesji Code. W ciągu minuty zapytanie powinno pojawić się w Panelu na stronie Zużycie z modelem, tokenami i opłatą. Jeśli się nie udaje:

Zwykły ekran logowania bez opcji dostawcy → formularz nie został zastosowany: całkowicie zamknij aplikację (Cmd+Q w macOS, Menedżer zadań w Windows) i otwórz ją ponownie
"Gateway was unreachable" → sprawdź base URL (dokładnie https://api.oneprovider.dev) i wyłącz VPN lub proxy
401 → błędny, odwołany lub wygasły klucz: sprawdź go w Panelu w sekcji Klucze
429 insufficient balance → doładuj saldo w Panelu i wyślij ponownie
Pusta lista modeli → dodaj ID modelu w sekcji Models
"Error 403: Forbidden" → jesteś na ścieżce logowania do Anthropic: wybierz zamiast niej opcję dostawcy
Co zastosował Desktop: Help → Troubleshooting → Generate Diagnostic Report → Export to file (managed-config.txt, provider-status.txt)
Log: ~/Library/Logs/Claude-3p/main.log (macOS) lub %LOCALAPPDATA%\Claude-3p\Logs\main.log (Windows)

Dane połączenia

Protokół

anthropic

Endpoint

https://api.oneprovider.dev

Bezpieczeństwo klucza

Klucz jest zapisany w konfiguracji Desktop tylko na tym komputerze. Użyj dedykowanego klucza z limitem wydatków; jeśli komputer jest wspólny albo klucz wycieknie, usuń lub wstrzymaj ten klucz w Panelu, a reszta salda pozostanie bezpieczna.

Szybkie odpowiedzi

Jakiego base URL użyć?

Claude Code i SDK Anthropic używają https://api.oneprovider.dev. SDK OpenAI i klienty zgodne z OpenAI używają https://api.oneprovider.dev/v1. Jeden klucz działa przy obu; lista modeli jest na stronie modeli , a stawki na stronie cennika .

Jak się uwierzytelnić?

Wyślij surowy klucz sk-… w x-api-key albo Authorization: Bearer: w jednym z nich, nigdy w obu. Trzymaj klucz w zmiennej środowiskowej, a nie w pliku, który trafia do repozytorium. Więcej o uwierzytelnianiu .

Skąd wziąć klucz?

Otwórz swój Panel w bocie Telegram @oneprovider_robot lub na app.oneprovider.dev, doładuj saldo i naciśnij „Utwórz klucz”. Każdy klucz może mieć własny limit wydatków. Panel i klucze API .

Co oznaczają 401, 404 i 429?

401: klucza brakuje, jest błędnie wpisany albo wysłany w złym nagłówku; wklej cały klucz bez cudzysłowów i spacji. 404: zwykle zły base URL, na przykład brakujące lub podwojone /v1. 429 z komunikatem „Insufficient balance”: saldo Panelu lub limit wydatków klucza się wyczerpał, więc doładuj zamiast ponawiać; każde inne 429 to limit zapytań, więc poczekaj zgodnie z Retry-After. Szczegóły: kody błędów i rozwiązywanie problemów .

Dlaczego strumienie się urywają lub resetują?

VPN i proxy VLESS często buforują SSE albo zrywają negocjację HTTP/2. OneProvider nie ma ograniczeń regionalnych i nie buforuje strumieni, więc wyłącz proxy i spróbuj ponownie.

Gdzie pytać, jeśli to nie wystarcza?

Napisz do @Oneproviderhelpbot w Telegramie albo otwórz „Wsparcie” w Panelu w przeglądarce, podając kod statusu HTTP i dokładny komunikat błędu. Jak działa wsparcie .