Hermes Claude Plugin: Claude über das Claude-Code-Abo nutzen, ohne API-Key

Der Videotitel von Julian Goldie klingt zuerst wie SEO: „Use Claude inside Hermes Agent without API keys using the new official plugin“. Diesmal hält der Inhalt, was der Titel verspricht. Im offiziellen Plugin-Katalog von Hermes Agent liegt ein Modell-Provider-Plugin mit dem Namen claude-subscription-directsdk, das Claude-Modelle über die eigene Claude-Code-Anmeldung anbindet. Wer ohnehin ein Claude Pro- oder Max-Abo besitzt, braucht keinen Anthropic-API-Key, kein separates Guthaben und keine zweite Abrechnung mehr. Der Katalogeintrag trägt laut Katalogseite den Stand vom 3. Oktober 2026, geprüft ist der Commit ef73726 aus dem öffentlichen Repository. Dieser Beitrag sortiert die offiziellen Fakten: was sich gegenüber dem API-Key-Weg ändert, welche Voraussetzungen gelten, wie das Setup abläuft, wie die Isolation aufgebaut ist und wo die harten Grenzen liegen.

Der alte Weg zu Claude in Hermes lief über einen klassischen API-Key: Schlüssel in der Anthropic-Konsole beantragen, Guthaben aufladen, Key in die Konfiguration eintragen und jede einzelne Anfrage tokenweise bezahlen. Wer daneben schon Claude Code mit einem Pro- oder Max-Abo nutzte, betrieb dasselbe Modell gleich doppelt: ein Gehirn, zwei Türen, zwei Rechnungen. Genau diese zweite Tür schließt das Plugin. Hermes spricht künftig das offizielle Claude-Code-Programm als Modell-Client an, statt direkt auf die Metered-Billing-API zu gehen. Die Anmeldung bleibt beim CLI, die Entgelte bleiben beim Abo.

Für den Agentenalltag ändert sich handwerklich wenig: Hermes behält seinen normalen Agenten-Loop, die Werkzeuge, die Genehmigungen, den Speicher und die Kontext-Kompression. Der Provider erscheint einfach als weitere Auswahl in der Modellauswahl und lässt sich per Konfigurationszeile als Standardmodell festlegen. Goldie demonstriert im Video genau diesen Ablauf: Nachricht in Hermes schreiben, das Plugin startet das Programm, das gewählte Claude-Modell antwortet, Hermes führt die Werkzeuge aus und liefert die Antwort zurück. Dasselbe Gehirn, aber eine Tür.

Der Katalogeintrag heißt vollständig Claude Subscription DirectSDK (Experimental), als Plugin-Name wird claude-subscription-directsdk-experimental geführt. Kernidee: Das Plugin steuert das unveränderte, offizielle Claude-Code-Programm als anfragespezifischen Modell-Client. Trotz des Namens DirectSDK spricht die Implementierung natives stream-json direkt und benötigt keine Python-Agent-SDK-Bibliothek. Lizenziert ist das Ganze unter MIT.

Die Voraussetzungen aus der offiziellen Doku: Erstens Hermes Agent 0.21.4 oder neuer, alternativ der main-Zweig ab Commit 118984d7a02f, dem Core-Teil von PR #117451. Auf älteren Hermes-Versionen lädt das Plugin nicht und meldet eine klare Warnung (Failed to load user provider plugin), statt halb zu funktionieren. Zweitens Python 3.10 oder neuer auf Linux, macOS oder Windows; laut README läuft die Testsuite auf allen drei Plattformen in der CI. Drittens das offizielle Claude-Code-CLI, installiert und eingeloggt: Das Plugin besitzt selbst keinerlei Zugangsdaten, alles läuft über das Programm claude.

Bemerkenswert ist die Konsequenz der Prüfungen: Das Plugin testet an jeder Stelle und rät nie. Beim Laden gibt es eine Log-Warnung, der Provider bleibt registriert. In der Modellauswahl stoppt der Fluss mit Installationshinweis, ohne etwas in die Konfiguration zu schreiben. Bei einer Anfrage kommt sofort ein Fehler mit Installationshinweis statt eines Traceback-Abbruchs. Offiziell qualifiziert ist Claude Code in Version 2.1.263.

Das offizielle Setup besteht aus vier Schritten. Erstens: Das Claude-Code-CLI installieren, falls es noch fehlt, via npm install -g @anthropic-ai/claude-code. Liegt das Binary außerhalb des PATH, setzt man die Umgebungsvariable CLAUDE_SUBSCRIPTION_DIRECTSDK_COMMAND auf den absoluten Pfad. Zweitens: Das Plugin aus dem gepinnten, geprüften Katalog installieren mit hermes plugins install claude-subscription-directsdk. Wer dem Hauptzweig folgen will, nutzt die GitHub-Variante NousResearch/hermes-plugin-claude-subscription-directsdk; für die manuelle Installation genügt ein Git-Klon nach ~/.hermes/plugins/claude-subscription-directsdk-experimental. Pro-Profile installieren unter ~/.hermes/profiles/PROFILNAME/plugins/.

Drittens die Anmeldung: claude auth login. Viertens die Auswahl: hermes model aufrufen und Claude Subscription DirectSDK (Experimental) wählen, oder direkt starten mit hermes --provider claude-subscription-directsdk-experimental -m sonnet. Wer die Einrichtung dauerhaft will, trägt den Provider in der Konfigurationsdatei unter model.provider und das Standardmodell unter model.default ein. Die Videoversion von Goldie drückt denselben Ablauf auf rund drei Minuten Setup zusammen, nach einem Update von Hermes auf 0.21.4 oder neuer. Die offizielle README bleibt die verlässliche Referenz, weil sie jeden Schritt an einen geprüften Commit bindet.

Das Sicherheitsdesign ist der bemerkenswerteste Teil der Dokumentation. Die Authentifizierung gehört vollständig dem offiziellen CLI: Das Plugin öffnet, kopiert, erneuert oder druckt niemals die Credential-Dateien und verlangt oder versendet selbst keinen Hermes-API-Key. Der normale Hermes-Client-Pfad weist vererbte API-Key-Overrides, eigene Anthropic-Endpoints und Cloud-Backend-Overrides ab, bevor überhaupt ein Prozess gestartet wird. Die Fehlermeldung nennt die konfligierenden Umgebungsvariablen, ohne ihre Werte auszugeben. Einen stillen HTTP- oder API-Key-Fallback gibt es laut Doku nicht.

Jede Anfrage startet einen frischen Prozess in einem privaten temporären Verzeichnis. Native Werkzeuge, Skills und Setting-Quellen von Claude Code sind abgeschaltet; MCP macht nur den aktuellen Hermes-Werkzeugbestand sichtbar, Ausführungen werden seitens Claude Code über dontAsk verweigert. Das Kind-Programm läuft in einer eigenen Prozessgruppe: Ein Abbruch räumt über killpg beziehungsweise taskkill /T den kompletten Prozessbaum ab, das node-Kind hinter dem npm-Starter überlebt eine abgebrochene Anfrage also nicht. Für die Autorisierung bindet ein Relay einen kurzlebigen Loopback-Port mit einer zufälligen Route pro Anfrage; Authentifizierungs-Header laufen direkt durch den Speicher zum Upstream und werden weder geloggt noch persistiert. Wer die Anmeldedaten in einem eigenen Verzeichnis pflegt, setzt CLAUDE_CONFIG_DIR für die Anmeldung und exportiert CLAUDE_SUBSCRIPTION_DIRECTSDK_CONFIG_DIR auf denselben Pfad.

Ein weniger prominenter, aber betrieblich wichtiger Punkt ist das Replay-Design. Jede Chat-Anfrage beginnt frisch: Hermes spielt die komplette Unterhaltungshistorie in Reihenfolge zurück. Historische User-Frames sind so markiert, dass das native Programm dafür keine neuen Abfragen startet; laut Doku erhält jeder dieser Frames eine Bestätigung ohne eigene Antwortrunde. Erst der letzte User- oder Tool-Ergebnis-Frame löst tatsächlich eine Abfrage aus. Es gibt keine parkende native Session und kein natives Genehmigungs-Warten, und der Adapter fügt keinen synthetischen Continue-Prompt hinzu. Das hält den Unterhaltungspfad vorhersehbar.

Das Relay verhindert außerdem, dass die native Wiederherstellung von Claude Code weitere Upstream-Anfragen absetzt, obwohl Hermes genau eine will. Hermes bleibt Herr über die Token-Budgets: Weil der Modellbetreiber die Budgets setzt, ist die native Token-Budget-Erinnerung auf dieser Strecke ausgeschaltet, und das Replay rekonstruiert diesen Hinweis jenseits der Cache-Grenze. Andere native Annotationen bleiben vorhanden, daher ist der abgeschickte Prompt nicht byte-identisch mit dem reinen Hermes-Kontext, gut zu wissen für Audits und Kostenübersicht.

Der Zusatz Experimental ist hier kein Marketing, sondern eine selbst geprüfte Grenze mit Protokoll. Die Kernfunktion heißt Single-Request-Admission und ist implementiert und live-qualifiziert. Der Hintergrund: Claude Code in Version 2.1.263 versucht mitunter zusätzliche Generierungen, obwohl max-turns 1 gesetzt und die HTTP-Retry ausgeschaltet ist. Ein anfragespezifisches Loopback-Relay reicht deshalb nur die erste Messages-Anfrage weiter und blockiert weitere Versuche lokal. Hermes erhält die erste vollständige Antwort samt echter Nutzungszahlen und nativem Stop-Grund; eine blockierte native Wiederherstellung verwandelt kein fertiges Ergebnis in eine Exception.

Im integrierten Abotest liefen sieben Hermes-Aufrufe gegen exakt sieben Upstream-Anfragen, dazu zwölf Werkzeugausführungen mit zwölf dauerhaft gespeicherten Ergebnissen. Der Kontext wuchs von 138.498 auf 165.697 Token, die nachfolgenden Cache-Lesungen lagen im Durchschnitt bei 97,13 Prozent. Ein früherer Lauf begann bei 187.000 Token und stieß nach den Werkzeugdaten an die 200.000-Token-Grenze des nativen Weges; dieser unvollständige Lauf zählt nicht als Erfolg. Das ist die wichtigste betriebliche Grenze: Sehr lange Kontexte haben auf dieser Strecke aktuell ein hartes Limit. Die README hält außerdem fest: Es ist ein Review-Build, kein Anspruch auf volle Parität oder Produktionsreife. Replay-Bestätigungen und das Extra-Body-Verhalten sind versionsempfindliche Schnittstellen, kein öffentliches SDK-Versprechen für beliebige Historien.

Zur Abrechnung gehört Ehrlichkeit in beide Richtungen. Der Testlauf meldete 0,8793728 US-Dollar in nativer Listenpreisrechnung. Die README erklärt unmissverständlich: Das ist ein Listenpreis-Schätzwert, kein Nachweis einer tatsächlichen Aborechnung. Wer ein Abo besitzt, zahlt dessen Preis; die Zahl sagt nur, was dieselbe Menge auf API-Basis zum Listenpreis gekostet hätte. Umgekehrt bleibt zusätzliche Nutzung eine Kontoeinstellung: Wer keine Overage-Rechnung will, schaltet extra usage im Account ab; das Plugin ändert daran nichts und kann es nicht abschalten.

Der eigentliche Sprengsatz des Videos liegt trotzdem im Kostenbild: dasselbe Claude-Modell, das auf API-Basis pro Token abrechnet, läuft über das Abo ohne zweite Rechnung. Für Vielnutzer mit ohnehin bezahltem Max-Abo sinkt die Hemmschwelle, Agenten tatsächlich laufen zu lassen, statt jede Anfrage gegen das Guthaben abzuwägen. Am Ende des Videos stehen die Verkaufsschiene eines bezahlten Boardroom-Angebots und ein Zip-Paket mit Voreinstellungen. Beides wird hier nicht bewertet; die im Katalog beschriebenen Befehle sind frei nachlesbar.

Drei Gruppen profitieren am deutlichsten. Erstens Claude-Abonnenten, die Hermes meiden, weil der API-Key-Weg ein zweites Abrechnungskonstrukt verlangte. Zweitens Vielnutzer von Agenten-Workflows, die eine feste Aboplanung der tokenweisen Abrechnung vorziehen. Drittens Teams mit Max-Plätzen, die Agenten für Routineaufgaben einsetzen und Werkzeuge, Genehmigungen und Speicher in Hermes behalten wollen.

Eher nicht geeignet ist der Weg für Kontexte jenseits der 200.000-Token-Grenze und für alle, die Garantien für volle Funktionsparität mit der API erwarten. Auch kritische Produktions-Pipelines sollten warten, bis der Experimental-Stempel fällt. Für alle anderen ist es die konsequenteste Antwort auf eine alte Doppelbelastung: Ein Gehirn, eine Tür, eine Rechnung.

Ich bin Marcel, Grafikdesigner, und betreibe Agentensysteme im Alltag, unter anderem das HUNTER-Cyberdeck. Dieser Beitrag beruht auf dem vollständig gelesenen Transkript aus dem Newsdesk-Zulauf vom 03.10.2026 sowie auf dem offiziellen Katalogeintrag und README des Plugins, abgerufen am 03.10.2026. Zuletzt fachlich geprüft am 03.10.2026. Verantwortlich: Marcel, erreichbar über d4sn3st.dev.

Einordnung und Grenzen: Technische Details, Zahlen und Grenzen stammen aus dem offiziellen Katalogeintrag und README (Commit ef73726, Stand 03.10.2026). Das Video dient als Auslöser; das am Ende beworbene Boardroom-Angebot wird hier nicht bewertet. Der Experimental-Status ist dokumentiert; neuere Claude-Code-Versionen können versionsempfindliche Schnittstellen verändern. Zahlen gelten für die qualifizierten Versionen laut README; der Listenpreis-Schätzwert ist kein Abobeleg.