- Installation und Einrichtung von Claude Desktop
- Gateway-Konfiguration für Claude Desktop
- Konfigurationsreferenz für Claude Desktop
Third-party inference in Claude Desktop erfordert ein Anthropic-compatible gateway. CometAPI unterstützt Claude-Modelle über die Anthropic Messages API.
Voraussetzungen
- Claude Desktop installiert von claude.com/download
- Ein Claude Desktop-Build, der Developer mode und Configure third-party inference enthält
- Ein CometAPI-Konto mit einem aktiven API-Schlüssel
- Zugriff auf Claude-Modelle in CometAPI
- Ein Netzwerkpfad, der
https://api.cometapi.comerreichen kann
Konfiguration
Developer mode 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 erreichbar sein. Fokussieren Sie das E-Mail-Feld, drücken Sie
Tab, bis das Menü fokussiert ist, und drücken Sie dann Enter.Einstellungen für third-party inference öffnen
Nachdem Developer mode aktiviert wurde, öffnen Sie Developer → Configure third-party inference.Das Konfigurationsfenster öffnet sich mit mehreren Abschnitten in der linken Seitenleiste. Verwenden Sie für die CometAPI-Einstellungen den Abschnitt Connection.
Das gateway konfigurieren
Geben Sie im Abschnitt Connection die folgenden CometAPI-Werte ein:
Behalten Sie die base URL exakt wie gezeigt bei. Claude Desktop erfordert eine HTTPS-base URL.Der folgende Screenshot zeigt den Abschnitt Connection mit ausgefüllten CometAPI-Werten.
| Field | Value |
|---|---|
| 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 |

Model IDs hinzufügen
Fügen Sie in Model list diese model IDs manuell hinzu:
Das erste Modell in der Liste wird zum Standardmodell. Setzen Sie 
| Model ID | Empfohlene Verwendung |
|---|---|
claude-opus-4-7 | Komplexe Planung und Agentenaufgaben |
claude-sonnet-4-6 | Allgemeine Desktop-Nutzung |
claude-haiku-4-5-20251001 | Leichtgewichtige Prompts und schnelle Entwürfe |
claude-sonnet-4-6 an die erste Stelle, wenn Sie einen allgemeinen Standard möchten.Der folgende Screenshot zeigt die Modellliste mit den drei für CometAPI konfigurierten Claude model IDs.
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.
Eine Cowork-Sitzung starten
Wählen Sie auf dem Anmeldebildschirm die Option für Cowork on third-party inference. Ö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.
Verify the configuration
Verwenden Sie einen kurzen Prompt, der keine externen Tools erfordert:
Fehlerbehebung
Developer-Menü wird nicht angezeigt
Developer-Menü wird nicht angezeigt
Claude Desktop öffnet den Standard-Anmeldeablauf
Claude Desktop öffnet den Standard-Anmeldeablauf
Prüfen Sie diese Punkte:
- Inference provider ist auf Gateway gesetzt.
- Gateway base URL ist
https://api.cometapi.com. - Gateway API key enthält Ihren CometAPI-API-Schlüssel ohne zusätzliche Leerzeichen.
- Sie haben Apply locally angeklickt und Claude Desktop vollständig neu gestartet.
Verbindungsvalidierung schlägt fehl
Verbindungsvalidierung schlägt fehl
Bestätigen Sie, dass die base URL mit
https:// beginnt. Claude Desktop akzeptiert keine einfachen HTTP-gateway-URLs.Bestätigen Sie außerdem, dass Ihr CometAPI-Konto Zugriff auf Claude-Modelle hat und dass der API-Schlüssel nicht gelöscht oder deaktiviert wurde.Konfigurierte Modelle werden nicht angezeigt
Konfigurierte Modelle werden nicht angezeigt
Öffnen Sie erneut Developer → Configure third-party inference und prüfen Sie die Einträge in Model list. Model IDs müssen exakt mit den IDs übereinstimmen, die CometAPI bereitstellt.Fügen Sie jede model ID als separaten Eintrag hinzu. Fügen Sie in den UI-Feldern keine Anführungszeichen, Kommas oder zusätzlichen Leerzeichen ein.
Eine OpenAI-compatible base URL funktioniert nicht
Eine OpenAI-compatible base URL funktioniert nicht
Claude Desktop third-party inference erwartet für diesen Ablauf ein Anthropic-compatible gateway. Verwenden Sie
https://api.cometapi.com und die oben aufgeführten Claude model IDs.Die Registerkarte Code verhält sich anders
Die Registerkarte Code verhält sich anders
Die Registerkarte Code 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 die Integrationsanleitung für Claude Code.