Kurz gesagt: Seit OpenCode 2.2.3 bringt OpenCode einen eingebauten Provider namens Claude Agent mit. Claude Code (2.1.248 oder neuer) installieren, im Terminal claude auth login ausführen und in OpenCode unter /connect Claude Agent wählen – dann nutzen Sie Ihren Claude-Code-Login und dessen Modelle in OpenCode. Der Post von @opencode dazu („you can now use your claude subscription in OpenCode") kam innerhalb eines Tages auf über 620.000 Aufrufe.
Es ist nicht der einzige Weg. Claude ließ sich in OpenCode schon immer auf zwei Arten nutzen:
- Abo-Login:
/connect→ Claude Agent. Die Nutzung läuft über Ihr Claude-Konto. - API Key:
/connect→ Anthropic, oderbaseURLund Key für den Provideranthropicinopencode.json. Die Nutzung wird pro Key erfasst.
Im Folgenden: worin sich die beiden unterscheiden, wie Sie jeden einrichten und warum Ihre CLAUDE.md nach dem Wechsel scheinbar nicht mehr greift.
API Key erstellen und in OpenCode, Claude Code, Codex und Cursor gemeinsam nutzen →
Beide Wege im Vergleich
| Claude Agent (Abo-Login) | Anthropic (API Key) | |
|---|---|---|
| Versionen | OpenCode 2.2.3+, Claude Code 2.1.248+ lokal installiert | Jede OpenCode-Version |
| Anmeldung | claude auth login im Terminal | API Key einfügen (oder aus einer Umgebungsvariable lesen) |
| Wer sendet die Anfragen | Ihr lokales claude-Programm über das offizielle Claude Agent SDK | OpenCode selbst |
| Tools, Berechtigungen, Verlauf | Alles auf OpenCode-Seite | Alles auf OpenCode-Seite |
| CLAUDE.md | Das Laden von CLAUDE.md durch Claude Code ist aus; Regeln kommen über AGENTS.md | OpenCodes eigenes Regel-Laden (AGENTS.md zuerst) |
| Remote- / gehostete Workspaces | Nicht unterstützt; claude muss auf demselben Rechner laufen | Unterstützt |
| Temperature und andere Sampling-Optionen | Nicht unterstützt | Unterstützt |
Alles in dieser Tabelle stammt aus dem Designdokument claude-agent-provider.md und PR #58782 im OpenCode-Repository.
Welcher Weg:
- Sie haben bereits einen Claude-Plan und nutzen OpenCode nur auf dem eigenen Rechner: Claude Agent.
- Sie betreiben OpenCode auf Servern, in Remote-Workspaces oder in CI, oder OpenCode, Claude Code, Codex und Cursor sollen einen Key teilen und die Aufrufprotokolle an einer Stelle zeigen: API Key.
- Sie können beide einrichten und in
/modelsumschalten. Laut Designdokument ist der Verlauf in OpenCode maßgeblich: Wechseln Sie zurück zu Claude Agent, bekommt es alles Verpasste als eine Nachricht.
Weg 1: Claude-Agent-Abo-Login (OpenCode 2.2.3+)
Schritt 1: Versionen prüfen
opencode --version # 2.2.3+
claude --version # 2.1.248+
Bei Bedarf aktualisieren:
# OpenCode
opencode upgrade
# or: curl -fsSL https://opencode.ai/v2/install | bash
# or: npm i -g @opencode/cli@latest
# Claude Code
claude update
# or: curl -fsSL https://claude.ai/install.sh | bash
Claude Code muss mindestens 2.1.248 sein. Laut Designdokument lässt OpenCode Claude Code den Kontext weglassen, den es sonst in jeder Runde ergänzt (verschachtelte CLAUDE.md-Dateien, Skill-Listen, Erinnerungen), und diese Option gibt es erst ab 2.1.248.
Schritt 2: Im Terminal bei Claude Code anmelden
claude auth login
claude --version
opencode
claude auth login im Terminal ausführen, nicht /login innerhalb von Claude Code. Die Release Notes zu 2.2.4 haben genau diesen irreführenden /login-Hinweis durch claude auth login ersetzt.
Laut Designdokument liest OpenCode den gespeicherten Login von Claude Code nie aus. /connect merkt sich nur, dass Sie diese Anmeldeart gewählt haben; die Anfragen schickt Ihr lokales claude selbst. Jede Anmeldung, die claude unterstützt, funktioniert: Abo, API Key oder Cloud-Konto.
Schritt 3: In OpenCode /connect ausführen und Claude Agent wählen
/connect
→ Claude Agent (Claude Code login)
→ Anthropic (API Key)
/models
Claude Agent wählen, nicht Anthropic. Anthropic ist der API-Key-Zugang und zeigt nur ein Feld für den Key. Ab 2.2.4 startet Claude Agent eine geführte Einrichtung: claude auth login kopieren, Claude Code installieren, Verbindung prüfen, dann Modell wählen. In der Desktop-App kommen Sie dort auch aus dem Zustand Needs sign-in heraus.
Liegt claude nicht im PATH oder sind mehrere Versionen installiert, zeigen Sie OpenCode die richtige:
export OPENCODE_CLAUDE_PATH="$HOME/.local/bin/claude"
opencode
Was sich nach dem Wechsel ändert
Laut Designdokument:
- Die eingebauten Tools von Claude Code sind aus. Claude nutzt die Tools von OpenCode, und jeder Tool-Aufruf läuft über OpenCodes Berechtigungsabfragen. Es gibt nur ein Berechtigungssystem.
- Die Konfiguration von Claude Code wird nicht gelesen: Einstellungen in
~/.claudeund im.claude-Ordner des Projekts, CLAUDE.md-Dateien, Hooks, MCP-Server und Skills sind aus; OpenCode nutzt seine eigenen. Auto-Compaction und Auto-Memory sind ebenfalls aus; die Compaction übernimmt OpenCode. - Der System-Prompt ist der von Claude Code, ergänzt um OpenCodes Anweisungen: AGENTS.md, Skills, MCP-Anweisungen, den Prompt des gewählten Agenten usw.
- Nicht unterstützt:
/usagedes Claude-Plans, Cloud-Sessions und/teleport,/loop, Auto Mode, Computer Use und mehr./usagein OpenCode zeigt die Nutzung der OpenCode Console. - Jede Session hält einen dauerhaften
claude-Prozess. Er beendet sich nach 5 Minuten Leerlauf; die nächste Nachricht setzt die gespeicherte Claude-Session fort.
Die Frage nach den Nutzungsbedingungen
Unter der Ankündigung fragen viele, ob das gegen Anthropics Bedingungen verstößt:
- Die offizielle Übersichtsseite des Claude Agent SDK sagt: Sofern nicht vorher genehmigt, erlaubt Anthropic Drittentwicklern nicht, claude.ai-Login oder Plan-Limits in ihren Produkten anzubieten – auch nicht für Agenten auf Basis des Claude Agent SDK – und verweist stattdessen auf API-Key-Authentifizierung.
- OpenCodes eigenes Designdokument fragt unter „Open Questions", ob man das mit Anthropic besprechen oder genehmigen lassen muss.
- Laut @grok hat Anthropic diese Nutzung weder öffentlich bestätigt noch genehmigt; laut @schulzfel basiert sie auf dem offiziellen Agent SDK; laut @jimmyyangrz ist sie, weil sie am Claude-Login hängt, zum Ausprobieren in Ordnung, aber riskant als Grundlage eines Workflows.
Bei Veröffentlichung hat sich Anthropic nicht öffentlich zu OpenCodes Provider geäußert. Zu Kontorisiken bei Abo-Logins siehe Warum Claude-Konten gesperrt werden und wie Claude Code auf einen API Key umzieht.
Weg 2: Anthropic-Provider + API Key
Dieser Weg braucht kein Claude Code; OpenCode sendet die Anfragen direkt. So sieht die Einrichtung mit einem AICodeWith-Key aus.
Schritt 1: Key in eine Umgebungsvariable legen
export AICODEWITH_API_KEY="IHR_API_KEY"
Schritt 2: baseURL in opencode.json setzen
opencode.json im Projektstamm oder global unter ~/.config/opencode/opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"baseURL": "https://api.aicodewith.ai/v1",
"apiKey": "{env:AICODEWITH_API_KEY}"
}
}
},
"model": "anthropic/claude-sonnet-5-5"
}
Hinweise:
- Der
baseURLvon OpenCode enthält/v1:https://api.aicodewith.ai/v1. Bei Claude Code ist das anders: Dort istANTHROPIC_BASE_URLhttps://api.aicodewith.ai, ohne/v1. apiKeyliest{env:AICODEWITH_API_KEY}aus der Umgebung, damit landet der Key weder in Projektdateien noch in git.- Sie können
apiKeyauch weglassen und den Key über/connect→ Anthropic einfügen. /modelslistet die wählbaren Claude-Modelle;modelschreiben Sie alsanthropic/<Modell-ID>.
Wie Sie Keys und Adressen trennen, wenn mehrere Clients ein Konto teilen, steht in Codex, OpenCode und WorkBuddy sauber parallel einrichten. Für Claude Code siehe Claude Code mit einer Drittanbieter-API verbinden.
Test: OpenCode 2.2.5 behebt einen kleinen Bug mit einem AICodeWith-Key
Wir haben OpenCode 2.2.5 auf einem Linux-Rechner installiert, die Konfiguration oben verwendet und eine slugify-Funktion reparieren lassen. Im Projekt lag eine AGENTS.md, die nach jeder Änderung an einer .py-Datei die Tests verlangt:
# slug.py
def slugify(title):
return title.lower().replace(" ", "-")
# test_slug.py
def test_basic(self): self.assertEqual(slugify("Hello World"), "hello-world")
def test_punct(self): self.assertEqual(slugify("OpenCode + Claude: Setup!"), "opencode-claude-setup")
def test_spaces(self): self.assertEqual(slugify(" a b "), "a-b")
Befehl:
opencode run -m anthropic/claude-sonnet-5-5 \
"Fix slugify in slug.py so all tests in test_slug.py pass. Follow AGENTS.md. Reply with one short summary line."
Von Enter bis zum Ende vergingen rund 11 Sekunden. OpenCode las beide Dateien, schrieb slug.py neu, ließ wie in AGENTS.md verlangt die Tests laufen, und alle 3 Tests bestanden. Echte Ausgabe:
> build · claude-sonnet-5-5
→ Read slug.py
→ Read test_slug.py
← Write slug.py
Wrote file successfully: slug.py
$ python3 -m unittest 2>&1 | tail -5
...
Ran 3 tests in 0.000s
OK
I rewrote `slugify` in `slug.py` to turn each run of non-alphanumeric characters into one hyphen and strip hyphens from both ends, and `python3 -m unittest` now passes all 3 tests.
Der korrigierte Code:
import re
def slugify(title):
# Collapse every run of non-alphanumeric characters into a single hyphen
return re.sub(r"[^a-z0-9]+", "-", title.lower()).strip("-")
Ein Claude-Konto mit Abo hatten wir zum Testen nicht, daher folgen die Schritte von Weg 1 den Release Notes und dem Designdokument von OpenCode.
API Key erstellen und die opencode.json oben selbst ausprobieren →
CLAUDE.md nach AGENTS.md umziehen
Mit Claude Agent ist das Laden von CLAUDE.md durch Claude Code aus; Projektregeln müssen über OpenCode kommen. OpenCodes Reihenfolge (siehe OpenCode-Doku zu Rules):
- Hat ein Projekt AGENTS.md und CLAUDE.md, wird nur AGENTS.md verwendet.
- CLAUDE.md dient nur als Rückfall, wenn es keine AGENTS.md gibt.
- Die globale
~/.config/opencode/AGENTS.mdhat Vorrang vor~/.claude/CLAUDE.md.
Am einfachsten: Regeln in AGENTS.md verschieben und in CLAUDE.md nur eine Import-Zeile lassen, damit OpenCode, Claude Code und Codex dieselbe Datei lesen:
git mv CLAUDE.md AGENTS.md
printf '@AGENTS.md\n' > CLAUDE.md
git add AGENTS.md CLAUDE.md
Claude Code holt den Inhalt über @AGENTS.md herein. Ein ausführlicheres gemeinsames Setup zeigt AGENTS.md für Claude Code und Codex gemeinsam nutzen.
Häufige Fehler
/connect zeigt nur ein Feld für den API Key
Sie haben Anthropic gewählt, den API-Key-Zugang. Für den Abo-Login zurückgehen und Claude Agent wählen. Fehlt Claude Agent in der Liste, ist OpenCode älter als 2.2.3: opencode upgrade ausführen.
Claude Agent verbindet sich nicht oder will eine Anmeldung
Der Reihe nach prüfen: claude --version ist 2.1.248+; claude auth login wurde im Terminal ausgeführt; claude liegt im PATH (sonst OPENCODE_CLAUDE_PATH setzen). In Remote-Workspaces und gehostetem OpenCode ist der Provider nicht verfügbar.
„不支持的请求路径" (Anfragepfad nicht unterstützt)
Beim API-Key-Weg fehlt /v1 im baseURL. Als wir ihn absichtlich auf https://api.aicodewith.ai gesetzt haben, kam Folgendes zurück:
Error: 不支持的请求路径,请检查 API 地址是否正确
Auf https://api.aicodewith.ai/v1 ändern.
„请在请求中提供有效的 API Key" (kein gültiger API Key)
{env:AICODEWITH_API_KEY} war leer – meist, weil die Variable in einem anderen Terminal exportiert oder falsch geschrieben wurde. Der Fehler nach dem Leeren der Variable:
Error: 请在请求中提供有效的 API Key。
Änderungen an CLAUDE.md wirken nicht
Hat das Projekt schon eine AGENTS.md, nutzt OpenCode nur diese; mit Claude Agent ist zudem das Laden von CLAUDE.md durch Claude Code aus. Regeln wie oben nach AGENTS.md verschieben.
Plan-Limit erreicht
Laut Designdokument wiederholt Claude Code Anfragen selbst, OpenCode wiederholt für diesen Provider nicht; der Limit-Fehler erscheint einmal. Auf das Zurücksetzen warten oder in /models auf den API-Key-Weg wechseln.



