# SillyTavern mit QCode verbinden

> **Zuletzt überprüft**: 2026-09-18 · 📄 Laut offizieller Dokumentation (SillyTavern 1.19.0 (veröffentlicht am 2026-09-14))

## Auf einen Blick

| Eintrag | Details |
|---|---|
| Verfügbare Modelle | Claude ✅ (eigene Anthropic-kompatible API-URL) · GPT ✅ · Chinesische Modelle ✅ (OpenAI-kompatibel) · Gemini ⚠️ nicht überprüft |
| Protokoll & Base-URL | Anthropic: `https://api.qcode.cc/api/v1` (ST fügt nur `/messages` an, daher ist `/v1` hier erforderlich) · OpenAI: `https://api.qcode.cc/openai/v1` |
| Wo konfigurieren | API-Verbindungspanel in der App (Quelle für Chat-/Textvervollständigung + API-URL wählen) |
| Offizielle Doku | [github.com/SillyTavern/SillyTavern](https://github.com/SillyTavern/SillyTavern) |

[SillyTavern](https://github.com/SillyTavern/SillyTavern) ist ein beliebtes lokales LLM-Frontend, das auf Rollenspiel und mehrstufige Dialoge ausgerichtet ist. Es unterstützt die Anbindung verschiedenster Chat-Modelle und enthält Erweiterungen für Bildgenerierung, TTS und mehr. Dieses Tutorial zeigt, wie Sie die Modelle von QCode.cc in SillyTavern nutzen.

## Vorab: Das Wichtigste

| Funktion | Mit QCode nutzbar? | Hinweise |
|------|-------------|------|
| **Chat (Claude-/GPT-Modelle)** | ✅ Ja | SillyTavern unterstützt eigene Anthropic-/OpenAI-kompatible Endpunkte; einfach QCodes BASE_URL + API-Key eintragen |
| **Bildgenerierung (gpt-image-2)** | ❌ Noch nicht | Die Bildgenerierungs-Erweiterung von SillyTavern **unterstützt keinen eigenen OpenAI-kompatiblen Bild-Endpunkt** und kann daher nicht auf QCodes `gpt-image-2` zeigen. Siehe „Über die Bildgenerierung mit gpt-image-2“ weiter unten |
| **Gemini-Modelle** | ⚠️ Nicht überprüft | Die Google-AI-Studio-/Vertex-AI-Quellen von SillyTavern akzeptieren ebenfalls eine eigene Proxy-URL, aber wir haben nicht überprüft, ob deren Anfrageformat mit QCodes Gemini-Zweig übereinstimmt – daher empfehlen wir es nicht |

## 1. Mit QCodes Claude-Modellen chatten

Die Claude-Integration von SillyTavern enthält einen einklappbaren Abschnitt „Reverse Proxy“ – über diesen richten Sie die Verbindung auf QCode aus:

1. Öffnen Sie **API Connections** (das Stecker-Symbol) → **Chat Completion**.
2. Stellen Sie **Chat Completion Source** auf **Claude**.
3. Klappen Sie darunter den Bereich **Reverse Proxy** auf. **Das ist keine Checkbox und kein Toggle** – eine leere Proxy-URL bedeutet schlicht „SillyTaverns eingebaute offizielle Adresse verwenden“.
4. Tragen Sie zwei Felder ein:
   - **Proxy Server URL**: `https://api.qcode.cc/api/v1` (in Festlandchina bevorzugen Sie `https://asia.qcode.cc/api/v1`)
   - **Proxy Password**: Ihr QCode-API-Key (beginnt mit `cr_`)
5. Wählen Sie `claude-opus-5`, `claude-sonnet-5`, `claude-haiku-4-5` usw. im Dropdown **Claude Model** (4.x-Modelle wie `claude-sonnet-4-6` sind weiterhin erhältlich).
6. Klicken Sie auf **Connect**. Da eine Proxy-URL gesetzt ist, erscheint beim ersten Klick ein Bestätigungsdialog „Mit dieser Proxy-URL verbinden?“ – das ist zu erwarten.

> 🔴 **Die Proxy-URL muss `/v1` enthalten**: Tragen Sie `https://api.qcode.cc/api/v1` ein und enden Sie dort.
> SillyTavern fügt danach nur `/messages` an und **setzt Ihnen kein `/v1` hinzu** –
> `https://api.qcode.cc/api` würde `/api/messages` treffen und 404 zurückgeben. Auch kein abschließender Slash (ergäbe `//messages`).
> Quelle: SillyTavern 1.19.0 `src/endpoints/backends/chat-completions.js`, der Claude-Zweig führt `fetch(apiUrl + '/messages')` aus.

Zwei Dinge vorab:

- **Das Dropdown „Claude Model“ ist eine feste Liste; Sie können keine Modell-ID eingeben.** Die 1.19.0-Liste enthält bereits `claude-opus-5`, `claude-sonnet-5`, `claude-haiku-4-5` und `claude-sonnet-4-6`, was sich mit den Claude-Modellen überschneidet, die wir anbieten. Wenn wir später ein Claude-Modell aufnehmen, das in SillyTaverns Liste fehlt, können Sie es hier nicht auswählen – warten Sie auf ein SillyTavern-Update, oder nutzen Sie stattdessen [Claude Code](/docs/getting-started/installation).
- **Was die offizielle Dokumentation über Proxies sagt:** Die Nutzung eines Proxys, den Sie nicht selbst betreiben, stellt ein Datenschutzrisiko dar, und SillyTavern lehnt Support-Anfragen von Proxy-Nutzern ab. Hier verweist die URL auf Ihr eigenes QCode-Konto und Ihren eigenen Key – bedenken Sie das.
## 2. Mit QCode GPT-Modellen chatten

Verwenden Sie den OpenAI-kompatiblen Endpunkt:

1. **API Connections** → **Chat Completion**.
2. Setzen Sie **Chat Completion Source** auf **Custom (OpenAI-compatible)**.
3. Tragen Sie Folgendes ein:
   - **Custom Endpoint (Base URL)**: `https://api.qcode.cc/openai/v1` (in Festlandchina bevorzugen Sie `https://asia.qcode.cc/openai/v1`)
   - **API Key**: Ihr QCode API-Key
4. Geben Sie `gpt-6-sol`, `gpt-6-luna`, `gpt-5.6-terra` usw. unter **Enter a Model ID** ein.
5. Klicken Sie auf **Connect**.

> Hier gilt dieselbe Regel: **Nur `/openai/v1` eintragen** und nicht selbst `/chat/completions` ergänzen (SillyTavern fügt es hinzu).
> Ein API-Key funktioniert für alle Protokolle; der Pfad entscheidet, welches. Siehe [Endpunkte und API-Formate](/docs/getting-started/endpoints-and-api-paths).

## 3. Zur gpt-image-2-Generierung (ein ehrlicher Hinweis)

Viele Nutzer fragen: **Kann ich QCode `gpt-image-2` in SillyTavern für Charakterporträts / Illustrationen anbinden?**

**Aktuell nicht.** Warum:

- Die Bildgenerierungs-Erweiterung von SillyTavern (ehemals Stable-Diffusion-Erweiterung) unterstützt nur eine **feste Backend-Auswahl**: 24 Einträge im Dropdown der Version 1.19.0, wörtlich einschließlich `ComfyUI`, `Stable Diffusion Web UI (AUTOMATIC1111)`, `SD.Next (vladmandic)`, `stable-diffusion.cpp server`, `DrawThings HTTP API`, `NovelAI Diffusion`, `Stability AI`, `OpenAI`, `OpenRouter`, `TogetherAI`, `Pollinations`, `Z.AI`. Nur die Backends, die Sie lokal auf Ihrem eigenen Rechner betreiben (SD Web UI / SD.Next / ComfyUI / stable-diffusion.cpp / DrawThings), besitzen ein URL-Feld.
- Es gibt **keine** Option „Custom OpenAI-compatible image endpoint“ – das heißt, Sie können der Bildgenerierung, anders als beim Chat, keinen eigenen `base_url` geben, der auf QCode `/v1/images/generations` zeigt.
- Es existiert bereits ein Community-Feature-Request [#4851](https://github.com/SillyTavern/SillyTavern/issues/4851) (offizieller Titel wörtlich: `[FEATURE_REQUEST] Custom openai compatible image generation enpoint (image generation extension)` – die Schreibfehler stammen vom Autor), dieser ist noch OPEN und **nicht umgesetzt** Stand 2026-09-18.

> Bitte genau beachten: Die eingebaute OpenAI-Bildquelle listet `gpt-image-2` zwar im Modell-Dropdown, sodass es so aussieht, als würde es funktionieren. Aber das Request-Ziel ist im Quellcode hart auf `api.openai.com/v1/images/generations` verdrahtet, ohne Feld für eine Base URL – es kann daher QCode weiterhin nicht erreichen.

### Alternativen

Wenn Sie QCode `gpt-image-2` nutzen möchten, können Sie:

- **Das offizielle OpenAI SDK / jedes Tool, das einen eigenen `images`-Endpunkt unterstützt**, verwenden, um es direkt aufzurufen: Base `https://api.qcode.cc/qcode-img/v1`, Modell `gpt-image-2`, derselbe QCode-Key. Siehe [gpt-image-2 Bildgenerierung](/docs/usage/image-2).
- Den Fortschritt des SillyTavern-Issues #4851 verfolgen; sobald ein Custom OpenAI-kompatibler Bildendpunkt unterstützt wird, können Sie den QCode-Bildendpunkt so eintragen wie auf dieser Seite für den „Chat“-Bereich.

## FAQ

**Q: Die Verbindung liefert 401 / 403?**
A: Prüfen Sie, ob der API-Key korrekt und nicht abgelaufen ist. Claude verwendet das Feld „Proxy Password“, OpenAI-kompatible Endpunkte das Feld „API Key“ – tragen Sie den Key nicht am falschen Ort ein.

**Q: Instabile Netzwerkverbindung in Festlandchina?**
A: Wechseln Sie die BASE_URL-Domain auf `asia.qcode.cc` (Asien-Knoten, in der Nähe von Korea / Taiwan / Hong Kong); falls dies ebenfalls instabil ist, wechseln Sie zurück auf `api.qcode.cc` (globales Routing).

**Q: Kann ich meine Request-Verläufe einsehen?**
A: Ja. Requests über alle Domains werden an [probe.qcode.cc](https://probe.qcode.cc) gemeldet; geben Sie Ihren API-Key ein, um sie anzuzeigen.

---

> Möchten Sie einen Plan, der Claude Code, Codex und Drittanbieter-Clients wie diesen auf einmal abdeckt? Schauen Sie sich die [QCode.cc Preise](https://qcode.cc/pricing) an – ein API-Key funktioniert über alle drei Protokolle.