> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent の設定

> Hermes Agent に Crazyrouter を設定し、OpenAI 互換エンドポイント経由で 627 以上の AI モデルを利用します

> 更新日: 2026-06-06

[crazyrouter-hermes](https://github.com/xujfcn/crazyrouter-hermes) を使うと、[Hermes Agent](https://github.com/NousResearch/Hermes-Agent) のモデルプロバイダーを Crazyrouter に切り替えられます。設定後、Hermes は `https://api.crazyrouter.com/v1` を OpenAI 互換エンドポイントとして使い、1 つの Crazyrouter API Key で Claude、GPT、DeepSeek、Gemini、Qwen など 627 以上のモデルを呼び出します。

## 向いている用途

* Hermes Agent から Crazyrouter をモデルプロバイダーとして使いたい場合
* ローカル Agent のモデルと利用枠を Crazyrouter に統一したい場合
* `OPENAI_API_KEY`、`OPENAI_BASE_URL`、デフォルトモデルを 1 コマンドで設定したい場合

## 前提条件

| 項目                  | 説明                                                |
| ------------------- | ------------------------------------------------- |
| Hermes Agent        | ローカルにインストールし、起動できることを確認します                        |
| Crazyrouter アカウント   | [crazyrouter.com](https://crazyrouter.com) で作成します |
| Crazyrouter API Key | Hermes 専用の `sk-...` token を作成することを推奨します           |
| モデル権限               | Hermes で使うモデルを token で許可します                       |

<Tip>
  Hermes は OpenAI 互換設定で Crazyrouter に接続します。Base URL は `https://api.crazyrouter.com/v1` のままにしてください。
</Tip>

## ワンクリック設定

<Tabs>
  <Tab title="Linux / macOS / WSL2">
    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.sh | bash
    ```
  </Tab>

  <Tab title="Windows PowerShell">
    ```powershell theme={null}
    irm https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.ps1 | iex
    ```
  </Tab>

  <Tab title="Windows CMD">
    ```bat theme={null}
    curl -o setup.bat https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.bat
    setup.bat
    ```
  </Tab>
</Tabs>

スクリプトは Crazyrouter API Key の入力、デフォルトモデルの選択、任意の接続テストを案内します。

<Warning>
  セットアップスクリプトはローカルの Hermes 設定を書き換えます。既存のカスタム設定がある場合は、先に `~/.hermes/.env` と `~/.hermes/config.yaml` をバックアップしてください。
</Warning>

## 手動設定

スクリプトを使わない場合は、Hermes の設定ファイルを手動で編集します。

### 環境変数

`~/.hermes/.env` を編集します。

```bash theme={null}
OPENAI_API_KEY=sk-your-crazyrouter-key
OPENAI_BASE_URL=https://api.crazyrouter.com/v1
```

### デフォルトモデル

`~/.hermes/config.yaml` を編集します。

```yaml theme={null}
model:
  provider: "custom"
  default: "claude-opus-4-8"
  base_url: "https://api.crazyrouter.com/v1"
```

`default` は Crazyrouter token で許可済みのモデル名に変更できます。

## モデルの切り替え

設定後、Hermes 内で `/model` を使ってモデルを切り替えられます。

```text theme={null}
/model claude-opus-4-8
/model gpt-5.5
/model claude-sonnet-4.6
/model gemini-3.1-pro
/model deepseek-v4-pro
/model qwen-max
/model gpt-4o
```

切り替え時に `model not allowed` または `403` が返る場合、通常は現在の Crazyrouter token でそのモデルが許可されていません。

## 確認チェックリスト

* [ ] `~/.hermes/.env` の `OPENAI_API_KEY` が有効な Crazyrouter token である
* [ ] `OPENAI_BASE_URL` が `https://api.crazyrouter.com/v1` である
* [ ] `~/.hermes/config.yaml` の `provider` が `custom` である
* [ ] デフォルトモデルが Crazyrouter token で許可されている
* [ ] Hermes でテストメッセージに応答が返る
* [ ] `/model gpt-5.5` など、許可済みモデルへの切り替えが成功する

## よくある問題

| 現象                            | 主な原因                                   | 対処                                                             |
| ----------------------------- | -------------------------------------- | -------------------------------------------------------------- |
| `401 unauthorized`            | API Key が間違っている、期限切れ、またはローテーション済み      | Crazyrouter token を再作成し、`~/.hermes/.env` を更新します                |
| `403` または `model not allowed` | token で選択モデルが許可されていない                  | Crazyrouter token 設定でそのモデルを許可します                               |
| 古いプロバイダーが使われる                 | Hermes が設定を再読み込みしていない、または別の設定ファイルを編集した | Hermes を再起動し、`~/.hermes/.env` と `~/.hermes/config.yaml` を確認します |
| 接続タイムアウト                      | ローカルネットワークから Crazyrouter に到達できない       | プロキシ、ファイアウォール、DNS を確認します                                       |

<Card title="crazyrouter-hermes リポジトリを見る" icon="github" href="https://github.com/xujfcn/crazyrouter-hermes">
  セットアップスクリプト、手動設定例、最新の説明を確認できます。
</Card>