Hermes Agent Anbindung an die Claude API

Anleitung zur Konfiguration der 1折AI Claude API-Weiterleitung in Hermes Agent mit Adresse, Schlüssel und Modell, einschließlich Protokollauswahl, Konfigurationsbeispiel, Verifikationsschritten und häufigen Fehlern.

Verwende die benutzerdefinierte Anbieterfunktion von Hermes Agent, um dich mit 1折AI zu verbinden. Erstelle zuerst einen API-Schlüssel und bestätige die aktuell verfügbaren Modelle; die nachfolgenden Modell-IDs sind Beispiele, passe sie an die Berechtigungen deines Schlüssels an.

Datum der Überprüfung der offiziellen Konfiguration: 2026-10-15. Die folgende Konfiguration basiert auf der offiziellen Dokumentation; die End-to-End-Verifizierung auf dieser Website ist noch nicht abgeschlossen; führe zuerst eine kurze Frage-Antwort- und Tool-Call-Verifizierung durch, bevor du sie für lange Aufgaben verwendest. OpenAI-/GPT-Modelle sind live, Modellliste und Preise siehe Modellbeschreibung.

Gemäß offiziellen Providers: Im Terminal ausführen hermes model → Custom endpoint, im API mode explizit chat_completions auswählen, Base URL mit https://1zheai.com/v1 ausfüllen, Schlüssel und Modell eingeben. Wähle nicht die ChatGPT-/Codex-Anmeldung, das ist ein anderer Zugangsweg.

Wiederverwendbare benannte Provider-Konfiguration, zusammenführen in ~/.hermes/config.yaml:

1
providers:
2
  onezhe:
3
    api: https://1zheai.com/v1
4
    key_env: ONEZHE_API_KEY
5
    transport: chat_completions
6
    default_model: claude-sonnet-4-6
7
model:
8
  provider: custom:onezhe
9
  default: claude-sonnet-4-6

Lokal bereitstellen in ~/.hermes/.env:

1
ONEZHE_API_KEY=sk-替换为本站密钥

Nach der Konfiguration kannst du im Gespräch zwischen /model custom:onezhe:claude-sonnet-4-6 wechseln. /model kann das Erstellen neuer Provider über das Terminal hermes model nicht ersetzen. Offiziell wird anthropic_messages-Übertragung unterstützt, dieses Tutorial verwendet jedoch Chat Completions, um automatische Protokollerraten anhand der URL zu vermeiden. OPENAI_BASE_URL ist keine universelle Konfiguration für alle benutzerdefinierten Provider; die explizite Konfiguration oben sollte verwendet werden.

Verifikation der Anbindung und Fehlerbehebung

Konfiguration speichern und neu laden, bestätige, dass der aktuell ausgewählte Anbieter onezhe oder das hinzugefügte benutzerdefinierte Modell ist.
Sende eine kurze Frage und bestätige, dass eine Antwort zurückkommt; versuche anschließend eine kleine, rückgängig zu machende Aufgabe und bestätige Tool-Call und Mehrfachrundengespräch einzeln.
Öffne die Aufrufprotokolle und prüfe Anfragezeit, Modell, Status und Verbrauch. Ein erfolgreicher Textantwort bedeutet nicht, dass alle Agent-Fähigkeiten kompatibel sind.
Bei 404: prüfe, ob Adresse und Protokoll dieses Artikels zusammenpassen; bei 401: prüfe die Herkunft des Schlüssels und ob der Prozess die Umgebungsvariablen liest; bei 429: sieh dir die Rate-Limit-Informationen an und versuche es erneut. Weitere Fälle siehe Fehlercodes und Fehlerbehebung.

Schlüssel werden nur in der lokalen Umgebung oder im Credential-Speicher des Tools gespeichert, nicht in Code-Repositories, Screenshots oder öffentlichen Protokollen. Hintergrunddienste erben möglicherweise die Terminal-Umgebungsvariablen nicht; Hilfsmodelle, Suche und andere Tools haben möglicherweise eigene Anbieter-Einstellungen, die separat geprüft werden müssen.

Kosten und andere Zugangswege

Siehe Claude-API-Echtzeitpreise und Abrechnungsregeln. Für andere Clients gehe zurück zum Tool-Zugangskatalog; zum eigenständigen Programmieren nutze die SDK- und Entwicklungsanleitung.