ホーム / 学習 / ゲートウェイ経由でHermes AgentとClaudeを使用：カスタムプロバイダーの設定、コスト管理、問題の修正
Hermes Agent。翼のように折られた紙のメッセージが、小さなゲートウェイのアーチを通って整然としたコーディング作業スペースへ向かい、エージェントのルーティングを表しています。

ゲートウェイ経由でHermes AgentとClaudeを使う：カスタムプロバイダーの設定、コスト管理、問題の解決方法

Hermes Agentはシークレットを次のファイルに保存します： ~/.hermes/.env 。それ以外はすべて次のファイルに保存します： ~/.hermes/config.yaml。ゲートウェイ経由でClaudeを確実に使用するには、Anthropic Messages形式で通信する名前付きカスタムプロバイダーを使用します。簡略化した設定である provider: anthropic に別のベースURLを指定する方法は正しく見えますが、認識できないホストの場合、リクエストはAnthropicに送信されます。

インストール

Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

hermes setup はウィザード全体を実行します。 hermes model はプロバイダーとモデルのみを設定します。 hermes doctor は既存のインストールを確認します。

ゲートウェイをカスタムプロバイダーとして追加する

~/.hermes/.env
AIPRIME_API_KEY=your_gateway_key
~/.hermes/config.yaml
providers:
  aiprime:
    api: https://aiprimetech.io/v1
    key_env: AIPRIME_API_KEY
    transport: anthropic_messages
    catalog_provider: anthropic

model:
  provider: custom:aiprime
  default: claude-sonnet-5
キー 理由
transport: anthropic_messagesAnthropicのMessages形式で通信します。この設定がないと、HermesはOpenAI Chat Completions形式にフォールバックします
key_env次のファイル内で .env キーを保持する変数の名前
catalog_provider: anthropicゲートウェイのClaudeモデルは、Anthropicのコンテキストと画像認識のメタデータを継承します
provider: custom:aiprimeは名前付きプロバイダーを選択します。 /model custom:aiprime:<model> はチャット内で切り替えます

ウィザードでも同じ設定ができます： hermes model、次に**カスタムエンドポイント**、続いてAPIモードの**Anthropic Messages**を選択します。代わりにChat Completionsを選択する場合は、 /v1 をURLに残してください。

provider: anthropicにベースURLを指定しても動作しない理由

設定として provider: anthropic と base_url: https://aiprimetech.io を指定すると正しく見えますが、効果はありません。現在のHermesのソースでは、組み込みAnthropicプロバイダーのベースURLの上書きは、Anthropic、Claude、Azureのホストに対してのみ受け付けられるため、リクエストは引き続きAnthropicに送信されます。上記の名前付きカスタムプロバイダーを使用してください。

ANTHROPIC_BASE_URL はAnthropicのベースURLを上書きする設定として文書化されていますが、未解決のHermesのバグにより、モデル選択機能はこの設定を無視します。カスタムプロバイダーを使用すれば、両方の問題を回避できます。

トークン使用量を増やす要因と、それを制限する設定

Hermesは画面に表示される会話以外の処理も実行します。別の経路に振り分けない限り、それらはすべて同じキーに課金されます。

使用量の発生源 設定として
Subagents (delegation)delegation.max_concurrent_children （デフォルトは10）、 delegation.max_iterations （デフォルトは250）、 delegation.max_spawn_depth （デフォルトは1）。より安価な delegation.model
各ターン後にバックグラウンドで行うメモリとスキルのレビューauxiliary.background_review.enabled: false、または、より低い max_input_tokens
補助タスク（圧縮、タイトル、画像認識）auxiliary.<task>.provider と .model で、より安価なモデルに送信します
スケジュールされたジョブcron.model をすべてのジョブに適用します。 hermes cron pause <id> または hermes pause
メッセージングゲートウェイ（Telegram、Discordなど）次のような許可リスト TELEGRAM_ALLOWED_USERS。次は避けてください GATEWAY_ALLOW_ALL_USERS=true
~/.hermes/config.yaml（追加設定）
delegation:
  max_concurrent_children: 3
  model: claude-haiku-4-5
auxiliary:
  background_review:
    enabled: false
cron:
  model: claude-haiku-4-5

hermes prompt-size は、各呼び出しで発生する固定コストを表示します。 /usage と /compress は、長いセッションで役立ちます。

キーの代わりにClaude ProまたはMaxでログインする

HermesはClaudeアカウントにログインできますが、ドキュメントによると、この方法は追加使用分のクレジットを購入したMaxプランでのみ利用でき、Proの加入者は利用できません。ゲートウェイのAPIキーを使用する場合、サブスクリプションの利用枠はなく、使用量はトークン単位で残高から課金されます。

モデル

モデルID 用途
claude-sonnet-5コーディングとエージェント作業の標準モデル：高速、高性能、中程度の価格。
claude-opus-5-5より難しい推論、大規模なリファクタリング、長時間のエージェント実行。
claude-fable-5-1最も高性能で最も高価。最も難しいタスクに絞って使いましょう。
claude-haiku-4-5低価格で高速：タイトル、要約、分類、小さな処理。

Hermesには少なくとも64Kトークンのコンテキストウィンドウが必要です。表内のすべてのモデルがこの条件を満たしています。

トラブルシューティング

表示される内容 原因 対処方法
初回実行時のHTTP 400モデル名がゲートウェイのモデルIDと一致していない上の表にあるIDを使用してください
リクエストがAnthropicに送信されるか、Anthropicの認証エラーで失敗するprovider: anthropic サードパーティのベースURLを使用する場合名前付きカスタムプロバイダーを使用する
意味不明な応答または空の応答URLに適さないトランスポートtransport: anthropic_messages Claude用
コンテキスト長の上限超過設定されたウィンドウを超えるセッション設定する項目： model.context_length; /compress
403 Your request was blockedエンドポイントの前段にあるファイアウォールがクライアントを拒否している追加する extra_headers ブラウザーに似たUser-Agentを指定して
更新後に設定が欠落している設定スキーマが変更されたhermes config check。続いて次を実行してください： hermes config migrate
TelegramまたはDiscordでボットが応答しないゲートウェイが稼働していない、または送信者が許可されていないhermes gateway status。確認してください： ~/.hermes/logs/gateway.log

エージェントフレームワークを比較していますか？こちらをご覧ください： OpenClawセットアップガイド.

よくある質問

Hermes AgentでカスタムClaudeエンドポイントを使用するにはどうすればよいですか？
~/.hermes/config.yamlに名前付きプロバイダーを追加し、apiをゲートウェイURLに、key_envを~/.hermes/.env内の変数名に設定し、transport: anthropic_messagesを指定します。その後、model.provider: custom:<name>を設定します。
HermesがAnthropicのbase_urlを無視するのはなぜですか？
provider: anthropicの場合、HermesがベースURLの上書きを受け付けるのはAnthropic、Claude、Azureのホストのみで、サードパーティのURLは破棄されます。代わりに名前付きカスタムプロバイダーを使用してください。
Hermes Agentのトークン使用量を減らすにはどうすればよいですか？
サブエージェントを制限し（委任設定）、補助タスクとcronジョブをより安価なモデルに振り分け、バックグラウンドレビューを無効にして、hermes prompt-sizeを確認してください。
Hermes AgentでClaude Proサブスクリプションを使用できますか？
Hermesのドキュメントによると、使用できません。Claudeのログイン方式は、追加使用クレジットがあるMaxでのみ機能します。APIキーを使用すれば、サブスクリプションの制限を完全に回避できます。
数分でClaudeの利用を開始

APIキーを取得 — Anthropicアカウントもウェイトリストへの登録も不要です。

APIキーを取得

AI Prime Techは独立したAPIゲートウェイです。Anthropicとの提携関係はなく、同社の承認を受けておらず、同社の再販業者でもありません。Claudeおよび関連するモデル名は、それぞれの所有者の商標です。

Claude APIのその他のガイド

Claude APIキーの取得方法Claude API の料金を解説Claude APIを最も安く利用する方法Claude APIでCursorを無制限に利用Claude Codeへの無制限アクセスClaude APIゲートウェイとAnthropicへの直接接続の比較OpenAI SDK で Claude を使う：OpenAI 互換エンドポイント、ストリーミング、ツール、制限Claude モデルを解説：Claude Opus、Sonnet、Haiku、Fable のモデル比較 — すべての Claude API モデル、Anthropic のモデル名と料金（2026）暗号資産でClaude APIの料金を支払うウェイティングリストなしでClaude APIを利用Claudeのトークン使用量を削減する方法Claude APIでClineを無制限に利用Claude APIでRoo Codeを無制限に利用JetBrains IDEでClaudeを無制限に利用ゲートウェイ経由でAiderとClaudeを使う：ANTHROPIC_API_BASE、設定ファイル、アーキテクトモード、問題の解決方法VS CodeでClaudeを無制限に利用Claude向けのOpenCode設定：opencode.jsonの設定、モデル、よくあるエラーClaudeでOpenClawを無制限に実行Anthropic互換APIとはClaude CodeのAPIキー — ANTHROPIC_API_KEY：取得方法、設定方法、代わりにclaude setup-tokenを使うべき場合Claude Code APIのコスト — 料金と削減方法Claude APIエラーを解説：サーバーエラー500、過負荷529、レート制限429、不正なリクエスト400 — それぞれの解決方法Claude APIクレジットの購入方法 — Claudeクレジットがどの「Claudeアカウント購入」のオファーよりも優れている理由Claudeの無料API：無料のClaude APIキーはあるのか、2026に実際に無料で使えるものは？Claude APIとClaude Pro/Maxサブスクリプション — どちらを選ぶべきかカスタムプロバイダーでCodex CLIを使う：config.toml、GPTとClaudeのモデル、IDE拡張機能、問題の解決方法Claudeをn8nに接続するLiteLLMからClaudeへのルーティングKilo CodeでClaudeを使うゲートウェイ経由でGitHub Copilot ChatとClaudeを使う：Custom Endpointの設定、エージェントモード、問題の解決方法ゲートウェイ経由でZedをClaudeに接続するCherry StudioをClaudeに接続LangChainのChatAnthropic：インポート、base_url、ストリーミング、ツール、エラーAnthropic Python SDK：インストール、base_urlの設定、ストリーミング、エラー処理Vercel AI SDKでClaudeを使用：createAnthropicのbaseURL、ストリーミング、問題の修正ClaudeでFactory Droidを実行Claude Code APIの仕組みを解説アプリケーションへのClaude APIの統合Claudeを無制限に利用する方法 — 「Claude Codeのクラック版」が存在しない理由

その他の Claude API ガイド

Anthropic互換APIとはAnthropic Python SDK：インストール、base_urlの設定、ストリーミング、エラー処理Claude APIクレジットの購入方法Claude APIを最も安く利用する方法Claude APIエラーを解説：サーバーエラー500、過負荷529、レート制限429、不正なリクエスト400 — それぞれの解決方法Claudeの無料API：無料のClaude APIキーはあるのか、2026に実際に無料で使えるものは？アプリケーションへのClaude APIの統合Claude モデルを解説：Claude Opus、Sonnet、Haiku、Fable のモデル比較 — すべての Claude API モデル、Anthropic のモデル名と料金（2026）Claude API の料金を解説Claude APIゲートウェイとAnthropicへの直接接続の比較Claude APIとClaude Pro/Maxサブスクリプション — どちらを選ぶべきか暗号資産でClaude APIの料金を支払うウェイティングリストなしでClaude APIを利用Claude Code APIの仕組みを解説Claude Code APIのコスト — 料金と削減方法Claude CodeのAPIキー — ANTHROPIC_API_KEY：取得方法、設定方法、代わりにclaude setup-tokenを使うべき場合Claudeを無制限に利用する方法Claude API キーの取得方法Claudeのトークン使用量を削減する方法OpenAI SDK で Claude を使う：OpenAI 互換エンドポイント、ストリーミング、ツール、制限ClaudeでOpenClawを無制限に実行Claude APIへの無制限アクセスとは無制限のClaude APIキーを取得する方法Claude Codeを無制限に利用 — トークン制限なしClaude Opus 4.8への無制限アクセスClaudeを無制限に利用 — プランと料金ゲートウェイ経由でAiderとClaudeを使う：ANTHROPIC_API_BASE、設定ファイル、アーキテクトモード、問題の解決方法Cherry StudioをClaudeに接続Claude Codeへの無制限アクセスClaude APIでClineを無制限に利用カスタムプロバイダーでCodex CLIを使う：config.toml、GPTとClaudeのモデル、IDE拡張機能、問題の解決方法Claudeの無制限アクセスでCursorを使うClaudeでFactory Droidを実行ゲートウェイ経由でGitHub Copilot ChatとClaudeを使う：Custom Endpointの設定、エージェントモード、問題の解決方法JetBrains IDEでClaudeを無制限に利用Kilo CodeでClaudeを使うLangChainのChatAnthropic：インポート、base_url、ストリーミング、ツール、エラーLiteLLMからClaudeへのルーティングClaudeをn8nに接続するClaude向けのOpenCode設定：opencode.jsonの設定、モデル、よくあるエラーClaude APIでRoo Codeを無制限に利用Vercel AI SDKでClaudeを使用：createAnthropicのbaseURL、ストリーミング、問題の修正VS CodeでClaudeを無制限に利用ゲートウェイ経由でZedをClaudeに接続する