OpenCode 2.1 Breaking Changes: öffentliche Verträge
Stand 2026-10-20: OpenCode v2.1.0 ändert das öffentliche SDK sowie die Verträge für HTTP message/event und Plugins bewusst. Wer Plugins baut, das SDK nutzt oder per HTTP integriert, muss die neuen Felder übernehmen. Laut offiziellem Changelog bleiben gespeicherte Sitzungen, Zugangsdaten und der Import älterer Sitzungen lesbar; eine Datenbankmigration ist nicht nötig.
Aktualisiert 2026-10-20
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 / AMEX), Apple Pay, Google Pay oder Krypto
- Selbstbedienung: aufladen und sofort aktivieren
Vier Änderungen (eine davon ist ein neues Feature)
Neuer Name der Replay-Felder
Laut offiziellem Changelog hatten Provider-Replay-Daten an verschiedenen Stellen unterschiedliche Namen; 2.1 liest und schreibt stattdessen native.
Aus öffentlichen Events entfernt
Das Übergangsereignis wurde entfernt; Event-Abonnements und Schema-Importe wechseln zu session.compaction.started und session.compaction.ended.
Wechselt zu metadata
Öffentliche Schreibvorgänge für Zugangsdaten legen die Antworten aus dem Setup-Formular in metadata ab; das alte configuration-Format gilt nur noch für Speicherung und Import.
Persistentes PTY unter Windows
Derselbe Release bringt persistentes PTY für Windows x64 und ARM64; Todo-Listen in der TUI erscheinen mit experimental.todo.
Was v2.1.0 ändert
OpenCode v2.1.0 erschien am 2026-10-20. Das offizielle Changelog schreibt, Version 2.1 ändere das öffentliche SDK sowie die Verträge für HTTP message/event und Plugins bewusst, damit Provider-Replay-Daten und Compaction überall dieselben Namen und Formen verwenden; Integrationen müssen die neuen Felder übernehmen. Dort steht auch, dass gespeicherte Sitzungen, Zugangsdaten und der Import älterer Sitzungen über Kompatibilitätsdecoder lesbar bleiben und keine Datenbankmigration nötig ist.
Das offizielle Changelog
Die Breaking Changes konzentrieren sich auf das öffentliche SDK sowie die Verträge für HTTP message/event und Plugins; das offizielle Changelog beschreibt die Änderungen Gruppe für Gruppe: Provider-Replay, Zugangsdaten, Summary-Compaction, Provider-Compaction und Events. Derselbe Release bringt persistentes PTY unter Windows und Todo-Listen in der TUI; Plugin-Befehle, Shell-Aufrufe und andere TUI-Anfragen können außerdem über die Fünf-Minuten-Fetch-Grenze von Bun hinauslaufen, ohne die Verbindung zu verlieren.
Zeitleiste
OpenCode v2.1.0 erscheint; das offizielle Changelog führt die Änderungen an SDK, HTTP message/event und Plugin-Verträgen als Breaking Changes.
Derselbe Release bringt persistentes PTY für Windows (x64 / ARM64) und Todo-Listen in der TUI; für die Todo-Listen ist experimental.todo nötig.
Die OpenCode-Seite der QCode-Dokumentation wurde am 2026-10-20 geprüft und enthält nun einen Abschnitt zu OpenCode 2.
Bestätigt vs. nicht verifiziert
Bestätigt (im offiziellen Changelog nachprüfbar)
Das offizielle Changelog nennt: v2.1.0 erschien am 2026-10-20; Version 2.1 ändert das öffentliche SDK sowie die Verträge für HTTP message/event und Plugins bewusst, und Integrationen müssen die neuen Felder übernehmen.
Nicht verifiziert und vom Hersteller nicht veröffentlicht
Das offizielle Changelog nennt keinen Zeitplan für spätere 2.1-Versionen und beschreibt nicht, wie sich diese Vertragsänderung auf einzelne Drittanbieter-Integrationen auswirkt.
2.1.0 gegenüber 2.0
Gegenüber 2.0
Gegenüber 2.0 ändert 2.1.0 Feldnamen und Events der öffentlichen Verträge: Replay-Daten werden native, das Event session.compacted entfällt, Credential.Key.configuration entfällt und die Angaben wandern nach metadata.
Für die normale CLI-Nutzung
Die Anforderung im offiziellen Changelog richtet sich an Integrationen; ob die normale CLI-Nutzung betroffen ist, wird dort nicht gesondert gesagt.
Vier Stellen zum Anpassen
① Replay-Daten über native statt über state, providerState oder resultState lesen und schreiben (Text- und Reasoning-Teile, Assistant- und Compaction-Nachrichten, Lifecycle-Events nach der Tabelle im Changelog; der Ausführungsstatus tool.state und die UI-Metadaten eines Tools werden nicht umbenannt). ② session.compacted aus Event-Abonnements und Schema-Importen entfernen und auf session.compaction.started sowie session.compaction.ended wechseln. ③ Bei öffentlichen Schreibvorgängen für Zugangsdaten die Antworten aus dem Setup-Formular in metadata ablegen und configuration nicht mehr senden. ④ In Plugins und SDK prüfen, wo providerContext und recent gelesen werden: Das Ersatz-Nachrichtenfenster der Provider-Compaction liegt jetzt in native.messages; Summary-Compactions geben recent nicht mehr aus, neue verweisen über metadata.keepID auf die erste wörtlich behaltene Nachricht, und der behaltene Text älterer Compactions (vor 2.1) und von V1-Importen bleibt als metadata.recent verfügbar.
OpenCode bei QCode
Die dokumentierte OpenCode-Anbindung bei QCode: Die Konfigurationsdatei ist ~/.config/opencode/opencode.json; Claude nutzt https://api.qcode.cc/claude/v1, GPT den openai-Provider und chinesische Modelle einen OpenAI-kompatiblen Provider; baseURL ist bei beiden https://api.qcode.cc/openai/v1. Der Schlüssel wird mit opencode auth login oder /connect geschrieben; OpenCode 1 speichert die Zugangsdaten in ~/.local/share/opencode/auth.json, OpenCode 2 in SQLite und importiert die alte auth.json. Aktivieren Sie zuerst die Berechtigung API direct access; sie ist standardmäßig deaktiviert; zur Freischaltung für Ihren Key wenden Sie sich an den Online-Support oder schreiben an hi@qcode.cc. Diese Dokumentationsseite wurde zuletzt am 2026-10-20 geprüft und gibt an, dass die Konfiguration im V1-Format auch in OpenCode 2 weiter unterstützt wird. Die Abrechnung erfolgt pro Token, die Preise je Modell stehen auf /models. Lieber ohne Monatsplan? «Nutzungspakete» gibt es ab $4: ein einmaliges Kontingent, das Sie innerhalb von 7 bis 90 Tagen aufbrauchen. Wenn Sie bereits einen Privatplan haben und mehr Kontingent brauchen, buchen Sie ein Booster-Paket dazu.
Häufig gestellte Fragen
Wer muss wegen der Breaking Changes in 2.1 Code ändern?
Das offizielle Changelog verlangt, dass Integrationen die neuen Felder übernehmen, und nennt das öffentliche SDK sowie die Verträge für HTTP message/event und Plugins. Wer Plugins baut, das SDK nutzt oder Events per HTTP empfängt, muss die neuen Felder übernehmen.
Was hat sich bei den Replay-Daten geändert?
An verschiedenen Stellen wurden unterschiedliche Namen wie state, providerState und resultState verwendet; 2.1 liest und schreibt native. Ausführungsstatus und UI-Metadaten eines Tools werden nicht umbenannt.
Kann ich session.compacted noch verwenden?
Nein. Das Event wurde aus den öffentlichen Events entfernt; verwenden Sie session.compaction.started und session.compaction.ended in Event-Abonnements und Schema-Importen.
Erfordert das Upgrade auf 2.1 eine Datenbankmigration?
Nein. Das offizielle Changelog sagt, dass gespeicherte Sitzungen, Zugangsdaten und der Import älterer Sitzungen über Kompatibilitätsdecoder lesbar bleiben; eine Datenbankmigration ist nicht nötig.
Müssen normale CLI-Nutzer etwas ändern?
Die Anforderung im offiziellen Changelog richtet sich an Integrationen und ist nicht nach Nutzertyp aufgeschlüsselt. Prüfen Sie vor dem Upgrade Ihre Plugins, SDK-Nutzung und Event-Abonnements.
Was ändert sich bei der OpenCode-Anbindung an QCode?
Folgen Sie der QCode-Dokumentation: Setzen Sie in opencode.json für den Anthropic-Provider https://api.qcode.cc/claude/v1 und für den OpenAI-Provider https://api.qcode.cc/openai/v1; den Schlüssel schreiben Sie mit opencode auth login oder /connect. Die OpenCode-Seite der QCode-Dokumentation wurde am 2026-10-20 geprüft: Die dortige Konfiguration im V1-Format wird in OpenCode 2 weiter unterstützt, und die Dokumentation nennt zusätzlich die native V2-Schreibweise. Die Abrechnung erfolgt pro Token, die Preise je Modell stehen auf /models.
Quellen
Offizielles OpenCode-Changelog (abgerufen am 2026-10-20, Eintrag v2.1.0); offizielle OpenCode-CLI-Dokumentation (opencode auth login); OpenCode-Seite der QCode-Dokumentation (abgerufen am 2026-10-20; letzte Prüfung 2026-10-20); QCode-Seite «Nutzungspakete» (abgerufen am 2026-10-20).
Vertragsänderungen, Punkt für Punkt
Die OpenCode-Anbindung bei QCode nutzt opencode.json plus zwei baseURLs; die Abrechnung erfolgt pro Token, die Preise je Modell stehen auf /models.
Weiterführende Lektüre
Nutzungspakete für Claude Code: ohne Abo, 7–90 Tage gültig
Kontingent einmal kaufen und binnen 7–90 Tagen nutzen, ohne Abo; weitere Pakete landen auf demselben Key.
OpenCode: Session-Sharing entfällt (1.19.1), Upgrade auf 2
Der Upgrade-Befehl von 1.19.x auf 2.0 und das Ende des Session-Sharings.
OpenCode 2026: über 200.000 Sterne, KI-Coding-Agent
Was OpenCode ist, Installation, Multi-Agent, BYOK und die Anbindung an QCode.
Krypto-Zahlungsleitfaden
Neun Coins, 56 Netzwerke, keine Plattformgebühr für KI-Coding-API-Guthaben.
Die OpenCode-Fakten auf dieser Seite wurden am 2026-10-20 gegen das offizielle Changelog geprüft; die QCode-Anbindung folgt docs.qcode.cc, Modellverfügbarkeit und Preise folgen /models. OpenCode und QCode können diese Angaben ohne Vorankündigung ändern.