Source: https://aiprimetech.io/de/learn/run-hermes-agent-with-claude-api/ [Startseite](/de/) / [Lernen](/de/learn/) / Hermes Agent mit Claude über ein Gateway: Einrichtung eines benutzerdefinierten Anbieters, Kostenkontrolle und Fehlerbehebung # 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 Linux / macOS / WSL2Kopieren ``` curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` WindowsKopieren ``` iex (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 ~/.hermes/.envKopieren ``` AIPRIME_API_KEY=your_gateway_key ``` ~/.hermes/config.yamlKopieren ``` providers: 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: 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 Die Einstellung 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..provider und .model um sie an ein günstigeres Modell zu senden | Geplante Aufgaben | cron.model für alle Aufgaben; hermes cron pause oder hermes pause | Messaging-Gateway (Telegram, Discord und andere) | Zulassungslisten wie TELEGRAM_ALLOWED_USERS; vermeiden Sie GATEWAY_ALLOW_ALL_USERS=true ~/.hermes/config.yaml (Ergänzungen)Kopieren ``` delegation: max_concurrent_children: 3 model: claude-haiku-4-5 auxiliary: background_review: enabled: false cron: model: claude-haiku-4-5 ``` hermes 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](/de/learn/run-openclaw-with-claude-api/). ## Häufig gestellte Fragen Wie verwende ich Hermes Agent mit einem benutzerdefinierten Claude-Endpunkt? Fügen Sie in ~/.hermes/config.yaml einen benannten Anbieter hinzu: Setzen Sie api auf die Gateway-URL, lassen Sie key_env auf eine Variable in ~/.hermes/.env verweisen und legen Sie transport: anthropic_messages fest. Setzen Sie anschließend model.provider: custom:. Warum ignoriert Hermes meine Anthropic-base_url? Bei provider: anthropic akzeptiert Hermes eine abweichende Basis-URL nur für Anthropic-, Claude- und Azure-Hosts. Eine Drittanbieter-URL wird daher verworfen. Verwenden Sie stattdessen einen benannten benutzerdefinierten Anbieter. Wie reduziere ich den Token-Verbrauch von Hermes Agent? Begrenzen Sie Subagenten über die Delegationseinstellungen, leiten Sie Hilfsaufgaben und Cronjobs an ein günstigeres Modell weiter, deaktivieren Sie die Hintergrundprüfung und prüfen Sie hermes prompt-size. Kann Hermes Agent ein Claude Pro-Abonnement verwenden? Laut der Dokumentation von Hermes nicht: Die Anmeldung über Claude funktioniert nur mit Max und Guthaben für zusätzliche Nutzung. Mit einem API-Schlüssel umgehen Sie Abonnementlimits vollständig. Claude in wenigen Minuten nutzen Holen Sie sich einen API-Schlüssel – ohne Anthropic-Konto oder Warteliste.[API-Schlüssel erhalten](/register) AI 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. ## Weitere Anleitungen zur Claude API [So erhalten Sie einen Claude API-Schlüssel](/de/learn/how-to-get-a-claude-api-key/)[Claude-API-Preise erklärt](/de/learn/claude-api-pricing-explained/)[Die günstigste Möglichkeit, die Claude API zu nutzen](/de/learn/cheapest-way-to-use-claude-api/)[Cursor unbegrenzt mit der Claude API nutzen](/learn/use-claude-api-with-cursor/)[Unbegrenzter Zugang zu Claude Code](/de/learn/use-claude-api-with-claude-code/)[Claude API-Gateway vs. direkter Zugang zu Anthropic](/de/learn/claude-api-vs-anthropic-direct/)[Claude mit dem OpenAI SDK verwenden: OpenAI-kompatibler Endpunkt, Streaming, Tools und Limits](/de/learn/openai-compatible-claude-api/)[Claude-Modelle erklärt: ein Vergleich von Claude Opus, Sonnet, Haiku und Fable — alle Claude-API-Modelle, Anthropic-Modellnamen und Preise (2026)](/de/learn/claude-api-models-compared/)[Die Claude API mit Kryptowährungen bezahlen](/de/learn/claude-api-with-crypto-payment/)[Zugang zur Claude API ohne Warteliste](/de/learn/claude-api-without-waitlist/)[So reduzieren Sie den Token-Verbrauch von Claude](/de/learn/how-to-reduce-claude-token-usage/)[Cline unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-cline/)[Roo Code unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-roo-code/)[Claude unbegrenzt in JetBrains-IDEs nutzen](/de/learn/use-claude-api-with-jetbrains/)[Aider mit Claude über ein Gateway: ANTHROPIC_API_BASE, Konfigurationsdateien, Architektenmodus und Fehlerbehebungen](/de/learn/use-claude-api-with-aider/)[Claude unbegrenzt in VS Code nutzen](/de/learn/use-claude-api-with-vscode/)[OpenCode-Konfiguration für Claude: Einrichtung von opencode.json, Modelle und häufige Fehler](/de/learn/use-claude-api-with-opencode/)[OpenClaw unbegrenzt mit Claude betreiben](/de/learn/run-openclaw-with-claude-api/)[Was eine Anthropic-kompatible API bedeutet](/de/learn/anthropic-compatible-api/)[Claude Code-API-Schlüssel — ANTHROPIC_API_KEY: So erhalten und konfigurieren Sie ihn, und wann Sie stattdessen claude setup-token verwenden sollten](/de/learn/claude-code-api-key-setup/)[Claude Code-API-Kosten — Preise und Möglichkeiten zur Kostensenkung](/de/learn/claude-code-api-costs/)[Claude API-Fehler erklärt: Serverfehler 500, Überlastung 529, Ratenlimit 429, fehlerhafte Anfrage 400 — und die jeweilige Lösung](/de/learn/claude-api-errors-troubleshooting/)[So kaufen Sie Claude API-Guthaben – und warum Claude-Guthaben besser ist als jedes Angebot zum „Kauf eines Claude-Kontos“](/de/learn/buy-claude-api-credits/)[Kostenlose Claude API: Gibt es einen kostenlosen Claude API-Schlüssel, und was ist in 2026 tatsächlich kostenlos?](/de/learn/claude-api-free-trial/)[Claude API vs. Claude Pro/Max-Abonnement — welche Option wählen?](/de/learn/claude-api-vs-subscription/)[Codex CLI mit einem benutzerdefinierten Anbieter: config.toml, GPT- und Claude-Modelle, IDE-Erweiterung und Fehlerbehebungen](/de/learn/use-claude-api-with-codex/)[Claude mit n8n verbinden](/de/learn/use-claude-api-with-n8n/)[LiteLLM-Anfragen an Claude weiterleiten](/de/learn/use-claude-api-with-litellm/)[Claude in Kilo Code verwenden](/de/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat mit Claude über ein Gateway: Einrichtung von Custom Endpoint, Agentenmodus und Fehlerbehebungen](/de/learn/use-claude-api-with-github-copilot/)[Zed über das Gateway mit Claude verbinden](/de/learn/use-claude-api-with-zed/)[Cherry Studio mit Claude verbinden](/de/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: Import, base_url, Streaming, Tools und Fehler](/de/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: installieren, base_url setzen, streamen und Fehler behandeln](/de/learn/anthropic-python-sdk/)[Claude mit dem Vercel AI SDK: createAnthropic baseURL, Streaming und Fehlerbehebung](/de/learn/use-claude-api-with-vercel-ai-sdk/)[Factory Droid mit Claude betreiben](/de/learn/use-claude-api-with-factory-droid/)[Die Claude Code API erklärt](/de/learn/claude-code-api/)[Die Claude API in Ihre Anwendung integrieren](/de/learn/claude-api-integration/)[So nutzen Sie Claude unbegrenzt – und warum es kein „gecracktes Claude Code“ gibt](/de/learn/get-unlimited-claude-usage/)