CodeBuddy models.json: eigenes Modell einbinden und die richtige url (November 2026)
Ja. Laut dem offiziellen models.json Configuration Guide von CodeBuddy (Stand 2026-11-10) stehen eigene Modelle in ~/.codebuddy/models.json auf Benutzerebene (auf Projektebene in .codebuddy/models.json im Projektstamm); unterstützt wird derzeit nur das OpenAI-Schnittstellenformat, und in der CLI lässt sich api zusätzlich auf openai-responses setzen. Getestet mit CodeBuddy Code 2.182.0 funktioniert QCode ohne Anmeldung bei einem Tencent-Konto: Ein Chat-Eintrag bekommt als url den vollständigen Pfad https://api.qcode.cc/openai/v1/chat/completions, ein Responses-Eintrag https://api.qcode.cc/openai/v1 und die Umgebungsvariable CODEBUDDY_BASE_URL ebenfalls https://api.qcode.cc/openai/v1. Alle drei Varianten funktionieren.
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 Punkte: offizielle Doku und der Test vom 2026-11-10
Läuft mit CLI 2.182.0
Stand 2026-11-10, getestet mit CodeBuddy Code 2.182.0: Ohne Anmeldung bei einem Tencent-Konto erreichen die Chat- und Responses-Einträge in models.json sowie die Variable CODEBUDDY_BASE_URL QCode. Verwenden Sie einen QCode-Schlüssel, der mit cr_ beginnt; abgerechnet wird pro Token, die Preise je Modell stehen auf /models.
Die Chat-url endet auf /chat/completions
Offizieller Wortlaut: Das Feld url muss der vollständige Schnittstellenpfad sein und endet in der Regel auf /chat/completions; https://api.openai.com/v1 steht dort als falsches Beispiel. Ein Chat-Eintrag für QCode lautet daher https://api.qcode.cc/openai/v1/chat/completions; endet die url bei /v1, ist der Anfragepfad unvollständig.
Mit api ist url nur die Basis
Laut CLI-Doku gehen Anfragen mit api: openai-responses an {url}/responses; url ist die Basis-URL, ein angehängtes /responses ist optional. Für QCode nehmen Sie https://api.qcode.cc/openai/v1 und ein GPT-Modell wie gpt-6.1-terra. Die Feldtabelle der IDE kennt kein api, Responses-Einträge sind also für die CLI gedacht.
Gleiche Datei in der IDE, apiKey ist der Schlüssel selbst
Die IDE-Doku nennt dieselben Dateipfade und Chat-Felder und beschreibt apiKey als „tatsächlichen Schlüsselwert, keinen Variablennamen“; in der CLI akzeptieren apiKey und url Verweise der Form ${VAR_NAME}. Nutzen IDE und CLI dieselbe ~/.codebuddy/models.json, tragen Sie in jeden Eintrag den cr_-Schlüssel direkt ein; die CLI akzeptiert das ebenfalls.
Kann CodeBuddy Ihren eigenen API-Schlüssel nutzen?
Ja. Laut dem offiziellen models.json Configuration Guide von CodeBuddy (Stand 2026-11-10) stehen eigene Modelle in models.json: ~/.codebuddy/models.json auf Benutzerebene gilt für alle Projekte, .codebuddy/models.json im Projektstamm hat Vorrang. Unterstützt wird derzeit nur das API-Format von OpenAI, und in der CLI lässt sich api auf openai-responses setzen. CodeBuddy ist das KI-Programmierwerkzeug von Tencent Cloud; laut Produktübersicht von Tencent Cloud gibt es drei Formen – Plugin, IDE und CLI: Das Plugin läuft in VS Code oder JetBrains-IDEs, CodeBuddy IDE ist eine eigenständige IDE und CodeBuddy Code das Kommandozeilenwerkzeug (Befehl codebuddy). Der Pfad zu models.json ist in der Doku von codebuddy.cn und codebuddy.ai gleich. Über dieses Protokoll stehen bei QCode GPT und die chinesischen Modellfamilien (DeepSeek, GLM, Kimi, Qwen) bereit; wenn Sie Claude brauchen, nutzen Sie mit demselben Schlüssel ein Werkzeug mit Anthropic-Endpunkt, etwa Claude Code, ZCode oder Qoder. WorkBuddy, das Office-Produkt desselben Teams, nutzt ebenfalls OpenAI Chat Completions, legt models.json aber unter einem anderen Pfad ab; siehe /workbuddy-guide.
Stand 2026-11-10: Seit CLI v2.180.0 senden eigene Modelle keine Plattform-Identitäts-Header
Die internationale Versionshistorie der CLI datiert v2.180.0 auf 2026-11-04 und v2.182.0 auf 2026-11-09. Laut den Versionshinweisen zu v2.180.0 senden eigene Modelle keine Plattform-Identitäts-Header mehr: Verbindet sich ein eigenes Modell direkt mit einem Drittanbieter-Endpunkt, gehen keine Identitätsdaten mehr an den von Ihnen konfigurierten Dienst. Der neueste Eintrag der IDE-Versionshistorie für Festland-China ist 4.12.4 (2026-11-06); der dokumentierte Pfad zu models.json ist unverändert. Stand 2026-11-10, getestet mit CodeBuddy Code 2.182.0, erreichen eigene Modelle QCode über OpenAI Chat und Responses ohne Anmeldung bei einem Tencent-Konto.
Zeitleiste
Die internationale Versionshistorie der CLI führt v2.180.0; laut den Versionshinweisen senden eigene Modelle ab dieser Version keine Plattform-Identitäts-Header mehr.
Die internationale Versionshistorie der CLI führt v2.182.0 – die Version aus dem Test dieser Seite.
Test mit CodeBuddy Code 2.182.0: vollständiger Pfad für Chat, /openai/v1 für Responses und CODEBUDDY_BASE_URL – alle drei erreichen QCode, ganz ohne Anmeldung bei einem Tencent-Konto.
Was die Doku sagt und was der Test vom 2026-11-10 ergänzt
Was die CodeBuddy-Doku sagt
① Dateiorte: ~/.codebuddy/models.json auf Benutzerebene gilt für alle Projekte; auf Projektebene liegt .codebuddy/models.json im Projektstamm und hat höhere Priorität. Zusammengeführt wird in der Reihenfolge Projektebene, Benutzerebene, eingebaute Standardkonfiguration: Ein Eintrag mit gleicher id wird überschrieben, einer mit anderer id angehängt, und availableModels auf Projektebene ersetzt die Benutzerebene vollständig, ohne Zusammenführung. ② Unterstützt wird derzeit nur das OpenAI-Schnittstellenformat; die Chat-url muss der vollständige Schnittstellenpfad sein und endet in der Regel auf /chat/completions. ③ Felder: id (Pflicht), name, vendor, apiKey, url, maxInputTokens, maxOutputTokens, supportsToolCall, supportsImages und supportsReasoning; die CLI ergänzt api, temperature (0-2) und relatedModels. ④ Mit api: openai-responses nutzt das Modell die OpenAI Responses API, Anfragen gehen an {url}/responses; das Protokoll wechselt nur, wenn api ausdrücklich im Modelleintrag steht. ⑤ In der CLI akzeptieren apiKey und url ${VAR_NAME}, aufgelöst beim Start der CLI; fehlt die Variable, bleibt der ursprüngliche Platzhalter stehen und der API-Aufruf schlägt fehl. ⑥ Empfohlen sind die Dateirechte 600 für models.json; eine Konfigurationsdatei mit echtem Schlüssel gehört nicht in die Versionsverwaltung. ⑦ Konfigurationsdateien werden mit 1 Sekunde Entprellung automatisch neu geladen; über models.json hinzugefügte Modelle erhalten automatisch das Label custom. ⑧ Umgebungsvariablen der CLI: CODEBUDDY_API_KEY wird im nicht interaktiven Modus (-p) immer verwendet; CODEBUDDY_BASE_URL überschreibt die Adresse des API-Endpunkts, meist zusammen mit CODEBUDDY_API_KEY; CODEBUDDY_MODEL überschreibt das Standard-Agentenmodell.
Was die Doku offenlässt – ergänzt durch den Test vom 2026-11-10
Stand 2026-11-10, getestet mit CodeBuddy Code 2.182.0: ① CODEBUDDY_BASE_URL ist eine OpenAI-Chat-Basis, an die die CLI /chat/completions anhängt; setzen Sie also https://api.qcode.cc/openai/v1 und übergeben Sie mit --model eine GPT- oder chinesische Modell-ID – models.json ist dafür nicht nötig. ② Weder models.json noch CODEBUDDY_BASE_URL setzen eine vorherige Anmeldung bei einem Tencent-Konto voraus. ③ Eine Responses-url https://api.qcode.cc/openai funktioniert ebenfalls; in den Schritten oben und in der QCode-Doku steht https://api.qcode.cc/openai/v1, derselbe Wert wie bei CODEBUDDY_BASE_URL. ④ Die Schritte für die IDE folgen der offiziellen IDE-Doku.
IDE und CLI: eine models.json, zwei Unterschiede
CodeBuddy IDE (laut offizieller Doku)
Liest dieselbe ~/.codebuddy/models.json und die Datei auf Projektebene. Die url eines Chat-Eintrags ist der vollständige Pfad https://api.qcode.cc/openai/v1/chat/completions; in apiKey steht der cr_-Schlüssel selbst (IDE-Doku: tatsächlicher Schlüsselwert, kein Variablenname); ein Feld api gibt es nicht. In der Modellauswahl tragen eigene Einträge das Label custom.
CodeBuddy Code CLI (getestet mit 2.182.0)
Chat-Einträge nutzen denselben vollständigen Pfad; ein Eintrag mit api: openai-responses bekommt als url nur https://api.qcode.cc/openai/v1 und ein GPT-Modell; apiKey darf ${QCODE_API_KEY} sein. Sie können models.json auch weglassen und nur CODEBUDDY_BASE_URL=https://api.qcode.cc/openai/v1 und CODEBUDDY_API_KEY setzen.
So binden Sie QCode in CodeBuddy ein
① CLI installieren (entfällt, wenn Sie nur die IDE nutzen – die laden Sie von codebuddy.cn oder codebuddy.ai): Offiziell vorausgesetzt ist Node.js 18.20 oder neuer; führen Sie npm install -g @tencent-ai/codebuddy-code aus und prüfen Sie mit codebuddy --version (der Test lief mit 2.182.0). ② Legen Sie ~/.codebuddy/models.json an und schreiben Sie einen Chat-Eintrag in das Array models: id deepseek-v4-flash, name frei wählbar, vendor QCode, url https://api.qcode.cc/openai/v1/chat/completions, apiKey ${QCODE_API_KEY} (CLI) oder Ihr cr_-Schlüssel selbst (IDE), supportsToolCall true, maxInputTokens und maxOutputTokens passend zu den Fähigkeiten des gewählten Modells. ③ Für Responses (CLI) kommt ein zweiter Eintrag dazu: id gpt-6.1-terra, api openai-responses, url https://api.qcode.cc/openai/v1, übrige Felder wie oben. ④ CLI: export QCODE_API_KEY=cr_xxx ausführen, dann codebuddy -p mit einer kurzen Eingabe und --model mit der id des Eintrags starten; eine normale Antwort heißt, dass alles funktioniert. IDE: Modellauswahl öffnen, den Eintrag mit dem Label custom wählen und eine Nachricht senden. ⑤ Setzen Sie wie empfohlen die Dateirechte auf 600 und committen Sie keine Datei mit echtem Schlüssel. Aus Festland-China können Sie api.qcode.cc durch asia.qcode.cc ersetzen; der Pfad bleibt gleich.
CodeBuddy mit einem QCode-API-Schlüssel
Stand 2026-11-10 erhalten Sie mit einem QCode-API-Schlüssel beide kompatiblen Endpunkte, Anthropic und OpenAI. Eigene Modelle in CodeBuddy laufen über den OpenAI-Endpunkt: Die url eines Chat-Eintrags ist der vollständige Pfad https://api.qcode.cc/openai/v1/chat/completions, Responses-Einträge und CODEBUDDY_BASE_URL nutzen https://api.qcode.cc/openai/v1. Über dieses Protokoll stehen bei QCode GPT und die chinesischen Modellfamilien bereit; gängige IDs sind gpt-6.1-sol, gpt-6.1-terra, deepseek-v4-flash, deepseek-v4-pro, glm-5.3, kimi-k3 und qwen3.8-max. Claude-Modelle laufen über den Anthropic-Endpunkt https://api.qcode.cc/api – mit demselben Schlüssel etwa in Claude Code, ZCode oder Qoder. Abgerechnet wird pro Token, die Preise je Modell stehen auf /models. 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; ③ schreiben Sie models.json wie oben beschrieben; das vollständige JSON und die Testbefehle stehen in der QCode-Dokumentation unter https://docs.qcode.cc/de/docs/ide/codebuddy. 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
Wo richte ich in CodeBuddy ein eigenes Modell ein?
In models.json. ~/.codebuddy/models.json auf Benutzerebene gilt für alle Projekte, .codebuddy/models.json im Projektstamm hat Vorrang, und IDE wie CLI lesen dieselben Pfade. Stand 2026-11-10 listet der offizielle models.json Configuration Guide alle Felder; die Datei wird mit 1 Sekunde Entprellung automatisch neu geladen, ein Neustart nach dem Speichern ist nicht nötig.
Braucht die url in models.json /chat/completions?
Bei Chat-Einträgen ja. Offizieller Wortlaut: Das Feld url muss der vollständige Schnittstellenpfad sein und endet in der Regel auf /chat/completions; https://api.openai.com/v1 steht dort als falsches Beispiel. Für QCode also https://api.qcode.cc/openai/v1/chat/completions. Ein Eintrag mit api: openai-responses funktioniert umgekehrt: url ist die Basis (https://api.qcode.cc/openai/v1), Anfragen gehen an {url}/responses, ein angehängtes /responses ist optional. Bei einem 404 prüfen Sie zuerst, ob die Chat-url bis /chat/completions reicht.
Muss ich mich anmelden, bevor ein eigenes Modell in CodeBuddy funktioniert?
Nein. Stand 2026-11-10, getestet mit CodeBuddy Code 2.182.0, erreichen sowohl models.json als auch CODEBUDDY_BASE_URL QCode und liefern Antworten, ohne Anmeldung bei einem Tencent-Konto. Die Einrichtung der IDE folgt der offiziellen IDE-Doku. Laut den Versionshinweisen zu v2.180.0 senden eigene Modelle außerdem keine Plattform-Identitäts-Header mehr.
Kann CodeBuddy Claude oder GPT nutzen?
GPT und die chinesischen Modelle, ja. Eigene Modelle in CodeBuddy nutzen die OpenAI-Schnittstelle, und über dieses Protokoll stehen bei QCode GPT sowie DeepSeek, GLM, Kimi und Qwen bereit: Chat-Einträge können gpt-6.1-sol, deepseek-v4-flash, glm-5.3, kimi-k3 oder qwen3.8-max verwenden, Responses-Einträge in der CLI gpt-6.1-terra. Claude-Modelle laufen über den Anthropic-Endpunkt von QCode, https://api.qcode.cc/api; wenn Sie Claude brauchen, nutzen Sie mit demselben Schlüssel ein Werkzeug, das diesen Endpunkt unterstützt, etwa Claude Code, ZCode oder Qoder.
Wie setze ich CODEBUDDY_BASE_URL?
Auf https://api.qcode.cc/openai/v1; CODEBUDDY_API_KEY bekommt Ihren QCode-Schlüssel, der mit cr_ beginnt, und --model eine GPT- oder chinesische Modell-ID. Stand 2026-11-10, getestet mit CodeBuddy Code 2.182.0, ist diese Variable eine OpenAI-Chat-Basis, an die die CLI /chat/completions anhängt – models.json ist dafür nicht nötig; mit https://api.qcode.cc/api geht die Anfrage an /api/chat/completions, und QCode antwortet mit HTTP 400. Offiziell gilt: CODEBUDDY_BASE_URL überschreibt die Adresse des API-Endpunkts, meist zusammen mit CODEBUDDY_API_KEY; CODEBUDDY_MODEL überschreibt das Standard-Agentenmodell.
Ist die models.json von CodeBuddy dieselbe wie bei WorkBuddy?
Die Pfade unterscheiden sich. Laut offizieller Beschreibung teilt WorkBuddy dieselbe Basis mit CodeBuddy, dem Produkt für die Entwicklung. Die Version für Festland-China speichert die Konfiguration lokal in workbuddy/models.json und sagt, dass in ~/.codebuddy/models.json bereits eingerichtete eigene Modelle nach dem Oberflächen-Update weiter funktionieren; in der internationalen Version ist die Standarddatei ~/.workbuddy-ai/models.json. Auch WorkBuddy nutzt für eigene Modelle OpenAI Chat Completions, die url beim Schreiben von Hand ist also derselbe vollständige Pfad https://api.qcode.cc/openai/v1/chat/completions; Menüs und Schritte stehen auf /workbuddy-guide.
Quellen
CodeBuddy: der models.json Configuration Guide auf codebuddy.cn und codebuddy.ai (IDE und CLI), die CLI-Seiten zu Umgebungsvariablen und Installation, die Versionshinweise zu CLI v2.180.0 und die internationale Versionshistorie, die IDE-Versionshistorie für Festland-China sowie die CodeBuddy-Produktübersicht von Tencent Cloud; WorkBuddy: die Seiten zur Modellkonfiguration auf workbuddy.cn und workbuddy.ai und workbuddy.cn/llms.txt. Alles geprüft am 2026-11-10. QCode: die Doku Endpunkte & API-Pfade, die CodeBuddy-Doku und die aktuellen IDs auf qcode.cc/models. CLI-Test: CodeBuddy Code 2.182.0, 2026-11-10.
CodeBuddy mit eigenem Schlüssel
Ein QCode-API-Schlüssel in der models.json von CodeBuddy: OpenAI Chat für GPT und chinesische Modelle, Responses in der CLI für GPT; Abrechnung pro Token, Preise je Modell auf /models.
Weiterlesen
Nutzungspakete
Einmaliges Kontingent für 7 Tage ohne Abo; weitere Pakete landen auf demselben Key
Tencent WorkBuddy Guide
Überblick über Office-Multi-Agents, Einrichtung der Custom API und Abgrenzung zu Coding-Tools
ZCode mit eigenem API-Anbieter einrichten (2026-11)
Eigener API-Schlüssel in ZCode: Add Provider in der Desktop-App und provider_config.json in der CLI, ob jede Base URL /v1 braucht, Testergebnis mit CLI 0.17.1.
Krypto-Zahlungsleitfaden
Neun Coins, 56 Netzwerke, keine Plattformgebühr für KI-Coding-API-Guthaben.
Geprüft am 2026-11-10 anhand der offiziellen CodeBuddy-Doku; die QCode-Anbindung wurde mit CodeBuddy Code CLI 2.182.0 getestet, die Schritte für die IDE folgen der offiziellen IDE-Doku. QCode.cc ist nicht mit Tencent oder CodeBuddy verbunden. Oberfläche und Felder richten sich nach Ihrer installierten Version, Modell-IDs nach /models.