---
title: "Hermes Agent Anbindung an die Claude API"
description: "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."
headingIds: {"Verifikation der Anbindung und Fehlerbehebung":"section-1","Kosten und andere Zugangswege":"section-2"}
---

<aside className="docs-publication" data-pagefind-ignore>

Dokumentation gepflegt von [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Quellen und Korrekturen](https://1zheai.com/en/editorial/).

Fehler gefunden? [Support kontaktieren](mailto:support@1zheai.com) mit Seitenadresse und Beschreibung. Senden Sie keine API-Schlüssel oder Kontodaten.

</aside>
Verwende die benutzerdefinierte Anbieterfunktion von Hermes Agent, um dich mit 1折AI zu verbinden. Erstelle zuerst einen [API-Schlüssel](/de/docs/api-keys/) und bestätige die [aktuell verfügbaren Modelle](/de/docs/models/); die nachfolgenden Modell-IDs sind Beispiele, passe sie an die Berechtigungen deines Schlüssels an.

<Note>
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](/de/docs/models/).
</Note>

Gemäß [offiziellen Providers](https://hermes-agent.nousresearch.com/docs/integrations/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`:

```yaml
providers:
  onezhe:
    api: https://1zheai.com/v1
    key_env: ONEZHE_API_KEY
    transport: chat_completions
    default_model: claude-sonnet-4-6
model:
  provider: custom:onezhe
  default: claude-sonnet-4-6
```

Lokal bereitstellen in `~/.hermes/.env`:

```dotenv
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

1. Konfiguration speichern und neu laden, bestätige, dass der aktuell ausgewählte Anbieter `onezhe` oder das hinzugefügte benutzerdefinierte Modell ist.
2. 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.
3. Öffne die [Aufrufprotokolle](/de/docs/usage-logs/) und prüfe Anfragezeit, Modell, Status und Verbrauch. Ein erfolgreicher Textantwort bedeutet nicht, dass alle Agent-Fähigkeiten kompatibel sind.
4. 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](/de/docs/troubleshooting/).

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](https://1zheai.com/en/pricing/) und [Abrechnungsregeln](/de/docs/pricing-explained/). Für andere Clients gehe zurück zum [Tool-Zugangskatalog](/de/docs/integrations/); zum eigenständigen Programmieren nutze die [SDK- und Entwicklungsanleitung](/de/docs/guides/).