Intégration de l'agent Hermes avec l'API Claude

Tutoriel sur la configuration de l'adresse de relais, de la clé et du modèle de l'API Claude de 1折AI dans Hermes Agent, incluant la sélection du protocole, des exemples de configuration, des étapes de vérification et des erreurs courantes.

Utilisez la fonctionnalité de fournisseur personnalisé de Hermes Agent pour vous connecter à 1折AI. D’abord créez une clé API , et confirmez les modèles actuellement disponibles ; les identifiants de modèles ci-dessous sont des exemples — ajustez-les en fonction des permissions de votre clé.

Date de vérification officielle de la configuration : 2026-10-15. La configuration suivante est compilée à partir de la documentation officielle ; la vérification de bout en bout sur ce site n’a pas encore été terminée ; veuillez d’abord effectuer une courte vérification de questions-réponses et d’appels d’outils avant de l’utiliser pour de longues tâches. Les modèles OpenAI / GPT sont désormais en ligne ; consultez la description des modèles pour la liste des modèles et les tarifs.

Basé sur les fournisseurs officiels : exécutez hermes model dans le terminal → point de terminaison personnalisé, sélectionnez explicitement chat_completions pour le mode API, renseignez https://1zheai.com/v1 pour l’URL de base, puis saisissez la clé et le modèle. Ne sélectionnez pas la connexion ChatGPT/Codex — c’est une méthode d’accès différente.

Configuration de fournisseur nommé réutilisable, à fusionner dans ~/.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

Servi localement sur ~/.hermes/.env :

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

Une fois configuré, vous pouvez basculer /model custom:onezhe:claude-sonnet-4-6 dans la conversation. /model ne peut pas remplacer le hermes model du terminal pour créer un nouveau fournisseur. Le transport anthropic_messages est officiellement pris en charge, mais ce tutoriel utilise Chat Completions pour éviter de deviner automatiquement le protocole à partir de l’URL. OPENAI_BASE_URL n’est pas une configuration universelle pour tous les fournisseurs personnalisés ; utilisez la configuration explicite ci-dessus.

Vérifier la connexion et résoudre les problèmes

Enregistrez et rechargez la configuration, puis confirmez que le fournisseur actuellement sélectionné est onezhe ou le modèle personnalisé que vous avez ajouté.
Envoyez une question courte et confirmez qu’elle renvoie une réponse ; puis essayez une petite tâche réversible pour vérifier séparément les appels d’outils et la conversation multi-tours.
Ouvrez le journal des appels et vérifiez l’heure de la requête, le modèle, le statut et l’utilisation. Une réponse textuelle réussie unique ne signifie pas que toutes les capacités de l’Agent sont compatibles.
Si vous rencontrez une erreur 404, vérifiez si l’adresse et le protocole de cet article correspondent ; si vous rencontrez une erreur 401, vérifiez la source de la clé et si le processus a lu les variables d’environnement ; si vous rencontrez une erreur 429, examinez les informations de limitation de débit avant de réessayer. Pour plus de cas, consultez les codes d’erreur et le dépannage .

Les clés ne doivent être stockées que dans l’environnement local ou le magasin d’identifiants de l’outil — ne les commettez pas dans des dépôts de code, des captures d’écran ou des journaux publics. Les services d’arrière-plan peuvent ne pas hériter des variables d’environnement du terminal ; les modèles auxiliaires, la recherche et d’autres outils peuvent également avoir des paramètres de fournisseur indépendants qui doivent être vérifiés séparément.

Coûts et autres méthodes d’accès

Consultez les tarifs en temps réel de l’API Claude et les règles de facturation . Pour d’autres clients, revenez au répertoire d’accès aux outils ; pour écrire votre propre programme, utilisez le SDK et le guide développeur .