OpenCode-Anleitung
Die Provider-Konfiguration in opencode.jsonc, Modell-IDs für jede Stufe und wie du typische Fehler prüfst.
Nach dem Rollout von OpenCode v2 schnellten die Berichte über blockierte Gratis-Modelle in #59387 nach oben. Viele vermuten ein erschöpftes Tageslimit und schließen OpenCode Go ab – dabei stecken mindestens vier verschiedene Ursachen hinter ähnlichen Popups.
Ende Oktober führte OpenCode Version 2.x ein und begann, den Zugriff auf kostenlose Modelle für ältere Clients abzuschalten. Auf GitHub häuften sich daraufhin die Fehlermeldungen so stark, dass die Maintainer anomalyco/opencode#59387 als Sammel-Issue einrichteten und neue Tickets als Duplikate dorthin umleiteten.
Der Ablauf wirkt auf den ersten Blick eindeutig: Eine Sitzung bricht mitten in der Arbeit mit einer roten Meldung ab, das kostenlose Kontingent sei aufgebraucht. Viele aktualisieren nach einer Kurzanleitung oder warten auf den angezeigten Reset-Zeitpunkt – nur um festzustellen, dass sich das Datum um einen weiteren Tag nach hinten verschiebt. Hinter derselben Beschreibung „Gratis-Limit erreicht“ verbergen sich vier unterschiedliche Ursachen.
Prüfe zuerst den genauen Wortlaut der Meldung, bevor du Einstellungen änderst oder Go buchst. Veraltete 1.x-Clients, alte 1.x-Sitzungen, hängende Server-Zähler und fremde Clients erfordern jeweils eine eigene Lösung.
Die Popups sehen fast identisch aus; den Unterschied machen Wortlaut und Buttons:
1. This version of OpenCode Desktop no longer supports free models.2. Free usage exceeded, subscribe to Go3. You've used today's free messages. They reset at Oct 22, 2026, 8:00 p.m.4. FreeUsageLimitError (HTTP 429)Erscheint die dritte Meldung zusammen mit den Buttons Upgrade to OpenCode Go und Switch model, hat dein Client die Versionsprüfung bereits bestanden und das Problem liegt tatsächlich beim Kontingent. Die übrigen drei Meldungen haben mit aufgebrauchten Tagesnachrichten nichts zu tun.
Meldungen wie no longer supports free models oder Free usage exceeded, subscribe to Go deuten fast immer auf einen Client der Version 1.x hin. Am 27. Oktober bestätigten die Maintainer, dass v1 keine kostenlosen Modelle mehr unterstützt.
Viele bleiben auf 1.x hängen, obwohl sie sich auf dem neuesten Stand wähnen. Dafür gibt es zwei Gründe: Erstens hält der integrierte Updater von Desktop v1 dich in der 1.x-Reihe (#59482: The v1 Desktop's built-in updater keeps you on 1.x, so updating from inside the app won't get you there.). Zweitens existieren auf npm zwei Pakete: Das alte Paket opencode-ai endet bei 1.19.5 auf latest, während v2 unter @opencode/cli (2.2.2+ auf latest) veröffentlicht wird. Ein npm i -g opencode-ai belässt dich dauerhaft auf 1.x.
Da Desktop und CLI getrennte Programme sind, prüfe 2.x genau dort, wo du arbeitest: per opencode --version im Terminal, unter Settings → About in der Desktop-App oder über die Dateiversion der .exe im Windows-Installationsordner. Für die manuelle v2-Installation wähle den passenden Weg für dein System:
| Methode | Plattform | Befehl oder Vorgehen |
|---|---|---|
| curl | macOS / Linux | curl -fsSL https://opencode.ai/v2/install | bash |
| npm | Alle Plattformen | npm install -g @opencode/cli |
| Homebrew | macOS | brew install anomalyco/tap/opencode-v2 |
| Eigenständiges Binary | Windows | Offizielles x64-Zip laden, entpacken und den Ordner in PATH aufnehmen |
Laut offizieller Dokumentation werden Windows-Paketmanager nicht unterstützt; unter Windows empfehlen sich daher npm oder das x64-Zip. Tauchen nach der Installation unter /models keine Gratis-Modelle auf, melde dich zuerst per /connect am OpenCode-Console-Account an – im abgemeldeten Zustand erscheint der eingebaute opencode-Provider gar nicht.
Nach dem Update auf v2 öffnen viele direkt eine laufende Sitzung und erhalten weiterhin no longer supports free models, was wie ein fehlgeschlagenes Upgrade wirkt.
Issue #60352 beschreibt genau dieses Verhalten: Selbst wenn CLI und Desktop auf 2.2.2 laufen und die lokale Datenbankmigration sauber durchging, lehnt das Backend noch unter 1.x angelegte Sitzungen weiterhin als veralteten Client ab. Eine neu erstellte Sitzung funktioniert mit demselben Account und demselben Modell in der Regel sofort. Teste ein v2-Upgrade daher immer in einer frischen Sitzung.
Beobachte bei You've used today's free messages. They reset at <Zeit> · <Datum>, ob die Uhrzeit stabil bleibt. Zeigt sie jeden Tag auf dieselbe Stunde, ist das Tageslimit tatsächlich voll und du musst den Reset abwarten.
Springt das Datum nach Ablauf des Countdowns direkt auf den nächsten Tag weiter (etwa von Oct 22 auf Oct 23), hängt der serverseitige Zähler. Laut #60328 verwaltet das gehostete Console-Backend Quoten und Reset-Fenster pro Account und Netzwerk; lokale Eingriffe ändern daran nichts. Eine Neuinstallation oder das Löschen von Konfigurationsordnern und Datenbanken hilft selten und vernichtet deinen lokalen Sitzungsverlauf. Zwei inoffizielle Workarounds aus dem Issue: In OpenCode vom Console-Account ab- und wieder anmelden (manchmal mehrfach) oder das Netzwerk wechseln, etwa über einen mobilen Hotspot.
Erscheint FreeUsageLimitError oder HTTP 429 in einem anderen Editor oder einem eigenen Skript, spielen Version und Netzwerk keine Rolle. Die OpenCode-Dokumentation hält ausdrücklich fest: Free-tier chat models require OpenCode. API-Keys für Gratis-Modelle funktionieren ausschließlich im OpenCode-Client; externe Aufrufe erhalten unabhängig vom Setup HTTP 429. Wechsle zurück in OpenCode oder nutze ein kostenpflichtiges Modell.
GPT-6 Luna auf, bucht OpenCode nicht heimlich Geld ab. Laut Console-Dokumentation generiert OpenCode Sitzungstitel im Hintergrund über günstige Modelle (Haiku, Nano, Flash) auf einem separaten Kanal, unabhängig von deinem Gratis-Kontingent.Illegal instruction auf älteren CPUs: Über zehn Jahre alte Prozessoren, die nur bis SSE4.1 reichen (ohne SSE4.2 und POPCNT), stürzen unter v2 mit Illegal instruction ab, während v1 keine kostenlosen Modelle mehr unterstützt. Das ist eine Hardware-Grenze und kein Konfigurationsfehler.Bleibt der Fehler nach der Prüfung auf 2.x, einer neuen Sitzung sowie Abmeldung oder Netzwerkwechsel bestehen, melde dich in #59387 mit drei Angaben: genauer Version, Betriebssystem und vollständigem Fehlertext.
Auf der OpenCode-Go-Seite steht: If you reach the usage limit, you can continue using the free models. Go kauft bezahltes Kontingent in einem eigenen Pool und schaltet keine Gratis-Modelle frei.
Ein Go-Abo umgeht weder einen 1.x-Client noch eine alte 1.x-Sitzung oder ein 429 aus Dritt-Tools. Sinnvoll ist Go erst, wenn du in einer neuen v2-Sitzung bei festem Reset-Zeitpunkt regelmäßig schon nachmittags ans Tageslimit stößt (Go kostet $10/Monat, Go Plus $40/Monat und Go Teams $20/Nutzer/Monat; eine genaue tägliche Nachrichtenobergrenze für Gratis-Modelle nennt OpenCode nicht).
Hinweise zum Gratis-Pool und zu Regionen: Der zeitlich begrenzte Gratis-Pool umfasst aktuell Big Pickle, GLM-5.3-Flash Free, DeepSeek V4.1 Flash Free, Beam Free, Flint 40B Free, MiMo-V2.6-Flash Free, Nemotron 3 Ultra Free, Nemotron 3.5 Lightning Free, Nemotron 3.5 Super VL Free und Jev 1.13 Free. Beam Free ist in China (einschließlich Hongkong und Macau) nicht verfügbar. Um kostenlose Modelle komplett auszublenden, setze OPENCODE_DISABLE_FREE_MODELS=1.
Nutze OpenCode 2 einfach weiter. Wenn Gratis-Limits oder regionale Sperren bremsen, zeig mit der Base URL auf CodingPass für nutzungsbasierten Zugriff auf Claude, GPT und Open-Weight-Modelle.