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

Déclarer un provider yycode dans custom_providers
Pointer le modèle par défaut vers ce provider dans le bloc model
Désactiver smart_model_routing pour éviter que Hermes bascule automatiquement vers un autre modèle

Étape 1 : définir un provider personnalisé

custom_providers:
  - name: custom-yycode-net-aws
    base_url: https://yycode.net
    api_key: <your-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

model:
  default: claude-opus-4-6
  provider: custom-yycode-net-aws
  base_url: https://yycode.net
  api_key: <your-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

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 <your-key> par votre propre API Key Dragon Code :

model:
  default: claude-opus-4-6
  provider: custom-yycode-net-aws
  base_url: https://yycode.net
  api_key: <your-key>
  api_mode: anthropic_messages

custom_providers:
  - name: custom-yycode-net-aws
    base_url: https://yycode.net
    api_key: <your-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 :

curl -X POST "https://yycode.net/v1/messages" \
  -H "Content-Type: application/json" \
  -H "x-api-key: <your-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 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