Claude API Neu in 0.9.18

Der Provider Claude API betreibt Claude-Chats mit einem API-Key aus der Claude Console statt mit deinem Claude-Abo. Der Agent ist derselbe: Claude Code auf dem Rechner des Relays, mit denselben Tools, Modi, Rückfrage-Karten, Subagents, demselben Nachsteuern und denselben Hintergrund-Tasks. Nur die Abrechnung ändert sich. Turns werden der Console-Organisation berechnet, zu der der Key gehört.

Claude API steht neben deinem Abo, nicht an seiner Stelle. Du kannst einen Chat auf dem Key starten, einen auf dem Abo starten und einen Claude-Chat zwischen Turns vom einen zum anderen verschieben, wobei er seine Session behält. Ein optionales Monatslimit stoppt die Ausgaben auf dem Key, sobald die Schätzung dieses Relays es erreicht. Die Tabelle aller Provider steht unter Provider im Überblick.

Der API-Key #

Du brauchst einen API-Key aus der Claude Console, zu finden unter API keys (API-Keys) auf platform.claude.com. Leg ihn in einem Workspace an; siehe Grenzen. Öffne Settings → Providers → Claude API (Einstellungen → Provider → Claude API), den Unter-Tab nach Claude.

Die Zeile unter den Feldern sagt, wo du stehst:

Starte dann wie gewohnt eine Konversation: Wähl in New Chat Claude API. Siehe Eine Konversation starten. Ein Claude-API-Chat trägt ein goldenes Label Claude API, und der Sperrhinweis im Eingabebereich lautet 🔒 Session locked to Claude API models.

Welche Keys angenommen werden #

• Ein Console-API-Key, ein Key, der mit sk-ant- beginnt, mit 8 bis 512 Zeichen ohne Leerzeichen.
• Claude-Anmelde- und Session-Tokens sowie Admin-Keys werden beim Speichern abgelehnt, mit einer Meldung, die nennt, was eingefügt wurde, z. B. This is an Anthropic Admin API key (it manages an organisation and cannot run models), not an API key. Ein Key eines anderen Herstellers bekommt This does not look like a Claude API key. Keine Meldung zitiert den Key.
• Ob Anthropic den Key akzeptiert, zeigt sich, wenn das Relay nach seinen Modellen fragt (siehe Modelle). Ein abgelehnter Key bleibt gespeichert, und die Statuszeile sagt, warum.

Den Key speichern, ändern und entfernen #

• Einen anderen Key zu speichern leert die Modellliste des Keys und stoppt die laufenden Claude-API-Worker, auch einen mitten in einem Turn, also ändere den Key zwischen Turns. Die nächste Nachricht startet sie mit dem neuen Key.
• Den Key zu entfernen wird abgelehnt, solange irgendein Claude-API-Chat eine Nachricht gesendet oder eine eingereiht hat: Cannot remove the Claude API key while N Claude API conversation(s) still exist. Switch Claude API off for new conversations instead. Es wird auch abgelehnt, solange noch ein Worker auf dem Key läuft.
• Den Key zu entfernen oder Claude API auszuschalten setzt Claude-API-Chats, die noch keine Nachricht gesendet haben, auf Copilot zurück. Ein Chat auf dem Key, der schon begonnen hat, behält seinen Abrechnungsschalter, sodass du ihn aufs Abo verschieben kannst; seine Turns auf dem Key laufen nicht, solange Claude API aus ist.

Einen Chat zwischen Abo und Key wechseln #

Ein Claude-Chat, mit beiden Abrechnungsarten, hat unter dem Sperrhinweis einen Schalter: Subscription | API key (Abo | API-Key). Er erscheint, solange Claude API mit einem gespeicherten Key eingeschaltet ist. Ein Chat, der auf dem Key läuft, behält ihn, nachdem Claude API ausgeschaltet wurde, damit er zurückwechseln kann.

• Ab dem nächsten Turn. Ein laufender Turn endet mit der Abrechnung, mit der er begonnen hat. Bereits eingereihte Nachrichten laufen mit der neuen.
• Die Session bleibt. Das Relay startet das Claude Code des Chats zwischen Turns neu und setzt dieselbe Session fort. Es wartet auf den laufenden Turn, eine offene Frage, eine Kompaktierung oder Hintergrund-Tasks, und der Schalter sagt, worauf, z. B. Moves to the API key after the running turn.
• Der erste Turn auf dem Key kostet mehr. Er hat keinen Prompt-Cache. Der Schalter sagt das: The first turn on the API key has no prompt cache and costs more.
• Der Verlauf vermerkt jeden Wechsel, z. B. 💳 Billing: this chat runs on the Claude API key from the next turn., mit (switched by an agent) oder (switched at the usage limit), wo das zutrifft.
• Wenn eine Seite nicht wählbar ist, ist ihr Button ausgegraut, und ihr Tooltip sagt, warum. Der Wechsel wird abgelehnt, wenn Claude API keinen Key hat oder aus ist, wenn das Limit dieses Monats erreicht ist (der Schalter sagt dann This month's Claude API cap is reached: the chat stays on the subscription.), wenn Claude für einen Wechsel zurück aufs Abo ausgeschaltet ist (CLAUDE_NOT_CONFIGURED) oder wenn das Modell des Chats nicht auf der Modellliste der anderen Seite steht.
• Eine Seite, die nicht aktuell ist. Eine Nachricht, die von einer Seite gesendet wird, die noch die alte Abrechnung zeigte, wird nicht mit der neuen gesendet: Ihr Text geht zurück in den Entwurf.

Nichts anderes wechselt einen Chat. Es gibt drei Wege: den Schalter, das Banner am Nutzungslimit und das send eines Agents:

• Am Nutzungslimit. Wenn ein Abo-Chat am Nutzungslimit von Claude pausiert ist, bietet das Banner Switch this chat to API key (Diesen Chat auf API-Key umstellen) an, wenn der Chat wechseln darf. Der pausierte Turn läuft dann sofort auf dem Key weiter. Am Limit sagt das Banner No switch to the API key: this month's Claude API cap is reached.
• Durch einen Agent. send von relay_tool nimmt für eine Claude-Session provider (claude oder claude-api) und wechselt sie zusammen mit der Nachricht. Die Freigabekarte sagt dann Switches billing to API key.

Es gibt keine Einstellung pro Ordner für die Abrechnung: Jeder Chat hat seine eigene, gewählt in New Chat und geändert mit dem Schalter. Was ein Ordner festlegt, seine Commit-Zuschreibung, gilt für beide Abrechnungsarten.

Das Monatslimit #

Monthly cap in US dollars (optional) begrenzt, was dieses Relay in einem Kalendermonat auf dem Key ausgibt, nach seiner eigenen Schätzung. Beträge über 0, bis 1.000.000, mit höchstens zwei Nachkommastellen; lass das Feld für kein Limit leer.

Sobald die Schätzung dieses Monats das Limit erreicht:

• Ein neuer Turn auf dem Key läuft nicht. Der Chat bekommt eine Notiz, die mit Error code: relay.claude-api-cap-reached. endet, und die Buttons Claude API settings (Claude-API-Einstellungen; öffnet den Tab am Limit-Feld) und Switch to subscription (Zum Abo wechseln).
• Ein Wechsel auf den Key wird abgelehnt, vom Schalter, vom Banner am Nutzungslimit oder von einem Agent.
• New Chat lehnt einen Claude-API-Chat ab. Der Dialog bleibt offen, mit dem Grund, Claude API settings und Start on subscription (Mit Abo starten), das denselben Chat stattdessen auf Claude startet (angeboten, solange Claude eingeschaltet ist). Auf dem Handy scrollt der Dialog dorthin.
• Agents werden auch abgelehnt. Das send eines Agents an eine Session auf dem Key und sein create_session für einen Claude-API-Chat werden abgelehnt: Das Relay antwortet mit 409 CLAUDE_API_CAP_REACHED, und nichts wird eingereiht oder angelegt.
• Ein Turn, den Claude Code selbst startet auf dem Key, wenn ein Hintergrund-Task sich zurückmeldet, bekommt die Notiz, und die Hintergrund-Tasks des Chats werden gestoppt, da jede Rückmeldung einen weiteren solchen Turn starten würde. Seine erste Anfrage kann bereits berechnet sein. Die Notiz kommt einmal pro Chat, bis das Limit wieder frei ist, eine Claude-API-Einstellung gespeichert wird oder ein Turn des Chats wieder auf dem Key läuft.

Ein Turn, der schon läuft, wird beendet. Die Kosten eines Turns werden bei seinem Ende verbucht, daher können laufende Turns den Monat über das Limit bringen. Das Limit zählt nur den Teil der Schätzung, der einen Preis hat (siehe Grenzen). Solange ein Limit gesetzt ist und die Ausgaben sich nicht lesen lassen, gilt das Limit als erreicht. Der Monat ist der des Relays: Er beginnt um Mitternacht am 1. in der Zeitzone des Relays neu. Ausgabenlimits aus der Console gelten zusätzlich.

Dieselbe Notiz und dieselben Buttons kommen, wenn Claude API keinen Key hat (relay.claude-api-not-configured) oder ausgeschaltet ist: Der Turn läuft nicht. New Chat lehnt dann ebenfalls einen Claude-API-Chat ab, mit CLAUDE_API_NOT_CONFIGURED.

Die Verbrauchskarte #

📊 Check Usage (Verbrauch prüfen) hat einen Tab Claude API, solange ein Key gespeichert ist, auch wenn Claude API ausgeschaltet ist, damit die Ausgaben des Monats sichtbar bleiben. Er zeigt, was die Turns dieses Relays auf dem Key geschätzt gekostet haben:

Der Balken wechselt bei 50 % und 75 % des Limits die Farbe und wird bei 90 % rot, wie jeder Balken; siehe Eine Karte lesen. Die Karte verlinkt auf Console billing (Console-Abrechnung) und Console limits (Console-Limits).

Woher die Zahlen kommen. Sie sind die eigene Schätzung von Claude Code aus seiner Preistabelle, für die Turns auf dem gespeicherten Key auf diesem Relay, daher sind Subagents, Kompaktierung und Websuche enthalten. OAR führt keine eigene Preistabelle. Tage und Monat folgen der Uhr und Zeitzone des Relays. Turns, die aus dem API-Guthaben eines Max- oder Team-Plans bezahlt werden, zählen ebenfalls; OAR sieht dieses Guthaben nicht, ebenso wenig das Guthaben in der Console. Die Abrechnungsseite der Console hat die echten Zahlen und das Guthaben.

Tokens ohne Preis. Ein Modell, für das Claude Code keinen Preis hat, zeigt no price known statt eines Betrags, nie 0 $. Eine Summe, die solche Tokens auslässt, lautet (estimate incomplete).

Ein Agent kann dieselbe Karte mit der Aktion usage von relay_tool lesen.

Modelle #

Das Relay fragt Anthropic, welche Modelle der Key nutzen darf (GET /v1/models), wenn du einen Key speicherst, wenn du Claude API wieder einschaltest, und bei Refresh models: im Tab oder mit Refresh (Aktualisieren) in 🤗 Select Models. Eine Anfrage gibt nach 10 Sekunden auf.

• Bis zur ersten Antwort bietet der Tab die Modelle des Tabs Claude an, mit dem Hinweis Not listed by Anthropic yet: these are the Claude tab's models until the key's list is read.
• Eine fehlgeschlagene Anfrage behält die Liste, die das Relay hatte; Refresh models meldet Claude API model discovery failed. The stored models were kept: ….
• Long Context. Ein Modell mit einem Fenster von 1M Tokens oder mehr, oder eines, dessen 1M-Variante der Tab Claude listet, bekommt auch seine [1m]-Variante, angeboten im Dropdown Context window (Kontextfenster) wie bei Claude.
• Welche erscheinen. 🤗 Select Models → Claude API wählt, welche Modelle der Eingabebereich anbietet. Das Default model wird immer angeboten.
• Pro Nachricht. Ein Chat kann sein Modell zwischen Turns wechseln, wie bei Claude.

Reasoning-Effort #

Die Effort-Auswahl funktioniert wie bei Claude. Die Stufen kommen aus der Modellliste von Anthropic: none und die Stufen, die das Modell meldet, plus Ultracode bei einem Modell, das xhigh hat. Ein Modell, das keine Effort-Unterstützung meldet, bietet nur none an. Bevor die Liste des Keys gelesen ist, hat ein Modell die Stufen, die der Tab Claude dafür hat. Der Dialog 🧠 hat dieselben Schalter für Thinking (Denken) wie bei Claude.

Gemeinsam mit Claude #

Commit-Zuschreibung, das Limit für Hintergrund-Befehle, die Effort-Stufen und das Kompaktierungsfenster sind die des Tabs Claude, daher ändert ein Wechsel nur, wer bezahlt:

• Commit-Zuschreibung, mit der Wahl eines Ordners aus dem Dialog 🧠;
• das Limit für Hintergrund-Befehle;
• das Auto-Kompaktierungsfenster.

Ein Claude-Konfigurationsordner. Claude-API-Chats nutzen denselben Claude-Code-Ordner wie Abo-Chats (~/.claude oder CLAUDE_CONFIG_DIR): dieselben Skills, Plugins, MCP-Server und Verläufe. Das erlaubt einem Chat, beim Wechsel seine Session zu behalten. Einstellungen in diesem Ordner oder in .claude/ des Chat-Ordners können den Key nicht umleiten: Das Relay legt die Adresse von Anthropic und den Key darüber fest.

Nicht auf dem Key. Die Plan-Anzeigen von Claude und die Pause am Nutzungslimit gelten nicht: Ein Turn, den Anthropic ablehnt, schlägt mit einer Notiz fehl. Claude-API-Chats laufen mit allen Hooks und der Statuszeile aus; siehe Sicherheit.

Überall sonst gilt Claude. Wo andere Seiten beschreiben, was Claude-Chats tun, etwa Subagents, Hintergrund-Tasks, Kompaktierung, das Plan-Board, Rückfrage-Karten oder der Senden-Button während eines Turns, tut ein Claude-API-Chat dasselbe.

Grenzen #

• Ein Key außerhalb eines Workspace bekommt HTTP 400. Anthropic beantwortet einen Key, der an keinen Workspace gebunden ist, mit HTTP 400, und der Tab sagt API key saved, but Anthropic refused it: …. Leg den Key in einem Workspace in der Claude Console an und speichere diesen. Den Workspace in OAR anzugeben ist geplant.
• Modelle ohne Preis. Ein Modell, für das Claude Code keinen Preis hat, derzeit Claude Haiku 5.5, zeigt no price known auf der Karte. Seine Tokens fehlen in der Schätzung und im Limit.
• Die Schätzung ist die dieses Relays. Andere Nutzung des Keys ist nicht enthalten; die Console hat jede Anfrage.
• Kein Guthaben. OAR liest weder das Guthaben in der Console noch das API-Guthaben des Plans.
• Keine Basis-URL. Der Key geht nur an https://api.anthropic.com. Es gibt keine Einstellung für einen anderen Endpunkt.
• Der Agent kann den Key lesen. Siehe Sicherheit.

Fehlercodes #

Eine fehlgeschlagene Claude-API-Antwort endet mit Error code: relay.<code>. und, bei manchen Codes, mit Buttons, die direkt zur Lösung führen:

Claude API settings öffnet Settings → Providers → Claude API. Add funds und Console billing öffnen die Abrechnungsseite der Console, Console limits ihre Limit-Seite. Switch to subscription verschiebt den Chat ab seinem nächsten Turn auf dein Abo; sende die Nachricht erneut.

Die eigenen Ablehnungen des Relays haben ebenfalls Codes:

Fehlerbehebung #

Sicherheit #

Wo der Key liegt. Der Key wird in der Datenbank des Relays auf dem Rechner des Relays gespeichert und nie an einen Browser gesendet: Der Tab sagt nur, dass einer gespeichert ist. Das Relay nutzt ihn selbst für eine Anfrage, die Modellliste, und sendet ihn an https://api.anthropic.com und nirgendwo sonst hin. Er erreicht nur die Worker von Claude-API-Chats, wo Sessions unter tmux laufen, über eine Datei, die nur der Benutzer des Relays lesen kann. Im Worker erreicht er Claude Code über dessen Umgebung und über Einstellungen, die auf seiner Standardeingabe übergeben werden, nie über seine Befehlszeile, die andere Benutzer des Rechners lesen können. Ein Key in der eigenen Umgebung des Relays (ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN) erreicht keinen Chat.

Was der Agent sehen kann. Die eigenen Befehle des Agents können den Key aus ihrer Umgebung lesen, wie bei jedem Key, den eine CLI hält. Das Relay ersetzt den Key durch [redacted] in allem, was ein Worker sendet, und im Log des Workers, ab dem Moment, in dem er gespeichert ist, wie bei DeepSeek. Das hält ihn aus dem heraus, was OAR speichert und zeigt; gegen den Agent ist es keine Schranke.

Die Zugangsdaten werden geprüft, und eine Modellanfrage kann vorher rausgehen. Ein Claude-API-Chat teilt sich den Claude-Code-Ordner, in dem deine Claude-Anmeldung liegt. Das Relay setzt den gespeicherten Key über alle Zugangsdaten in den Einstellungen dieses Ordners oder des Chat-Ordners, und wenn der Startbericht von Claude Code eine andere Quelle für seinen Key nennt, stoppt das Relay den Turn sofort (relay.claude-api-key-source). Claude Code wartet nicht auf diese Prüfung: Es sendet seine erste Modellanfrage etwa 50 bis 90 ms nach dem Bericht, daher kann eine Modellanfrage bereits mit den anderen Zugangsdaten rausgegangen sein, z. B. deiner Claude-Anmeldung, bevor der Stopp greift. Die Prüfung begrenzt falsche Zugangsdaten auf diese eine Modellanfrage; sie verhindert sie nicht. Dieselbe Prüfung läuft umgekehrt in einem Chat auf deinem Abo; siehe Claude.

Keine Hooks. Claude Code startet in einem Claude-API-Chat mit allen Hooks aus: Weder deine eigenen (~/.claude) noch die des Chat-Ordners (.claude/settings.json, settings.local.json) noch die eines Plugins laufen, und auch kein Statuszeilen-Befehl. Sie würden als Benutzer des Relays mit dem Key in ihrer Umgebung laufen. Die Einstellung steht auf der Befehlszeile von Claude Code, daher kann keine Einstellungsdatei sie wieder einschalten. Hooks in verwalteten Einstellungen, denen des Administrators des Rechners, laufen weiterhin. Chats auf deinem Abo behalten ihre Hooks und ihre Statuszeile.

Was an Anthropic geht. Alles, was der Agent während eines Turns liest und schreibt, wie in einem Abo-Chat.

Mehr unter Was OAR offenlegt und was nicht.