ZCode mit eigenem API-Anbieter: Claude, GPT und chinesische Modelle per API-Schlüssel (November 2026)
Ja. Stand 2026-11-10 beschreibt die offizielle ZCode-Seite Connect Models, dass Sie einen eigenen Anbieter mit Anthropic- oder OpenAI-kompatiblem Protokoll hinzufügen können: Klicken Sie in der Desktop-App unten im Modellauswahlfeld auf Manage Models, um Settings -> Model Settings zu öffnen, dann unten in der Anbieterliste auf Add Provider, tragen Sie Endpunkt und API-Schlüssel ein und fügen Sie Modell-IDs mit Add Model hinzu. Im Test mit ZCode CLI 0.17.1 funktionierten alle drei QCode-Protokolle ohne Anmeldung bei einem Z.ai- oder BigModel-Konto: Anthropic mit der Base URL https://api.qcode.cc/api, OpenAI Chat und Responses beide mit https://api.qcode.cc/openai/v1, als Schlüssel Ihr QCode-Schlüssel, der mit cr_ beginnt.
Aktualisiert 2026-11-10
Richten Sie dieses Tool auf den QCode-Endpunkt — ein Key für Claude, GPT und chinesische Modelle.
- Bezahlung pro Token — aktuelle Preise unter /models
- Zahlung per Karte (Visa / Mastercard), Apple Pay, Google Pay oder Krypto
- Selbstbedienung: aufladen und sofort aktivieren
Vier Kernpunkte: offizielle Doku und Test vom 2026-11-10
Mit CLI 0.17.1 laufen alle
Stand 2026-11-10, getestet mit ZCode CLI 0.17.1: anthropic-messages mit https://api.qcode.cc/api (claude-haiku-5-5), openai-chat-completions und openai-responses beide mit https://api.qcode.cc/openai/v1 (deepseek-v4-flash, gpt-6.1-terra). Alle drei lieferten eine Antwort, ohne Anmeldung bei einem Z.ai- oder BigModel-Konto.
Kein /v1 in der Anthropic-URL
Im Quellcode von ZCode bekommt eine Anthropic-Base-URL, die nicht auf /v1 endet, ein /v1 angehängt; danach ergänzt das SDK /messages. Eine Anfrage mit https://api.qcode.cc/api landet also bei /api/v1/messages. OpenAI Chat und Responses hängen /chat/completions bzw. /responses direkt an, deshalb brauchen sie https://api.qcode.cc/openai/v1.
Desktop und CLI nutzen verschiedene Konfigurationsdateien
Die Desktop-App speichert Anbieter in ~/.zcode/v2/config.json, baseURL steht in den options eines Anbieters. Die CLI liest ~/.zcode/v2/provider_config.json (nicht config.json) und verwendet api.type und api.baseUrl; laut offizieller CLI-Doku wird api.baseUrl anders geschrieben als das alte options.baseURL.
Neueste Version, Stand 2026-11-10
Das neueste GitHub-Release ist v3.17.2: README und Changelog datieren es auf 2026-11-03, veröffentlicht wurde das Release am 2026-11-04 (UTC). Das Repository zai-org/ZCode steht unter der Apache License 2.0; eine aus dem Quellcode gebaute CLI meldet die Version 0.17.1.
Was ist ZCode, und funktioniert es mit eigenem API-Schlüssel?
Ja. Stand 2026-11-10 schreibt die offizielle ZCode-Seite Connect Models, dass ZCode jeden Modelldienst mit Anthropic- oder OpenAI-kompatiblem Protokoll als eigenen Anbieter aufnehmen kann, auch öffentliche Dienste, von Teams verwaltete Kanäle und selbst gehostete Dienste im internen Netz. ZCode ist eine Open-Source-Arbeitsumgebung für KI-gestütztes Programmieren von Z.ai (Zhipu): Das offizielle FAQ nennt es eine neue Agentic Development Environment (ADE) rund um den hauseigenen ZCode Agent, das README beschreibt es als „AI-Coding-Arbeitsumgebung mit Desktop-, Browser- und Terminal-Oberflächen“. Die Desktop-App gibt es für macOS (Apple Silicon / Intel), Windows (x64 / ARM64) und Linux (AppImage, DEB, RPM); die Kommandozeilenversion startet mit zcode, zcode --web öffnet die Weboberfläche, und die CLI wird laut Repository-Doku aus dem Quellcode gebaut. Die offizielle Seite nennt drei Wege zu einem Modell: mit einem Z.ai- oder BigModel-Konto anmelden und das Kontingent des GLM Coding Plan direkt nutzen; die Z.ai- / BigModel-Seite in den Modus API Key schalten und einen Schlüssel dieser Plattform eintragen; oder einen eigenen Anbieter hinzufügen, dann rechnet der Dienst ab, den Sie eintragen. QCode wird über den dritten Weg angebunden.
v3.17.2: neueste Version, Stand 2026-11-10
Stand 2026-11-10 ist v3.17.2 das neueste Release auf GitHub: README und Changelog datieren es auf 2026-11-03, das GitHub-Release wurde am 2026-11-04 (UTC) veröffentlicht. Laut Changelog dieser Version werden beschädigte Konfigurationsdateien nicht mehr überschrieben, um Datenverlust zu vermeiden. Eine aus dem main-Zweig gebaute CLI meldet die Version 0.17.1, also eine andere Nummer als die Desktop-App; genau diese CLI wurde beim QCode-Test am 2026-11-10 verwendet.
Zeitleiste
Das Repository zai-org/ZCode wird auf GitHub angelegt.
v3.17.2 erscheint (Datum laut README und Changelog; das GitHub-Release wurde am 2026-11-04 UTC veröffentlicht).
Offizielle Doku, README und Releases geprüft: v3.17.2 ist weiterhin die neueste Version. Test mit ZCode CLI 0.17.1: Die QCode-Protokolle Anthropic, OpenAI Chat und Responses funktionieren.
Was die ZCode-Doku festhält und was Test und Quellcode klären
Von ZCode dokumentiert
① Eigenen Anbieter in der Desktop-App hinzufügen: Settings -> Model Settings öffnen, unten in der Anbieterliste auf Add Provider klicken, einen Namen vergeben, Endpunkt und API-Schlüssel eintragen, Modell-IDs mit Add Model von Hand hinzufügen und den Aktivierungsschalter einschalten. ② Offizielles DeepSeek-Beispiel: Anthropic-Endpunkt https://api.deepseek.com/anthropic, OpenAI-Endpunkt https://api.deepseek.com/v1. ③ In der Desktop-Datei ~/.zcode/v2/config.json erkennt options eines Anbieters nur Verbindungsangaben wie apiKey, baseURL, apiKeyRequired und headers; andere von Hand ergänzte Schlüssel werden stillschweigend ignoriert und nicht in den Anfragetext übernommen. ④ Die CLI-Doku im Repository: Eigene Anbieter stehen in ~/.zcode/v2/provider_config.json, die API-Typen heißen openai-chat-completions, openai-responses und anthropic-messages, und api.baseUrl wird anders geschrieben als das alte options.baseURL. ⑤ Ebenfalls laut CLI-Doku enthält diese Datei den Schlüssel im Klartext; schränken Sie die Dateirechte ein und committen Sie sie nicht in Git. ⑥ Einige Drittanbieter-Deployments akzeptieren höchstens xhigh; die höchste Denkstufe liefert dann einen Parameterfehler 400, mit high funktioniert es. ⑦ Dasselbe GLM-Modell behält Bilder über einen Anthropic-kompatiblen Endpunkt, wird über einen OpenAI-Chat-kompatiblen Endpunkt aber als bildunfähig behandelt. ⑧ Nach der Einrichtung wählen Sie den Kanal im Modellauswahlfeld und senden eine kurze Testanweisung.
Was die Doku offenlässt und Test und Quellcode beantworten
Stand 2026-11-10: ① Wie der Pfad zusammengesetzt wird, steht nicht in der Doku; im Quellcode von ZCode bekommt eine Anthropic-Base-URL ohne /v1 am Ende ein /v1, danach ergänzt das SDK /messages, während OpenAI Chat und Responses /chat/completions bzw. /responses direkt anhängen. Für QCode gelten daher https://api.qcode.cc/api und https://api.qcode.cc/openai/v1. ② Ob vorher eine Anmeldung bei einem Z.ai- oder BigModel-Konto nötig ist: Im Test mit ZCode CLI 0.17.1 genügte die persönliche Anbieterkonfiguration. ③ Responses: Die Konfigurationsseite der Desktop-Version nennt die Protokolle Anthropic und OpenAI, ohne eigenen Eintrag für Responses; der CLI-Typ openai-responses funktionierte im Test, ebenfalls mit https://api.qcode.cc/openai/v1. ④ Wie die Desktop-App wählt, wenn ein Anbieter sowohl eine Anthropic- als auch eine OpenAI-Adresse hat, ist offiziell weiterhin nicht beschrieben; am übersichtlichsten ist ein Anbieter je Protokoll.
Desktop-App und CLI: zwei Einstiege, zwei Konfigurationsdateien
Desktop-App: Anbieter in der Oberfläche anlegen
Laut offizieller Doku: Settings -> Model Settings → Add Provider. Tragen Sie als Anthropic- und OpenAI-Endpunkt dieselben Adressen ein, die im CLI-Test funktioniert haben (https://api.qcode.cc/api und https://api.qcode.cc/openai/v1), und fügen Sie Modell-IDs mit Add Model hinzu. Gespeichert wird das in ~/.zcode/v2/config.json, wo baseURL in den options des Anbieters steht.
CLI: provider_config.json schreiben
Die CLI liest ~/.zcode/v2/provider_config.json, nicht die config.json der Desktop-App. Jeder Anbieter hat genau einen api.type: anthropic-messages mit https://api.qcode.cc/api oder openai-chat-completions / openai-responses mit https://api.qcode.cc/openai/v1; der Schlüssel gehört in access.apiKey, die Modelle in personalModelIds. Stand 2026-11-10 funktionieren alle drei im Test mit ZCode CLI 0.17.1.
So verbinden Sie ZCode mit QCode: Schritte für Desktop und CLI
Desktop-App: ① Installieren Sie ZCode von zcode.z.ai (unter macOS ziehen Sie ZCode.app in den Ordner Applications, unter Windows starten Sie das Installationsprogramm, unter Linux nutzen Sie AppImage, DEB oder RPM). ② Klicken Sie im Chatfeld auf den Modellnamen und unten in der Liste auf Manage Models; es öffnet sich Settings -> Model Settings. ③ Klicken Sie unten in der Anbieterliste auf Add Provider, nennen Sie den Anbieter QCode Claude, tragen Sie als Anthropic-Endpunkt https://api.qcode.cc/api und Ihren cr_-Schlüssel ein, fügen Sie Modelle wie claude-sonnet-5-5 mit Add Model hinzu und schalten Sie den Aktivierungsschalter ein. ④ Legen Sie einen zweiten Anbieter QCode OpenAI an, mit dem OpenAI-Endpunkt https://api.qcode.cc/openai/v1 und Modellen wie gpt-6.1-sol und deepseek-v4-flash. ⑤ Wählen Sie im Modellauswahlfeld ein Modell und senden Sie eine kurze Testanweisung. CLI: Fügen Sie in ~/.zcode/v2/provider_config.json unter providerRules einen Anbieter hinzu, tragen Sie den cr_-Schlüssel in access.apiKey ein, setzen Sie api.type auf anthropic-messages und api.baseUrl auf https://api.qcode.cc/api (oder openai-chat-completions / openai-responses mit https://api.qcode.cc/openai/v1), listen Sie die Modell-IDs in personalModelIds auf und verweisen Sie mit defaultModelSelection darauf. Die Datei enthält den Schlüssel im Klartext: Schränken Sie die Dateirechte ein und committen Sie sie nicht in Git.
ZCode mit einem QCode-API-Schlüssel betreiben
Stand 2026-11-10 erhalten Sie mit einem QCode-API-Schlüssel beide kompatiblen Endpunkte, Anthropic und OpenAI: Claude-Modelle laufen über den Anthropic-Endpunkt https://api.qcode.cc/api, GPT-Modelle über den OpenAI-Endpunkt https://api.qcode.cc/openai/v1 (dieselbe Adresse für Chat und Responses), die Familien GLM, Kimi, DeepSeek und Qwen über den Anthropic-Endpunkt oder OpenAI Chat. Abgerechnet wird pro Token, die Preise je Modell stehen auf /models; gängige Modell-IDs sind claude-sonnet-5-5, claude-opus-5-5, gpt-6.1-sol, deepseek-v4-pro, glm-5.3, kimi-k3 und qwen3.8-max. Drei Schritte: ① Registrieren Sie sich und laden Sie Guthaben auf (Alipay und weitere gängige Zahlungsarten werden unterstützt); ② kaufen Sie einen Privatplan oder «Nutzungspakete» und kopieren Sie Ihren API-Schlüssel, der mit cr_ beginnt; ③ legen Sie die Anbieter in ZCode wie oben beschrieben an; Schritt für Schritt beschreibt die QCode-Dokumentation dieselbe Einrichtung unter https://docs.qcode.cc/de/docs/ide/zcode. Kein Monatsplan? «Nutzungspakete» (/pay-as-you-go) starten bei $4 für ein einmaliges Kontingent, das Sie innerhalb von 7 Tagen aufbrauchen. Wenn Sie bereits einen Privatplan haben und mehr Kontingent brauchen, buchen Sie ein Booster-Pack dazu.
Häufige Fragen
Kann ZCode meinen eigenen API-Schlüssel nutzen?
Ja. Die offizielle ZCode-Seite Connect Models beschreibt, dass ZCode jeden Modelldienst mit Anthropic- oder OpenAI-kompatiblem Protokoll als eigenen Anbieter hinzufügen kann: Add Provider, Endpunkt und API-Schlüssel eintragen, dann Modell-IDs mit Add Model von Hand ergänzen. Stand 2026-11-10 funktionierten im Test mit ZCode CLI 0.17.1 alle drei QCode-Protokolle direkt: Anthropic mit https://api.qcode.cc/api, OpenAI Chat und Responses mit https://api.qcode.cc/openai/v1, als Schlüssel Ihr QCode-Schlüssel mit cr_ am Anfang. Abgerechnet wird pro Token, die Preise je Modell stehen auf /models.
Wo richte ich in ZCode ein eigenes Modell ein?
Desktop-App: Klicken Sie im Chatfeld auf den Modellnamen, dann unten im Modellauswahlfeld auf Manage Models, um Settings -> Model Settings zu öffnen, und dort unten in der Anbieterliste auf Add Provider. Beim ersten Start ohne nutzbares Modell führt auch Use API Key auf dem Begrüßungsbildschirm zu den Modelleinstellungen. CLI: Bearbeiten Sie ~/.zcode/v2/provider_config.json, nicht die ~/.zcode/v2/config.json der Desktop-App, und tragen Sie die Adresse in api.baseUrl ein, nicht in options.baseURL. Laut offizieller CLI-Doku hängt ZCODE_BASE_URL mit dem Dienst-Endpunkt des Produkts selbst zusammen; eine Modell-API-Adresse gehört dort nicht hinein.
Kann ZCode Claude nutzen?
Der eigene Anbieter in ZCode unterstützt das Anthropic-Protokoll. Sie können daher die Anthropic-Base-URL von QCode https://api.qcode.cc/api eintragen und Claude-Modelle aufrufen; Stand 2026-11-10 antwortete claude-haiku-5-5 im Test mit ZCode CLI 0.17.1 direkt, und claude-sonnet-5-5 sowie claude-opus-5-5 stehen ebenfalls auf /models. Claude-Modelle werden nur über diese Adresse bereitgestellt; GPT-Modelle nutzen die OpenAI-Base-URL https://api.qcode.cc/openai/v1.
Braucht die Base URL in ZCode ein /v1?
Für Anthropic nein, für OpenAI ja. Der Quellcode von ZCode hängt an eine Anthropic-Base-URL ohne /v1 am Ende ein /v1 an, danach ergänzt das SDK /messages; tragen Sie also https://api.qcode.cc/api ein (laut Quellcode landet auch https://api.qcode.cc/api/v1 beim selben /api/v1/messages). OpenAI Chat und Responses hängen /chat/completions bzw. /responses direkt an, daher gehört dort https://api.qcode.cc/openai/v1 hin. Stand 2026-11-10 haben alle drei im Test mit ZCode CLI 0.17.1 funktioniert; einen abschließenden Schrägstrich lassen Sie weg.
Unterstützt ZCode Responses oder Gemini?
Die CLI unterstützt Responses: Setzen Sie api.type auf openai-responses und api.baseUrl auf https://api.qcode.cc/openai/v1; Stand 2026-11-10 hat das im Test mit ZCode CLI 0.17.1 funktioniert (gpt-6.1-terra). Die Konfigurationsseite der Desktop-Version nennt die Protokolle Anthropic und OpenAI ohne eigenen Eintrag für Responses; für GPT-Modelle in der Desktop-App tragen Sie den OpenAI-Endpunkt https://api.qcode.cc/openai/v1 ein. Unter den dokumentierten API-Typen von ZCode ist kein Gemini; über QCode nutzen Sie Claude, GPT und die Familien GLM, Kimi, DeepSeek und Qwen, die Modell-IDs stehen auf /models.
ZCode mit QCode meldet 400 oder 404: was tun?
Richten Sie sich nach der Meldung. model_not_available_on_endpoint: Ein Claude-Modell wurde dem Anbieter mit der OpenAI-Adresse zugeordnet; ordnen Sie claude-…-Modelle dem Anbieter mit der Adresse https://api.qcode.cc/api zu. Parameterfehler 400 bei der höchsten Denkstufe: Laut Doku akzeptieren einige Drittanbieter-Deployments höchstens xhigh, wählen Sie high. 404: Häufige Ursache ist ein abschließender Schrägstrich, der den Pfad zu //v1/messages macht; tragen Sie /api und /openai/v1 genau wie oben ein. Bilder fallen weg: Im offiziellen Beispiel behält dasselbe GLM-Modell Bilder über einen Anthropic-kompatiblen Endpunkt, wird über einen OpenAI-Chat-kompatiblen Endpunkt aber als bildunfähig behandelt; geben Sie bei einem eigenen Modell die Bildfähigkeit in der Modellkonfiguration ausdrücklich an.
Quellen
ZCode: die Seiten Connect Models, Installation und FAQ sowie der Changelog auf zcode.z.ai, die ZCode-Seite auf docs.bigmodel.cn sowie README, LICENSE, CLI-Leitfaden und Konfigurationsdoku, die Funktion normalizeAnthropicBaseURL im Quellcode, Repository-Daten und Releases von zai-org/ZCode auf GitHub, alle am 2026-11-10 gelesen. Test: 2026-11-10, ZCode CLI 0.17.1, aus dem Quellcode des Repositorys gebaut. QCode: qcode.cc/models, qcode.cc/pricing, qcode.cc/pay-as-you-go und die Seite Endpoints & API Paths auf docs.qcode.cc, abgerufen am 2026-11-10.
ZCode mit Ihrem eigenen Schlüssel betreiben
Ein QCode-API-Schlüssel für den eigenen Anbieter in ZCode: der Anthropic-Endpunkt für Claude, der OpenAI-Endpunkt für GPT, chinesische Modelle über beide; abgerechnet pro Token, die Preise je Modell stehen auf /models.
Weiterlesen
Nutzungspakete
Einmaliges Kontingent für 7 Tage ohne Abo; weitere Pakete landen auf demselben Key
Chinesische Modelle in Claude Code: Einrichtung
Ein cr_-Schlüssel für DeepSeek, GLM, Kimi und Qwen in Claude Code: gleiche Adresse, Wechsel per /model.
Eigene Modelle in Trae: Leitfaden
So füllen Sie ein eigenes Modell in Trae aus: API-Format, Request-URL, Modell-ID und API-Key, dazu die Grenze im Auto-Modus und häufige Fehler.
Krypto-Zahlungsleitfaden
Neun Coins, 56 Netzwerke, keine Plattformgebühr für KI-Coding-API-Guthaben.
Die Angaben auf dieser Seite wurden am 2026-11-10 anhand der ZCode-Dokumentation, des Repositorys und des Quellcodes geprüft, die QCode-Adressen mit ZCode CLI 0.17.1 getestet; die offiziellen Seiten haben Vorrang. Menünamen und Optionen richten sich nach der installierten Version, die Verfügbarkeit der QCode-Modelle nach /models.