# Cherry Studio Integration

> **Zuletzt überprüft**: 2026-09-18 · 📄 Gemäß offizieller Dokumentation (Cherry Studio v2.0.14, veröffentlicht 2026-09-09)

## Auf einen Blick

| Punkt | Details |
|---|---|
| Verfügbare Modelle | Claude ✅ (Anthropic-Typ) · GPT ✅ (OpenAI-Typ) · Chinesische Modelle ✅ (OpenAI-Typ) · Gemini ✅ (Gemini-Typ, Pfadverknüpfung nicht live getestet) |
| Protokoll & Base URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai` · Gemini: `https://api.qcode.cc/gemini` (nur Root-URLs — siehe unten) |
| Konfiguration | In-App: Einstellungen → Modelldienste → „+ Anbieter hinzufügen“ |
| Offizielle Dokumentation | [Anbieterkonfiguration](https://docs.cherryai.com.cn/) |

Cherry Studio ist einer der beliebtesten Open-Source-Desktop-AI-Clients unter chinesischsprachigen Nutzern (Windows / macOS / Linux): Chat, Übersetzung, Wissensdatenbanken und MCP in einem Fenster. **Kein Kontosystem, rein lokale Konfiguration** — auf einen beliebigen OpenAI- / Anthropic-kompatiblen Endpunkt zeigen und loslegen.

## Voraussetzungen

- Cherry Studio installiert (die Download-Seite bietet Global- und CN-Builds, x64 / ARM64; Mindest-OS-Versionen werden upstream nicht angegeben — siehe [Download-Seite](https://www.cherryai.com.cn/)). Kein Cherry-Studio-Konto und keine Modell-Anbieterkonten erforderlich.
- Ein QCode.cc-`cr_`-API-Key ([Dashboard](https://qcode.cc/dashboard)).
- Vom chinesischen Festland aus ersetzen Sie `api.qcode.cc` durch `asia.qcode.cc` in allen untenstehenden Angaben — identische Funktionen.

## Einrichtung

Öffnen Sie **Einstellungen → Modelldienste**, klicken Sie unterhalb der Liste auf „**+ Anbieter hinzufügen**“ und arbeiten Sie im Dialog „Benutzerdefinierten Anbieter hinzufügen“. Die offizielle Regel: **Das Feld „API Host“ akzeptiert nur die Root-URL — kein `/v1`, keine Pfade** — Cherry Studio ergänzt den Rest je nach gewähltem Typ (z. B. fügt der OpenAI-Typ `/v1/chat/completions` hinzu); um das Anhängen vollständig zu deaktivieren, beenden Sie die URL mit `#`.

### Route A: Claude-Modelle (Anthropic-Typ, empfohlen)

1. Wählen Sie den Typ **Anthropic**.
2. API Host: `https://api.qcode.cc/api`.
3. API-Key: Ihr `cr_`-Schlüssel.
4. Fügen Sie die gewünschten Modell-IDs hinzu (z. B. `claude-sonnet-5`) in den Endpunkt-/Modelleinstellungen oder rufen Sie die Modellliste ab.
5. Die offizielle Dokumentation besagt, dass die **Cherry-Agent-Funktion einen Anthropic-Protokoll-fähigen Endpunkt erfordert** — wenn Sie In-App-Agenten nutzen möchten, ist dies die richtige Route.

### Route B: GPT und chinesische Modelle (OpenAI-Typ)

1. Wählen Sie den Typ **OpenAI**.
2. API Host: `https://api.qcode.cc/openai` (Cherry baut daraus `/openai/v1/chat/completions`).
3. API-Key: derselbe `cr_`-Schlüssel.
4. Modell-IDs: beliebiges GPT (z. B. `gpt-5.6`) oder chinesisches Modell (`glm-5.3`, `kimi-k3`, `deepseek-v4.1-flash`, `qwen3.8-max`, …) — aktuelle Liste unter [qcode.cc/models](https://qcode.cc/models).

### Die verbleibenden Typen

- **OpenAI Responses**: derselbe Host `https://api.qcode.cc/openai`; beachten Sie, dass die QCode-Responses-Schiene **nur GPT-Modelle** bedient — kein Claude, keine chinesischen Modelle (Matrix: [Endpunkte und API-Pfade](/docs/getting-started/endpoints-and-api-paths)).
- **Gemini**: API Host `https://api.qcode.cc/gemini`; wir haben den exakten Pfad, den Cherry für diesen Typ anhängt, nicht überprüft — bei einem 404 passen Sie ihn über die Root-URL + abschließendes `#` an.

## Funktion überprüfen

Senden Sie eine Nachricht an das neue Modell in einem beliebigen Chat-Tab, oder nutzen Sie die In-App-Funktion „Modellliste abrufen“ (sie greift auf `<api host>/models` zu). Falls keine Antwort kommt: Prüfen Sie zunächst, ob der Typ zur Modellfamilie passt (Claude benötigt den Anthropic-Typ), dann ob Sie nicht manuell `/v1/...` in den Host eingefügt haben (es würde sich zu `/v1/v1` verdoppeln). Immer noch Probleme? Befolgen Sie das [Fehlerbehebungs-Handbuch](/docs/reference/troubleshooting); jede Anfrage ist unter [probe.qcode.cc](https://probe.qcode.cc) sichtbar.

## Bekannte Einschränkungen

- **Claude kann den OpenAI-Typ nicht verwenden**: die QCode-OpenAI-Schiene lehnt Claude-Modelle direkt ab (`model_not_available_on_endpoint`); verwenden Sie den Anthropic-Typ.
- Fügen Sie **keine** vollständigen Pfade wie `/v1/chat/completions` in den API Host ein — das Anhängen ist die Standardeinstellung; das abschließende `#` ist der Ausstieg.
- Cherrys zweisprachige Dokumentation bezeichnet die Einstellungsseite je nach Version sowohl als „Model Services“ als auch als „Model Provider“; die Schaltfläche „Modellliste abrufen“ kann in Ihrem Build „Modelle synchronisieren“ lauten.
- Bildgenerierung / -bearbeitung haben eigene Base-URL-Felder; QCodes Bildmodell (`gpt-image-2`) ist in [gpt-image-2 Bildgenerierung und -bearbeitung](/docs/usage/image-2) dokumentiert — Cherry-seitiges Verhalten hier nicht verifiziert.
- Die Domain der offiziellen Dokumentation wurde kürzlich umgezogen (docs.cherry-ai.com leitet jetzt per 301 auf docs.cherryai.com.cn um); alte Lesezeichen werden umgeleitet.

## Verwandte Dokumentationen

- [Endpunkte und API-Pfade](/docs/getting-started/endpoints-and-api-paths)
- [Tool-Kompatibilitätsübersicht](/docs/ide/tool-compatibility)
- [Chinesische Modelle](/docs/usage/cn-models)
- [Abos vs. API-Keys vs. QCode-Keys](/docs/reference/subscription-vs-api-key)
- [Fehlerbehebung](/docs/reference/troubleshooting)