Einrichtungsanleitung · Stand 22. November 2026

Claude API in Cherry Studio 2.2.3 einrichten: eigener Anbieter und Base URL

Stand 22. November 2026 lautet die Einrichtung in Cherry Studio 2.2.3 so: Öffnen Sie Settings über das Zahnrad unten links, gehen Sie zu Model Provider, klicken Sie unten in der Liste auf + Add Provider und dann auf Add Custom Provider, geben Sie dem Anbieter einen Namen und fügen Sie den API key ein, der mit cr_ beginnt, tragen Sie https://api.qcode.cc/api in der Zeile Anthropic ein (ohne /v1; Cherry erzeugt https://api.qcode.cc/api/v1/messages), klicken Sie auf Add und setzen Sie ein Häkchen bei claude-sonnet-5-5; für GPT erstellen Sie einen zweiten Anbieter mit demselben key und tragen https://api.qcode.cc/openai in der Zeile OpenAI ein. Getestet unter Windows 11 (englische Oberfläche) am 2026-11-21: die Antwort Hello! kam zurück.

Aktualisiert 2026-11-22

Richten Sie dieses Tool auf den QCode-Endpunkt — ein Key für Claude, GPT, DeepSeek und Qwen.

#Oberfläche 2.2.3#Zeile Anthropic#Zeile OpenAI#ein cr_ key

Vier Werte zum Merken

2.2.3

Kein Dropdown für den Anbietertyp

In 2.2.3 entscheidet der Dialog Add Custom Provider über das Protokoll, je nachdem, welche Zeile Sie ausfüllen: Anthropic für Claude, OpenAI für GPT und chinesische Modelle. Das Dropdown, das ältere Anleitungen beschreiben, gibt es nicht mehr.

/api

Stammadresse für die Zeile Anthropic

Tragen Sie https://api.qcode.cc/api ein, und Cherry erzeugt https://api.qcode.cc/api/v1/messages; die Vorschauzeile Anthropic auf der Anbieterseite zeigt genau diesen vollständigen Pfad.

/openai

Stammadresse für die Zeile OpenAI

Tragen Sie https://api.qcode.cc/openai ein, und Cherry erzeugt https://api.qcode.cc/openai/v1/chat/completions; OpenAI Responses unter More options nimmt dieselbe Adresse und bedient nur GPT.

cr_

Ein key, zwei Anbieter

An keiner Stelle des Ablaufs ist ein Cherry Studio Konto nötig: klicken Sie auf der Willkommensseite auf Set up later. Ein key, der mit cr_ beginnt, deckt zwei Anbieter ab, einen in der Zeile Anthropic und einen in der Zeile OpenAI.

Wie sich ältere Builds von 2.2.3 unterscheiden

Das Hinzufügen eines Anbieters in Cherry Studio 2.2.3 öffnet einen Dialog mit dem Titel Add Custom Provider, in dem kein Dropdown für den Anbietertyp mehr vorhanden ist: Das Protokoll ergibt sich daraus, welche Base URL Zeile Sie ausfüllen, die Zeile Anthropic bedeutet also das Anthropic-Protokoll und die Zeile OpenAI das OpenAI-Protokoll.

Ein Anbieter spricht ein Protokoll, deshalb bedeutet Claude und GPT parallel zu nutzen zwei Anbieter mit demselben cr_ key. Claude läuft ausschließlich über die Zeile Anthropic: QCodes OpenAI-Endpunkt antwortet für Claude-Modelle mit model_not_available_on_endpoint. Ältere Versionen nennen diese Einstellungsseite Model Services; 2.2.3 nennt sie Model Provider, und sie öffnet sich über das Zahnrad unten links in der App.

Drei Stellen in der Oberfläche in 2.2.3

Erstens erschien Cherry Studio 2.2.3 am 2026-11-19 als stabile Version, und die englische Downloadseite schreibt Stable Release · 11/19/2026. Zweitens fragt Cherry nach dem Klick auf Add sofort /models unter der Base URL nach der Modellliste ab und öffnet ein Fenster mit dem Titel QCode · Choose models; 2.2.3 hat keine Schaltfläche zum Abrufen der Modellliste, ein erneuter Abruf erfolgt daher über Sync models auf der Anbieterseite. Drittens enthält die Anbieterseite eine Schaltfläche Model Check, um ein Modell zu testen.

Drei Zeitpunkte: das Release, die erste Antwort, der zweite Anbieter

2026-11-19

Cherry Studio 2.2.3 erschien als stabile Version, und die englische Downloadseite schreibt sie als Stable Release · 11/19/2026 · Changelog; dieser Build wird für diese Einrichtung verwendet.

2026-11-21

Unter Windows 11 in der englischen Oberfläche, 2.2.3 mit https://api.qcode.cc/api in der Zeile Anthropic, claude-sonnet-5-5 angehakt, Say hello in one short sentence gesendet, Hello! empfangen.

2026-11-21

Ein zweiter Anbieter mit dem Namen QCode OpenAI wurde mit demselben cr_ key hinzugefügt, https://api.qcode.cc/openai in der Zeile OpenAI und ohne eingetipptes /v1; nach dem Anhaken von GPT-6.2 Sol wurde das Modell normal aufgelistet.

Bestätigt vs. drei leicht zu übersehende Punkte

Bestätigt (Praxis am 2026-11-21 und der Text der docs)

  1. 1Adressen: Die Zeile Anthropic mit https://api.qcode.cc/api wird zu /api/v1/messages, die Zeile OpenAI mit https://api.qcode.cc/openai wird zu /openai/v1/chat/completions, und beide nehmen nur die Stammadresse, ohne /v1 und ohne abschließenden Schrägstrich.
  2. 2Modelle: Der Anthropic-Endpunkt liefert claude-sonnet-5-5, claude-sonnet-5, claude-opus-5-5 und claude-haiku-5-5; der OpenAI-Endpunkt liefert gpt-6.2-sol, gpt-6.2-astra und chinesische Modelle wie glm-5.3.
  3. 3Modellliste: Add ruft sie automatisch in einem Dialog mit dem Titel QCode · Choose models ab, spätere Abrufe nutzen Sync models auf der Anbieterseite, und bei einem Fehler erscheinen Add model manually, eine rote Zeile Failed to pull models und Retry.
  4. 4Protokollgrenzen: Der OpenAI-Endpunkt antwortet für Claude-Modelle mit model_not_available_on_endpoint, chinesische Modelle antworten auch am Anthropic-Endpunkt, und Agent-Funktionen erwarten einen Anbieter auf dem Anthropic-Protokoll.
  5. 5Konten: Weder ein Cherry Studio Konto noch ein Konto eines Modellanbieters ist nötig; Set up later auf der Willkommensseite genügt.
  6. 6Schnittstellennamen: 2.2.3 sagt Model Provider, + Add Provider und Sync models, ältere Versionen sagen Model Services, + Add a provider und sync models.

Drei leicht zu übersehende Punkte

  1. 1Type: 2.2.3 hat kein Dropdown für den Type; die Stamm-Adresse in die Zeile Anthropic einzutragen ist das, was das Anthropic-Protokoll auswählt.
  2. 2/v1: Cherry hängt /v1/messages selbst an, ein eingetragenes /v1 macht den Pfad zu /api/v1/v1/messages und jede Anfrage liefert 404.
  3. 3Accounts: Weder ein Cherry-Konto noch ein Anbieterkonto ist nötig; klicken Sie auf der Willkommensseite auf Set up later und verwenden Sie den cr_-Schlüssel aus der Konsole.

Wohin die API-Adresse gehört: Zeile Anthropic versus Zeile OpenAI

Zeile Anthropic: Claude und auch chinesische Modelle

Setzen Sie die Base URL auf https://api.qcode.cc/api; der Vorschaupfad ist https://api.qcode.cc/api/v1/messages und die Modell-IDs sind claude-sonnet-5-5, claude-sonnet-5, claude-opus-5-5 und claude-haiku-5-5. Die docs merken an, dass chinesische Modelle auch am Anthropic-Endpunkt antworten, und Agent-Funktionen erwarten einen Anbieter auf diesem Protokoll.

Zeile OpenAI: GPT und chinesische Modelle

Setzen Sie die Base URL auf https://api.qcode.cc/openai; der Pfad in der Vorschau ist https://api.qcode.cc/openai/v1/chat/completions, und die Modell-IDs sind gpt-6.2-sol, gpt-6.2-astra und chinesische Modelle wie glm-5.3. Claude wird in dieser Zeile abgelehnt, und OpenAI Responses unter More options nutzt dieselbe Adresse und bedient nur GPT.

Neun Schritte von der Download-Seite bis zur ersten Antwort

  1. 1Öffnen Sie cherryai.com/download, wo Windows · x64 bereits ausgewählt ist, und klicken Sie auf Download Windows Standard; die Datei ist Cherry-Studio-2.2.3-win-x64-setup.exe, etwa 286 MiB.
  2. 2Starten Sie das Installationsprogramm: Der englische Assistent hat 4 Bildschirme, Choose Installation Options, Choose Install Location, Installing und Completing Cherry Studio Setup. Auf einem sauberen System wird zuerst der VC++-Runtime-Installer ausgeführt und es erscheint eine Benutzerkontensteuerung mit dem Herausgeber Microsoft Corporation; die App selbst wird pro Benutzer installiert, Administratorrechte sind nicht nötig.
  3. 3Klicken Sie beim ersten Start auf der Willkommensseite auf Set up later; eine Anmeldung ist nicht beteiligt.
  4. 4Klicken Sie unten links auf das Zahnrad, um Settings zu öffnen, suchen Sie Model Provider und klicken Sie unten in der Anbieterliste auf + Add Provider.
  5. 5Geben Sie in Add Custom Provider einen Namen wie QCode in Provider Name ein, fügen Sie den cr_ key in API Key ein und tragen Sie https://api.qcode.cc/api in der Anthropic-Zeile ein, nur die Stammadresse, kein /v1.
  6. 6Klicken Sie auf Add; Cherry ruft die Modelle sofort ab und öffnet QCode · Choose models, setzen Sie also ein Häkchen bei Claude Sonnet 5.5 (der graue Text in der Zeile ist die ID claude-sonnet-5-5) und klicken Sie auf Add selected models; dann erscheint ein kleines Fenster QCode · Verify and enable, Cherry sendet eine Testanfrage mit dem gewählten Modell, und Sie klicken auf Done, wenn sie abgeschlossen ist.
  7. 7Zurück im Chatfenster wechselt die Modellschaltfläche oben von Select Model zu Claude Sonnet 5.5 | QCode; senden Sie Say hello in one short sentence, und eine Antwort Hello! bedeutet, dass der Anbieter funktioniert.
  8. 8Optional: Klicken Sie erneut auf + Add Provider für einen zweiten Anbieter mit demselben cr_ key, diesmal mit https://api.qcode.cc/openai in der OpenAI-Zeile, wieder ohne /v1, und setzen Sie ein Häkchen bei GPT-6.2 Sol.
  9. 9Um die Liste später erneut abzurufen, nutzen Sie Sync models auf der Anbieterseite oder testen Sie ein Modell mit Model Check; um zu bestätigen, dass Anfragen QCode erreichen, fügen Sie denselben key unter probe.qcode.cc ein und sehen Sie sich den Traffic an.

Die QCode-Seite: ein cr_ key, zwei Anbieter

Das Protokoll entscheidet der Anfragepfad, nicht der key: Mit einem cr_ key erreicht https://api.qcode.cc/api in der Anthropic-Zeile Claude und https://api.qcode.cc/openai in der OpenAI-Zeile GPT und chinesische Modelle. Ersetzen Sie api.qcode.cc durch asia.qcode.cc oder us.qcode.cc, bleiben sowohl die Pfade als auch der key unverändert.

Die Abrechnung erfolgt pro Token; aktuelle Preise für jedes Modell finden Sie unter /models. Noch kein Monatsplan? Nutzungspakete beginnen bei $4 für ein einmaliges Kontingent, das Sie innerhalb von 7 Tagen verbrauchen; wenn Sie bereits einen Privatplan haben, fügen Sie ein Booster-Pack hinzu, wenn Sie mehr Kontingent benötigen. Um zu sehen, ob Anfragen bei QCode ankommen, fügen Sie denselben key unter probe.qcode.cc ein.

Cherry Studio einrichten, Schritt für Schritt

Das Tutorial in den docs führt Sie von der Download-Seite bis zur ersten Antwort, mit nummerierten Screenshots unter Windows in der englischen Oberfläche. Die Bilder unten zeigen die zwei fertigen Anbieter-Karten: Die erste enthält die Stamm-Adresse von Anthropic und ihren Vorschau-Pfad, die zweite die OpenAI-Adresse mit dem Modell GPT-6.2 Sol.

Englische Oberfläche: Beim QCode-Anbieter lautet Anthropic API Host https://api.qcode.cc/api, die Vorschauzeile lautet https://api.qcode.cc/api/v1/messages, und die Modellliste zeigt Claude Sonnet 5.5.
Prüfung eins: Der Anthropic API Host lautet https://api.qcode.cc/api und die Vorschauzeile darunter lautet https://api.qcode.cc/api/v1/messages, englische Oberfläche.
Englische Oberfläche: Der zweite Anbieter, QCode OpenAI, hat https://api.qcode.cc/openai in seinem API Host (kein /v1), und die Modellliste zeigt GPT-6.2 Sol.
Prüfung zwei: Der API Host des zweiten Anbieters lautet https://api.qcode.cc/openai ohne /v1, und das Modell ist GPT-6.2 Sol, englische Oberfläche.

Cherry Studio 2.2.3 unter Windows 11, geprüft am 2026-11-21; die Screenshots nutzen die englische Oberfläche, und die Formulierungen ändern sich zwischen Versionen, folgen Sie daher der Version, die Sie haben.

Häufige Fragen

In Cherry Studio 2.2.3 gibt es kein Dropdown für den Anbietertyp. Wie wähle ich Anthropic?

In 2.2.3 gibt es keinen Typ zum Auswählen: Wenn Sie https://api.qcode.cc/api in der Anthropic-Zeile des Dialogs Add Custom Provider eintragen, wählt das das Anthropic-Protokoll, und Claude-Modelle laufen nur über diese Zeile. Tragen Sie sie stattdessen in der OpenAI-Zeile ein, antwortet der OpenAI-Endpunkt von QCode mit model_not_available_on_endpoint. Das Dropdown für den Anbietertyp, das ältere Tutorials zeigen, gibt es in 2.2.3 nicht mehr.

Muss die API-Adresse in Cherry Studio /v1 enthalten?

Nein. Geben Sie nur die Stammadresse ein: https://api.qcode.cc/api in der Anthropic-Zeile und https://api.qcode.cc/openai in der OpenAI-Zeile, ohne /v1 und ohne abschließenden Schrägstrich. Cherry hängt /v1/messages oder /v1/chat/completions selbst an, ein eingetipptes /v1 erzeugt also /api/v1/v1/messages und jede Anfrage liefert 404. Die Docs ergänzen einen Hinweis: Ein # am Ende schaltet das Anhängen ab, das ist für Anbieter gedacht, die einen festen vollständigen Pfad brauchen, und die normalen QCode-Adressen benötigen es nie.

Was mache ich bei model_not_available_on_endpoint oder wenn jede Anfrage 404 zurückgibt?

Die beiden deuten auf zwei verschiedene Fehler hin. model_not_available_on_endpoint bedeutet, dass das Modell in der falschen Zeile steht: Claude-Modelle wurden in der Zeile OpenAI eingetragen, die der OpenAI-Endpunkt von QCode nicht bedient, verschieben Sie die Stamm-Adresse daher in die Zeile Anthropic unter https://api.qcode.cc/api. Bei einem 404 für jede Anfrage prüfen Sie zuerst, ob /v1 in die Base URL eingetragen wurde (Cherry macht daraus /api/v1/v1/messages), und setzen Sie die Base URL auf die Stamm-Adresse https://api.qcode.cc/api zurück; vergleichen Sie danach die Zeile Anthropic preview auf der Anbieterseite, denn der Pfad muss genau übereinstimmen.

Brauche ich für die Nutzung von QCode in Cherry Studio ein Cherry-Konto oder ein Anthropic-Konto?

Weder noch: Ein QCode key, der mit cr_ beginnt, genügt. Die Docs formulieren es so: No Cherry Studio account is needed at any point, und Set up later auf der Willkommensseite führt in die App, wobei alles lokal konfiguriert ist. Eine Meldung, die wie ein Fehler aussieht, aber nichts damit zu tun hat: Cherry benennt Unterhaltungen mit seinem eingebauten Modell CherryAI, daher zeigt eine abgemeldete App Failed to auto-generate conversation name, was nichts mit den Antworten von QCode zu tun hat.

Warum hat ein einzelnes hello zehntausende Token verbraucht?

Weil der erste Chat in Cherry Support läuft, einem vorgefertigten Agent, der mit jeder Nachricht einen langen System-Prompt sendet, können selbst ein einziges Hallo mehrere zehntausend Token kosten. Für alltägliche Chats klicken Sie oben auf Add Agent, starten Sie einen einfachen Assistenten und wählen Sie ein QCode-Modell.

Nach dem Klick auf Add erscheint Failed to pull models, oder die Modellliste ist leer. Was nun?

Klicken Sie zuerst im Dialog auf Retry; schlägt es erneut fehl, prüfen Sie, ob die Base URL die Stammadresse ist (kein /v1, kein abschließender Schrägstrich), und nutzen Sie dann Add model manually im selben Dialog und geben Sie die Modell-ID ein: claude-sonnet-5-5 für Claude, gpt-6.2-sol für GPT. Um die Liste später erneut abzurufen, klicken Sie auf der Anbieterseite auf Sync models. Um zu sehen, ob Anfragen QCode tatsächlich erreichen, fügen Sie denselben key unter probe.qcode.cc ein und sehen Sie sich den Traffic an.

Quellen

QCode Docs, Tutorial zur Einrichtung in Cherry Studio (Englisch, Windows, Screenshots aktualisiert 2026-11); praktischer Durchlauf unter Windows 11 in der englischen Oberfläche am 2026-11-21; englische Download-Seite von Cherry Studio (2.2.3, stabile Version 2026-11-19).

Verbinden Sie Claude und GPT in Cherry Studio

Erstellen Sie ein Konto für einen cr_ key, tragen Sie https://api.qcode.cc/api in der Anthropic-Zeile und https://api.qcode.cc/openai in der OpenAI-Zeile ein; die Abrechnung erfolgt pro Token, Preise unter /models.

Unsicher, womit Sie anfangen sollen?

Eine Woche ausprobieren

Kleinpaket für $4: $30 Kontingent, 7 Tage gültig

Täglich im Einsatz

Starter für $9.00 pro Monat mit $5 Kontingent pro Tag: nur etwa $0.060 pro $1 Kontingent, beim Mittelpaket etwa $0.113