OpenCode + Claude: Claude-Agent-Abo-Login oder API Key – welcher Weg passt (2.2.3+)

OpenCode 2.2.3 bringt einen eingebauten Claude-Agent-Provider. Claude Code 2.1.248+ installieren, claude auth login ausführen, dann in /connect Claude Agent wählen – schon nutzt OpenCode Ihren Claude-Code-Login und dessen Modelle. Der andere Weg ist der Anthropic-Provider mit baseURL und API Key. Dieser Leitfaden vergleicht beide Wege, zeigt jede Einrichtung, erklärt den Umzug von CLAUDE.md nach AGENTS.md, listet häufige Fehler und zeigt echte Ausgaben des API-Key-Wegs.

8 分钟阅读
OpenCode + Claude: Claude-Agent-Abo-Login oder API Key – welcher Weg passt (2.2.3+)

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, oder baseURL und Key für den Provider anthropic in opencode.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)
VersionenOpenCode 2.2.3+, Claude Code 2.1.248+ lokal installiertJede OpenCode-Version
Anmeldungclaude auth login im TerminalAPI Key einfügen (oder aus einer Umgebungsvariable lesen)
Wer sendet die AnfragenIhr lokales claude-Programm über das offizielle Claude Agent SDKOpenCode selbst
Tools, Berechtigungen, VerlaufAlles auf OpenCode-SeiteAlles auf OpenCode-Seite
CLAUDE.mdDas Laden von CLAUDE.md durch Claude Code ist aus; Regeln kommen über AGENTS.mdOpenCodes eigenes Regel-Laden (AGENTS.md zuerst)
Remote- / gehostete WorkspacesNicht unterstützt; claude muss auf demselben Rechner laufenUnterstützt
Temperature und andere Sampling-OptionenNicht unterstütztUnterstü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 /models umschalten. 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

bash
opencode --version   # 2.2.3+
claude --version     # 2.1.248+

Bei Bedarf aktualisieren:

bash
# 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

bash
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

text
/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:

bash
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 ~/.claude und 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: /usage des Claude-Plans, Cloud-Sessions und /teleport, /loop, Auto Mode, Computer Use und mehr. /usage in 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

bash
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:

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 baseURL von OpenCode enthält /v1: https://api.aicodewith.ai/v1. Bei Claude Code ist das anders: Dort ist ANTHROPIC_BASE_URL https://api.aicodewith.ai, ohne /v1.
  • apiKey liest {env:AICODEWITH_API_KEY} aus der Umgebung, damit landet der Key weder in Projektdateien noch in git.
  • Sie können apiKey auch weglassen und den Key über /connect → Anthropic einfügen.
  • /models listet die wählbaren Claude-Modelle; model schreiben Sie als anthropic/<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:

python
# 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:

bash
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:

text
> 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:

python
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.md hat 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:

bash
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:

text
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:

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

Quellen

相关文章

Was ist das UI SDK, und wie nutzt man es? Die Verhaltensbibliothek von Vercel und shadcn für Agents, installiert und getestet in Claude Code / Codex / Cursor (0.1.0-beta.1)

Was ist das UI SDK, und wie nutzt man es? Die Verhaltensbibliothek von Vercel und shadcn für Agents, installiert und getestet in Claude Code / Codex / Cursor (0.1.0-beta.1)

Das UI SDK ist Vercels Verhaltensbibliothek für Agents, veröffentlicht am 12. November 2026 als 0.1.0-beta.1. Die Behaviors liegen im frameworkunabhängigen Paket @ui-sdk/core und werden von Adaptern für React, Vue, Svelte, Solid und Web Components gerendert. Dieser Leitfaden folgt der offiziellen Dokumentation dazu, was es ist, wie man es installiert und wie man den Skill für Claude Code, Codex und Cursor hinzufügt, und hält die Befehle, Laufzeiten und Ausgaben unserer Testmaschine fest.

Was ist AWS Emulator und wie installiert man ihn? AWS-Apps lokal mit Claude Code und Codex testen (getestet mit 1.0.322)

Was ist AWS Emulator und wie installiert man ihn? AWS-Apps lokal mit Claude Code und Codex testen (getestet mit 1.0.322)

AWS Emulator ist der offizielle lokale Emulator der AWS-APIs und seit dem 11. November 2026 (US-Zeit) allgemein verfügbar. Es fällt keine zusätzliche Servicegebühr an, der Quellcode ist offen, ein AWS-Konto ist nicht nötig, und er deckt mehr als 200 Services ab. Wir haben Version 1.0.322 unter Debian 13 getestet: Installationsbefehle, AWS CLI auf den lokalen Endpoint richten und einen S3-Bucket sowie eine DynamoDB-Tabelle anlegen, die Fehler, auf die wir gestoßen sind, und wie Claude Code, Codex und Cursor Code gegen den Emulator schreiben und testen.

Was ist T3 Code und wie installiert man es? Claude Code und Codex anbinden, Drittanbieter-API-Key nutzen, häufige Fehler beheben (getestet mit 0.1.9)

Was ist T3 Code und wie installiert man es? Claude Code und Codex anbinden, Drittanbieter-API-Key nutzen, häufige Fehler beheben (getestet mit 0.1.9)

T3 Code ist die Open-Source-Steueroberfläche von pingdotgg für Coding-Agents. Es bringt kein eigenes Modell mit, sondern steuert die Claude-Code-, Codex-, Cursor- und weiteren CLIs, die schon auf Ihrem Rechner installiert sind. Wir haben T3 Code 0.1.9 unter Linux getestet. Der Leitfaden zeigt die Installationsbefehle, wie Sie Claude Code und Codex mit einem AICodeWith API Key einrichten, damit T3 Code sie steuern kann, einen kompletten Lauf beider Agents mit dem Befehl t3 thread sowie die Fehler, auf die wir gestoßen sind, samt Lösung.