---
title: "OpenCode-Fehler bei kostenlosen Modellen: v1-Abschaltung, v2-Upgrade und Reset-Verzögerungen"
description: "Seit dem Umstieg auf OpenCode v2 häufen sich Fehlermeldungen zu kostenlosen Modellen in #59387. Hier findest du den Hintergrund, die genauen Fehlermeldungen und alle vier Ursachen im Überblick."
url: https://codingpass.ai/de/blog/opencode-free-model-errors-v2-upgrade
language: de
updated: 2026-11-20
---
# OpenCode-Fehler bei kostenlosen Modellen: v1-Abschaltung und v2-Upgrade

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.

[CodingPass-Team](https://codingpass.ai/de/about) Veröffentlicht 20. Nov. 2026 Aktualisiert 20. Nov. 2026 6 Min. Lesezeit

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](https://github.com/anomalyco/opencode/issues/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.

## Wie die Fehlermeldungen aussehen

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 Go
3. 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.

## Die vier möglichen Ursachen

### 1. Du nutzt noch 1.x – dort sind kostenlose Modelle abgeschaltet

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.

### 2. Du bist auf v2, testest aber in einer alten 1.x-Sitzung

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.

### 3. Das Tageslimit ist erschöpft oder der Server-Zähler hängt

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.

### 4. Aufruf der Gratis-Modelle außerhalb von OpenCode

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.

## Zwei Randfälle, die schlimmer aussehen, als sie sind

- **402-Einträge bei Hintergrund-Anfragen**: Tauchen in lokalen Logs 402-Ablehnungen für günstige Modelle wie `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.

## Wann sich OpenCode Go lohnt

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`.

Geschrieben von CodingPass-Team

Wir betreiben CodingPass und testen jede Anleitung vor der Veröffentlichung mit der aktuellen stabilen Version des Tools. Etwas ist veraltet? Schreib an [support@codingpass.ai](mailto:support@codingpass.ai).

## Mehr zum Thema.

Anleitung

### [OpenCode-Anleitung](https://codingpass.ai/de/tools/opencode)

Die Provider-Konfiguration in opencode.jsonc, Modell-IDs für jede Stufe und wie du typische Fehler prüfst.

Referenz

### [So funktionieren Kontingente und Limits](https://codingpass.ai/de/usage-limits)

Jedes Kontingent und jedes Limit pro Tarif und Modell sowie die 429-Antwort.

Modelle

### [Alle Modelle](https://codingpass.ai/de/models)

Modell-IDs, erforderliche Stufe und das Monatskontingent für jedes Modell.
