Zum Hauptinhalt springen
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:
Third-party inference in Claude Desktop erfordert ein Anthropic-compatible gateway. CometAPI unterstützt Claude-Modelle über die Anthropic Messages API.
Inhalte, die Sie aus Claude Desktop senden, werden von CometAPI und dem ausgewählten Modellanbieter verarbeitet. Senden Sie keine vertraulichen Daten, es sei denn, Ihre Organisation erlaubt diesen Workflow.

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.com erreichen kann
Starten Sie beim Claude Desktop-Anmeldebildschirm. Wenn Sie sich bereits mit einem Anthropic-Konto angemeldet haben, melden Sie sich ab, bevor Sie third-party inference konfigurieren.

Konfiguration

1

Developer mode aktivieren

Öffnen Sie Claude Desktop und bleiben Sie auf dem Anmeldebildschirm. Öffnen Sie im Anwendungsmenü HelpTroubleshooting 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.
2

Einstellungen für third-party inference öffnen

Nachdem Developer mode aktiviert wurde, öffnen Sie DeveloperConfigure third-party inference.Das Konfigurationsfenster öffnet sich mit mehreren Abschnitten in der linken Seitenleiste. Verwenden Sie für die CometAPI-Einstellungen den Abschnitt Connection.
3

Das gateway konfigurieren

Geben Sie im Abschnitt Connection die folgenden CometAPI-Werte ein:
FieldValue
Inference providerGateway
GatewayAnthropic-compatible
Gateway base URLhttps://api.cometapi.com
Gateway API keyIhr CometAPI-API-Schlüssel, zum Beispiel <COMETAPI_KEY>
Gateway auth schemeBearer
Gateway extra headersLeer lassen
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.Claude Desktop-Connection-Einstellungen mit ausgefüllter CometAPI-gateway-base-URL, API-key-Feld und bearer-auth-scheme
4

Model IDs hinzufügen

Fügen Sie in Model list diese model IDs manuell hinzu:
Model IDEmpfohlene Verwendung
claude-opus-4-7Komplexe Planung und Agentenaufgaben
claude-sonnet-4-6Allgemeine Desktop-Nutzung
claude-haiku-4-5-20251001Leichtgewichtige 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.
Die Modellverfügbarkeit kann sich ändern. Wenn ein Modell nach der Konfiguration nicht in Claude Desktop erscheint, prüfen Sie den Zugriff auf der CometAPI Models page.
Der folgende Screenshot zeigt die Modellliste mit den drei für CometAPI konfigurierten Claude model IDs.Claude Desktop-Modellliste mit claude-opus-4-7, claude-sonnet-4-6 und claude-haiku-4-5-20251001 für CometAPI
5

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

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:
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. Claude Desktop-Cowork-Antwort mit CometAPI nach der Einrichtung von third-party inference Um die erkannten Einstellungen zu prüfen, öffnen Sie HelpTroubleshootingCopy Managed Configuration Report. Geheime Werte werden im kopierten Bericht geschwärzt.

Fehlerbehebung

Bestätigen Sie, dass Sie HelpTroubleshootingEnable Developer Mode ausgewählt haben. Beenden Sie Claude Desktop dann vollständig und öffnen Sie es erneut.Wenn die Option fehlt, installieren Sie einen Claude Desktop-Build, der die Konfiguration von third-party inference enthält.
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.
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.
Öffnen Sie erneut DeveloperConfigure 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.
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 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.