> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Używanie Claude Desktop z CometAPI

> Skorzystaj z tego przewodnika, aby skonfigurować Claude Desktop z CometAPI poprzez ustawienie base URL, klucza API oraz opcji model lub provider.

Skorzystaj z tego przewodnika, aby połączyć Claude Desktop Cowork on third-party inference z CometAPI. Ta konfiguracja umożliwia Claude Desktop wysyłanie żądań Claude Messages API do CometAPI z poziomu Cowork, Projects oraz obsługiwanych przepływów pracy w aplikacji desktopowej.

Oficjalne materiały:

* [Instalacja i konfiguracja Claude Desktop](https://claude.com/docs/cowork/3p/installation)
* [Konfiguracja gateway dla Claude Desktop](https://claude.com/docs/cowork/3p/gateway)
* [Dokumentacja konfiguracji Claude Desktop](https://claude.com/docs/cowork/3p/configuration)

<Note>
  Third-party inference w Claude Desktop wymaga bramki zgodnej z Anthropic. CometAPI obsługuje modele Claude przez [Anthropic Messages API](/api/text/anthropic-messages).
</Note>

<Warning>
  Treści wysyłane z Claude Desktop są przetwarzane przez CometAPI oraz wybranego dostawcę modelu. Nie wysyłaj danych poufnych, chyba że Twoja organizacja dopuszcza taki sposób pracy.
</Warning>

## Wymagania wstępne

* Claude Desktop zainstalowany z [claude.com/download](https://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 umożliwiająca połączenie z `https://api.cometapi.com`

Rozpocznij od ekranu logowania Claude Desktop. Jeśli masz już zalogowane konto Anthropic, wyloguj się przed skonfigurowaniem third-party inference.

## Konfiguracja

<Steps>
  <Step title="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 adresu e-mail, naciskaj `Tab`, aż menu będzie zaznaczone, a następnie naciśnij `Enter`.
  </Step>

  <Step title="Otwórz ustawienia third-party inference">
    Po włączeniu trybu deweloperskiego otwórz **Developer** → **Configure third-party inference**.

    Okno konfiguracji otworzy się z kilkoma sekcjami na lewym pasku bocznym. Do ustawień CometAPI użyj sekcji **Connection**.
  </Step>

  <Step title="Skonfiguruj gateway">
    W sekcji **Connection** wprowadź poniższe wartości CometAPI:

    | Field                 | Value                                                |
    | --------------------- | ---------------------------------------------------- |
    | Inference provider    | Gateway                                              |
    | Gateway               | Anthropic-compatible                                 |
    | Gateway base URL      | `https://api.cometapi.com`                           |
    | Gateway API key       | Twój klucz API CometAPI, na przykład `$COMETAPI_KEY` |
    | Gateway auth scheme   | Bearer                                               |
    | Gateway extra headers | Pozostaw puste                                       |

    Zachowaj base URL dokładnie w pokazanej postaci. Claude Desktop wymaga base URL w HTTPS.

    Poniższy zrzut ekranu pokazuje sekcję Connection wypełnioną wartościami CometAPI.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-connection.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=879de5e2a4587861f220a7f6e0f7d2a5" alt="Ustawienia Connection w Claude Desktop z uzupełnionym gateway base URL CometAPI, polem klucza API i schematem autoryzacji bearer" width="1800" height="1440" data-path="images/integrations/claude-desktop-cometapi-connection.png" />
  </Step>

  <Step title="Dodaj model IDs">
    W **Model list** dodaj ręcznie te model IDs:

    | Model ID                    | Zalecane zastosowanie                 |
    | --------------------------- | ------------------------------------- |
    | `claude-opus-4-7`           | Złożone planowanie i zadania agentowe |
    | `claude-sonnet-4-6`         | Ogólne użycie na desktopie            |
    | `claude-haiku-4-5-20251001` | Lekkie prompty i szybkie szkice       |

    Pierwszy model na liście staje się modelem domyślnym. Umieść `claude-sonnet-4-6` na początku, jeśli chcesz mieć domyślny model ogólnego przeznaczenia.

    <Tip>
      Dostępność modeli może się zmieniać. Jeśli model nie pojawia się w Claude Desktop po konfiguracji, sprawdź dostęp na [stronie Models CometAPI](/pl/overview/models).
    </Tip>

    Poniższy zrzut ekranu pokazuje listę modeli z trzema model IDs Claude skonfigurowanymi dla CometAPI.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-model-list.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=63dcdfe05db59c09782e1514e09a734d" alt="Lista modeli w Claude Desktop pokazująca claude-opus-4-7, claude-sonnet-4-6 i claude-haiku-4-5-20251001 dla CometAPI" width="1764" height="1278" data-path="images/integrations/claude-desktop-cometapi-model-list.png" />
  </Step>

  <Step title="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.
  </Step>

  <Step title="Rozpocznij sesję Cowork">
    Na ekranie logowania wybierz opcję Cowork dla third-party inference. 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ń modeli.
  </Step>
</Steps>

## Zweryfikuj konfigurację

Użyj krótkiego promptu, który nie wymaga narzędzi zewnętrznych:

```text theme={null}
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.

<img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-chat.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=93bb3b1a60de0d7edbd25cb6ba3b58d8" alt="Odpowiedź Cowork w Claude Desktop z użyciem CometAPI po konfiguracji third-party inference" width="2880" height="1600" data-path="images/integrations/claude-desktop-cometapi-chat.png" />

Aby sprawdzić wykryte ustawienia, otwórz **Help** → **Troubleshooting** → **Copy Managed Configuration Report**. W skopiowanym raporcie tajne wartości są ukryte.

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Menu deweloperskie się nie pojawia">
    Upewnij się, że wybrałeś **Help** → **Troubleshooting** → **Enable Developer Mode**. Następnie całkowicie zamknij Claude Desktop i otwórz go ponownie.

    Jeśli tej opcji nie ma, zainstaluj wersję Claude Desktop, która zawiera konfigurację inference innych firm.
  </Accordion>

  <Accordion title="Claude Desktop otwiera standardowy proces logowania">
    Sprawdź następujące 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ś ponownie Claude Desktop.
  </Accordion>

  <Accordion title="Walidacja połączenia kończy się niepowodzeniem">
    Upewnij się, że base URL zaczyna się od `https://`. Claude Desktop nie akceptuje adresów URL bramy używających zwykłego HTTP.

    Upewnij się również, że Twoje konto CometAPI ma dostęp do modeli Claude oraz że klucz API nie został usunięty ani wyłączony.
  </Accordion>

  <Accordion title="Skonfigurowane modele się nie pojawiają">
    Otwórz ponownie **Developer** → **Configure third-party inference** i sprawdź wpisy na liście **Model list**. Model IDs muszą odpowiadać identyfikatorom udostępnianym przez CometAPI.

    Dodaj każdy model ID jako osobny wpis. Nie umieszczaj cudzysłowów, przecinków ani dodatkowych spacji w polach interfejsu.
  </Accordion>

  <Accordion title="Base URL zgodny z OpenAI nie działa">
    Inference innych firm w Claude Desktop oczekuje w tym przepływie bramy zgodnej z Anthropic. Użyj `https://api.cometapi.com` oraz model IDs Claude wymienionych powyżej.
  </Accordion>

  <Accordion title="Karta Code zachowuje się inaczej">
    Karta Code używa silnika Claude Code wewnątrz Claude Desktop. Niektóre ustawienia desktopowe mogą nie mieć zastosowania do sesji Code w taki sam sposób, w jaki mają zastosowanie do Cowork.

    W przypadku samodzielnego użycia w terminalu zobacz [przewodnik integracji Claude Code](/pl/integrations/claude-code).
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#howto",
        "name": "Używanie Claude Desktop z CometAPI",
        "description": "Skorzystaj z tego przewodnika, aby skonfigurować Claude Desktop z CometAPI, ustawiając base URL, klucz API oraz opcje modelu lub dostawcy.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-1",
            "position": 1,
            "name": "Włącz tryb deweloperski",
            "text": "Wykonaj krok Włącz tryb deweloperski w przewodniku Używanie Claude Desktop z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-2",
            "position": 2,
            "name": "Otwórz ustawienia inference innych firm",
            "text": "Wykonaj krok Otwórz ustawienia inference innych firm w przewodniku Używanie Claude Desktop z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-3",
            "position": 3,
            "name": "Skonfiguruj bramę",
            "text": "Wykonaj krok Skonfiguruj bramę w przewodniku Używanie Claude Desktop z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-4",
            "position": 4,
            "name": "Dodaj model IDs",
            "text": "Wykonaj krok Dodaj model IDs w przewodniku Używanie Claude Desktop z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-5",
            "position": 5,
            "name": "Zastosuj konfigurację lokalnie",
            "text": "Wykonaj krok Zastosuj konfigurację lokalnie w przewodniku Używanie Claude Desktop z CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-6",
            "position": 6,
            "name": "Rozpocznij sesję Cowork",
            "text": "Wykonaj krok Rozpocznij sesję Cowork w przewodniku Używanie Claude Desktop z CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Dokumentacja CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integracje",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Używanie Claude Desktop z CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/claude-desktop"
          }
        ]
      }
    ]
    }
    `}
</script>