Cherry Studio mit Claude verbinden

Cherry Studio ist ein übersichtlicher Desktop-Client für Chats mit vielen Modellen und unterstützt das native Anthropic-Format direkt. Wenn Sie das Gateway von AI Prime Tech als Anbieter vom Typ Anthropic hinzufügen, steht Ihnen Claude im selben Fenster wie alle anderen von Ihnen verwendeten Modelle zur Verfügung – mit einem Host und einem Schlüssel.

Modelldienste öffnen

Gehen Sie zu den Einstellungen und öffnen Sie die Modelldienste. Hier listet Cherry Studio alle Anbieter auf, mit denen es kommunizieren kann, und hier fügen Sie neue hinzu. Klicken Sie auf das Plus, um einen Anbieter hinzuzufügen. Anschließend werden Sie nach dessen Typ gefragt.

Die Wahl des Typs ist wichtig, weil sie das Übertragungsformat festlegt. Für Claude über das Gateway benötigen Sie den Typ Anthropic, der die native /v1/messages-Schnittstelle statt eines Endpunkts im OpenAI-Stil verwendet.

Da Cherry Studio Anbieter in einer Liste verwaltet, steht das Gateway neben allen anderen Diensten, die Sie eingerichtet haben, und Sie können für jede Unterhaltung zwischen ihnen wechseln. Das macht es zu einer komfortablen Umgebung für ein Multi-Modell-Gateway: Ein Anbietereintrag kann mehrere Claude-Modelle enthalten, die Sie bei Bedarf aus dem Menü auswählen. Dass das Gateway als ein Eintrag unter mehreren behandelt wird, macht Cherry Studio zu einer komfortablen Steuerzentrale für mehrere Modelle. Sie wechseln den Anbieter für jede Unterhaltung, ohne die App zu verlassen.

Den Typ Anthropic auswählen

Wählen Sie Anthropic als Anbietertyp aus und aktivieren Sie ihn. Cherry Studio zeigt dann zwei Felder an, die alles bestimmen: den API-Schlüssel und den API-Host. Fügen Sie Ihren Gateway-Schlüssel in das Schlüsselfeld ein.

Da der Typ das native Anthropic-Format verwendet, sendet Cherry Studio Anfragen im Messages-Format, das das Gateway für Claude bereitstellt. Sobald der Typ festgelegt ist, müssen Sie sich um keinen separaten Protokollschalter kümmern.

Wenn Ihr Gateway auch eine OpenAI-kompatible Schnittstelle für andere Modelle bereitstellt, fügen Sie diese als separaten Anbieter vom Typ OpenAI hinzu, statt sie in diesen Eintrag aufzunehmen. Wenn der Eintrag vom Typ Anthropic ausschließlich für Claude verwendet wird, bleibt das Übertragungsformat eindeutig und Verwechslungen zwischen Protokollen werden vermieden. Protokolle in getrennten Anbietereinträgen zu halten, ist eine kleine organisatorische Maßnahme, die später viel Verwirrung verhindert. Jeder Eintrag hat dann genau ein Übertragungsformat, das berücksichtigt werden muss.

Den API-Host korrekt einstellen

Der API-Host ist das Feld, bei dem am häufigsten Fehler passieren. Geben Sie nur die Host-Stammadresse ein, ohne /v1 am Ende, da Cherry Studio den Versionspfad selbst anhängt. Wenn Sie /v1 selbst hinzufügen, entsteht ein doppelter Pfad, und die Anfrage schlägt fehl.

Der Wert ist also lediglich der Gateway-Host. Wenn nach dem Hinzufügen eines Anbieters 404-Fehler oder Pfadfehler auftreten, ist fast immer ein versehentlich hinzugefügtes /v1 im API-Host die Ursache.

Ein abschließender Schrägstrich am Host verursacht dieselbe Art von Fehler. Geben Sie daher nur den Host ein, ohne etwas dahinter. Wenn eine Anfrage fehlschlägt, prüfen Sie zur schnellsten Diagnose zunächst das Feld API-Host und entfernen Sie alles nach dem Hostnamen, bevor Sie an anderer Stelle suchen. Wenn etwas fehlschlägt, lassen sich die meisten Einrichtungsprobleme sofort lösen, indem Sie zuerst dieses eine Feld überprüfen. Das Ziel ist ein reiner Host ohne Suffix.

Die URL-Fixierung mit abschließendem Rautezeichen

Cherry Studio unterstützt einen kleinen, aber wichtigen Trick: Wenn Sie den API-Host mit einem # abschließen, verwendet der Client genau diese URL, ohne etwas anzuhängen. So erzwingen Sie einen exakten Endpunkt, wenn das automatische Anhängen stört.

Bei einem Standard-Gateway lassen Sie den Host normalerweise ohne Zusatz und überlassen Cherry Studio das Anhängen. Verwenden Sie # nur, wenn Ihr Gateway einen exakten Pfad benötigt, den das automatische Anhängen sonst verfälschen würde.

Gerade weil # nicht offensichtlich ist, lohnt es sich, dieses Zeichen im Gedächtnis zu behalten: Es ist der Ausweg für jedes Gateway, dessen Pfad nicht der Standardannahme von Cherry Studio entspricht. Falls das automatisch angehängte /v1/messages nicht zu dem passt, was Ihr Gateway erwartet, können Sie mit # die vollständige URL von Hand angeben. Wenn Sie sich den #-Trick jetzt merken, erkennen Sie die Lösung sofort, falls ein Pfad einmal nicht passt. Diese eine Überschreibung deckt jeden vom Standard abweichenden Gateway-Pfad ab.

Ein Modell auswählen und chatten

Fügen Sie unter dem Anbieter die gewünschten Claude-Modelle hinzu und verwenden Sie dabei die IDs, die das Gateway bereitstellt, etwa claude-sonnet-4-5 für alltägliche Chats und claude-opus-4-8 für anspruchsvollere Denkaufgaben. Sie erscheinen dann im Modellmenü von Cherry Studio.

Starten Sie eine Unterhaltung und wählen Sie ein Claude-Modell aus dem Menü aus. Damit kommunizieren Sie mit dem Gateway. Da der Anbieter das native Anthropic-Format verwendet, funktionieren Funktionen, die vom Messages-Format abhängen, wie erwartet.

Sie können mehrere Unterhaltungen mit unterschiedlichen Claude-Modellen gleichzeitig geöffnet halten. Das ist praktisch, um zu vergleichen, wie Sonnet und Opus mit demselben Prompt umgehen. Da alle über denselben Gateway-Anbieter laufen, wählen Sie zum Modellwechsel einfach einen Menüeintrag aus, statt die Konfiguration zu ändern. Der direkte Modellvergleich ist einer der unaufdringlichen Vorzüge, wenn alles über einen einzigen Anbieter läuft. Zwischen demselben Prompt für Sonnet und Opus liegt nur ein Wechsel im Menü.

# Cherry Studio -> Settings -> Model Services -> + Add
# Provider type: Anthropic   (native /v1/messages)
# API Key:  <your gateway key>
# API Host: https://aiprimetech.io        (root only, NO /v1 -- it auto-appends)
#   end with #  ->  https://aiprimetech.io#   to lock the exact URL
# Model: claude-sonnet-4-5

Häufig gestellte Fragen

AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber.