Alle Seiten
Auf dieser Seite

Claude Neu in 0.9.0

Der Claude-Provider führt den Agent Claude Code von Anthropic auf dem Rechner des Relays aus, über das Claude Agent SDK. OAR startet einen Worker-Prozess pro Konversation. Es gibt keinen API-Key einzugeben: Claude nutzt die Claude-Anmeldung des Relay-Rechners, und du kannst diese Anmeldung im Browser wechseln.

Claude Cloud führt Claude Code in einer Sandbox bei Anthropic aus statt auf deinem Rechner. Es ist ein eigener Provider mit eigener Einrichtung. Neu in 0.9.18 Claude API betreibt dieselben Claude-Chats mit einem API-Key der Claude Console statt mit deinem Abo, und ein Claude-Chat kann zwischen beiden wechseln.

Was du brauchst #

  • Eine Claude-Anmeldung auf dem Rechner, auf dem das Relay läuft. Das Relay speichert keinen Claude-Key; die Claude CLI hält die Anmeldung, und OAR steuert sie nur. Du kannst dich im Browser anmelden (siehe Das Claude-Konto) oder indem du claude einmal auf dem Rechner ausführst.
  • Die Claude Code CLI (claude) auf diesem Rechner, für die Anmeldung im Browser und die Kontozeile. Claude-Turns brauchen sie nicht: Sie laufen auf dem Claude-Code-Build, der mit dem Agent SDK kommt. OAR kann die CLI für dich installieren, und ab dann nutzen neue Sessions diese Kopie.

Die Zeile Claude Code CLI #

Oben in Settings → Providers → Claude (Einstellungen → Provider → Claude) zeigt eine Zeile Claude Code CLI, ob die CLI installiert ist, ihre Version, wo sie liegt und ob sie aktuell ist. Ihre Buttons hängen vom Zustand ab:

Button Wann Was er tut
Install (Installieren) Keine CLI gefunden Fragt nach einer Bestätigung, nennt dabei den Befehl und den Ordner, in den er schreibt, und führt dann den Installer von Anthropic als Benutzer des Relays aus. Unter Linux und macOS ist das curl -fsSL https://claude.ai/install.sh | bash; unter Windows irm https://claude.ai/install.ps1 | iex.
Update (Aktualisieren) CLI gefunden Führt claude update aus.
Switch to native installer (Zum nativen Installer wechseln) Die CLI wurde mit npm in einen Ordner installiert, in den der Benutzer des Relays nicht schreiben kann Führt claude install aus. Die npm-Kopie bleibt, wo sie ist; der native Build hat auf dem PATH Vorrang.
Cancel (Abbrechen) / Dismiss (Schließen) Während eine Installation läuft / nachdem sie beendet ist Stoppt den Lauf / entfernt das Ergebnis.

Die Ausgabe der Installation läuft live als Install log (Installationslog) in die Leiste. Sie bleibt erhalten, wenn du die Einstellungen schließt, und lässt sich von einem anderen Gerät aus verfolgen. Auf dem Relay läuft immer nur eine Installation gleichzeitig. Nichts, was du tippst, erreicht eine Shell: Die Befehle sind fest im Relay hinterlegt.

OAR sucht claude auf dem PATH des Relays, dann in ~/.local/bin und /usr/local/bin. Nach einer Installation oder einem Update nutzt es die neue Binary sofort und merkt sie sich über Neustarts hinweg, du musst das Relay also nicht neu starten. Sessions, die schon laufen, behalten die Binary, mit der sie gestartet sind.

Einschalten #

Claude ist standardmäßig aus. Öffne Settings → Providers → Claude. Unter Claude SDK:

Einstellung Standard Was sie tut
Enable Claude for New Chat model selection (Claude in der Modellauswahl für neue Chats aktivieren) Aus Macht Claude in New Chat (Neuer Chat) wählbar und startet die Modellerkennung. Wirkt sofort beim Umschalten, ohne Save Claude settings (Claude-Einstellungen speichern).
Claude model ID (Claude-Modell-ID) claude-sonnet-5 Das Modell, mit dem eine Claude-Konversation startet. Drück Save Claude settings, um es zu übernehmen.
Commit attribution (Commit-Zuschreibung) OAR Was Commits und Pull Requests sagen. Siehe Commit-Zuschreibung. Braucht ebenfalls Save Claude settings.

Eine Zeile unter den Einstellungen sagt, in welchem Zustand Claude ist. Claude auszuschalten setzt Konversationen, die noch keine Nachricht gesendet haben, auf den Standard-Provider zurück. Konversationen, die schon begonnen haben, behalten Claude.

Modelle #

Claude einzuschalten erkennt die Modelle, die das Agent SDK anbietet, und fügt ihre claude-*-IDs zu den Auswahlen hinzu. Mit Select Models → Claude SDK (Modelle auswählen → Claude SDK) wählst du, welche davon im Eingabebereich erscheinen; das Standardmodell bleibt immer aktiviert.

Long-Context-Varianten wie claude-opus-5[1m] erscheinen nicht als eigene Modelle. Sie zeigen sich als Eintrag 1M im Dropdown Context window (Kontextfenster) des Basismodells, in New Chat und im Eingabebereich.

Ein neues Modell kommt mit einem OAR-Update

Die Erkennung fragt den Claude-Code-Build, der mit dem Agent SDK gebündelt ist, daher lässt claude update allein kein neues Claude-Modell erscheinen. Es kommt mit einem OAR-Update.

Das Claude-Konto #

Unter der CLI-Zeile nennt die Kontozeile das angemeldete Konto und seinen Plan, z. B. Account: dev@example.com · Max plan, oder Not logged in.

Relogin (Neu anmelden) #

  1. Drück Relogin. Das Relay führt die Anmeldung der Claude CLI auf seinem Rechner aus.
  2. Ein Link Open the Claude login page (Claude-Anmeldeseite öffnen) erscheint, mit einem Button Copy link (Link kopieren). Öffne den Link auf einem beliebigen Gerät und autorisiere auf claude.ai.
  3. Claude.ai zeigt einen Code. Füge ihn in das Feld ein (Paste the code from claude.ai, Code von claude.ai einfügen) und drück Submit code (Code absenden; oder Enter).
  4. Die Leiste meldet Logged in as …. Eine neue Modellerkennung läuft, du musst das Relay also nicht neu starten.

Cancel bricht die Anmeldung ab. Eine Anmeldung, die niemand abschließt, endet nach 10 Minuten. Auf einem Relay läuft immer nur eine Anmeldung gleichzeitig. Sie wird an jeden offenen Browser übertragen, du kannst sie also auf einem Gerät beginnen und auf einem anderen abschließen, und das Schließen der Einstellungen verliert sie nicht.

Das Relay hält kein Claude-Geheimnis. Die CLI schreibt die neue Anmeldung in den Claude-Konfigurationsordner des Relay-Rechners (~/.claude oder den Ordner in CLAUDE_CONFIG_DIR).

Logout (Abmelden) #

Logout öffnet Log out of Claude (Von Claude abmelden), das das Konto nennt und sagt, wie viele Claude-Worker laufen. Bestätige mit Log out. Neue Claude-Turns schlagen dann fehl, bis du dich wieder anmeldest.

Laufende Sessions #

Laufende Claude-Sessions behalten das vorherige Konto, bis ihr Worker-Prozess endet. Neue Sessions nutzen das neue Konto.

Commit-Zuschreibung #

Claude Code fügt den Commits, die ein Agent macht, normalerweise eine eigene Zeile Co-Authored-By: Claude … hinzu und eine Zeile zu Pull-Request-Texten. OAR lässt dich wählen:

Wahl Commits Pull Requests
OAR (Standard) Enden mit Co-authored-by: Open Agent Relay (<model>) <no-reply@oar.sh>, mit dem Namen des Modells in den Klammern, z. B. Claude Fable 5.1. Enden mit 🤖 Generated with [Open Agent Relay](https://oar.sh).
Vanilla Die eigenen Zeilen von Claude Code. Die eigene Zeile von Claude Code.
Off (Aus) Keine Zuschreibungszeile. Keine Zuschreibungszeile.

OAR und Off halten außerdem einen Link zur Session aus dem Commit- und Pull-Request-Text heraus.

Stell die Wahl für das ganze Relay in Settings → Providers → Claude → Commit attribution ein. Unter der Auswahl zeigt eine Beispielzeile, was Commits sagen werden.

Pro Ordner #

Der 🧠-Kontext-Button einer Claude-Konversation zeigt Commit attribution für den Ordner der Konversation, mit einer Auswahl: Inherit (provider: …) (Erben, Provider: …), OAR, Vanilla oder Off. Eine Wahl hier gilt für jede Claude-Session in diesem Ordner. Inherit kehrt zur relayweiten Einstellung zurück.

Eine Änderung erreicht eine laufende Session mit ihrer nächsten Nachricht. Ein Wechsel zu Vanilla startet die CLI der Session zwischen Turns neu. Claude-Cloud-Konversationen folgen ebenfalls der relayweiten Einstellung. Neu in 0.9.18 Claude-API-Chats sind Claude-Sessions und folgen der Wahl des Ordners wie jede andere. Neu in 0.9.17 DeepSeek-Konversationen im Ordner folgen der Wahl des Ordners, wobei Vanilla als OAR gilt; ihre relayweite Einstellung steht im Unter-Tab DeepSeek. Andere Provider sind nicht betroffen.

Limit für Hintergrund-Befehle Neu in 0.9.12 #

Settings → Providers → Claude → Claude background command limit (Einstellungen → Provider → Claude → Limit für Claude-Hintergrundbefehle) legt fest, wie lange ein Befehl, den Claude im Hintergrund ausführt, dauern darf, bevor Claude Code ihn stoppt, wenn Claude dem Befehl keinen eigenen Timeout gibt. Der Schieberegler reicht von 30 Minuten bis 8 Stunden in 30-Minuten-Schritten; der Standard ist 2 Stunden. Save Claude settings speichert ihn. Claude kann für einen einzelnen Befehl trotzdem bis zu 8 Stunden anfordern.

  • Ein Befehl, den Claude im Vordergrund ausführt, wandert nach 2 Minuten in den Hintergrund, sodass der Turn weiterläuft, während er läuft, und erscheint mit seiner Konsole in der Task-Leiste.
  • Befehle, die mit sleep beginnen, und Befehle von Subagents bleiben im Vordergrund und können den Turn dann bis zum Limit aufhalten.
  • Claude bekommt das Limit mitgeteilt, außerdem die Anweisung, die volle Ausgabe eines langen Befehls in eine Logdatei zu schreiben, statt sie in tail oder head zu leiten, und einen Lauf, der einen Session-Neustart überleben muss, mit nohup losgelöst zu starten.
  • Die CLI liest das Limit beim Start: Eine Änderung gilt für Claude-Sessions, die nach dem Speichern starten; eine laufende Session behält ihr Limit, bis sie neu startet. Claude-Cloud-Chats sind nicht betroffen; Neu in 0.9.17 DeepSeek- und Neu in 0.9.18 Claude-API-Chats, die ebenfalls Claude Code ausführen, nutzen dasselbe Limit.

OAR übergibt das Limit an Claude Code als BASH_DEFAULT_TIMEOUT_MS, mit BASH_MAX_TIMEOUT_MS auf 8 Stunden und CLAUDE_CODE_AUTO_BACKGROUND_TIMEOUT_MS auf 2 Minuten. Diese drei werden für jede Claude-Session gesetzt, die OAR startet, daher haben dieselben Variablen in der Umgebung des Relays keine Wirkung.

Effort und Thinking #

Reasoning-Effort #

Die Auswahl für den Reasoning-Effort gilt pro Nachricht: Du kannst sie zwischen Turns ändern. Sie bietet none und die Stufen an, die das Modell meldet (low, medium, high, xhigh, max). Ultracode erscheint bei Modellen, die xhigh unterstützen. Es bedeutet xhigh-Effort zusammen mit Multi-Agent-Workflow-Orchestrierung und verbraucht deutlich mehr Tokens.

Kontextfenster #

Für Modelle mit einer 1M-Variante bietet das Dropdown Context window das Standardfenster des Modells an (angezeigt als —, da der Katalog des SDK keine Zahl enthält) und 1M. Ein Modell, das es nur als 1M-Variante gibt, bietet nur diese an.

Thinking #

Der 🧠-Kontext-Button enthält außerdem zwei Einstellungen nur für Claude, pro Konversation:

Einstellung Optionen Standard
Thinking (Denken) On (An), Off An
Thinking text (Thinking-Text) Summarized (Zusammengefasst), Hidden (Ausgeblendet) Summarized

Thinking einzuschalten und den Text zu ändern gilt ab der nächsten Nachricht. Thinking auszuschalten gilt für die nächste CLI-Session. Hidden blendet nur den Text aus; das Modell denkt trotzdem, und die Tokens zählen trotzdem. Off ist die Einstellung, die Tokens spart.

Was auf Claude besonders gut funktioniert #

  • Nachsteuern. Eine Nachricht, die du während eines laufenden Turns sendest, geht in diesen Turn; der Senden-Button heißt Steer (Nachsteuern). Siehe Turns und die Queue und Während ein Turn läuft.
  • Modi. plan nutzt den eigenen Plan-Modus des SDK und endet mit einem Board Plan ready (Plan bereit) aus dem Plan-Tool von Claude. Siehe Relay-Modi.
  • Rückfrage-Karten. AskUserQuestion von Claude wird zu einer Karte, Mehrfachauswahl inklusive. Siehe ask_user.
  • Hintergrund-Tasks und Subagents. Befehle im Hintergrund, Subagents, Monitore und Workflows überdauern die Antwort, die sie gestartet hat, und erscheinen in der Task-Leiste des Eingabebereichs. Der Titel eines Subagents öffnet seine vollständige Aufzeichnung. Nur ein Subagent im Hintergrund lässt sich einzeln stoppen; einer, der im aktuellen Turn läuft, stoppt mit dem Turn. Settings → General → Background task timeout (Einstellungen → Allgemein → Timeout für Hintergrund-Tasks) (Standard 4 h) begrenzt, wie lange Hintergrund-Tasks allein eine Session am Laufen halten.
  • Genaue Aufschlüsselung des Kontexts. Der Button 🧠 zeigt die Kategorien, die das SDK meldet.
  • Automatische Kompaktierung. Claude kompaktiert eine lange Session selbst. Das Fenster 🧠 hat einen Schieberegler Auto-compact window (Auto-Kompaktierungsfenster): Auto, 100k, 150k, 200k, 300k, 500k oder 1M. Siehe Eine Konversation kompaktieren.
  • Pause am Nutzungslimit. Ein Turn, der das Nutzungslimit des Abos erreicht, wird pausiert und läuft nach dem Reset weiter. Siehe Wenn ein Nutzungslimit erreicht ist.
  • Session-Kontinuität. Die Session-ID des SDK wird gespeichert, daher wird eine Konversation fortgesetzt, nachdem ihr Worker neu gestartet ist.
  • Anhänge. Bilder bis 5 MB werden inline gesendet. Größere Bilder und andere Dateien werden als Pfade übergeben, die Claude liest.

Claude-Turns haben keine Verbrauchszeile unter der Antwort. Die Plan-Limits von Claude stehen in Check Usage (Verbrauch prüfen).

Wo die Session liegt #

Im Dateibrowser öffnet der Button Session root (Session-Stammordner; 🕵️) den eigenen Ordner der Session im Projektbereich des Agent SDK, in ~/.claude/projects (oder in CLAUDE_CONFIG_DIR). Der Verlauf ist die .jsonl-Datei neben diesem Ordner. Der Ordner wird erst angelegt, wenn die Session Subagent- oder Tool-Ergebnis-Dateien hat, daher kann er bei einer jungen Konversation leer sein. Eine Konversation zu löschen löscht ihren Verlauf.

Umgebungsvariablen #

Setze diese in der Umgebung, in der das Relay startet.

Variable Was sie tut
CLAUDE_CONFIG_DIR Der Claude-Konfigurationsordner statt ~/.claude: die Anmeldung und wo Session-Ordner gesucht werden.
CLAUDE_CODE_EXECUTABLE Die Claude-Code-Binary, die die Worker statt des mit dem Agent SDK gebündelten Builds nutzen. Eine Installation oder ein Update aus der Leiste setzt sie für dich.
CLAUDE_CODE_AUTO_COMPACT_WINDOW Überschreibt das Auto-Kompaktierungsfenster. Die Zeile unter dem Schieberegler nennt sie dann als Quelle. Wird von Claude Code selbst gelesen; wo Sessions unter tmux laufen, erreicht sie die Einstellung für das Relay nicht (siehe welche Variablen die Agents erreichen).
BASH_DEFAULT_TIMEOUT_MS, BASH_MAX_TIMEOUT_MS, CLAUDE_CODE_AUTO_BACKGROUND_TIMEOUT_MS Neu in 0.9.12 Werden nicht aus der Umgebung des Relays gelesen: OAR setzt sie für jede Claude-Session aus dem Limit für Hintergrund-Befehle.
CLAUDE_CODE_OAUTH_TOKEN Ein Anmelde-Token statt der Anmeldedatei der CLI, für Claude Cloud und für lokale Claude-Chats, deren CLI es der Anmeldedatei vorzieht. Neu in 0.9.17 Nur Claude- und Claude-Cloud-Worker bekommen es, unter tmux über eine Datei, die nur der Benutzer des Relays lesen kann; die Worker anderer Provider, auch die von DeepSeek, nie.
ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN Neu in 0.9.17 Werden nicht an die Worker übergeben. Ein Claude-Chat läuft auf der Claude-Anmeldung, nie auf einem Key in der Umgebung des Relays; vor 0.9.17 zog Claude Code einen solchen Key der Anmeldung vor. Ein Claude-API-Chat läuft auf dem Key, der in Settings → Providers → Claude API gespeichert ist, nie auf diesen.

Neu in 0.9.18 Ein Abo-Chat läuft nie auf einem API-Key. Claude Code nimmt einen API-Key statt deiner Claude-Anmeldung, wenn eine seiner eigenen Einstellungen ihm einen gibt: env.ANTHROPIC_API_KEY in ~/.claude/settings.json oder in .claude/settings*.json des Chat-Ordners, ein apiKeyHelper oder eine Console-Anmeldung. Ein solcher Chat lief früher auf diesem Key und belastete dessen Besitzer. Jetzt stoppt der Turn, wenn Claude Code startet, mit einer Notiz, die die Quelle und die zu entfernende Einstellung nennt, und dem Code relay.subscription-key-source. Claude Code sendet seine erste Modellanfrage einen Moment nach diesem Start, daher kann höchstens eine Modellanfrage vorher über den Key rausgehen. Um einen Chat auf einem API-Key zu betreiben, nutze Claude API und seinen Abrechnungsschalter.

Fehlerbehebung #

Problem Was zu tun ist
Claude fehlt in New Chat Schalte Enable Claude for New Chat model selection in Settings → Providers → Claude ein.
Die CLI-Zeile zeigt Not installed (Nicht installiert), oder die Kontozeile kann das Konto nicht lesen Die Anmeldung im Browser und die Kontozeile brauchen claude auf dem Rechner des Relays. Drück Install oder installiere es selbst und öffne die Einstellungen erneut.
Not logged in, oder eine Antwort sagt, dass Claude sich nicht authentifizieren kann Drück Claude settings (Claude-Einstellungen) an der fehlgeschlagenen Antwort, dann Relogin (oder führ claude auf dem Rechner aus). Sende die Nachricht dann erneut.
Die Anmeldung ist abgelaufen Wie oben. Eine laufende Session behält ihr altes Token, bis ihr Worker endet; sende die Nachricht nach der Anmeldung erneut.
Die Antwort verweist auf Abrechnung, Abo oder die Organisation Prüf das Konto, das die Leiste nennt: sein Abo, seine Zahlungsmethode und ob die Organisation Claude Code erlaubt. Relogin meldet ein anderes Konto an.
Ein Turn wurde an einem Nutzungslimit pausiert Warte auf den Reset oder nutze Resume now (Jetzt fortsetzen) oder Cancel im Banner. Siehe Wenn ein Nutzungslimit erreicht ist.
Ein neues Modell fehlt in der Auswahl Modelle kommen aus dem gebündelten Claude-Code-Build des SDK; sie kommen mit einem OAR-Update, nicht mit claude update.
Neu in 0.9.18 Claude Code took an API key for this subscription turn (source "…"), so the turn was stopped (relay.subscription-key-source) Entferne ANTHROPIC_API_KEY aus dem env der Einstellungen von Claude Code (~/.claude/settings.json oder .claude/settings*.json des Ordners), entferne einen apiKeyHelper oder melde die Console-Anmeldung ab und sende die Nachricht dann erneut. Um den Chat auf dem in Settings gespeicherten Key zu betreiben, stell ihn auf API-Key um.
Relogin schlägt unter Windows fehl Der Anmeldeablauf ist für Linux und macOS gebaut; unter Windows funktioniert er nur nach Möglichkeit. Führ stattdessen claude in einem Terminal aus.