Hermes Agentには少数の組み込みプロバイダーが用意されていますが、真の柔軟性はカスタムエンドポイントオプションにあります。OpenAIのchat-completions形式に対応したサービスであれば、ベースURL、APIキー、モデル名の3つだけで接続できます。MiniMax、DeepSeek、Google Gemini、xAI Grok、OpenAI、OpenRouter、プライベートなvLLMサーバー、ローカルのOllamaインスタンス、そしてこれらすべてをまとめて利用できるhaimaker.aiにも対応しています。

ここではまず一般的な設定方法を説明し、その後、よく使われるプロバイダーごとの具体的な値を紹介します。

一般的な設定方法

Hermesでは、どのカスタムプロバイダーも以下の流れで設定します。

hermes model
  1. メニューからCustom endpointを選択します。
  2. ベースURLを入力します。OpenAI互換のルートURLで、末尾は/v1です（Hermesが自動的に/chat/completionsを追加します）。
  3. そのプロバイダーのAPIキーを入力します。
  4. プロバイダーが求めるモデル識別子を入力します。

Hermesは選択内容を保存し、以降のすべての実行で使用します。プロバイダーを変更するときは、もう一度hermes modelを実行してください。仕組みはこれだけです。残りは各プロバイダーに合わせた正しい値を埋めるだけです。

Hermesでモデルがうまく動作するには、ツールスキーマに従いつつ、エージェントのループ処理に対応できる十分なコンテキスト長を備えている必要があります。最低でも約64Kの利用可能なコンテキストを確保してください。実際にどのモデルを選ぶべきかはHermes Agentに最適なモデルを参照してください。

haimaker.ai：1つのキーですべてのモデルにアクセス

プロバイダーごとに別々のアカウント、キー、ベースURLを管理する代わりに、Hermesをhaimaker.aiへ一度接続すれば、モデルの切り替えは1つの文字列を変更するだけです。最も早いセットアップ方法は、次の1コマンドです。

export HAIMAKER_API_KEY=your-haimaker-key
npx -y @haimaker/connect --hermes

@haimaker/connectはHermesのカスタムエンドポイント設定を書き込み、キーを検証してから終了します。--modelを付けるとモデルを固定できます。--pick-modelを付けると対話形式で選択できます。元に戻すにはnpx @haimaker/connect --uninstall --hermesを実行します。まずapp.haimaker.aiでキーを取得してください。新規アカウントには無料クレジットが付与されます。

組み込みのhermes modelフローを使いたい場合は、以下の値を入力してください。

  • ベースURL： https://api.haimaker.ai/v1
  • APIキー： haimaker.aiのキー
  • モデル： 対応モデルなら何でも。例：anthropic/claude-sonnet-4-6、openai/gpt-5-4-codex、google/gemini-3-1-pro、minimax/minimax-m2-5、deepseek/deepseek-v3-2、xai/grok-4-1-fast、zai/glm-4-7、moonshot/kimi-k2-5

モデルは市場価格より約5%安く、請求アカウントの管理は1つだけで済みます。

HermesでMiniMaxを使う

MiniMax M2.5は、Hermesで人気のコストパフォーマンスに優れた選択肢です。常時稼働させても気にならない価格で、ツールループを処理できる性能があります。

  • ベースURL： https://api.minimax.io/v1
  • APIキー： MiniMaxプラットフォームのコンソールから取得
  • モデル： MiniMax-M2.5（MiniMaxコンソールに表示される正確なIDを使用してください。大文字と小文字は区別されます）

または、haimaker.ai経由でモデルminimax/minimax-m2-5を使えば、個別のアカウントは不要です。

HermesでGoogle Geminiを使う

GeminiはOpenAI互換レイヤーを提供しているため、Hermesのカスタムエンドポイントとして利用できます。

  • ベースURL： https://generativelanguage.googleapis.com/v1beta/openai
  • APIキー： Google AI Studioのキー
  • モデル： 安価で高速な処理ならgemini-3-flash、長文コンテキストのリサーチならgemini-3.1-pro

Hermes Agentはこの方法でGoogle Geminiをサポートしています。別途Gemini専用の統合を有効にする必要はなく、カスタムエンドポイントとして接続するだけです。haimaker.ai経由でgoogle/gemini-3-1-proを使うこともできます。

HermesでDeepSeekを使う

  • ベースURL： https://api.deepseek.com/v1
  • APIキー： DeepSeekプラットフォームから取得
  • モデル： deepseek-chat（現在のV3.2系を指します）またはdeepseek-reasoner

haimaker.ai経由の場合：deepseek/deepseek-v3-2

HermesでxAI Grokを使う

  • ベースURL： https://api.x.ai/v1
  • APIキー： xAIコンソールから取得
  • モデル： 安価な大規模コンテキスト処理ならgrok-4.1-fast、コード特化のタスクならgrok-code-fast

haimaker.ai経由の場合：xai/grok-4-1-fast

HermesでOpenAI / Codexモデルを使う

OpenAIのモデル（Codexシリーズを含む）をHermes経由で使いたい場合：

  • ベースURL： https://api.openai.com/v1
  • APIキー： OpenAIのAPIキー（ChatGPT PlusのサブスクリプションにはAPIアクセスは含まれません。課金が有効な別途のAPIキーが必要です）
  • モデル： コーディングにはgpt-5.4-codex、汎用的な作業にはgpt-5.4

haimaker.ai経由の場合：openai/gpt-5-4-codex

Ollama経由のローカルモデル

  • ベースURL： http://localhost:11434/v1
  • APIキー： 空でない文字列なら何でも可（Ollamaは無視しますが、Hermesは値が必要です）
  • モデル： gemma4:latest、qwen3.5:latest、またはpull済みの任意のモデル
ollama pull gemma4
hermes model   # Custom endpoint → base URL above → model gemma4:latest

よくある問題

  • 長い処理でのタイムアウト。 低速なプロバイダーでは、長いエージェント処理の途中でHermesのデフォルトのストリーム読み取りタイムアウトを超えることがあります。Hermesを起動する前にHERMES_STREAM_READ_TIMEOUT（秒）をより大きな値に設定してください。
  • 401 / 認証エラー。 キーが正しく登録されていないか、APIキーではなくコンソール/セッショントークンを貼り付けた可能性があります。hermes modelを再実行して、キーを再入力してください。
  • リクエストで404が返る。 ベースURLにすでに/chat/completionsが含まれているか、末尾にスラッシュがある可能性があります。Hermesがパスを自動的に追加するため、URLは/v1で終わるようにしてください。
  • ツール呼び出しが繰り返し失敗する。 通常は設定ではなくモデル側の問題です。小規模モデルはツールスキーマから外れやすいため、上位のモデルに切り替えてください。

haimaker.aiのキーを取得する

新規アカウントにはテスト用の無料クレジットが付与されます。haimaker.aiで、対応モデルを最新の価格とベンチマーク付きで確認できます。その上でnpx -y @haimaker/connect --hermesを実行して、Hermesを接続してください。

HAIMAKERで10ドル分の無料クレジットを獲得

関連記事：Hermes Agentに最適なモデル · Hermes Agentの料金 · Hermes Agent vs Codex CLI