yycode × Hermes クイックスタートガイド

適用シーン

このドキュメントが解決することは 1 つだけです。yycode の Anthropic 互換インターフェースを Hermes に接続し、最小構成での可用性検証を完了します。

現在使っているのが Hermes であり、OpenClaw、Cherry Studio、その他のクライアントではない場合、このドキュメントが対応する接続方法です。

1. 準備事項

始める前に、次を確認してください。

yycode コンソールで API Key を 1 つ作成済み
Hermes が現在呼び出す実際のモデル名を把握している
Hermes の設定ファイル config.yaml を編集できる
今回接続するのは yycode の Anthropic 互換エンドポイントであり、OpenAI 互換エンドポイントではない

2. 対応モデル

このドキュメントでは、yycode の Anthropic 互換モデル接続を優先的に扱います。よく使うモデル名は次のとおりです。

モデル名
`claude-opus-4-6`
`claude-sonnet-4-6`
`claude-haiku-4-5-20251001`

自分のアカウントで実際に利用可能なモデルが分からない場合は、コンソールまたは既存の呼び出し記録を基準にしてください。

3. 推奨ルート：Hermes の `custom_providers` で接続

Hermes を yycode に接続する際の基本方針は次のとおりです。

custom_providers で yycode provider を宣言する
model ブロックでデフォルトモデルをこの provider に向ける
smart_model_routing を無効化し、Hermes が自動的に別モデルへ切り替わるのを避ける

第一步：カスタム provider を定義

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

ここで最も重要なのは次の 2 点です。

base_url は https://yycode.net
api_mode は必ず anthropic_messages

第二步：デフォルトモデルをこの 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

ここの provider は、上の custom_providers 内の name と一致している必要があります。一致していないと、Hermes は定義した Dragon Code provider を使いません。

第三步：Smart Model Routing を無効化

smart_model_routing:
  enabled: false

無効化しない場合、Hermes はメッセージが短いとより安価なモデルへ自動切り替えすることがあります。その結果、claude-opus-4-6 を設定したつもりでも、実際には別のモデルが実行される可能性があります。

4. そのまま参考にできる最小可用設定

以下は統合済みの最小可用例です。<your-key> を自分の Dragon Code API Key に置き換えてください。

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

別の Anthropic 互換モデルへ切り替えたい場合は、model.default と custom_providers[].models 内のモデル名を一緒に変更するだけです。

5. 成功基準

次を満たしていれば、Hermes と Dragon Code は基本的に接続済みです。

base_url が https://yycode.net
api_mode が anthropic_messages
model.provider が custom_providers で定義した provider 名を指している
smart_model_routing.enabled が無効化されている
Hermes からメッセージを送ると、実際にモデル返信を正常に受け取れる

6. よくある質問

なぜ OpenAI 互換方式で接続できないのですか？

今回 Hermes で yycode に接続する場合は、Anthropic ネイティブのメッセージ形式、つまり /v1/messages を使うべきです。

既知の結論は次のとおりです。

/v1/messages は利用可能
/v1/chat/completions はこの Hermes 設定方案のメイン経路には適していない

そのため api_mode は必ず anthropic_messages にしてください。OpenAI 互換モードとして設定しないでください。

`claude-opus-4-6` を選んだのに、実際には別のモデルが走ります

まず smart_model_routing.enabled が無効化されているか確認してください。

Hermes のスマートルーティングが有効な場合、短いメッセージは安価なモデルへ自動的に切り替えられる可能性があり、画面で選んだモデルと実際のリクエストモデルが一致しないことがあります。

`api_key_env` は使えますか？

現在の設定記録では、Hermes v0.10.0 において model と custom_providers ブロック内の api_key_env は不安定な場合があり、環境変数が正しく展開されず、最終的に 401 が返る可能性があります。

この問題だと確認できた場合は、まず api_key を直接記入する方式に戻して接続経路を通し、その後で環境変数方式を続けて調査するか判断してください。

なぜ 401 が返りますか？

通常はまず次を確認します。

API Key が有効か
api_key が model と custom_providers の必要な位置に入っているか
Hermes が現在、本当に変更後の設定ファイルを読み込んでいるか

なぜ 503 またはサービス不可が返りますか？

現在の設定が OpenAI 互換経路になっている場合は、Hermes を誤った api_mode で設定していないか確認してください。

このドキュメントの推奨ルートは Anthropic 互換方式です。OpenAI 互換の書き方と混在させることはおすすめしません。

7. API 検証例

Hermes を経由せず、先に Dragon Code エンドポイント自体が使えるか検証したい場合は、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"}]}'

このリクエストが正常に返るなら、Hermes 設定に戻って確認すると、切り分けがより直接的になります。

8. 次のステップ

他のクライアントにも接続したい場合：OpenClaw クイックスタートガイド、Cherry Studio クイックスタートガイド を確認
まだ Key を作成していない場合：yycode コンソールに戻って API Key を作成
開発ツール設定を統一的に整理したい場合：サイト内の他のクイック接続ドキュメントを続けて確認