canonical_url: https://yycode.net/docs/ja/hermes-quickstart
lang: ja
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/ja/hermes-quickstart

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

## 適用シーン

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

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

---

## 1. 準備事項

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

- [yycode コンソール](https://yycode.net/console/token) で 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 に接続する際の基本方針は次のとおりです。

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

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

```yaml
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 に向ける

```yaml
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 を無効化

```yaml
smart_model_routing:
  enabled: false
```

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

---

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

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

```yaml
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 ネイティブエンドポイントを直接呼び出せます。

```bash
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 コンソール](https://yycode.net/console/token) に戻って API Key を作成
- 開発ツール設定を統一的に整理したい場合：サイト内の他のクイック接続ドキュメントを続けて確認