---
title: "Intégration de l'agent Hermes avec l'API Claude"
description: "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."
headingIds: {"Vérifier la connexion et résoudre les problèmes":"section-1","Coûts et autres méthodes d’accès":"section-2"}
---

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

Documentation maintenue par [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Sources et corrections](https://1zheai.com/en/editorial/).

Vous avez trouvé une erreur ? [Contactez l'assistance](mailto:support@1zheai.com) en indiquant l'adresse de la page et une description. N'envoyez pas de clés API ni d'identifiants de compte.

</aside>
Utilisez la fonctionnalité de fournisseur personnalisé de Hermes Agent pour vous connecter à 1折AI. D'abord [créez une clé API ](/fr/docs/api-keys/), et confirmez les [modèles actuellement disponibles ](/fr/docs/models/) ; les identifiants de modèles ci-dessous sont des exemples — ajustez-les en fonction des permissions de votre clé.

<Note>
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 ](/fr/docs/models/) pour la liste des modèles et les tarifs.
</Note>

Basé sur les [fournisseurs officiels ](https://hermes-agent.nousresearch.com/docs/integrations/providers) : 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` :

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

Servi localement sur `~/.hermes/.env` :

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

1. Enregistrez et rechargez la configuration, puis confirmez que le fournisseur actuellement sélectionné est `onezhe` ou le modèle personnalisé que vous avez ajouté.
2. 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.
3. Ouvrez le [journal des appels ](/fr/docs/usage-logs/) 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.
4. 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 ](/fr/docs/troubleshooting/).

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 ](https://1zheai.com/en/pricing/) et les [règles de facturation ](/fr/docs/pricing-explained/). Pour d'autres clients, revenez au [répertoire d'accès aux outils ](/fr/docs/integrations/) ; pour écrire votre propre programme, utilisez le [SDK et le guide développeur ](/fr/docs/guides/).