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

# Claude Desktop × AIHubMix – Einrichtungsanleitung

> AIHubMix in Claude Desktop nutzen: Steuern Sie den Client ganz ohne Anthropic-Konto – komplett per Klick – und rufen Sie Claude, GPT, Gemini, DeepSeek und weitere Modelle über einen einzigen API-Schlüssel auf, mit flexibler nutzungsbasierter Abrechnung.

> Gilt für: Claude Desktop 1.3883.0 (aktualisiert: 23. April 2026)\
> Niveau: Anfänger – keine Kommandozeile erforderlich, vollständig per Klick, kein Anthropic-Konto nötig

## Einführung

**Claude Desktop** (Enterprise-Version bekannt als Claude Cowork) unterstützt die Verbindung mit Drittanbieter-LLM-Gateways, sodass Sie den Client ohne Anthropic-Abonnement nutzen können.

Diese Anleitung führt Sie durch die Konfiguration von AIHubMix als API-Anbieter für Claude Desktop und ermöglicht:

* Kein Anthropic-Konto erforderlich – umgeht Telefonnummer- / E-Mail-Registrierungsbeschränkungen
* Zugriff auf Claude, GPT, Gemini, DeepSeek und mehr über einen einzigen AIHubMix-Schlüssel
* Pay-as-you-go-Abrechnung, flexibel und kostenkontrolliert

***

## Voraussetzungen

Stellen Sie vor dem Start sicher, dass Sie über Folgendes verfügen:

* **Betriebssystem:** macOS 13.0 (Ventura) oder höher, oder Windows 10 / 11
* **AIHubMix-Konto:** Registrieren und aufladen auf [aihubmix.com](https://aihubmix.com)

***

## Schritt 1: AIHubMix-API-Schlüssel besorgen

1. Besuchen Sie [aihubmix.com](https://aihubmix.com) und melden Sie sich an
2. Gehen Sie zur Konsole → Seite **API Keys**
3. Klicken Sie auf **Create New Key**, geben Sie einen Namen ein (z. B. `claude-desktop`)
4. Kopieren Sie den generierten Schlüssel (Format: `sk-xxxxxxxxxxxxxxxx`)

> **Sicherheitshinweis:** Der API-Schlüssel wird nur einmal angezeigt. Speichern Sie ihn sofort an einem sicheren Ort.

***

## Schritt 2: Claude Desktop herunterladen und installieren

1. Besuchen Sie die offizielle Download-Seite: [claude.ai/download](https://claude.ai/download)
2. Laden Sie den Installer für Ihr Betriebssystem herunter

**macOS:**

* Öffnen Sie die heruntergeladene `.dmg`-Datei
* Ziehen Sie `Claude.app` in den `Applications`-Ordner
* Öffnen Sie Claude über Launchpad oder den Applications-Ordner

**Windows:**

* Führen Sie den heruntergeladenen `.msix`-Installer aus
* Folgen Sie den Anweisungen auf dem Bildschirm, um die Installation abzuschließen
* Öffnen Sie Claude über das Startmenü

> **Hinweis: Nach dem Öffnen müssen Sie sich nicht in einem Anthropic-Konto anmelden. Fahren Sie direkt mit dem nächsten Schritt fort.**

***

## Schritt 3: Developer-Modus aktivieren und AIHubMix konfigurieren

Bevor Sie eine Drittanbieter-API anbinden, müssen Sie den Developer-Modus aktivieren:

1. Öffnen Sie die Claude-Desktop-App
2. Klicken Sie oben in der Menüleiste auf **Help**
3. Wählen Sie **Troubleshooting**
4. Klicken Sie auf **Enable Developer mode**
   <Frame>
     <img src="https://mintcdn.com/aihubmix/HYvdaCIBLe6vZmYS/images/image-48.png?fit=max&auto=format&n=HYvdaCIBLe6vZmYS&q=85&s=c1f95583a73bc0dbdc640ee26aa1525a" alt="Image" width="1308" height="836" data-path="images/image-48.png" />
   </Frame>
5. Sobald aktiviert, erscheint oben in der Menüleiste ein neues Menü **Developer**.

<Frame>
  <img src="https://mintcdn.com/aihubmix/HYvdaCIBLe6vZmYS/images/image-49.png?fit=max&auto=format&n=HYvdaCIBLe6vZmYS&q=85&s=b2b603895bdf8b4aee70097587be0b20" alt="Image" width="1354" height="1476" data-path="images/image-49.png" />
</Frame>

6. Klicken Sie in der Menüleiste auf **Developer** und wählen Sie **Configure third-party inference**

<Frame>
  <img src="https://mintcdn.com/aihubmix/HYvdaCIBLe6vZmYS/images/image-53.png?fit=max&auto=format&n=HYvdaCIBLe6vZmYS&q=85&s=5b1ac146a29f9f13477142c477f936ea" alt="Image" width="1354" height="1428" data-path="images/image-53.png" />
</Frame>

7. **Füllen Sie die folgenden Felder im Konfigurationsdialog aus:**

**Connection** – Gateway (Anthropic-kompatibel)

**Gateway Base URL** – AIHubMix-Service-Endpoint

```text theme={null}
https://aihubmix.com
```

**Gateway API Key** – Ihr AIHubMix-API-Schlüssel

```text theme={null}
sk-xxxxxxxxxxxxxxxx
```

<Frame>
  <img src="https://mintcdn.com/aihubmix/HYvdaCIBLe6vZmYS/images/image-54.png?fit=max&auto=format&n=HYvdaCIBLe6vZmYS&q=85&s=fdc50cf5a709572b54e5c57521cfa5b1" alt="Image" width="1826" height="1478" data-path="images/image-54.png" />
</Frame>

8. **Klicken Sie auf Apply locally → Relaunch**

<Frame>
  <img src="https://mintcdn.com/aihubmix/HYvdaCIBLe6vZmYS/images/img_v3_02111_1bf57885-9883-46d1-81b1-4a1c4b45bb1g-1.png?fit=max&auto=format&n=HYvdaCIBLe6vZmYS&q=85&s=654eeeffbe512c11e493d73726d52ba0" alt="Img V3 02111 1bf57885 9883 46d1 81b1 4a1c4b45bb1g" width="1806" height="1430" data-path="images/img_v3_02111_1bf57885-9883-46d1-81b1-4a1c4b45bb1g-1.png" />
</Frame>

9. Wählen Sie nach dem Neustart im folgenden Bildschirm **Continue with Gateway**

<Frame>
  <img src="https://mintcdn.com/aihubmix/HYvdaCIBLe6vZmYS/images/img_v3_02111_e41b4400-e68c-4c63-ac88-434d2e69693g.jpg?fit=max&auto=format&n=HYvdaCIBLe6vZmYS&q=85&s=e5fc1e7e295ccbae0b86dfbb07665414" alt="Img V3 02111 E41b4400 E68c 4c63 Ac88 434d2e69693g" width="1140" height="1044" data-path="images/img_v3_02111_e41b4400-e68c-4c63-ac88-434d2e69693g.jpg" />
</Frame>

***

## Schritt 4: Modelle konfigurieren und überprüfen

Im Gateway-Modus beschränkt Claude Desktop die Modellnamen auf den Claude-Stil – **Modellnamen müssen mit `claude-` beginnen**. Sie können daher keine echten Modellnamen wie `gpt`, `gemini` oder `deepseek` direkt eingeben, sonst enthält das Dropdown keine nutzbaren Modelle. Die Lösung ist das **Modellnamen-Mapping**: Der Client verwendet einen Alias mit `claude-`-Präfix, und Sie ordnen diesen Alias auf Ihrem AIHubMix Key einem echten Modell zu.

**① Das Mapping auf Ihrem AIHubMix Key konfigurieren**

Öffnen Sie die [AIHubMix-Key-Verwaltungsseite](https://console.aihubmix.com/token), erstellen oder bearbeiten Sie einen Key und fügen Sie im Abschnitt `Model name mapping` Einträge nach dem Schema „Alias → echtes Modell“ hinzu:

```text theme={null}
claude-g-p-t-5.5 -> gpt-5.5
claude-gemi-3.1 -> gemini-3.1-pro-preview
claude-depsek-v4 -> deepseek-v4-flash
```

<Frame>
  <img src="https://mintcdn.com/aihubmix/f2xuPZ5QhzR5YO-z/images/api/model-mapping-fallback/optimized-aihubmix-mapping-fallback.png?fit=max&auto=format&n=f2xuPZ5QhzR5YO-z&q=85&s=f4b00d9392919b98919b680e1288e7a1" alt="Konfiguration des Modellnamen-Mappings im AIHubMix-Dashboard" width="400" data-path="images/api/model-mapping-fallback/optimized-aihubmix-mapping-fallback.png" />
</Frame>

**② Die Aliase in der Modellliste von Claude Desktop eintragen**

Hier tragen Sie die `claude-`-Aliase vor dem Mapping ein – die Modellnamen, die Claude Desktop an AIHubMix sendet, nicht die echten Upstream-Modellnamen:

<Frame>
  <img src="https://mintcdn.com/aihubmix/f2xuPZ5QhzR5YO-z/images/api/model-mapping-fallback/optimized-claude-model-list.png?fit=max&auto=format&n=f2xuPZ5QhzR5YO-z&q=85&s=5a7b9f3c57502b3a9a9f807e1799da07" alt="Modellliste von Claude Desktop mit den Aliasen vor dem Mapping" width="1000" height="625" data-path="images/api/model-mapping-fallback/optimized-claude-model-list.png" />
</Frame>

Nach der Konfiguration erscheinen diese Aliase im Modell-Dropdown von Claude Desktop zur Auswahl:

<Frame>
  <img src="https://mintcdn.com/aihubmix/f2xuPZ5QhzR5YO-z/images/api/model-mapping-fallback/optimized-claude-model-picker-compact.png?fit=max&auto=format&n=f2xuPZ5QhzR5YO-z&q=85&s=a3a18c6d1316ba1aab73ff787e9e0547" alt="Modell-Dropdown von Claude Desktop mit den konfigurierten Alias-Modellen" width="1105" height="612" data-path="images/api/model-mapping-fallback/optimized-claude-model-picker-compact.png" />
</Frame>

Namenstipps:

* Verwenden Sie für die `Model ID` ein `claude-`-Präfix.
* Schreiben Sie keine echten Modellfamiliennamen wie `gpt`, `gemini` oder `deepseek` direkt; verwenden Sie Aliase wie `g-p-t`, `gemi`, `depsek`.
* Die `Model ID` muss **Zeichen für Zeichen** mit der linken Seite des AIHubMix-Mappings übereinstimmen, sonst greift das Mapping bei der Anfrage nicht.

> Mehr dazu – etwa das automatische Umschalten auf ein Ersatzmodell, wenn das primäre Modell fehlschlägt, die Abrechnung nach dem letztendlich antwortenden Modell und mehr – finden Sie unter [Modell-Mapping und Fallback](https://docs.aihubmix.com/de/api/Model-Mapping-Fallback).

> **Hinweis: Das Standardmodell ist Claude Opus 4.7, das einen höheren Preis hat** und für den Alltagsgebrauch erhebliche Kosten verursachen kann. Wir empfehlen, auf ein anderes Modell umzustellen. AIHubMix bietet eine große Auswahl an kosteneffizienten und kostenlosen Modellen – die vollständige Liste finden Sie unter [aihubmix.com/models](https://aihubmix.com/models).

Starten Sie Claude Desktop nach der Konfiguration neu und überprüfen Sie:

* Der Tab **Cowork** erscheint im linken Navigationsbereich
* Sie können Nachrichten senden und Antworten normal empfangen
* Der unten rechts angezeigte Modellname entspricht dem von Ihnen konfigurierten Modell
  <Frame>
    <img src="https://mintcdn.com/aihubmix/4hgEUfIX29E20QAD/images/image-59.png?fit=max&auto=format&n=4hgEUfIX29E20QAD&q=85&s=aa317bc8e272ec27c7b3c352d261448c" alt="Image" width="2998" height="1642" data-path="images/image-59.png" />
  </Frame>

Herzlichen Glückwunsch! Sie nutzen Claude Desktop jetzt mit Ihren eigenen konfigurierten Modellen, betrieben von AIHubMix.

***

## Fehlerbehebung

### Fehler beim Start / Verbindung nicht möglich

**Checkliste:**

1. Stellen Sie sicher, dass der Verbindungstyp auf `gateway` (nicht `bedrock` / `vertex`) eingestellt ist
2. Prüfen Sie, ob die Base URL `https://aihubmix.com` ist (kein abschließender Schrägstrich)
3. Verifizieren Sie, dass der API-Schlüssel vollständig kopiert wurde (muss mit `sk-` beginnen)
4. Stellen Sie sicher, dass Ihr AIHubMix-Konto über ausreichendes Guthaben verfügt

**Logs einsehen:**

* macOS: **Console.app** öffnen, nach `Claude` filtern
* Windows: **Ereignisanzeige** öffnen

***

### Fehler „Model Not Found"

Stellen Sie sicher, dass die eingegebene Modell-ID auf AIHubMix verfügbar ist. Sie können die verfügbare Modellliste per API abfragen:

```bash theme={null}
curl https://aihubmix.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"
```

***

### Welches Auth-Schema sollte ich verwenden?

AIHubMix verwendet den Authentifizierungs-Header `x-api-key`. Falls Sie einen 401-Fehler erhalten, versuchen Sie es mit `bearer`.

***

## Fortgeschritten: Konfigurationsdatei exportieren (optional)

Nach Abschluss der Einrichtung können Sie die Konfiguration zur Sicherung oder Team-Verteilung exportieren:

**macOS** – Klicken Sie im Konfigurations-UI auf **Export**, um eine `.mobileconfig`-Datei herunterzuladen\
**Windows** – Klicken Sie im Konfigurations-UI auf **Export**, um eine `.reg`-Registry-Datei herunterzuladen

***

## Verwandte Ressourcen

* [AIHubMix-Dokumentation](https://docs.aihubmix.com)
* [AIHubMix Claude Native API Reference](https://docs.aihubmix.com/en/api/Claude-Native)
* [Offizielle Claude-Desktop-Drittanbieter-Plattform-Anleitung](https://support.anthropic.com/en/articles/claude-cowork-with-third-party-platforms)
* [Claude Desktop Download-Seite](https://claude.ai/download)

***

*Zuletzt aktualisiert: 23. April 2026 | Basierend auf offiziellen Anthropic-Dokumenten + AIHubMix-API-Dokumentation*

<Frame>
  <img src="https://mintcdn.com/aihubmix/HYvdaCIBLe6vZmYS/images/image-56.png?fit=max&auto=format&n=HYvdaCIBLe6vZmYS&q=85&s=e4d98f8307b9b8d7054a14887b061be4" alt="Image" width="1500" height="500" data-path="images/image-56.png" />
</Frame>