canonical_url: https://yycode.net/docs/fr/hermes-quickstart lang: fr updated_at: 2026-07-04T13:33:48.616Z source_html: https://yycode.net/docs/fr/hermes-quickstart # Guide de démarrage rapide yycode × Hermes ## Cas d'utilisation Ce document ne résout qu'une seule chose : connecter l'interface compatible Anthropic de yycode à Hermes et effectuer une vérification minimale d'utilisabilité. Si vous utilisez actuellement Hermes, et non OpenClaw, Cherry Studio ou un autre client, ce document décrit la méthode d'intégration correspondante. --- ## 1. Préparation Avant de commencer, confirmez les points suivants : - Vous avez déjà créé une API Key dans la [console yycode](https://yycode.net/console/token) - Vous connaissez le nom réel du modèle que Hermes doit appeler - Vous pouvez modifier le fichier de configuration Hermes `config.yaml` - Cette intégration vise le point de terminaison compatible Anthropic de yycode, pas le point de terminaison compatible OpenAI --- ## 2. Modèles pris en charge Ce document couvre en priorité l'intégration des modèles compatibles Anthropic de yycode. Les noms courants sont : | Nom du modèle | |---| | `claude-opus-4-6` | | `claude-sonnet-4-6` | | `claude-haiku-4-5-20251001` | Si vous n'êtes pas sûr des modèles réellement disponibles sur votre compte, référez-vous à la console ou à vos enregistrements d'appels existants. --- ## 3. Chemin recommandé : intégration via `custom_providers` de Hermes Pour connecter Hermes à yycode, l'idée centrale est : 1. Déclarer un provider yycode dans `custom_providers` 2. Pointer le modèle par défaut vers ce provider dans le bloc `model` 3. Désactiver `smart_model_routing` pour éviter que Hermes bascule automatiquement vers un autre modèle ### Étape 1 : définir un provider personnalisé ```yaml custom_providers: - name: custom-yycode-net-aws base_url: https://yycode.net api_key: api_mode: anthropic_messages models: - claude-opus-4-6 ``` Les deux points les plus importants sont : - `base_url` doit être `https://yycode.net` - `api_mode` doit impérativement être `anthropic_messages` ### Étape 2 : pointer le modèle par défaut vers ce provider ```yaml model: default: claude-opus-4-6 provider: custom-yycode-net-aws base_url: https://yycode.net api_key: api_mode: anthropic_messages ``` Ici, `provider` doit correspondre au `name` défini dans `custom_providers`, sinon Hermes n'utilisera pas le provider Dragon Code que vous avez défini. ### Étape 3 : désactiver Smart Model Routing ```yaml smart_model_routing: enabled: false ``` Si vous ne le désactivez pas, Hermes peut basculer automatiquement vers un modèle moins cher pour les messages courts. Vous pourriez donc avoir configuré `claude-opus-4-6`, mais exécuter en réalité un autre modèle. --- ## 4. Configuration minimale directement réutilisable Voici un exemple minimal complet. Remplacez `` par votre propre API Key Dragon Code : ```yaml model: default: claude-opus-4-6 provider: custom-yycode-net-aws base_url: https://yycode.net api_key: api_mode: anthropic_messages custom_providers: - name: custom-yycode-net-aws base_url: https://yycode.net api_key: api_mode: anthropic_messages models: - claude-opus-4-6 smart_model_routing: enabled: false fallback_providers: - provider: minimax-cn model: MiniMax-M2.7 ``` Si vous voulez basculer vers un autre modèle compatible Anthropic, modifiez simplement le nom de modèle à la fois dans `model.default` et dans `custom_providers[].models`. --- ## 5. Critères de réussite Si les points ci-dessous sont satisfaits, Hermes et Dragon Code sont globalement connectés : - `base_url` est `https://yycode.net` - `api_mode` est `anthropic_messages` - `model.provider` pointe vers le nom du provider défini dans `custom_providers` - `smart_model_routing.enabled` est désactivé - Après l'envoi d'un message par Hermes, une réponse du modèle est bien reçue --- ## 6. Questions fréquentes ### Pourquoi ne pas utiliser la méthode compatible OpenAI ? Pour connecter Hermes à yycode dans ce cas, il faut utiliser le format natif des messages Anthropic, c'est-à-dire `/v1/messages`. Conclusion connue : - `/v1/messages` fonctionne - `/v1/chat/completions` n'est pas adapté comme chemin principal pour cette configuration Hermes `api_mode` doit donc être `anthropic_messages`. Ne configurez pas cette intégration comme un mode compatible OpenAI. ### Pourquoi ai-je choisi `claude-opus-4-6`, mais un autre modèle s'exécute réellement ? Vérifiez d'abord que `smart_model_routing.enabled` est bien désactivé. Si le routage intelligent de Hermes est activé, les messages courts peuvent être automatiquement basculés vers un modèle moins cher, ce qui crée un écart entre le choix affiché et le modèle réellement demandé. ### Peut-on utiliser `api_key_env` ? D'après cette configuration actuelle, `api_key_env` dans Hermes v0.10.0 peut être instable dans les blocs `model` et `custom_providers`. Il peut empêcher le bon développement de la variable d'environnement et finir par renvoyer 401. Si vous avez confirmé que le problème vient de là, revenez d'abord à une valeur `api_key` écrite directement pour valider la chaîne, puis décidez si vous voulez continuer à investiguer la solution par variable d'environnement. ### Pourquoi un 401 est-il renvoyé ? Vérifiez généralement ces points en premier : - L'API Key est-elle valide ? - `api_key` est-elle renseignée aux emplacements nécessaires dans `model` et `custom_providers` ? - Hermes a-t-il réellement chargé le fichier de configuration que vous avez modifié ? ### Pourquoi un 503 ou un service indisponible est-il renvoyé ? Si votre configuration actuelle utilise le chemin compatible OpenAI, revenez vérifier si Hermes a été configuré avec le mauvais `api_mode`. Le chemin recommandé dans ce document est l'intégration compatible Anthropic. Il n'est pas conseillé de la mélanger avec une configuration compatible OpenAI. --- ## 7. Exemple de vérification API Si vous voulez contourner Hermes et vérifier directement que le point de terminaison Dragon Code fonctionne, vous pouvez appeler d'abord le point de terminaison natif Anthropic : ```bash curl -X POST "https://yycode.net/v1/messages" \ -H "Content-Type: application/json" \ -H "x-api-key: " \ -H "anthropic-version: 2023-06-01" \ -d '{"model":"claude-opus-4-6","max_tokens":50,"messages":[{"role":"user","content":"hi"}]}' ``` Si cette requête renvoie une réponse normale, revenez ensuite vérifier la configuration Hermes ; le dépannage sera plus direct. --- ## 8. Étapes suivantes - Pour connecter d'autres clients : consultez `Guide de démarrage rapide OpenClaw` et `Guide de démarrage rapide Cherry Studio` - Si vous n'avez pas encore créé de Key : retournez dans la [console yycode](https://yycode.net/console/token) pour créer une API Key - Pour organiser les configurations de vos outils de développement : continuez avec les autres documents de démarrage rapide du site