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
claudeeinmal 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 -fs; unter Windows irm https://. |
| 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 ~/. und
/. 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- |
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- 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., oder Not logged in.
Relogin (Neu anmelden) #
- Drück Relogin. Das Relay führt die Anmeldung der Claude CLI auf seinem Rechner aus.
- 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.
- 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).
- 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 (~/. oder den Ordner in
CLAUDE_).
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- hinzu und eine Zeile zu Pull-Request-Texten.
OAR lässt dich wählen:
| Wahl | Commits | Pull Requests |
|---|---|---|
| OAR (Standard) | Enden mit Co-, mit dem Namen des Modells in den Klammern, z. B. Claude Fable 5.. |
Enden mit 🤖 Generated with [Open Agent Relay](https://. |
| 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
sleepbeginnen, 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
tailoderheadzu leiten, und einen Lauf, der einen Session-Neustart überleben muss, mitnohuplosgelö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_, mit
BASH_ auf 8 Stunden und CLAUDE_
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 1. 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.
Askvon Claude wird zu einer Karte, Mehrfachauswahl inklusive. Siehe ask_user.User Question - 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 ~/. (oder in CLAUDE_). Der Verlauf
ist die .-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_ |
Der Claude-Konfigurationsordner statt ~/.: die Anmeldung und wo Session-Ordner gesucht werden. |
CLAUDE_ |
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_ |
Ü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_, BASH_, CLAUDE_ |
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_ |
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_, ANTHROPIC_ |
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. in
~/. oder in . des Chat-Ordners,
ein api 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.. 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.) |
Entferne ANTHROPIC_ aus dem env der Einstellungen von Claude Code (~/. oder . des Ordners), entferne einen api 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. |