Your privacy choices

Allow optional cookies for referral attribution and anonymous visit measurement.

Hermes 導入ガイド

ターミナル AI Agent の利用に適した、環境構築、モデル設定、トラブルシューティングのガイドです。

**利用シーン：**Hermes Agent は Nous Research がオープンソースで公開しているターミナル AI Agent です。ローカルのコマンドライン、ファイルの読み書き、Web／画像／音声ツール、永続メモリ、メッセージゲートウェイを必要とするユーザーに適しています。本記事では「環境構築 → Hermes のインストール → 貴数 Token モデルの設定 → チャット／ゲートウェイの起動 → トラブルシューティング」の順に説明します。

設定項目推奨入力内容説明
ProviderMore Provider / Custom / OpenAI Compatibleバージョンによって名称が多少異なります。カスタム URL を入力できる項目を選択してください。
Base URLhttps://api.llm-token.cn/v1まず /v1 を含むルートパスを使用し、接続できない場合は https://api.llm-token.cn を試してください。
API Keysk-xxxxxxxx貼り付けた文字がターミナルに表示されないのは正常です。
推奨モデルclaude-sonnet-4-6応答が速く、Agent、画像認識、大きなコンテキストに対応しています。モデル一覧から別のモデルを選択することもできます。

一、Hermes とは

Hermes Agent は、ターミナル上での対話、コマンド実行、ファイルの読み書きや検索、Web とマルチモーダルツールの利用ができ、永続メモリに長期的な設定を保存できます。ローカルまたはサーバー上で継続的に動作する AI Agent と考えると分かりやすいでしょう。

**初心者への推奨：**まずコマンドラインのチャットを正常に設定してから、Telegram、Discord、WeChat などのメッセージチャンネルを設定してください。最小構成を先に動かしておくと、その後のトラブルシューティングが容易になります。

二、インストール方法を選ぶ

システム推奨方法コマンド／説明
Windows / macOS の一般ユーザーHermes Desktopまずデスクトップインストーラーをダウンロードする方法が最も簡単です。
Linux / macOS / WSL2 / Termux公式ワンクリックスクリプト
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows ネイティブ PowerShell公式 PowerShell スクリプト
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Windows の安定した方法WSL2 + UbuntuWindows ネイティブでうまくインストールできない場合は、WSL2 を使用してください。

三、Windows で WSL2 を使用するインストール手順

  1. PowerShell を管理者として開きます。
  2. WSL のインストールコマンドを実行します。
wsl --install

インストールが 0% で止まる場合は、次のコマンドを使用できます。

wsl --install --web-download -d Ubuntu
  1. 画面の案内に従ってパソコンを再起動します。
  2. Ubuntu を初めて開いたときに、Linux のユーザー名とパスワードを設定します。
  3. Win キーを押して WSL または Ubuntu を検索し、起動項目が表示されることを確認します。

画像には Windows Subsystem for Linux（WSL）システムのアイコンが表示されています。赤い背景の左上に青いペンギンの図柄があり、右側に白い文字で「WSL システム」と表示されています。この画像は、「Win キーを押して WSL または Ubuntu を検索し、起動項目が表示されることを確認します」という手順の後にあり、WSL システムの起動項目を視覚的に示します。上記の操作と合わせて、WSL が正常にインストールされたことを確認するために使用します。画像には Windows Subsystem for Linux（WSL）システムのアイコンが表示されています

WSL が正常にインストールされたか確認します。

wsl --version

四、Git と Hermes をインストールする

WSL2 / Ubuntu のターミナルで次を実行します。

sudo apt update
sudo apt install git -y
git --version

続いて Hermes をインストールします。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

インストール完了後、ターミナルの設定を再読み込みして確認します。

source ~/.bashrc
hermes version
hermes doctor

画像には、WSL2 / Ubuntu のターミナルで hermes --version コマンドを実行した結果が表示されています。Hermes Agent のバージョンは v0.8.0、実行日は 2026 年 4 月 8 日、プロジェクトパスは /home/omen/.hermes/hermes-agent、Python のバージョンは 3.11.15、OpenAI SDK のバージョンは 2.30.0 で、更新済みであることが示されています。この画像は「Git と Hermes をインストールする」に関連し、インストール完了後に Hermes が正常にインストールされたことを確認する際の出力例です。画像には、WSL2 / Ubuntu のターミナルで hermes --version コマンドを実行した結果が表示されています

**注意：**以前のドキュメントにある hermes updata はスペルミスです。正しい更新コマンドは hermes update です。

五、貴数 Token モデルを設定する

  1. Hermes をインストールしたターミナルで実行します。
hermes setup

画像には、Hermes をインストールしたターミナルでコマンドを実行している画面が表示されています。コマンドは「hermes setup」で、実行後に「omen@LAPTOP-VMJ1GE8P:~」というプロンプトが表示され、コマンドが完了したことが分かります。この画像は「Hermes をインストールしたターミナルで実行します：$ hermes setup」に対応しています。貴数 Token モデルを設定する手順で、クイック設定またはモデル設定を選択し、「More Provider」／カスタムプロバイダー、OpenAI Compatible またはカスタム URL を入力できるプロトコルを選択した後のターミナル画面です。画像には、Hermes をインストールしたターミナルでコマンドを実行している画面が表示されています

  1. クイック設定またはモデル設定を選択します。
  2. More Provider／カスタムプロバイダーを選択します。
  3. OpenAI Compatible、またはカスタム URL を入力できるプロトコルを選択します。

この画像は Hermes を設定する際のターミナル画面です。背景は暗色で、上部には現在 hermes-chat のターミナル環境にいることが表示されています。画面には設定案内が明示され、1 行目で Telegram、Discord など対応するメッセージプラットフォームを選択するよう案内しています。その下には「set up messaging one (recommended)」に関連する設定項目があります。この画面は、貴数 Token モデルの設定手順にあるメッセージ関連の選択に対応し、Hermes の導入フローで設定を完了するよう案内しています。この画像は Hermes を設定する際のターミナル画面です

画像には、Hermes をインストールしたターミナルでプロバイダーを選択する画面が表示されています。上部に「Select provider:」と表示され、その下に Nous Portal、OpenRouter など複数のプロバイダーがあります。「More providers...」を緑色の矢印が指しています。この画像は「貴数 Token モデルを設定する」に関連し、「More Provider／カスタムプロバイダーを選択する」という手順に対応します。Hermes のインストール時にカスタムプロバイダーを選択し、貴数 Token モデルを設定する操作を案内しています。画像には、Hermes をインストールしたターミナルでプロバイダーを選択する画面が表示されています

画像には、Hermes をインストールしたターミナルでプロバイダーを選択する画面が表示されています。上部に「Select provider:」と表示され、その下に GitHub Copilot ACP、Google AI Studio など複数のプロバイダーがあります。「Custom endpoint (enter URL manually)」が緑色の矢印で強調され、URL を手動で入力できることを示しています。この画像は、貴数 Token モデルの設定でカスタムプロバイダーを選ぶ手順に対応します。必要に応じて適切なプロバイダーを選ぶか、カスタムプロバイダーを選択して URL を手動入力できます。画像には、Hermes をインストールしたターミナルでプロバイダーを選択する画面が表示されています

URL には、まず次を入力します。

https://api.llm-token.cn/v1

現在のバージョンで検証に失敗する場合は、次を試してください。

https://api.llm-token.cn

この画像には、Hermes で貴数 Token モデルを設定する際の、OpenAI 互換カスタム API の設定画面が表示されています。中心には「Custom OpenAI-compatible endpoint configuration」とあり、設定項目は API base URL、例は https://api.example.com/v1、現在入力されているカスタムアドレスは https://api.llm-token.cn/v1 です。カスタムプロバイダーと OpenAI 互換プロトコルを選択した後に URL を入力し、API 連携の基本設定を完了する画面です。この画像には、Hermes で貴数 Token モデルを設定する際の、OpenAI 互換カスタム API の設定画面が表示されています

  1. API Key を貼り付けます。ターミナルに文字が表示されないのは正常です。貼り付けたら、そのまま Enter キーを押します。
  2. 最初のテストには claude-sonnet-4-6 モデルをおすすめします。
  3. コンテキスト長を尋ねられた場合、claude-sonnet-4-6 では大きなコンテキストを設定できます。クライアント側の制限が厳しい場合は、まず 32000 を入力して動作確認し、その後段階的に大きくしてください。
  4. メッセージチャンネルは初回にスキップできます。ターミナルチャットが動作してからゲートウェイを設定してください。

画像には、Hermes で貴数 Token モデルを設定した後のターミナル画面が表示されています。上部には API base URL として https://api.example.com/v1 があり、API key は任意で、エンドポイントが検証済みです。その下には claude-sonnet-4-6、claude-sonnet-4-6-thinking など 33 個の利用可能なモデルがあります。下部ではモデルを選択するよう案内され、数字がモデル名に対応しています。たとえば 1 は claude-sonnet-4-6、33 は glm-4.6v です。この画像は、貴数 Token モデルの設定後にチャットへ進む際のモデル選択画面です。画像には、Hermes で貴数 Token モデルを設定した後のターミナル画面が表示されています

画像には、Hermes の設定完了後にチャットへ進む際の画面が表示されています。「Connect a messaging platform? (Telegram, Discord, etc.)」という案内と、「Set up messaging now (recommended)」「Skip — set up later with 'hermes setup gateway'」の 2 つの選択肢があります。現在は矢印が指す「Skip」が選択されています。設定完了後に直接チャットへ進むという説明に関連し、チャット開始前にプラットフォームへ接続するか、後で設定するかを選択できます。画像には、Hermes の設定完了後にチャットへ進む際の画面が表示されています

六、チャットとゲートウェイを起動する

設定完了後は、そのままチャットを開始できます。チャットを開始するか表示されたら、Y を入力します。

画像には、Hermes の導入完了後にターミナルへ表示される案内があります。上部には「Ready to go!」とあり、その下には 3 つのコマンドと用途が表示されています。「hermes」はチャット開始、「hermes gateway」はメッセージチャンネルの起動、「hermes doctor」は問題の確認に使用します。最下部には「Launch hermes chat now? [Y/n]：」と表示され、Hermes のチャットを今すぐ起動するか Y/n で尋ねています。この画像は、Hermes 導入ガイドの「七、よく使うコマンド早見表」に関連し、導入完了後に実行できるコマンドと機能を視覚的に示しています。画像には、Hermes の導入完了後にターミナルへ表示される案内があります

メッセージチャンネルを設定しても反応がない場合は、gateway を起動または確認します。

hermes gateway
hermes gateway status

七、よく使うコマンド早見表

コマンド用途
hermesチャットを開始します。
hermes setup完全設定ウィザードをもう一度開きます。
hermes modelモデルまたはプロバイダーを切り替えます。
hermes doctor依存関係、設定、サービスの状態を診断します。
hermes updateHermes を更新します。
hermes --continue前回のセッションを再開します。

八、よくある問題

問題対処方法
hermes: command not foundsource ~/.bashrc を実行するか、ターミナルを開き直してください。それでも解決しない場合は PATH を確認します。
モデルの検証に失敗するURL、API Key、モデル ID を確認してください。https://api.llm-token.cn/v1 を優先して使用します。
応答が途切れる、コンテキストが小さいhermes setup または設定ファイルで context length を調整します。まず動作を確認してから、コンテキストを大きくしてください。
WSL2 から Windows のローカルサービスにアクセスできないWindows 11 では WSL mirrored networking を試せます。Windows 10 では localhost の代わりに WSL のデフォルトゲートウェイ IP を使用できます。
更新後に設定が失われたhermes config check と hermes config migrate を実行します。
[wsl2]
networkingMode=mirrored
wsl --shutdown

Codex デプロイガイド

CLI ツールのインストール、API 接続、開発環境の設定を分かりやすく解説します。

gpt-image-2 画像生成モデル設定ガイド

Cherry Studio、Skill パッケージ、スクリプトとの連携に適した画像生成チュートリアルです。

このページのセクション

一、Hermes とは二、インストール方法を選ぶ三、Windows で WSL2 を使用するインストール手順四、Git と Hermes をインストールする五、貴数 Token モデルを設定する六、チャットとゲートウェイを起動する七、よく使うコマンド早見表八、よくある問題