Claude in OpenCode: der Claude-Agent-Provider, API-Keys und die anderen Wege

Claude lässt sich auf zwei Arten in OpenCode nutzen. Seit OpenCode 2.2.3, erschienen am 30. Oktober 2026, führt der eingebaute Claude-Agent-Provider Claude über Ihr eigenes Claude-Code-Login aus: Claude Code installieren, claude auth login ausführen, in /connect Claude Agent wählen, und die Claude-Modelle laufen über Ihr Claude-Abo, während OpenCode seine eigenen Tools, Berechtigungen und den Sitzungsverlauf behält. Der andere Weg ist die Abrechnung pro Token oder pro Platz über einen Anbieter: Anthropic-API-Key, OpenCode Console, GitHub Copilot, OpenRouter oder Amazon Bedrock und Google Vertex.

Nicht verwenden sollten Sie die älteren Community-Plugins, die OpenCode direkt mit Ihrem Claude-Pro- oder Max-Konto anmelden. OpenCode liefert sie seit Version 1.3.0 nicht mehr mit, die Dokumentation sagt, dass Anthropic sie ausdrücklich verbietet, und die Bedingungen von Anthropic untersagen Drittanbieter-Apps, Claude.ai-Zugangsdaten einzusammeln oder weiterzuleiten. Dieser Leitfaden beschreibt jeden Weg, die Funktionsweise des Claude-Agent-Providers, die Kosten und das Ergebnis eines kleinen Testlaufs auf meinem Rechner. Das Werkzeug selbst behandelt mein OpenCode-Test.

Welche Wege gibt es, Claude in OpenCode zu nutzen?

Stand Oktober 2026 gibt es sieben praktikable Wege. opencode models listet die Claude-Modelle aller verbundenen Provider auf; auf meinem Rechner boten fünf Provider Claude an, von claude-agent/opus bis openrouter/anthropic/claude-sonnet-5.5.

Die Modell-IDs folgen den Konventionen des jeweiligen Providers. Claude Agent nutzt die Aliase von Claude Code wie opus, sonnet und haiku, und Claude Code löst sie zum aktuellen Modell auf, zum Beispiel claude-opus-5-5 für opus. Copilot und OpenRouter schreiben Versionen mit Punkt, etwa claude-sonnet-5.5; der Anthropic-Provider und OpenCode Console verwenden Bindestriche wie in claude-sonnet-5-5.

Wie richten Sie den Claude-Agent-Provider ein?

Sie brauchen Claude Code ab Version 2.1.248, angemeldet, auf derselben Maschine wie der OpenCode-Server. Danach verbinden Sie Claude Agent wie jeden anderen Provider. Die Modellliste kommt von Claude Code, und Effort-Stufen sind Varianten wie claude-agent/opus#high.

# 1. Claude Code installieren oder aktualisieren (ab 2.1.248), dann anmelden
claude update
claude auth login

# 2. In der OpenCode-TUI: Provider verbinden und Modell wählen
/connect     # Claude Agent auswählen
/models      # zum Beispiel claude-agent/sonnet

# 3. Oder aus der Shell, mit einer Effort-Variante
opencode run -m "claude-agent/opus#high" "Erkläre, warum tests/api fehlschlägt"

OpenCode sucht claude im PATH. Für eine andere Installation setzen Sie OPENCODE_CLAUDE_PATH auf dem OpenCode-Server, zum Beispiel mit opencode service set env OPENCODE_CLAUDE_PATH /opt/claude/bin/claude. Version 2.2.4, am selben Tag wie 2.2.3 erschienen, ergänzt in der Desktop- und Web-App eine geführte Einrichtung: Wer Claude Agent wählt, sieht den Befehl claude auth login, eine Schaltfläche zur Installation von Claude Code und eine Prüfung, die wartet, bis OpenCode bestätigt hat, dass Claude Code installiert und angemeldet ist. Schlägt die Prüfung fehl, nennt der Dialog den Grund, etwa nicht installiert, nicht angemeldet oder zu alt, und bietet eine erneute Prüfung an.

Jedes Claude-Code-Login funktioniert, nicht nur ein Abo. Ist Claude Code mit einem API-Key angemeldet oder für Claude Platform on AWS, Bedrock, Vertex oder Microsoft Foundry eingerichtet, nutzt der Provider dieses Login. Verbindungseinstellungen aus der OpenCode-Konfiguration reicht OpenCode an Claude Code weiter: settings.baseURL wird zu ANTHROPIC_BASE_URL, settings.apiKey zu ANTHROPIC_API_KEY und headers zu ANTHROPIC_CUSTOM_HEADERS. So leiten Sie den Provider über ein firmeneigenes LLM-Gateway.

Was passiert, wenn OpenCode Claude über Claude Code ausführt?

Claude Code ruft das Modell auf, OpenCode erledigt den Rest. OpenCode startet Ihr installiertes claude-Programm über das Claude Agent SDK von Anthropic, mit einem langlebigen Prozess pro Sitzung, und gibt ihm die Tools von OpenCode statt der eigenen von Claude Code. Ruft Claude ein Tool auf, hält der Provider den Aufruf an, OpenCode führt ihn mit den üblichen Berechtigungsabfragen aus, und das Ergebnis geht an Claude zurück. Laut Design-Spezifikation steht OpenCode nie zwischen Claude Code und Anthropic, verändert keine Anfragen von Claude Code und liest nie das gespeicherte Login von Claude Code.

Der Provider schaltet bewusst den Großteil der Mechanik von Claude Code ab, damit sich OpenCode unabhängig vom gewählten Modell gleich verhält:

• Tools: Die eingebauten Tools von Claude Code sind aus. Claude erhält nur die Tools von OpenCode, so gilt ein einziges Berechtigungssystem, und der Verlauf sieht gleich aus, egal welches Modell ihn geschrieben hat.
• Einstellungen: Claude Code liest keine Ihrer ~/.claude-Einstellungen, CLAUDE.md-Dateien, Hooks, MCP-Server oder Skills. OpenCode ergänzt den System-Prompt von Claude Code um seine eigenen Anweisungen: den Prompt des gewählten Agenten, AGENTS.md-Dateien, Skills und MCP-Anweisungen.
• Verlauf: Maßgeblich ist der Verlauf von OpenCode. Wechseln Sie mitten in einer Sitzung zu Claude, geht alles, was Claude noch nicht gesehen hat, als eine Nachricht hinüber. So können Sie in derselben Sitzung zwischen Claude und anderen Modellen wechseln.
• Komprimierung und Subagenten: Beides übernimmt OpenCode. Automatische Komprimierung, Auto-Memory und Tool-Suche von Claude Code sind aus.
• Prozesslaufzeit: Der claude-Prozess endet nach 5 Minuten Leerlauf, die nächste Nachricht setzt die gespeicherte Claude-Sitzung fort. Zeit, in der OpenCode Tools ausführt, zählt nicht als Leerlauf.

Eine praktische Folge: Tool-Aufrufe laufen nacheinander. Laut Spezifikation muss der Provider jedes Ergebnis der Aufruf-ID von Claude zuordnen und verfolgt nur eine ID zur selben Zeit, daher markiert er Tools nie als parallel ausführbar.

Ist es erlaubt, das Claude-Abo in OpenCode zu nutzen?

Den Claude-Agent-Provider mit dem eigenen Abo zu nutzen, passt Stand Oktober 2026 zu den veröffentlichten Regeln von Anthropic; Plugins, die Ihr Claude.ai-Login wiederverwenden, tun das nicht. Der Unterschied liegt darin, wer mit den Zugangsdaten umgeht. Laut der Rechtsseite von Anthropic ist die OAuth-Anmeldung für Abonnenten und für die gewöhnliche Nutzung von Claude Code und anderen nativen Anthropic-Anwendungen gedacht. Drittanbietern ist es nicht erlaubt, in ihren eigenen Apps ein Claude.ai-Login anzubieten, Anfragen im Namen ihrer Nutzer über Zugangsdaten von Free-, Pro-, Max- oder Ultra-Plänen zu leiten oder Claude.ai-Zugangsdaten und Sitzungstoken einzusammeln, zu speichern oder weiterzuleiten. Im selben Abschnitt steht, dass dies Endnutzer nicht daran hindert, sich mit dem eigenen Claude-Abo im unveränderten Claude-Code-Programm anzumelden.

Der Claude-Agent-Provider ist genau entlang dieser Linie gebaut: Er startet Ihr eigenes, unverändertes claude, und Sie melden sich über den Ablauf von Anthropic in Ihrem Terminal an. Das Hilfecenter von Anthropic, aktualisiert im Oktober 2026, sagt außerdem, dass Nutzung über das Agent SDK, claude -p und Drittanbieter-Apps weiterhin gegen die Abo-Limits zählt, wenn Sie mit Ihrem Plan angemeldet sind. Das ist eine Kehrtwende gegenüber Anfang 2026: Die v1-Provider-Dokumentation von OpenCode sagt noch immer, dass es Plugins für Claude Pro oder Max in OpenCode gibt, dass Anthropic dies ausdrücklich verbietet und dass OpenCode sie seit Version 1.3.0 nicht mehr mitliefert.

Wann sind ein API-Key oder OpenCode Console die bessere Wahl?

Zahlen Sie pro Token, wenn die Arbeit auf einem Server, in der CI, für ein Team oder in einem Remote-Workspace läuft. Der Claude-Agent-Provider braucht ein installiertes und angemeldetes Claude Code auf derselben Maschine wie der OpenCode-Server und steht daher im gehosteten OpenCode und in Remote-Workspaces nicht zur Verfügung. Mit einem API-Key ruft OpenCode Anthropic direkt auf. Den Key verbinden Sie mit /connect oder übergeben ihn dem Hintergrunddienst als Umgebungsvariable:

# Anthropic-API-Key für den gemeinsamen Hintergrunddienst
opencode service set env ANTHROPIC_API_KEY sk-ant-...
opencode auth list

# Oder für einen einzelnen Lauf mit privatem Server
ANTHROPIC_API_KEY=sk-ant-... opencode --standalone

OpenCode Console verkauft dieselben Modelle auf Prepaid-Guthaben weiter, praktisch, wenn Sie eine einzige OpenCode-Rechnung über mehrere Anbieter hinweg wollen. Stand Oktober 2026 entsprechen die Preise für Ein- und Ausgabetoken denen von Anthropic. Der einzige Unterschied in der Tabelle ist das Cache-Lesen bei Sonnet 5.5, und in einer langen Coding-Sitzung sind die meisten Eingabetoken Cache-Lesevorgänge.

Cache-Schreibvorgänge für fünf Minuten kosten bei beiden das 1.25-Fache des Eingabepreises: $5.00 für Opus 5.5, $2.50 für Sonnet 5.5 und $0.125 für Haiku 5.5. OpenCode setzt Prompt-Cache-Breakpoints auf Anthropic-Wegen automatisch. Nur wenn Claude hinter einem OpenAI-kompatiblen Proxy wie LiteLLM sitzt, setzen Sie bei diesen Modellen compatibility.cacheFormat auf "anthropic", weil OpenCode dem Proxy nicht ansieht, dass sie Breakpoints im Anthropic-Stil brauchen. Mein Leitfaden zu den Claude-Preisen vergleicht Abo-Limits und API-Kosten genauer.

Geht Claude auch über Copilot, OpenRouter, Bedrock oder Vertex?

Ja, alle vier funktionieren, und sie lohnen sich, wenn Sie den Dienst ohnehin bezahlen. GitHub Copilot verbindet sich über den Geräte-Login von GitHub, und das Konto braucht Zugriff auf Copilot Chat. GitHub führt Claude Haiku 4.5 und 5.5, Sonnet 4.6, 5 und 5.5, Opus 4.8, 5 und 5.5 sowie Fable 5 und 5.1 als allgemein verfügbar in Copilot, Nutzer von Copilot Free und Student erhalten Modelle aber nur über die automatische Modellauswahl. OpenCode lädt nach dem Login die aktuelle Modellliste des Kontos.

OpenRouter nimmt einen OPENROUTER_API_KEY oder ein verbundenes Konto, und Modelle tragen nach dem Präfix die vollständige OpenRouter-ID, etwa openrouter/anthropic/claude-sonnet-5.5. Meine Modellliste zeigte zudem mitlaufende Aliase wie openrouter/~anthropic/claude-sonnet-latest. Amazon Bedrock nutzt die Standard-Credential-Kette von AWS, ein benanntes AWS-Profil ist die einfachste dauerhafte Einrichtung. Google Vertex nutzt Application Default Credentials und braucht ein Projekt, bevor Modelle erscheinen. Laut Provider-Spezifikation kosten regionale Bedrock-Modell-IDs wie us.anthropic.claude-opus-5-5 10% mehr als die Listenpreise von Anthropic.

OpenCode Go ist der günstigste Einstieg, deckt unter den Claude-Modellen aber nur Claude Haiku 5.5 ab. Der Go-Plan kostet $10 im Monat, und OpenCode schätzt darauf 3,850 Haiku-5.5-Anfragen pro fünf Stunden, bei 1,100 Eingabe-, 55,000 gecachten und 240 Ausgabetoken pro Anfrage. Das passt für einen Subagenten oder ein günstiges Nebenmodell, nicht für den Haupt-Coding-Agenten. Mein Leitfaden zu Haiku 5.5 zeigt, welche Aufgaben es gut erledigt.

Was hat ein kleiner Testlauf gezeigt?

Beide Abo-Wege haben denselben kleinen Fehler in rund fünf Sekunden behoben, und der Claude-Agent-Weg nutzte die Tools von OpenCode, wie die Spezifikation es beschreibt. Ich habe eine Aufgabe mit OpenCode 2.2.4 und Claude Code 2.1.314 ausgeführt: eine zweizeilige Python-Datei, deren add() subtrahierte, mit dem Prompt, den Fehler zu beheben und die Änderung in einem Satz zu beschreiben. Beide Läufe nutzten Haiku 5.5 mit opencode run --format json, einmal über claude-agent/haiku mit meinem Claude-Abo und einmal über opencode-go/claude-haiku-5-5.

OpenCode zeigte für beide Läufe Kosten von $0, weil der jeweilige Plan die Nutzung abdeckt. Die Spalte mit Listenpreisen ist meine eigene Rechnung zu Haiku-5.5-Preisen, unter der Annahme von Cache-Schreibvorgängen für fünf Minuten. Die Prompts waren ähnlich groß: rund 22,900 Token über Claude Agent, mit dem System-Prompt von Claude Code, und rund 20,700 über Go, mit dem von OpenCode. Der erste Claude-Agent-Schritt las in einer frischen Sitzung bereits 6,226 Token aus dem Cache, höchstwahrscheinlich den Teil des System-Prompts von Claude Code, der von meiner früheren Claude-Code-Nutzung noch gecacht war. Beide Protokolle zeigen, dass die Tool-Aufrufe read und edit von OpenCode kamen.

Zwei praktische Hinweise aus dem Test. Mein OpenCode-Console-Konto hatte kein Guthaben, und dieser Weg scheiterte sofort mit dem Fehler 402 „Insufficient account funds“, denn Console ist Prepaid. Außerdem wartete opencode run, aus einem Skript ohne Terminal aufgerufen, auf eine Eingabe, bis ich die Standardeingabe mit < /dev/null schloss; danach liefen alle Durchgänge normal durch.

Wie legen Sie Modelle und Effort für Claude in OpenCode fest?

Legen Sie in opencode.jsonc ein Standardmodell fest und geben Sie einzelnen Agenten ein eigenes Modell mit optionaler #variant. Eine übliche Aufteilung ist ein starkes Modell fürs Planen, ein mittleres fürs Bauen und ein kleines für die Suche. Die eingebauten Agenten von OpenCode sind build und plan als primäre Agenten sowie general und explore als Subagenten:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "claude-agent/sonnet",
  "agents": {
    "plan": { "model": "claude-agent/opus#high" },
    "explore": { "model": "claude-agent/haiku" }
  }
}

#high wählt eine Effort-Variante. Die Variantennamen stammen aus den Katalogdaten des Modells, und eine unbekannte Variante endet mit einem Fehler bei der Modellauflösung. Prüfen Sie deshalb /models, bevor Sie eine Konfiguration übernehmen. Ein Subagent ohne eigenes Modell erbt das Modell der übergeordneten Sitzung. Mit dem Anthropic-Provider nutzt dieselbe Konfiguration IDs wie anthropic/claude-opus-5-5#high. Beim Claude-Agent-Provider werden Temperature, Top-p, Top-k, Seed und Stop-Sequenzen nicht unterstützt, und CLAUDE_CODE_EFFORT_LEVEL in Ihrer Shell wirkt nicht, weil der Provider die Variable leert, damit der in OpenCode gewählte Effort gilt.

Was funktioniert mit Claude Agent in OpenCode nicht?

Der Provider bringt die Modelle von Claude in OpenCode, nicht die Produktfunktionen von Claude Code. Die OpenCode-Dokumentation und die Design-Spezifikation nennen diese Lücken:

• Kein gehostetes OpenCode und keine Remote-Workspaces, weil Claude Code auf derselben Maschine wie der OpenCode-Server laufen muss.
• Der System-Prompt von Claude Code ersetzt die eingebauten Agenten-Prompts von OpenCode; eigene Agenten-Prompts gelten weiterhin.
• Die Plugin-Hooks http.request und http.response laufen nicht, weil Claude Code die API-Aufrufe macht.
• Funktionen von Claude Code ohne Gegenstück in OpenCode fehlen: /usage und die Optionen bei Erreichen eines Limits, /loop, der Auto-Modus, Agent Teams, Cloud-Sitzungen und /teleport, Computer Use, die Bash-Sandbox und mitgelieferte Skills wie /simplify. Das /usage von OpenCode zeigt stattdessen die Console-Nutzung.
• Tool-Aufrufe laufen nacheinander, wie oben beschrieben.

Wenn Sie diese Funktionen von Claude Code täglich brauchen, nutzen Sie Claude Code selbst; mein Claude-Code-Test behandelt es. Der Provider ist für alle, die die Oberfläche von OpenCode, seine Sitzungen mit mehreren Modellen und seine Berechtigungsregeln bevorzugen, aber ihr Claude-Abo dahinter wollen.

Welchen Weg sollten Sie wählen?

Wählen Sie den Weg danach, wer OpenCode nutzt und wo es läuft:

1. Eigener Rechner und ein vorhandenes Claude-Pro-, Max- oder Ultra-Abo: der Claude-Agent-Provider. Er nutzt Limits, die Sie ohnehin bezahlen, und behält den Arbeitsablauf von OpenCode bei.
2. Ein Team, CI, ein Server oder ein Remote-Workspace: ein Anthropic-API-Key, oder Bedrock bzw. Vertex, wenn Ihr Unternehmen dort ohnehin arbeitet. Nehmen Sie OpenCode Console, wenn Sie eine einzige Prepaid-Rechnung von OpenCode über mehrere Anbieter wollen.
3. Ein vorhandener Copilot-Platz: der GitHub-Copilot-Provider, im Rahmen der Modelle und Limits Ihres Copilot-Plans.
4. Ein günstiges kleines Nebenmodell: OpenCode Go für Haiku 5.5, etwa als Subagent explore.
5. Routing und Fallbacks über Anbieter hinweg: OpenRouter, wenn Sie es bereits nutzen.

Egal welchen Weg Sie wählen: Halten Sie Ihre Projektanweisungen in AGENTS.md statt in CLAUDE.md, denn diese Datei gibt OpenCode an jedes Modell weiter, auch an Claude über den Claude-Agent-Provider. Die Entscheidungsmatrix für AGENTS.md, Skills, MCP und CLIs hilft bei dieser Aufteilung. Wenn Sie Coding-Agenten für ein Team einrichten und Kosten und Datenschutz geklärt haben wollen, gehört das zu meiner Arbeit im Bereich KI-Engineering.

Quellen

1. OpenCode v2.2.3 release notes (October 30, 2026)
2. OpenCode pull request #58782: add Claude Agent provider
3. Claude Agent provider design spec
4. OpenCode docs: Providers
5. OpenCode docs: Models
6. OpenCode docs (v1): Providers, note on Claude Pro/Max plugins
7. OpenCode Console: models and pricing
8. OpenCode Go: plans and usage limits
9. Claude Code docs: Legal and compliance
10. Claude Help Center: Use the Claude Agent SDK with your Claude plan
11. Claude Platform docs: Pricing
12. GitHub Docs: Supported AI models in GitHub Copilot