Hermes Agent mit Claude über ein Gateway: Einrichtung eines benutzerdefinierten Anbieters, Kostenkontrolle und Fehlerbehebungen
Hermes Agent speichert Geheimnisse in ~/.hermes/.env und alles andere in ~/.hermes/config.yaml. Der zuverlässige Weg, ihn mit Claude über ein Gateway zu betreiben, ist ein benannter benutzerdefinierter Anbieter, der das Anthropic-Messages-Format verwendet. Die Abkürzung, provider: anthropic mit einer anderen Basis-URL, sieht richtig aus, sendet Anfragen aber bei jedem nicht erkannten Host an Anthropic.
Installation
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashiex (irm https://hermes-agent.nousresearch.com/install.ps1)hermes setup führt den vollständigen Assistenten aus; hermes model kümmert sich nur um Anbieter und Modell; hermes doctor prüft eine bestehende Installation.
Gateway als benutzerdefinierten Anbieter hinzufügen
AIPRIME_API_KEY=your_gateway_keyproviders:
aiprime:
api: https://aiprimetech.io/v1
key_env: AIPRIME_API_KEY
transport: anthropic_messages
catalog_provider: anthropic
model:
provider: custom:aiprime
default: claude-sonnet-5| Schlüssel | Warum |
|---|---|
transport: anthropic_messages | Verwendet das Messages-Format von Anthropic. Ohne diese Einstellung greift Hermes auf das OpenAI-Chat-Completions-Format zurück |
key_env | Der Name der Variable in .env die den Schlüssel enthält |
catalog_provider: anthropic | Die Claude-Modelle des Gateways übernehmen die Kontext- und Vision-Metadaten von Anthropic |
provider: custom:aiprime | Wählt den benannten Anbieter aus; /model custom:aiprime:<model> wechselt innerhalb eines Chats |
Der Assistent macht dasselbe: hermes model, dann **Benutzerdefinierter Endpunkt**, dann der API-Modus **Anthropic Messages**. Wenn Sie stattdessen Chat Completions wählen, behalten Sie /v1 in der URL bei.
Warum provider: anthropic mit einer Basis-URL nicht funktioniert
provider: anthropic und base_url: https://aiprimetech.io sieht korrekt aus, hat aber keine Wirkung: Im aktuellen Hermes-Quellcode wird eine Überschreibung der Basis-URL beim integrierten Anthropic-Anbieter nur für Anthropic-, Claude- und Azure-Hosts akzeptiert, sodass Anfragen weiterhin an Anthropic gehen. Verwenden Sie den oben beschriebenen benannten benutzerdefinierten Anbieter.ANTHROPIC_BASE_URL ist als Überschreibung der Anthropic-Basis-URL dokumentiert, aber wegen eines offenen Hermes-Fehlers ignoriert die Modellauswahl diese Einstellung. Der benutzerdefinierte Anbieter vermeidet beide Probleme.
Was den Token-Verbrauch bestimmt und welche Einstellungen ihn begrenzen
Hermes erledigt Aufgaben, die über die sichtbare Unterhaltung hinausgehen, und all diese Aufgaben werden über denselben Schlüssel abgerechnet, sofern Sie sie nicht anderswohin leiten.
| Verbrauchsquelle | Die Einstellung |
|---|---|
| Subagents (delegation) | delegation.max_concurrent_children (Standard 10), delegation.max_iterations (Standard 250), delegation.max_spawn_depth (Standard 1); ein günstigeres delegation.model |
| Überprüfung von Gedächtnis und Skills im Hintergrund nach jeder Gesprächsrunde | auxiliary.background_review.enabled: false, oder ein niedrigeres max_input_tokens |
| Hilfsaufgaben (Komprimierung, Titel, Vision) | auxiliary.<task>.provider und .model um sie an ein günstigeres Modell zu senden |
| Geplante Aufgaben | cron.model für alle Aufgaben; hermes cron pause <id> oder hermes pause |
| Messaging-Gateway (Telegram, Discord und andere) | Zulassungslisten wie TELEGRAM_ALLOWED_USERS; vermeiden Sie GATEWAY_ALLOW_ALL_USERS=true |
delegation:
max_concurrent_children: 3
model: claude-haiku-4-5
auxiliary:
background_review:
enabled: false
cron:
model: claude-haiku-4-5hermes prompt-size zeigt die Fixkosten, die jeder Aufruf verursacht; /usage und /compress helfen während einer langen Sitzung.
Anmeldung bei Claude Pro oder Max statt eines Schlüssels
Hermes kann sich bei einem Claude-Konto anmelden, laut seiner Dokumentation funktioniert dieser Weg jedoch nur mit einem Max-Tarif und gekauften Guthaben für zusätzliche Nutzung; Pro-Abonnenten können ihn nicht verwenden. Mit einem API-Schlüssel von einem Gateway gibt es kein abonnementbedingtes Nutzungsfenster; die Nutzung wird pro Token von Ihrem Guthaben abgerechnet.
Modelle
| Modell-ID | Einsatzbereich |
|---|---|
claude-sonnet-5 | Standard für Programmier- und Agentenaufgaben: schnell, leistungsstark, mittleres Preisniveau. |
claude-opus-5-5 | Anspruchsvollere Denkaufgaben, umfangreiche Refactorings, lange Agentenläufe. |
claude-fable-5-1 | Am leistungsfähigsten und am teuersten; für die schwierigsten Aufgaben reservieren. |
claude-haiku-4-5 | Günstig und schnell: Titel, Zusammenfassungen, Klassifizierung, kleine Schritte. |
Hermes benötigt ein Kontextfenster von mindestens 64K Tokens; jedes Modell in der Tabelle erfüllt diese Anforderung.
Fehlerbehebung
| Was Sie sehen | Ursache | Lösung |
|---|---|---|
| HTTP 400 beim ersten Start | Der Modellname stimmt nicht mit einer Modell-ID des Gateways überein | Verwenden Sie eine ID aus der obigen Tabelle |
| Anfragen gehen an Anthropic oder schlagen mit einem Anthropic-Authentifizierungsfehler fehl | provider: anthropic mit einer Basis-URL eines Drittanbieters | Den benannten benutzerdefinierten Anbieter verwenden |
| Unbrauchbare oder leere Antworten | Falscher Transport für die URL | transport: anthropic_messages für Claude |
| Kontextlänge überschritten | Sitzung größer als das konfigurierte Kontextfenster | Setzen Sie model.context_length; /compress |
403 Your request was blocked | Eine Firewall vor dem Endpunkt weist den Client ab | Hinzufügen extra_headers mit einem browserähnlichen User-Agent |
| Fehlende Einstellungen nach einem Update | Konfigurationsschema geändert | hermes config checkaus, dann hermes config migrate |
| Bot antwortet auf Telegram oder Discord nicht | Gateway läuft nicht oder Absender ist nicht zugelassen | hermes gateway status; prüfen Sie ~/.hermes/logs/gateway.log |
Sie vergleichen Agenten-Frameworks? Lesen Sie die OpenClaw-Einrichtungsanleitung.
Häufig gestellte Fragen
Wie verwende ich Hermes Agent mit einem benutzerdefinierten Claude-Endpunkt?
Warum ignoriert Hermes meine Anthropic-base_url?
Wie reduziere ich den Token-Verbrauch von Hermes Agent?
Kann Hermes Agent ein Claude Pro-Abonnement verwenden?
Holen Sie sich einen API-Schlüssel – ohne Anthropic-Konto oder Warteliste.
API-Schlüssel erhaltenAI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber.