# Qoder mit QCode einrichten (BYOK)

> **Zuletzt überprüft**: 2026-11-10 · 📄 Laut offizieller Dokumentation (Qoder 0.5.7 und Qoder CLI 1.1.86, beide veröffentlicht am 2026-11-09; die Dokumentation wurde am 2026-11-10 gelesen)

## Auf einen Blick

| Punkt | Details |
|---|---|
| Was es ist | Qoder ist eine Familie von Coding-Agent-Produkten: die Qoder-Desktop-App, Qoder CLI (`qoder`), Qoder IDE und ein JetBrains-Plugin. Diese Seite behandelt die Desktop-App und die CLI. Die globale Website ist qoder.com (Dokumentation auf docs.qoder.com), die China-Website ist Qoder CN (Dokumentation auf docs.qoder.cn) |
| Eigener API-Schlüssel? | Ja. Laut der offiziellen Seite zu benutzerdefinierten Modellen bindet Qoder Modelle von Drittanbietern per API-Schlüssel an, auch über einen eigenen Endpunkt. Tarif: Die CLI-Seite nennt „Available edition: Individual plan“, die Release Note der Desktop-App „Personal plan BYOK“ |
| Wo konfigurieren | Desktop: **Settings** → **Models** → **Add model** → **Provider** → **Custom**. CLI: `/model` → Tab **Custom** → **Add custom model...** |
| Protokolle | **OpenAI Compatible** (danach **Chat Completions API** oder **Responses API**) · **Anthropic Compatible** |
| QCode-Werte | Anthropic Compatible: `https://api.qcode.cc/api` · OpenAI Compatible: `https://api.qcode.cc/openai/v1` |
| Nutzbare Modelle | Claude ✅ (Anthropic Compatible) · GPT ✅ (OpenAI Compatible) · GLM / Kimi / DeepSeek / Qwen ✅ (beide) · Gemini ❌ (QCode bietet derzeit keine Gemini-Modelle an) |
| Offizielle Dokumentation | [Custom models (global)](https://docs.qoder.com/qoder/custom-models) · [Custom models (CN)](https://docs.qoder.cn/qoder/custom-models) · [CLI custom models](https://docs.qoder.com/cli/custom-models) · [Release notes](https://changelog.qoder.com/app) |

Qoder IDE ist ein eigenes Produkt derselben Familie; seine Seite zu benutzerdefinierten Modellen (docs.qoder.com/user-guide/chat/custom-models) führt nur vordefinierte Anbieter. Eigene Base URLs gibt es in der Qoder-Desktop-App (seit 0.1.8, 2026-09-05) und in Qoder CLI, wo Nutzer der Personal Edition sie seit 1.1.50 (2026-09-11) auf der Seite Custom in `/model` verwalten – um diese beiden geht es hier.

## Welches Protokoll

Das Formular für einen eigenen Endpunkt bietet zwei Anbietertypen; bei **OpenAI Compatible** wählen Sie zusätzlich den API-Typ. Nehmen Sie die Zeile, die zur Modellfamilie passt:

| Auswahl in Qoder | Base URL | Modell-IDs (Beispiele) |
|---|---|---|
| **Anthropic Compatible** | `https://api.qcode.cc/api` | `claude-sonnet-5-5`, `claude-opus-5-5`, `deepseek-v4.1-flash`, `glm-5.3` |
| **OpenAI Compatible** + **Chat Completions API** | `https://api.qcode.cc/openai/v1` | `gpt-6.1-sol`, `deepseek-v4.1-flash`, `glm-5.3`, `kimi-k3`, `qwen3.8-max` |
| **OpenAI Compatible** + **Responses API** | `https://api.qcode.cc/openai/v1` | `gpt-6.1-sol`, `gpt-6.1-terra` |

Claude-Modelle laufen nur über das Anthropic-Protokoll, tragen Sie `claude-…`-IDs also unter **Anthropic Compatible** ein; GPT-Modelle laufen nur über die beiden OpenAI-Protokolle. Die vier chinesischen Modellfamilien funktionieren mit beiden. Die vollständige Tabelle steht unter [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths); Modell-IDs übernehmen Sie Zeichen für Zeichen von [qcode.cc/models](https://qcode.cc/models).

**Form der Base URL.** Qoder formuliert es so: „enter the exact Base URL supplied by the model service. Qoder displays https://api.example.com/v1 as an example format.“ Das Beispiel endet auf `/v1`, also geben Sie für beide OpenAI-Varianten die QCode-URL mit `/v1` am Ende ein. Für die Responses API funktioniert das ebenfalls, weil QCode `/openai/responses` und `/openai/v1/responses` gleich bedient. Welchen Pfad Qoder bei **Anthropic Compatible** anhängt, sagt die Dokumentation nicht. Beginnen Sie mit der Anthropic-Adresse von QCode `https://api.qcode.cc/api` (ohne abschließenden Schrägstrich). Schlägt **Validate and add model** fehl, tragen Sie `https://api.qcode.cc/api/v1` ein und validieren Sie erneut: Beide Adressen führen zum selben QCode-Endpunkt `/api/v1/messages`; der Unterschied liegt nur darin, wie viele Pfadsegmente Qoder selbst ergänzt.

In Asien oder Nordamerika können Sie die Domain durch `asia.qcode.cc` oder `us.qcode.cc` ersetzen; die Pfade bleiben gleich.

## Installation

Laden Sie die Desktop-App von der [Qoder-Downloadseite](https://qoder.com/download) herunter (macOS 12+, Windows 10+ oder Linux) und melden Sie sich an. Für die CLI nennt dieselbe Seite:

```sh
# macOS / Linux
curl -fsSL https://qoder.com/install | bash

# Windows PowerShell
irm https://qoder.com/install.ps1 | iex
```

Qoder CN hat eine eigene App und Dokumentation auf docs.qoder.cn. Gleichen Sie Ihre Version mit den oben genannten ab.

## Konfiguration

### Desktop: Settings → Models

Die Schritte stammen von der offiziellen Seite zu benutzerdefinierten Modellen, mit den Oberflächenbegriffen der englischen Dokumentation:

1. Öffnen Sie **Settings** und wählen Sie in der linken Navigation **Models**.
2. Klicken Sie auf **Add model**. Für einen eigenen Endpunkt öffnen Sie **Provider** und wählen unter **Custom** **OpenAI Compatible** oder **Anthropic Compatible**.
3. Bei **OpenAI Compatible** wählen Sie **Chat Completions API** oder **Responses API**.
4. Geben Sie die **Base URL**, Ihren API-Schlüssel und mindestens eine **Model ID** ein. Für weitere Modelle am selben Endpunkt klicken Sie auf **Add Model ID**.
5. Stellen Sie die Fähigkeiten ein, die die Seite aufführt: **Display name**, **Context window** (unterstützte Werte wählen, dann ein **Default context window**), **Vision** (einschalten, wenn das Modell Bilder verarbeitet) und **Thinking** (einschalten, wenn das Modell Reasoning unterstützt, dann die Aufwandsstufen wählen).
6. Klicken Sie auf **Validate and add model**. „Qoder validates the connection and saves the model after validation succeeds.“
7. Wählen Sie das neue Modell in der Chat-Oberfläche aus.

Werte für QCode (Platzhalter für den Schlüssel: `cr_xxx`):

| Feld | Anthropic Compatible | OpenAI Compatible |
|---|---|---|
| Base URL | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| API-Typ | — | **Chat Completions API** (für GPT auch **Responses API**) |
| API-Schlüssel | `cr_xxx` | `cr_xxx` |
| Model ID | `claude-sonnet-5-5` | `gpt-6.1-sol` |

Legen Sie je benötigtem Protokoll einen Eintrag an; jeder Eintrag bekommt seine eigene Base URL.

**Unterschiede zwischen global und CN.** Die globale Seite nennt als vordefinierte Anbieter Alibaba Cloud Model Studio, DeepSeek, Z.ai, Kimi, MiniMax, Xiaomi MIMO, OpenAI, Google und OpenRouter. Die CN-Seite nennt Alibaba Cloud Model Studio, DeepSeek, Zhipu, Kimi, MiniMax und Xiaomi MIMO, ohne OpenAI, Google und OpenRouter. Beide führen dieselben zwei benutzerdefinierten Anbieter – **OpenAI Compatible** und **Anthropic Compatible** – und dieselben Schritte.

Um den Schlüssel später zu ändern, nutzen Sie die Aktion **Edit** im Panel **Models**; **Delete** entfernt das Modell.

### CLI: /model → Custom

1. Starten Sie Qoder CLI und geben Sie `/model` ein.
2. Wechseln Sie zum Tab **Custom**.
3. Wählen Sie **Add custom model...** und drücken Sie Enter.
4. Folgen Sie dem Assistenten: „Provider → model type → model“, dann geben Sie den API-Schlüssel und weitere abgefragte Angaben ein.
5. Nach erfolgreicher Validierung wird die Konfiguration automatisch gespeichert, und das Modell ist sofort auswählbar. Wählen Sie es im Tab **Custom**; mit `d` auf einem Modell löschen Sie es dort.

Die offizielle Seite sagt außerdem: „Do not configure BYOK manually in settings.json; the available providers, models, and credential fields are determined by the BYOK catalog available to the current account.“ Die Felder des Assistenten listet die CLI-Seite nicht auf. Laut Release Note zu CLI 1.1.50 können Nutzer der Personal Edition BYOK-Modelle „with custom URL endpoints from the Custom page in /model“ einrichten, und der offizielle Qoder-Account auf X beschreibt es als Eingabe von Base URL, Model ID und API-Schlüssel. Tragen Sie in diese Felder die QCode-Werte aus der Tabelle oben ein.

## Verbindung prüfen

1. Wählen Sie das hinzugefügte Modell und senden Sie eine kurze Nachricht wie `ping`.
2. Öffnen Sie [probe.qcode.cc](https://probe.qcode.cc), geben Sie Ihren QCode-Schlüssel ein und prüfen Sie, ob die Anfrage mit diesem Modell erscheint.
3. Schlüssel und Pfad ohne Qoder testen:

```bash
KEY="cr_your_key"

# OpenAI Compatible, Chat Completions API
curl -sS https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" \
  -d '{"model":"gpt-6.1-sol","max_tokens":32,
       "messages":[{"role":"user","content":"ping"}]}'

# Anthropic Compatible
curl -sS https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":32,
       "messages":[{"role":"user","content":"ping"}]}'
```

## Fehlerbehebung

Die offizielle FAQ für ein Modell, das sich nicht hinzufügen lässt, nennt fünf Prüfpunkte. So übertragen Sie sie auf QCode:

| Offizieller Prüfpunkt | Bei QCode |
|---|---|
| "Whether the Base URL is complete and the selected compatible protocol and API type match the endpoint" | Anthropic Compatible → `https://api.qcode.cc/api` (oder `https://api.qcode.cc/api/v1`, siehe oben); OpenAI Compatible → `https://api.qcode.cc/openai/v1`, ohne `/` am Ende |
| "Whether the API key is correct with no extra spaces, and has not expired or been disabled" | Den `cr_`-Schlüssel ohne Leerzeichen neu einfügen |
| "Whether the Model ID is correct and accessible to the provider account" | Die ID von [qcode.cc/models](https://qcode.cc/models) kopieren |
| "Whether the provider account has sufficient balance" | Das Guthaben im QCode-Dashboard prüfen |
| "Whether the network connection is normal" | `asia.qcode.cc` oder `us.qcode.cc` mit denselben Pfaden versuchen |

Zwei Meldungen kommen von QCode: `model_not_available_on_endpoint` heißt, dass eine `claude-…`-ID unter einer OpenAI-Variante eingetragen wurde – tragen Sie sie unter **Anthropic Compatible** ein; das ist ein falsch gewähltes Protokoll, kein Schlüsselproblem. `Invalid API key` ist ein Schlüsselproblem.

Zur CLI sagt die offizielle Seite: Fehlen der Tab **Custom** oder der Eintrag zum Hinzufügen, prüfen Sie, ob BYOK für den aktuellen Account und Tarif verfügbar ist; fehlt ein Anbieter oder Modell, gilt der aktuelle Katalog, den der Assistent anzeigt.

## Bekannte Einschränkungen

- Offiziell: „Image and video generation are currently unavailable when using models connected with your own API key (BYOK).“
- Offiziell: Kosten für benutzerdefinierte Modelle laufen über das API-Konto beim Anbieter und „do not use Qoder Credits“. Repo Wiki nutzt ein festes Modell und verbraucht weiterhin Qoder Credits.
- Das Beispiel `https://api.example.com/v1` zeigt Qoder nur als Format; welchen Pfad Qoder je Protokoll anhängt, beschreibt die Dokumentation nicht. Maßgeblich ist daher das Ergebnis von **Validate and add model**.
- QoderWork ist ein eigenes Produkt. Seine Modellseite nennt die Stufen Premium, Advanced und Standard sowie Qwen3.7-Max und Qwen3.7-Plus und hat Stand 2026-11-10 keinen Eintrag für benutzerdefinierte Modelle. Laut Qoder-Downloadseite stellt QoderWork den Betrieb am 5. September 2027 ein; empfohlen wird der Wechsel zu Qoder Desktop, das Werkzeuge für den Datenimport mitbringt.
- Laut offizieller Mitteilung wurde die Modellstufe Lite am 18. September 2026 um 14:00 Uhr Singapurer Zeit (UTC+8) aus der Modellauswahl entfernt.

## Weiterführende Dokumentation

- [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths) – Tabelle „Protokoll × Modellfamilie“
- [Übersicht der Tool-Kompatibilität](/docs/ide/tool-compatibility) – welches Tool welches Protokoll spricht
- [DeepSeek Harness](/docs/ide/deepseek-harness) – ein weiteres Tool mit Formular für benutzerdefinierte Modelle
- [LobsterAI](/docs/ide/lobsterai) – ein Desktop-Agent, dessen benutzerdefinierte Anbieter ebenfalls Anthropic- und OpenAI-Formate annehmen
- [Chinesische Modelle](/docs/usage/cn-models) – IDs und Pfade von GLM / Kimi / DeepSeek / Qwen
- [Qoder-Leitfaden zu Custom Models und BYOK auf qcode.cc](https://qcode.cc/de/qoder-custom-model-byok-setup) – Daten und Hintergrund