> ## 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.

# Claude Desktop mit CometAPI verwenden

> Verwenden Sie diese Anleitung, um Claude Desktop mit CometAPI zu konfigurieren, indem Sie die base URL, den API key sowie model- oder provider-Optionen festlegen.

Verwenden Sie diese Anleitung, um Claude Desktop Cowork on third-party inference mit CometAPI zu verbinden. Mit dieser Konfiguration kann Claude Desktop Claude Messages API-Anfragen aus Cowork, Projects und unterstützten Desktop-Workflows an CometAPI senden.

Offizielle Referenzen:

* [Installation und Einrichtung von Claude Desktop](https://claude.com/docs/cowork/3p/installation)
* [Gateway-Konfiguration für Claude Desktop](https://claude.com/docs/cowork/3p/gateway)
* [Konfigurationsreferenz für Claude Desktop](https://claude.com/docs/cowork/3p/configuration)

<Note>
  Third-party inference in Claude Desktop erfordert ein Anthropic-kompatibles Gateway. CometAPI unterstützt Claude-Modelle über die [Anthropic Messages API](/api/text/anthropic-messages).
</Note>

<Warning>
  Inhalte, die Sie aus Claude Desktop senden, werden von CometAPI und dem ausgewählten model provider verarbeitet. Senden Sie keine vertraulichen Daten, es sei denn, Ihre Organisation erlaubt diesen Workflow.
</Warning>

## Voraussetzungen

* Claude Desktop installiert von [claude.com/download](https://claude.com/download)
* Ein Claude Desktop-Build, das **Developer mode** und **Configure third-party inference** enthält
* Ein CometAPI-Konto mit einem aktiven API key
* Zugriff auf Claude-Modelle in CometAPI
* Ein Netzwerkpfad, der `https://api.cometapi.com` erreichen kann

Beginnen Sie auf dem Anmeldebildschirm von Claude Desktop. Wenn Sie bereits mit einem Anthropic-Konto angemeldet sind, melden Sie sich ab, bevor Sie third-party inference konfigurieren.

## Konfiguration

<Steps>
  <Step title="Entwicklermodus aktivieren">
    Öffnen Sie Claude Desktop und bleiben Sie auf dem Anmeldebildschirm. Öffnen Sie im Anwendungsmenü **Help** → **Troubleshooting** und wählen Sie dann **Enable Developer Mode** aus.

    Unter Windows kann das Menü vor der Anmeldung schwer zu erreichen sein. Fokussieren Sie das E-Mail-Feld, drücken Sie `Tab`, bis das Menü fokussiert ist, und drücken Sie dann `Enter`.
  </Step>

  <Step title="Einstellungen für Inference von Drittanbietern öffnen">
    Nachdem der Entwicklermodus aktiviert wurde, öffnen Sie **Developer** → **Configure third-party inference**.

    Das Konfigurationsfenster wird mit mehreren Abschnitten in der linken Seitenleiste geöffnet. Verwenden Sie den Abschnitt **Connection** für die CometAPI-Einstellungen.
  </Step>

  <Step title="Das Gateway konfigurieren">
    Geben Sie im Abschnitt **Connection** die folgenden CometAPI-Werte ein:

    | Feld                  | Wert                                                     |
    | --------------------- | -------------------------------------------------------- |
    | Inference provider    | Gateway                                                  |
    | Gateway               | Anthropic-compatible                                     |
    | Gateway base URL      | `https://api.cometapi.com`                               |
    | Gateway API key       | Ihr CometAPI API-Schlüssel, zum Beispiel `$COMETAPI_KEY` |
    | Gateway auth scheme   | Bearer                                                   |
    | Gateway extra headers | Leer lassen                                              |

    Behalten Sie die base URL genau wie gezeigt bei. Claude Desktop erfordert eine HTTPS-base URL.

    Der folgende Screenshot zeigt den Abschnitt Connection mit ausgefüllten CometAPI-Werten.

    <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="Claude Desktop-Connection-Einstellungen mit ausgefüllter CometAPI-Gateway-base URL, API-Schlüsselfeld und Bearer-Authentifizierungsschema" width="1800" height="1440" data-path="images/integrations/claude-desktop-cometapi-connection.png" />
  </Step>

  <Step title="model IDs hinzufügen">
    Fügen Sie in **Model list** diese model IDs manuell hinzu:

    | Model ID                    | Empfohlene Verwendung                          |
    | --------------------------- | ---------------------------------------------- |
    | `claude-opus-4-7`           | Komplexe Planung und Agent-Aufgaben            |
    | `claude-sonnet-4-6`         | Allgemeine Desktop-Nutzung                     |
    | `claude-haiku-4-5-20251001` | Leichtgewichtige Prompts und schnelle Entwürfe |

    Das erste Modell in der Liste wird zum Standardmodell. Setzen Sie `claude-sonnet-4-6` an die erste Stelle, wenn Sie einen allgemeinen Standard möchten.

    <Tip>
      Die Modellverfügbarkeit kann sich ändern. Wenn ein Modell nach der Konfiguration nicht in Claude Desktop erscheint, überprüfen Sie den Zugriff auf der [CometAPI Models page](/de/overview/models).
    </Tip>

    Der folgende Screenshot zeigt die Modellliste mit den drei für CometAPI konfigurierten Claude-model IDs.

    <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="Claude Desktop-Modellliste mit claude-opus-4-7, claude-sonnet-4-6 und claude-haiku-4-5-20251001 für CometAPI" width="1764" height="1278" data-path="images/integrations/claude-desktop-cometapi-model-list.png" />
  </Step>

  <Step title="Die Konfiguration lokal anwenden">
    Klicken Sie auf **Apply locally**. Claude Desktop schreibt die ausgewählte Konfiguration in das lokale Benutzerprofil und startet die App neu.

    Wenn die App nicht neu startet, beenden Sie Claude Desktop vollständig und öffnen Sie es erneut.
  </Step>

  <Step title="Eine Cowork-Sitzung starten">
    Wählen Sie auf dem Anmeldebildschirm die Option für Cowork mit Inference von Drittanbietern. Öffnen Sie Cowork oder Projects, wählen Sie eines der konfigurierten Claude-Modelle aus und senden Sie einen kurzen Test-Prompt.

    Eine erfolgreiche Antwort bestätigt, dass Claude Desktop CometAPI für Modellaufrufe verwendet.
  </Step>
</Steps>

## Die Konfiguration überprüfen

Verwenden Sie einen kurzen Prompt, der keine externen Tools erfordert:

```text theme={null}
Reply with one sentence: Claude Desktop is connected through CometAPI.
```

Wenn Claude Desktop eine Antwort zurückgibt, sind base URL, API key und Modellliste korrekt konfiguriert.

Der folgende Screenshot zeigt eine erfolgreiche Cowork-Antwort über 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="Claude Desktop-Cowork-Antwort über CometAPI nach der Einrichtung von Inference von Drittanbietern" width="2880" height="1600" data-path="images/integrations/claude-desktop-cometapi-chat.png" />

Um die erkannten Einstellungen zu prüfen, öffnen Sie **Help** → **Troubleshooting** → **Copy Managed Configuration Report**. Geheime Werte werden im kopierten Bericht geschwärzt.

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Entwicklermenü wird nicht angezeigt">
    Vergewissere dich, dass du **Help** → **Troubleshooting** → **Enable Developer Mode** ausgewählt hast. Beende Claude Desktop dann vollständig und öffne es erneut.

    Falls die Option fehlt, installiere einen Claude-Desktop-Build, der die Konfiguration für Inference von Drittanbietern enthält.
  </Accordion>

  <Accordion title="Claude Desktop öffnet den standardmäßigen Anmeldeablauf">
    Prüfe diese Punkte:

    * **Inference provider** ist auf **Gateway** gesetzt.
    * **Gateway base URL** ist `https://api.cometapi.com`.
    * **Gateway API key** enthält deinen CometAPI API-Schlüssel ohne zusätzliche Leerzeichen.
    * Du hast auf **Apply locally** geklickt und Claude Desktop vollständig neu gestartet.
  </Accordion>

  <Accordion title="Verbindungsvalidierung schlägt fehl">
    Vergewissere dich, dass die base URL mit `https://` beginnt. Claude Desktop akzeptiert keine einfachen HTTP-Gateway-URLs.

    Vergewissere dich außerdem, dass dein CometAPI-Konto Zugriff auf Claude-Modelle hat und der API-Schlüssel nicht gelöscht oder deaktiviert wurde.
  </Accordion>

  <Accordion title="Konfigurierte Modelle werden nicht angezeigt">
    Öffne erneut **Developer** → **Configure third-party inference** und prüfe die Einträge in der **Model list**. model IDs müssen mit den IDs übereinstimmen, die CometAPI bereitstellt.

    Füge jede model ID als separaten Eintrag hinzu. Verwende in den UI-Feldern keine Anführungszeichen, Kommas oder zusätzlichen Leerzeichen.
  </Accordion>

  <Accordion title="Eine OpenAI-kompatible base URL funktioniert nicht">
    Die Drittanbieter-Inference in Claude Desktop erwartet für diesen Ablauf ein Anthropic-kompatibles Gateway. Verwende `https://api.cometapi.com` und die oben aufgeführten Claude-model IDs.
  </Accordion>

  <Accordion title="Der Code-Tab verhält sich anders">
    Der Code-Tab verwendet die Claude-Code-Engine innerhalb von Claude Desktop. Einige Desktop-Einstellungen gelten für Code-Sitzungen möglicherweise nicht auf dieselbe Weise wie für Cowork.

    Für die eigenständige Nutzung im Terminal siehe den [Claude Code integration guide](/de/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": "Claude Desktop mit CometAPI verwenden",
        "description": "Verwende diese Anleitung, um Claude Desktop mit CometAPI zu konfigurieren, indem du die base URL, den API-Schlüssel und die model- oder provider-Optionen festlegst.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-1",
            "position": 1,
            "name": "Entwicklermodus aktivieren",
            "text": "Schließe den Schritt Enable developer mode in der Anleitung Claude Desktop mit CometAPI verwenden ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-2",
            "position": 2,
            "name": "Einstellungen für Drittanbieter-Inference öffnen",
            "text": "Schließe den Schritt Open third-party inference settings in der Anleitung Claude Desktop mit CometAPI verwenden ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-3",
            "position": 3,
            "name": "Das Gateway konfigurieren",
            "text": "Schließe den Schritt Configure the gateway in der Anleitung Claude Desktop mit CometAPI verwenden ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-4",
            "position": 4,
            "name": "model IDs hinzufügen",
            "text": "Schließe den Schritt Add model IDs in der Anleitung Claude Desktop mit CometAPI verwenden ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-5",
            "position": 5,
            "name": "Die Konfiguration lokal anwenden",
            "text": "Schließe den Schritt Apply the configuration locally in der Anleitung Claude Desktop mit CometAPI verwenden ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/claude-desktop#step-6",
            "position": 6,
            "name": "Eine Cowork-Sitzung starten",
            "text": "Schließe den Schritt Start a Cowork session in der Anleitung Claude Desktop mit CometAPI verwenden ab."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI-Dokumentation",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrationen",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Claude Desktop mit CometAPI verwenden",
            "item": "https://apidoc.cometapi.com/integrations/claude-desktop"
          }
        ]
      }
    ]
    }
    `}
</script>