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

# Claude Desktop Integration

> Claude Desktop mit EvoLink.AI verbinden

## Überblick

<img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-overview.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=0b5b1ccfcee67ceae546cd4054afd004" alt="Claude Desktop" width="2382" height="1586" data-path="images/integration-guide/claude-desktop-overview.png" />

Claude Desktop ist die offizielle Desktop-App von Anthropic für die lokale Nutzung von Claude.

In dieser Anleitung wird beschrieben, wie Claude Desktop mit der **EvoLink API** verbunden wird, um über EvoLink Modelle zu nutzen, die mit der Anthropic Messages API kompatibel sind.

**Diese Anleitung umfasst:**

* Claude Desktop installieren
* Developer Mode aktivieren
* Die EvoLink-Verbindung konfigurieren
* Neu starten und ein Modell auswählen

## Voraussetzungen

Bereiten Sie vor dem Start Ihren EvoLink API Key vor.

### EvoLink API Key abrufen

* Melden Sie sich in der [EvoLink-Konsole](https://evolink.ai/dashboard) an
* Suchen Sie in der Konsole nach API Keys, klicken Sie auf **Create New Key** und kopieren Sie den generierten Key
* API-Keys beginnen meist mit `sk-`; bewahren Sie ihn sicher auf

## Schritt 1: Claude Desktop herunterladen

Öffnen Sie die [Claude Desktop-Downloadseite](https://claude.com/download) und installieren Sie die passende Version für Ihr Betriebssystem.

<Note>
  **Tipp:** Wenn Claude Desktop noch nicht installiert ist, schließen Sie die Installation zuerst ab und fahren Sie dann fort.
</Note>

<Frame>
  <img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-download-page.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=4fb80c3046fd68f5df3408815d111dca" alt="Claude Desktop Download-Seite" width="4118" height="2188" data-path="images/integration-guide/claude-desktop-download-page.png" />
</Frame>

### Nach der Installation

Prüfen Sie nach der Installation, ob Claude Desktop normal startet.

## Schritt 2: Developer Mode aktivieren

<Tabs>
  <Tab title="macOS">
    Nach dem Start von Claude Desktop klicken Sie auf **Help → Troubleshooting** und aktivieren im Dialog den Developer Mode.

    Danach erscheint ein **Developer**-Menüeintrag für die Konfiguration der Drittanbieter-Inferenz.

    <Note>
      **Hinweis:** Falls der Developer-Eintrag nicht angezeigt wird, prüfen Sie, ob Ihre Claude-Desktop-Version Developer Mode und Drittanbieter-Inferenz unterstützt.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-help-menu.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=dfc9f20aae993d1b3d25fdf2eae212dd" alt="Claude Desktop Hilfe-Menü Troubleshooting" width="1912" height="928" data-path="images/integration-guide/claude-desktop-help-menu.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-developer-menu.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=5001a483c077264fd4deeea6c36aa293" alt="Claude Desktop Developer-Menü" width="1188" height="812" data-path="images/integration-guide/claude-desktop-developer-menu.png" />
    </Frame>
  </Tab>

  <Tab title="Windows">
    Aktivieren Sie vor der Nutzung des Gateway- / Cowork-Modus die Windows-Funktion für die virtuelle Maschinenplattform:

    1. Drücken Sie `Win + R`
    2. Geben Sie `optionalfeatures` ein und drücken Sie `Enter`
    3. Aktivieren Sie unter **Windows Features** die Option **Virtual Machine Platform**
    4. Klicken Sie auf **OK**
    5. Starten Sie den Computer neu, falls Windows Sie dazu auffordert

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/lVQENoE4lWLkT7sb/images/integration-guide/windows-run-optionalfeatures-en.png?fit=max&auto=format&n=lVQENoE4lWLkT7sb&q=85&s=f84e0afd143886773ca61125c157c3e3" alt="Windows Run optionalfeatures" width="568" height="334" data-path="images/integration-guide/windows-run-optionalfeatures-en.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/lVQENoE4lWLkT7sb/images/integration-guide/windows-features-virtual-machine-platform-en.png?fit=max&auto=format&n=lVQENoE4lWLkT7sb&q=85&s=59ef055e4cc91217eba1be0bdb820d0c" alt="Windows Features Virtual Machine Platform" width="692" height="612" data-path="images/integration-guide/windows-features-virtual-machine-platform-en.png" />
    </Frame>

    Starten Sie danach Claude Desktop, klicken Sie auf **Help → Troubleshooting** und aktivieren Sie im Dialog den Developer Mode.

    Danach erscheint ein **Developer**-Menüeintrag für die Konfiguration der Drittanbieter-Inferenz.

    <Note>
      **Hinweis:** Falls der Developer-Eintrag nicht angezeigt wird, prüfen Sie, ob Ihre Claude-Desktop-Version Developer Mode und Drittanbieter-Inferenz unterstützt.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/lVQENoE4lWLkT7sb/images/integration-guide/claude-desktop-windows-enable-developer-mode.png?fit=max&auto=format&n=lVQENoE4lWLkT7sb&q=85&s=6f2de48dfc8f1f77bc7c81ce8931cbb2" alt="Claude Desktop Windows Developer Mode aktivieren" width="1513" height="905" data-path="images/integration-guide/claude-desktop-windows-enable-developer-mode.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/lVQENoE4lWLkT7sb/images/integration-guide/claude-desktop-windows-configure-third-party-inference.png?fit=max&auto=format&n=lVQENoE4lWLkT7sb&q=85&s=5a80699e3978a79ea6e92eda23a4a35f" alt="Claude Desktop Windows Developer-Menü" width="1799" height="901" data-path="images/integration-guide/claude-desktop-windows-configure-third-party-inference.png" />
    </Frame>
  </Tab>
</Tabs>

## Schritt 3: Drittanbieter-Inferenz öffnen

Öffnen Sie im Developer-Menü das Drittanbieter-Inferenz-Panel und füllen Sie es wie folgt aus:

| Feld                | Beschreibung                                                                                                                                                                                         |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Gateway base URL    | Adresse des EvoLink-Gateways, empfohlen: `https://direct.evolink.ai`                                                                                                                                 |
| Gateway API key     | Geben Sie Ihren EvoLink API Key direkt ein, ohne das Präfix `Bearer`                                                                                                                                 |
| Gateway auth scheme | `bearer`                                                                                                                                                                                             |
| Model list          | Empfohlen. Fügen Sie nur Text-/Chat-Modell-IDs hinzu, die die Anthropic Messages API unterstützen. Sie können auch direkt zur Tabelle der [unterstützten Modelle](#supported-claude-models) springen |

<Note>
  **Hinweis:** Wenn die Feldnamen in Ihrer Claude-Desktop-Version leicht abweichen, verwenden Sie die tatsächlichen Bezeichnungen in der Oberfläche, die Bedeutung sollte jedoch gleich bleiben.
</Note>

<Frame>
  <img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-third-party-inference.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=fd9e8fcaaa514b926d340353b673341c" alt="Claude Desktop Drittanbieter-Inferenz" width="1824" height="2190" data-path="images/integration-guide/claude-desktop-third-party-inference.png" />
</Frame>

## Schritt 4: Speichern und neu starten

Speichern Sie die Konfiguration, beenden Sie Claude Desktop vollständig und starten Sie es erneut.

<Frame>
  <img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-relaunch-dialog.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=0914bfb563206dfe93ba0f1ffc53c8cd" alt="Claude Desktop Neustart-Dialog" width="1980" height="1680" data-path="images/integration-guide/claude-desktop-relaunch-dialog.png" />
</Frame>

Nach dem Neustart sollte Claude Desktop die neue Drittanbieter-Inferenz-Konfiguration verwenden.

**Erwartetes Ergebnis:** Nach dem Start sehen Sie die verfügbare Modellliste und die Anfragen werden über EvoLink weitergeleitet.

## Schritt 5: Modell auswählen

Prüfen Sie nach dem Neustart im Modell-Auswahlbereich, ob die verfügbaren Modelle korrekt angezeigt werden.

## Funktionsweise

Claude Desktop kommuniziert über ein Anthropic-kompatibles Gateway mit EvoLink:

1. Claude Desktop sendet Anfragen an die konfigurierte Gateway-Adresse.
2. EvoLink empfängt die Anfrage und leitet sie an den passenden Modelldienst weiter.
3. Nach der Antwort zeigt Claude Desktop den Dialog weiterhin lokal an.

Ein zusätzlicher lokaler Proxy ist nicht erforderlich.

## Unterstützte Modelle

<a id="supported-claude-models" />

Wenn Sie die sichtbaren Modelle in `Model list` einschränken möchten, können Sie die folgenden Modell-IDs verwenden.

| Modell-ID                    |
| ---------------------------- |
| `claude-haiku-4-5-20251001`  |
| `claude-sonnet-4-5-20250929` |
| `claude-opus-4-5-20251101`   |
| `claude-sonnet-4-6`          |
| `claude-sonnet-5`            |
| `claude-opus-4-6`            |
| `claude-fable-5`             |
| `claude-opus-4-8`            |
| `claude-opus-4-7`            |
| `deepseek-v4-flash`          |
| `deepseek-v4-pro`            |

## FAQ

### Das Developer-Menü erscheint nicht

Stellen Sie sicher, dass Developer Mode aktiviert ist und Claude Desktop vollständig neu gestartet wurde.

### Nach der Konfiguration kann keine Verbindung hergestellt werden

Prüfen Sie Folgendes:

* Ist die Base URL korrekt?
* Ist der API Key gültig?
* Ist das Authentifizierungsschema `bearer`?
* Wurde Claude Desktop vollständig geschlossen und erneut geöffnet?

### Ich sehe keine Modelle

Stellen Sie sicher, dass Konto und Netzwerk normal funktionieren, und prüfen Sie anschließend, ob die Drittanbieter-Inferenz erfolgreich gespeichert wurde.

### Muss ich `Model list` ausfüllen?

Ja, es wird empfohlen. Fügen Sie nur Text-/Chat-Modell-IDs hinzu, die die Anthropic Messages API unterstützen.

### Was soll ich eintragen, wenn ich Modelle manuell festlegen möchte?

Verwenden Sie die Modell-IDs aus der obigen Tabelle "Unterstützte Modelle" und tragen Sie sie so ein, wie es Claude Desktop erwartet.
