Wenn eine KI-Anwendung keine Antwort liefert, hilft eine Neuinstallation selten dabei, einen falsch eingetragenen API-Pfad zu finden. Ich möchte deshalb beim Einrichten von Cherry Studio gleich zeigen, welche Einstellung welchen Teil der Verbindung bestimmt. Damit lässt sich später gezielt nachsehen, wenn ein Schlüssel ersetzt wurde oder ein anderes Modell verwendet werden soll.
Wir installieren den Windows-Client, verbinden einen API-Anbieter und wählen ein Modell für den Chat aus. Für diesen Ablauf braucht ihr weder ein Terminal noch eigenen Programmcode.
Cherry Studio gehört zu den länger bestehenden Desktop-Werkzeugen für KI: Das offizielle Repository wurde im Mai 2024 angelegt. Bis Oktober 2026 liegen damit mehr als zwei Jahre Entwicklung dazwischen. Die Anwendung bündelt Gespräche mit verschiedenen Modellen und bietet weitere Funktionen wie Agenten und Wissenssammlungen.
Stand 30. Oktober 2026 ist v2.1.8 die aktuelle stabile Version, veröffentlicht am 26. Oktober 2026. Sie bildet die Versionsgrundlage dieses Tutorials; die Dateien stehen im offiziellen Release.
Die Abbildungen zeigen die chinesische Oberfläche. Ich erkläre die jeweiligen Bedienelemente im Text auf Deutsch. Die Bilder enthalten keine Versionsanzeige und dienen deshalb nicht als eigenständiger Nachweis für die installierte Versionsnummer.
Transparenz zur Erstellung: Der Artikeltext und die Übungsaufgabe wurden von einem KI-Agenten anhand bereitgestellter Screenshots und offizieller Dokumentation erstellt. Die Übungsaufgabe wurde für diesen Artikel nicht als neuer Modelltest ausgeführt.
Vor dem Download: Was gehört zur API-Verbindung?
Für den hier gezeigten Zugang benötigt ihr einen API-Schlüssel. Eine offizielle API des Modellherstellers funktioniert ebenso wie ein kompatibler Anbieter eurer Wahl. Ich nutze gewöhnlich Crazyrouter und verwende es hier als Beispiel. Wer bereits einen anderen Dienst nutzt, übernimmt dessen zusammengehörige Zugangsdaten und Schnittstelleneinstellungen.
Vier Angaben haben dabei unterschiedliche Aufgaben:
| Angabe | Was sie festlegt |
|---|---|
| Anbietername | Unter welchem Namen die Verbindung in Cherry Studio erscheint |
| API-Schlüssel | Womit sich die Anwendung beim Dienst authentifiziert |
| Endpunkt und API-Format | Wohin und in welchem Format die Anfrage gesendet wird |
| Modell | Welches verfügbare Modell die Anfrage bearbeiten soll |
Ein Anzeigename wie Crazyrouter allein stellt noch keine Verbindung her. Ebenso muss ein gültiger Schlüssel zum eingetragenen Dienst passen. Cherry Studio liefert die Oberfläche; der API-Anbieter verwaltet den Zugang zu den verbundenen Modellen und deren Nutzung.
Cherry Studio aus der offiziellen Quelle installieren
Öffnet die offizielle Downloadseite von Cherry Studio und wählt das Windows-Paket für euren Prozessor. Auf üblichen Intel- und AMD-PCs ist das x64. Für Windows-Geräte mit ARM-Prozessor gibt es ARM64. Den Systemtyp findet ihr bei Bedarf in den Windows-Einstellungen unter System → Info.
Für die hier verwendete Versionsgrundlage heißt der x64-Installer:
Cherry-Studio-2.1.8-win-x64-setup.exe
Startet die Datei, folgt dem Installationsassistenten und öffnet anschließend Cherry Studio. setup bezeichnet hier das Installationspaket; eine Datei mit portable ist die portable Variante. Wer den Artikel später liest, prüft die Versionsnummer über das jeweils neueste offizielle Release.
Den API-Schlüssel anlegen und die Verbindung speichern
Ich würde für die Anwendung einen eigenen Schlüssel mit einem erkennbaren Namen wie cherry-studio anlegen. Im Crazyrouter-Dashboard öffnet ihr dafür API Keys und verwendet Create API Key. Falls ihr noch keinen Zugang habt, legt ihr zuerst beim gewählten API-Dienst ein Konto an.
Kopiert den vollständigen Schlüssel mit der Kopierfunktion. Die gekürzte Anzeige mit Sternchen ist kein verwendbarer Schlüssel. Auch das Passwort eures Kontos gehört nicht in das API-Feld. Wenn ihr später eigene Screenshots teilt, verdeckt den gesamten Schlüssel.
In Cherry Studio öffnet das Zahnrad unten links die Einstellungen.
Wechselt zu den Modelldiensten. Unterhalb der Anbieterliste findet ihr die Funktion zum Hinzufügen eines Anbieters.
Tragt im Dialog Crazyrouter als Namen und den kopierten Schlüssel als API-Schlüssel ein. Für das hier gezeigte OpenAI-kompatible Format lautet der Endpunkt:
https://api.crazyrouter.com
Die Bezeichnung OpenAI beschreibt an dieser Stelle das API-Format. Sie bedeutet nicht, dass ihr für den gewählten kompatiblen Dienst einen Schlüssel von OpenAI einsetzen sollt. Der ebenfalls sichtbare Anthropic-Endpunkt gehört zu einem anderen Protokoll; wir bleiben für diesen Chat bei der OpenAI-kompatiblen Konfiguration.
Den erzeugten Anfragepfad vor dem Speichern lesen
Unter dem Adressfeld zeigt die Oberfläche den zusammengesetzten Anfragepfad. Für die obige Eingabe soll dort stehen:
https://api.crazyrouter.com/v1/chat/completions
Cherry Studio ergänzt in dieser Konfiguration also den Pfad. Wird ein vollständiger Endpunkt in ein Feld kopiert, das selbst noch einen Pfad anfügt, kann eine falsche Adresse entstehen. Achtet besonders auf doppelte Abschnitte wie /v1.
Die Integrationsdokumentation für Cherry Studio beschreibt diese Eingabe der Basisadresse. Für andere Clients oder Anbieter kann eine andere Form erforderlich sein. Entscheidend sind deren Dokumentation und die tatsächlich angezeigte Zieladresse.
Sind die Angaben vollständig, fügt ihr den Anbieter hinzu.
Die angebotenen Modelle auswählen
Der folgende Dialog zeigt 168 Modelle. Das ist die Anzahl in der abgebildeten Liste zum Zeitpunkt der Aufnahme und keine dauerhaft zugesicherte Gesamtzahl.
Ihr könnt die gewünschten Modelle direkt anhaken und anschließend mit dem Knopf unten rechts hinzufügen. Die Suche hilft bei bekannten Modellnamen, die Filter bei der Auswahl nach Aufgabe. Bereits aufgelistete Modelle müssen nicht einzeln über ihre IDs eingetragen werden.
Nach dem Hinzufügen kann die folgende Abschlussansicht erscheinen. Sie zeigt Häkchen für das Hinzufügen der Modelle, die Validierung und die Aktivierung des Anbieters. Über den Abschlussknopf kehrt ihr zurück.
Daneben gibt es auf der Anbieterseite einen separaten Verbindungstest. Dort wählt ihr ein Modell und startet die Prüfung.
Dieser zusätzliche manuelle Test ist optional. Er ruft die API auf und verursacht Nutzungskosten nach den Abrechnungsregeln des Anbieters. Ein Test aller Modelle kann mehrere Aufrufe auslösen. Ihr entscheidet selbst, ob ihr die Verbindung separat prüfen oder nach dem Hinzufügen und Aktivieren direkt im Chat beginnen möchtet. Auch eine normale Chatnachricht verwendet die API.
Bei Fehlern die passende Einstellung prüfen
Ich würde die Verbindung anhand der konkreten Fehlermeldung untersuchen. Ein anderer Modellname behebt beispielsweise keinen falsch kopierten Schlüssel.
| Beobachtung | Nächster sinnvoller Blick |
|---|---|
| Authentifizierungsfehler, etwa 401 | Ist der Schlüssel vollständig, noch gültig und ohne zusätzliche Leerzeichen eingefügt? |
| Falscher Pfad oder 404 | Stimmen API-Format und erzeugte Anfrageadresse? |
| Modell wird abgelehnt | Ist das Modell für diesen Schlüssel freigegeben und beim Anbieter verfügbar? |
| Modell fehlt in der Chatauswahl | Wurde es hinzugefügt und der Anbieter aktiviert? |
| Prüfung erfolgreich, Chat fehlerhaft | Verwendet der Chat denselben Anbieter und dasselbe Modell wie die Prüfung? |
Diese Punkte sind Ansatzpunkte zur Fehlersuche, keine eindeutige Diagnose für jeden Fehlercode. Ändert jeweils eine Angabe und prüft anschließend erneut. So bleibt erkennbar, welche Änderung etwas bewirkt hat.
Im Chat ein Modell wählen und eine prüfbare Aufgabe stellen
Öffnet ein Gespräch und klickt oben auf den Modellnamen. Wählt unter Crazyrouter das gerade hinzugefügte Modell aus. Die Auswahl im Gespräch legt fest, womit diese Unterhaltung arbeitet; ein erfolgreicher Test eines anderen Modells ändert sie nicht automatisch.
Für den Einstieg eignet sich eine Aufgabe, deren Antwort ihr ohne weitere Recherche prüfen könnt. Hier ist eine vorbereitete Übung mit einer kleinen Ausleihliste. Sie wurde für diesen Artikel nicht ausgeführt und ist kein gemessenes Modellergebnis.
Ermittle anhand dieser Ausleihliste den aktuellen Zustand pro Gerät.
Für jedes Gerät zählt nur der Eintrag mit der höchsten laufenden Nummer.
Eine Rückgabe bedeutet: verfügbar. Eine Ausleihe bedeutet: ausgeliehen.
Die Geräte sind erfunden.
Nr. | Gerät | Vorgang
1 | Kamera A | Ausleihe
2 | Stativ B | Ausleihe
3 | Kamera A | Rückgabe
4 | Mikrofon C | Ausleihe
5 | Stativ B | Rückgabe
6 | Kamera A | Ausleihe
Antworte mit einer Tabelle: Gerät, maßgebliche Nummer, Zustand.
Nenne danach die Anzahl verfügbarer und ausgeliehener Geräte.
Erfinde keine Personen, Fristen oder weiteren Vorgänge.
Die Regel lässt sich von Hand prüfen: Für Kamera A zählt Eintrag 6, für Stativ B Eintrag 5 und für Mikrofon C Eintrag 4. Damit ist ein Gerät verfügbar und zwei sind ausgeliehen. Das ist die aus den Eingaben abgeleitete Kontrolllösung, keine behauptete Ausgabe eines Modells.
Falls eine Antwort erscheint, kontrolliert deshalb beides: Hat die Verbindung funktioniert, und wurde für jedes Gerät tatsächlich der letzte Eintrag verwendet? Eine gut formatierte Tabelle allein beantwortet die zweite Frage noch nicht.
Wiederkehrende Arbeit über Standardmodelle vereinfachen
In den Einstellungen für Standardmodelle könnt ihr festlegen, welches Modell als Standard für Assistenten ohne eigene Modellzuweisung dienen soll.
Das schnelle Modell übernimmt unter anderem Gesprächstitel und die Aufbereitung von Suchbegriffen. Die Einstellungen für Übersetzung und Bildgenerierung gehören zu ihren jeweiligen Funktionen. Ihr müsst daher nicht alle Felder mit demselben Modell besetzen. Die Rollen beschreibt die offizielle Dokumentation zu Standardmodellen. Für ein bereits geöffnetes Gespräch schaut ihr weiterhin auf dessen eigene Modellauswahl.
Websuche und Browsersteuerung bewusst ergänzen
Für die Ausleihübung reicht ein Textchat. Soll das Modell später Informationen aus dem Web berücksichtigen, kommt die Suchkonfiguration hinzu. Der folgende Screenshot zeigt jedoch zunächst die Browsersteuerung: Dort kann erlaubt werden, dass die KI Webseiten bedient.
Für Recherche öffnet ihr stattdessen die Websucheinstellungen, prüft den Suchdienst und aktiviert die Suchfunktion im Eingabebereich des Gesprächs. Ob bei einer konkreten Antwort gesucht wurde, erkennt ihr an den Suchaktivitäten und Quellenangaben. Die offizielle Anleitung zur Websuche erklärt die zugehörigen Optionen. Gewöhnliche Textnachrichten benötigen keine Browsersteuerung.
Weitere Einstellungen betreffen unter anderem MCP, Skills, Dokumentverarbeitung, OCR und Schnellassistenten.
Ich würde diese Funktionen ergänzen, sobald eine konkrete Aufgabe sie benötigt. Für die Ausleihliste bleibt der Zusammenhang übersichtlich: ein bekannter API-Zugang, ein bewusst gewähltes Chatmodell und eine Antwort, die sich anhand der Eingabedaten überprüfen lässt.
Für Installation und spätere Updates bleibt die offizielle Downloadseite der Einstieg. Den jeweiligen Versionsstand findet ihr zusätzlich unter den offiziellen GitHub-Releases.
Top comments (0)