AnmeldenTarif wählen
Blog · Setup-Anleitungen

OpenCode 2 läuft rund, aber Claude streikt?

OpenCode 2 hat die gesamte CLI von Grund auf neu gebaut – Terminal, Web und Desktop teilen sich jetzt einen gemeinsamen Dienst, und der Workflow läuft spürbar runder. Doch wer sein Claude-Abo anbindet, stößt derzeit immer wieder auf denselben 400-Fehler, mal sofort, mal mitten im Gespräch.

Mitte Oktober ist OpenCode 2 erschienen. Das Team hat das Release nicht als gewöhnliches Versions-Update behandelt, sondern den Unterbau komplett neu geschrieben.

Die wichtigste Änderung: Alle Oberflächen laufen jetzt über einen gemeinsamen Hintergrunddienst. Unter 1.x starteten Terminal-UI, Web-Oberfläche und Desktop-Client jeweils eigene Prozesse, die Sitzungen waren voneinander getrennt. Ab 2.0 läuft pro Rechner nur noch ein lokaler Dienst, mit dem sich Terminal, Web und Desktop als Clients verbinden.

X · @CamilleRouxTUI, web et desktop sur un même service localAuf X ansehen
Ein 5-sekündiger Clip aus dem Terminal von OpenCode 2.0: Ein Rabatt-Bug wird behoben, danach laufen die Tests. Der Post nennt TUI, Web und Desktop auf einem gemeinsamen lokalen Dienst, eine neue API für JS-Skripte und Hunderte MCP server, ohne dass der Kontext überläuft. Das Cover ist ein Standbild aus dem Video; der Link öffnet X, vor dem Klick lädt die Seite nichts von X.

Automatisierungsskripte sprechen denselben Dienst direkt über @opencode/client an, geplante Jobs nehmen über opencode api denselben Eingang. Und wenn du von einem anderen Gerät aus weiterarbeiten willst, gibt opencode pair den lokalen Dienst frei, ohne dass du Port-Weiterleitungen basteln musst.

Neu ist auch der standardmäßig aktive Code Mode. Sobald früher mehrere MCP server eingebunden waren, landeten Dutzende JSON-Schemata auf einmal im Kontext – das fraß Platz im Kontextfenster und führte häufiger zu fehlerhaften Tool-Aufrufen. Version 2.0 verpackt sie stattdessen in direkt aufrufbare JavaScript-Funktionen. Muss das Modell mehrere Tools nacheinander aufrufen, schreibt es ein kurzes Skript und führt es in einem Rutsch in der Sandbox aus, statt für jeden Schritt einzeln hin und her zu schicken.

Code-Mode-Diagramm aus OpenCode 2.0: Auf die Bitte „File GitHub bugs in Linear“ führt die Sitzung einen einzigen Codeblock aus, der tools.github.list_issues und tools.linear.save_issue in einem Skript aufruft; rechts die MCP server github, linear und sentry
Code Mode: Ein Skript ruft GitHub und Linear nacheinander auf und liefert die neuen Issue-IDs zurück. Quelle: Release Notes zu OpenCode 2.0.

Auch der Update-Mechanismus wurde umgestellt. Seit Version 1.19.0 verzichtet der Client auf stille Hintergrund-Updates; der Sprung auf 2.0 erfordert ein manuelles /update oder opencode upgrade --major. Plugin-API und Server-Schnittstellen wurden komplett neu entworfen, alte 1.x-Plugins funktionieren nach dem Upgrade nicht mehr und müssen an die neuen Schnittstellen angepasst werden. Dass die Entscheidung beim Nutzer liegt, verhindert immerhin, dass morgens mitten in der Arbeit plötzlich die Umgebung stillsteht.

Im Alltag fühlen sich Antwortzeiten und der Wechsel zwischen den Oberflächen spürbar flüssiger an als unter 1.x. Doch viele, die nach dem Upgrade weiter mit ihrem Claude-Abo arbeiten wollen, laufen seitdem regelmäßig in einen 400-Fehler.

Vom Request-Header zum Request-Body

Die Fehlermeldung selbst ist kurz:

400 Third-party apps now draw from extra usage, not plan limits.Ask your workspace admin to add more and keep going.

Wer in diesem Jahr externe Tools mit einem Claude-Abo genutzt hat, kennt diesen Satz wahrscheinlich schon. Im Laufe des letzten halben Jahres hat Anthropic den Abfluss von Abo-Kontingenten in mehreren Schritten eingeschränkt.

Der erste Schnitt kam am 4. April. Seit diesem Tag zählen Aufrufe aus Drittanbieter-Clients nicht mehr zum Kontingent der Pro- und Max-Tarife. Das Abo-Kontingent ist seitdem für Claude.ai, das offizielle Claude Code und Cowork reserviert; andere Tools können sich zwar weiter einloggen, ihr Traffic wird aber zum regulären API-Preis über extra usage (also Prepaid-Guthaben) abgerechnet. Ist extra usage im Account deaktiviert oder das Guthaben bei null, blockiert der Server die Anfrage mit genau diesem 400-Fehler.

“Starting tomorrow at 12pm PT, Claude subscriptions will no longer cover usage on third-party tools like OpenClaw. You can still use these tools with your Claude login via extra usage bundles, or with a Claude API key.”

Boris Cherny, der Claude Code geschrieben hat, damals auf Threads.

Am 15. Juni wollte Anthropic eigentlich auch Aufrufe über das Agent SDK und claude -p auf den monatlichen Credit-Pool umlegen, setzte die Änderung aber noch am selben Tag wieder aus. Übrig blieb ein Zwischenzustand: Was durch den Kanal von echtem Claude Code geht, zählt weiterhin zum Tarifkontingent; was als Drittanbieter-Client eingestuft wird, läuft über extra usage.

Für OpenCode-Nutzer liegt die Tücke in der Erkennung. Vergleiche von Paketmitschnitten aus der Community zeigen, dass die Gegenseite nicht nur User-Agent und Request-Header prüft, sondern auch den System-Prompt im Request-Body.

Deshalb wirkt das Fehlerbild so unberechenbar. Der Upstream sperrt keinen Account pauschal am Eingang, sondern prüft jede einzelne Anfrage auf ihren Inhalt. Ein erschöpftes Kontingent oder ein ungültiges Token würde jede Anfrage scheitern lassen, statt erst 200 zu liefern und bei der nächsten nach extra usage zu verlangen.

Paketmitschnitt, Reproduktion und Eingrenzung

Am 12. November schlugen bei uns auf zwei Systemen kurz nacheinander dieselben Warnungen auf. Die Gateway-Logs zeigten auf beiden dasselbe Bild: gleiches Gespräch, gleicher Account – kurze Anfragen gehen durch, die Hauptanfrage (24 KB auf dem einen, 40 KB auf dem anderen System) prallt mit diesem 400 ab.

Lokal ließ sich das sauber reproduzieren: OpenCode 2.2.7 mit Abo-Login, ein aufzeichnender Proxy zwischen Client und Upstream, eine einfache Alltagsfrage. Der Proxy zeichnete vier Anfragen direkt hintereinander auf:

Anfragen, die OpenCode 2.2.7 für eine Frage gesendet hat
AnfrageBodyErgebnis
Sitzungstitel2,3 KB, ohne Tools200
Hauptanfrage47 KB, 4 System-Prompt-Blöcke, 13 Tools400
Titelanfrage wiederholt2,3 KB200
Hauptanfrage wiederholt47 KB400

Danach haben wir Account und Modell festgehalten und aus der 47 KB großen Hauptanfrage Abschnitt für Abschnitt Inhalt entfernt, um zu sehen, ab wann der Upstream sie durchlässt:

Statuscodes nach schrittweisem Kürzen der 47 KB großen Hauptanfrage
ÄnderungErgebnis
Unverändert gesendet400
Gesamtes system-Feld entfernt200
Alle tools entfernt, system behalten400
In system nur den 1,4 KB großen Basis-Prompt behalten200
In system nur den 23,8 KB großen Block für Code Mode behalten400
Code Mode behalten, Umgebungsblock am Ende entfernt200
Vom Umgebungsblock am Ende 160 / 180 / 220 Zeichen behalten200
Vom Umgebungsblock am Ende 240 Zeichen behalten400
Ersetzt durch 1000 x oder 240 Zeichen normalen englischen Text200

Damit lässt sich die Ursache eng eingrenzen. Weder die Gesamtgröße des Request-Bodys noch die Anzahl der eingebundenen Tools spielt eine Rolle – der Auslöser sitzt ganz am Ende des System-Prompts, in der Vorlage für Tagesdatum und Laufzeitumgebung. Eine simple Wort-Blacklist ist es ebenfalls nicht: Ersetzt man die Stelle durch 1000 x oder gewöhnlichen englischen Text gleicher Länge, kommt 200 zurück. Lässt man die ursprüngliche Struktur stehen, gehen im Test 220 Zeichen durch, während 240 Zeichen abgefangen werden; die Spanne dazwischen haben wir nicht weiter unterteilt.

Das erklärt auch, warum die Titelanfrage jedes Mal klappt: Ihr system-Feld enthält nur eine kurze Zusammenfassungsanweisung, aber keinen angehängten Umgebungsblock. Erst die Hauptanfrage des Gesprächs hängt Arbeitsverzeichnis, Betriebssystem und das aktuelle Datum an.

Andere in der Community kamen bei der Fehlersuche zum selben Befund. In einem Issue bei Manifest zeigen Mitschnitt-Vergleiche ebenfalls, dass der Upstream nach dem System-Prompt filtert; in den Repositories von Claude Code selbst und von pi melden Nutzer denselben Fehler.

Drei Auswege

Bevor du an deiner Konfiguration schraubst, nimm dir eine Minute Zeit, um die drei Fälle auseinanderzuhalten:

  • Scheitern nur die Hauptanfragen mit Tools, während kleine Anfragen durchgehen, hast du genau diesen Fall vor dir: Die Anfrage wurde als Drittanbieter-Client eingestuft.
  • Schlagen sämtliche Anfragen fehl oder nennt die Meldung login bzw. ein aufgebrauchtes Kontingent, prüf zuerst unter claude.ai/settings/usage deinen Account-Status – das hat mit diesem Filter nichts zu tun.
  • Tritt der Fehler selbst mit einem frisch angelegten Account und ausschließlich im offiziellen Claude Code von Hand auf, sind Account oder Netzwerkumgebung markiert; auf Client-Seite lässt sich das nicht beheben.

Ist ein Account-Problem ausgeschlossen, bleiben drei Wege. Such dir den aus, mit dem du auf Dauer am besten leben kannst.

Am unkompliziertesten ist der Wechsel auf einen offiziellen API key. Dann laufen deine Anfragen über die Standardschnittstelle, und die Frage, als welcher Client du zählst, stellt sich gar nicht erst. Der Nachteil: Der Preisvorteil des Abos fällt weg, abgerechnet wird jedes Token zum Listenpreis – und beim Programmieren mit Agenten klettert die Rechnung schnell.

Wenn du den Abo-Preis nicht aufgeben willst, kannst du in den Claude-Einstellungen extra usage aktivieren und Guthaben aufladen. Deine Anfragen werden dann nicht mehr blockiert, aber alles, was als Drittanbieter-Traffic gilt, geht zum vollen API-Preis vom Guthaben ab. Am Ende zahlst du also doppelt: einmal fürs Abo und einmal nach Verbrauch.

Der dritte Weg führt über ein Gateway, das die Kompatibilitätsbehandlung auf der Weiterleitungsschicht übernimmt. Dann musst du am Client nichts umbauen und auch nicht selbst mit Paketmitschnitten hinter neuen Upstream-Regeln herjagen. Der Haken ist, dass sich diese Erkennung ändert und das Gateway laufend nachgezogen werden muss. Genau diesen Ansatz verfolgt CodingPass: Nach dem Anbinden umgehst du den 400-Fehler, und Modellaufrufe sowie Limits werden weiter über das Dollar-Kontingent deines Tarifs abgerechnet.

Zum Schluss noch ein Hinweis: Auf der Gegenseite arbeitet ein Klassifikator, der laufend angepasst wird, kein fest dokumentiertes Protokoll. Heute greift er bei einem gut zweihundert Zeichen langen Umgebungsblock, morgen vielleicht bei einem anderen Merkmal. Wenn du OpenCode 2 einfach weiternutzen willst, richte baseURL nach der OpenCode-Anleitung auf CodingPass ein. Falls eine Anfrage über CodingPass trotzdem fehlschlägt: Die Fehlerreferenz listet jeden Status, den unser Gateway zurückgibt, und was dann zu tun ist.

Abfahrt

Provider wechseln, Tool behalten.

Nutze OpenCode 2 einfach weiter. Zeig mit der Base URL auf CodingPass – wir fangen den 400er ab, abgerechnet nach Verbrauch, jederzeit kündbar.

  • Request-ID in jeder Antwort
  • Volle Erstattung bei höchstens 5 % Nutzung
  • Keine Überraschungskosten
Go wählenOpenCode-Anleitung

$10/Monat bis zur Kündigung.