Source: https://aiprimetech.io/ja/learn/run-hermes-agent-with-claude-api/ [ホーム](/ja/) / [学習](/ja/learn/) / ゲートウェイ経由でHermes AgentとClaudeを使用：カスタムプロバイダーの設定、コスト管理、問題の修正 # ゲートウェイ経由で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_messages | AnthropicのMessages形式で通信します。この設定がないと、HermesはOpenAI Chat Completions形式にフォールバックします | key_env | 次のファイル内で .env キーを保持する変数の名前 | catalog_provider: anthropic | ゲートウェイのClaudeモデルは、Anthropicのコンテキストと画像認識のメタデータを継承します | provider: custom:aiprime | は名前付きプロバイダーを選択します。 /model custom:aiprime: はチャット内で切り替えます ウィザードでも同じ設定ができます： 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..provider と .model で、より安価なモデルに送信します | スケジュールされたジョブ | cron.model をすべてのジョブに適用します。 hermes cron pause または 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セットアップガイド](/ja/learn/run-openclaw-with-claude-api/). ## よくある質問 Hermes AgentでカスタムClaudeエンドポイントを使用するにはどうすればよいですか？ ~/.hermes/config.yamlに名前付きプロバイダーを追加し、apiをゲートウェイURLに、key_envを~/.hermes/.env内の変数名に設定し、transport: anthropic_messagesを指定します。その後、model.provider: custom:を設定します。 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キーを取得](/register) AI Prime Techは独立したAPIゲートウェイです。Anthropicとの提携関係はなく、同社の承認を受けておらず、同社の再販業者でもありません。Claudeおよび関連するモデル名は、それぞれの所有者の商標です。 ## Claude APIのその他のガイド [Claude APIキーの取得方法](/ja/learn/how-to-get-a-claude-api-key/)[Claude API の料金を解説](/ja/learn/claude-api-pricing-explained/)[Claude APIを最も安く利用する方法](/ja/learn/cheapest-way-to-use-claude-api/)[Claude APIでCursorを無制限に利用](/learn/use-claude-api-with-cursor/)[Claude Codeへの無制限アクセス](/ja/learn/use-claude-api-with-claude-code/)[Claude APIゲートウェイとAnthropicへの直接接続の比較](/ja/learn/claude-api-vs-anthropic-direct/)[OpenAI SDK で Claude を使う：OpenAI 互換エンドポイント、ストリーミング、ツール、制限](/ja/learn/openai-compatible-claude-api/)[Claude モデルを解説：Claude Opus、Sonnet、Haiku、Fable のモデル比較 — すべての Claude API モデル、Anthropic のモデル名と料金（2026）](/ja/learn/claude-api-models-compared/)[暗号資産でClaude APIの料金を支払う](/ja/learn/claude-api-with-crypto-payment/)[ウェイティングリストなしでClaude APIを利用](/ja/learn/claude-api-without-waitlist/)[Claudeのトークン使用量を削減する方法](/ja/learn/how-to-reduce-claude-token-usage/)[Claude APIでClineを無制限に利用](/ja/learn/use-claude-api-with-cline/)[Claude APIでRoo Codeを無制限に利用](/ja/learn/use-claude-api-with-roo-code/)[JetBrains IDEでClaudeを無制限に利用](/ja/learn/use-claude-api-with-jetbrains/)[ゲートウェイ経由でAiderとClaudeを使う：ANTHROPIC_API_BASE、設定ファイル、アーキテクトモード、問題の解決方法](/ja/learn/use-claude-api-with-aider/)[VS CodeでClaudeを無制限に利用](/ja/learn/use-claude-api-with-vscode/)[Claude向けのOpenCode設定：opencode.jsonの設定、モデル、よくあるエラー](/ja/learn/use-claude-api-with-opencode/)[ClaudeでOpenClawを無制限に実行](/ja/learn/run-openclaw-with-claude-api/)[Anthropic互換APIとは](/ja/learn/anthropic-compatible-api/)[Claude CodeのAPIキー — ANTHROPIC_API_KEY：取得方法、設定方法、代わりにclaude setup-tokenを使うべき場合](/ja/learn/claude-code-api-key-setup/)[Claude Code APIのコスト — 料金と削減方法](/ja/learn/claude-code-api-costs/)[Claude APIエラーを解説：サーバーエラー500、過負荷529、レート制限429、不正なリクエスト400 — それぞれの解決方法](/ja/learn/claude-api-errors-troubleshooting/)[Claude APIクレジットの購入方法 — Claudeクレジットがどの「Claudeアカウント購入」のオファーよりも優れている理由](/ja/learn/buy-claude-api-credits/)[Claudeの無料API：無料のClaude APIキーはあるのか、2026に実際に無料で使えるものは？](/ja/learn/claude-api-free-trial/)[Claude APIとClaude Pro/Maxサブスクリプション — どちらを選ぶべきか](/ja/learn/claude-api-vs-subscription/)[カスタムプロバイダーでCodex CLIを使う：config.toml、GPTとClaudeのモデル、IDE拡張機能、問題の解決方法](/ja/learn/use-claude-api-with-codex/)[Claudeをn8nに接続する](/ja/learn/use-claude-api-with-n8n/)[LiteLLMからClaudeへのルーティング](/ja/learn/use-claude-api-with-litellm/)[Kilo CodeでClaudeを使う](/ja/learn/use-claude-api-with-kilo-code/)[ゲートウェイ経由でGitHub Copilot ChatとClaudeを使う：Custom Endpointの設定、エージェントモード、問題の解決方法](/ja/learn/use-claude-api-with-github-copilot/)[ゲートウェイ経由でZedをClaudeに接続する](/ja/learn/use-claude-api-with-zed/)[Cherry StudioをClaudeに接続](/ja/learn/use-claude-api-with-cherry-studio/)[LangChainのChatAnthropic：インポート、base_url、ストリーミング、ツール、エラー](/ja/learn/use-claude-api-with-langchain/)[Anthropic Python SDK：インストール、base_urlの設定、ストリーミング、エラー処理](/ja/learn/anthropic-python-sdk/)[Vercel AI SDKでClaudeを使用：createAnthropicのbaseURL、ストリーミング、問題の修正](/ja/learn/use-claude-api-with-vercel-ai-sdk/)[ClaudeでFactory Droidを実行](/ja/learn/use-claude-api-with-factory-droid/)[Claude Code APIの仕組みを解説](/ja/learn/claude-code-api/)[アプリケーションへのClaude APIの統合](/ja/learn/claude-api-integration/)[Claudeを無制限に利用する方法 — 「Claude Codeのクラック版」が存在しない理由](/ja/learn/get-unlimited-claude-usage/)