Przejdź do głównej treści
Skorzystaj z tego przewodnika, aby połączyć Claude Desktop Cowork z inferencją zewnętrzną z CometAPI. Ta konfiguracja pozwala Claude Desktop wysyłać żądania Claude Messages API do CometAPI z poziomu Cowork, Projects oraz obsługiwanych przepływów pracy w aplikacji desktopowej. Oficjalne materiały:
Inferencja zewnętrzna w Claude Desktop wymaga bramy zgodnej z Anthropic. CometAPI obsługuje modele Claude przez Anthropic Messages API.
Treści wysyłane z Claude Desktop są przetwarzane przez CometAPI oraz wybranego dostawcę modelu. Nie wysyłaj poufnych danych, chyba że Twoja organizacja dopuszcza taki sposób pracy.

​
Wymagania wstępne

  • Claude Desktop zainstalowany z claude.com/download
  • Wersja Claude Desktop zawierająca Developer mode oraz Configure third-party inference
  • Konto CometAPI z aktywnym kluczem API
  • Dostęp do modeli Claude w CometAPI
  • Ścieżka sieciowa z dostępem do https://api.cometapi.com
Zacznij od ekranu logowania Claude Desktop. Jeśli masz już aktywną sesję po zalogowaniu na konto Anthropic, wyloguj się przed skonfigurowaniem inferencji zewnętrznej.

​
Konfiguracja

1

Włącz tryb deweloperski

Otwórz Claude Desktop i pozostań na ekranie logowania. W menu aplikacji otwórz Help → Troubleshooting, a następnie wybierz Enable Developer Mode.W systemie Windows dostęp do menu przed zalogowaniem może być utrudniony. Ustaw fokus na polu e-mail, naciskaj Tab, aż fokus przejdzie do menu, a następnie naciśnij Enter.
2

Otwórz ustawienia inferencji zewnętrznej

Po włączeniu trybu deweloperskiego otwórz Developer → Configure third-party inference.Otworzy się okno konfiguracji z kilkoma sekcjami na lewym pasku bocznym. Do ustawień CometAPI użyj sekcji Connection.
3

Skonfiguruj bramę

W sekcji Connection wpisz poniższe wartości CometAPI:
FieldValue
Inference providerGateway
GatewayAnthropic-compatible
Gateway base URLhttps://api.cometapi.com
Gateway API keyTwój klucz API CometAPI, na przykład <COMETAPI_KEY>
Gateway auth schemeBearer
Gateway extra headersPozostaw puste
Zachowaj base URL dokładnie w podanej postaci. Claude Desktop wymaga base URL z HTTPS.Poniższy zrzut ekranu pokazuje sekcję Connection uzupełnioną wartościami CometAPI.Ustawienia Connection w Claude Desktop z uzupełnionym adresem base URL bramy CometAPI, polem klucza API i schematem autoryzacji bearer
4

Dodaj model IDs

W Model list dodaj ręcznie następujące model IDs:
Model IDRecommended use
claude-opus-4-7Złożone planowanie i zadania agentowe
claude-sonnet-4-6Ogólne użycie w aplikacji desktopowej
claude-haiku-4-5-20251001Lekkie prompty i szybkie szkice
Pierwszy model na liście staje się modelem domyślnym. Umieść claude-sonnet-4-6 na pierwszym miejscu, jeśli chcesz używać uniwersalnego modelu domyślnego.
Dostępność modeli może się zmieniać. Jeśli model nie pojawia się w Claude Desktop po konfiguracji, sprawdź dostęp na stronie modeli CometAPI.
Poniższy zrzut ekranu pokazuje listę modeli z trzema Claude model IDs skonfigurowanymi dla CometAPI.Lista modeli w Claude Desktop pokazująca claude-opus-4-7, claude-sonnet-4-6 i claude-haiku-4-5-20251001 dla CometAPI
5

Zastosuj konfigurację lokalnie

Kliknij Apply locally. Claude Desktop zapisze wybraną konfigurację w lokalnym profilu użytkownika i uruchomi aplikację ponownie.Jeśli aplikacja nie uruchomi się ponownie, całkowicie zamknij Claude Desktop i otwórz go jeszcze raz.
6

Uruchom sesję Cowork

Na ekranie logowania wybierz opcję Cowork z inferencją zewnętrzną. Otwórz Cowork lub Projects, wybierz jeden ze skonfigurowanych modeli Claude i wyślij krótki prompt testowy.Pomyślna odpowiedź potwierdza, że Claude Desktop używa CometAPI do wywołań modelu.

​
Zweryfikuj konfigurację

Użyj krótkiego promptu, który nie wymaga narzędzi zewnętrznych: 
Reply with one sentence: Claude Desktop is connected through CometAPI.
Jeśli Claude Desktop zwróci odpowiedź, oznacza to, że base URL, klucz API i lista modeli są skonfigurowane poprawnie. Poniższy zrzut ekranu pokazuje pomyślną odpowiedź Cowork przez CometAPI. Odpowiedź Cowork w Claude Desktop z użyciem CometAPI po skonfigurowaniu inferencji zewnętrznej Aby sprawdzić wykryte ustawienia, otwórz Help → Troubleshooting → Copy Managed Configuration Report. Wartości sekretów są ukrywane w skopiowanym raporcie.

​
Rozwiązywanie problemów

Sprawdź poniższe elementy:
  • Inference provider jest ustawione na Gateway.
  • Gateway base URL to https://api.cometapi.com.
  • Gateway API key zawiera Twój klucz API CometAPI bez dodatkowych spacji.
  • Kliknąłeś Apply locally i całkowicie uruchomiłeś Claude Desktop ponownie.
Upewnij się, że base URL zaczyna się od https://. Claude Desktop nie akceptuje adresów URL bramy w zwykłym HTTP.Upewnij się też, że Twoje konto CometAPI ma dostęp do modeli Claude oraz że klucz API nie został usunięty ani wyłączony.
Otwórz ponownie Developer → Configure third-party inference i sprawdź wpisy w Model list. model IDs muszą odpowiadać identyfikatorom udostępnianym przez CometAPI.Dodaj każdy model ID jako osobny wpis. Nie umieszczaj w polach interfejsu cudzysłowów, przecinków ani dodatkowych spacji.
Inferencja zewnętrzna Claude Desktop oczekuje w tym przepływie bramy zgodnej z Anthropic. Użyj https://api.cometapi.com oraz Claude model IDs wymienionych powyżej.
Karta Code używa silnika Claude Code wewnątrz Claude Desktop. Niektóre ustawienia aplikacji desktopowej mogą nie mieć zastosowania do sesji Code w taki sam sposób, jak mają do Cowork.W przypadku samodzielnego użycia w terminalu zobacz przewodnik integracji Claude Code.