メインコンテンツへスキップ
phaseo hermes を実行して、専用のキーとともに Phaseo を Hermes Agent のカスタムエンドポイントに設定するか、同じ 4 つの Hermes の設定と .env の 1 行を自分で設定します。

Phaseo CLI で設定する

Hermes がインストールされていない場合、CLI は Nous Research の公式インストーラーのコマンドを表示し、実行する前に確認します。macOS と Linux では、インストーラーに sh、bash、curl が必要です。その後、セットアップは次の処理を行います。
  1. 削除時に元に戻せるよう、model.provider、model.base_url、model.default、model.key_env の現在の値を保存します。
  2. 有効期限が 90 日で月額 $100 の利用上限が付いた Phaseo CLI: Hermes Agent API Key を作成します。
  3. キーを OPENAI_API_KEY として Hermes の .env ファイルに書き込みます。書き込み先は # >>> phaseo managed (do not edit) で始まり # <<< phaseo managed で終わるブロックの中です。その他の行はそのまま残り、キーがコマンドラインに表示されることはありません。
  4. hermes config set を実行して、Hermes を Phaseo に向けます。
model.key_env は、OPENAI_API_KEY をカスタムエンドポイントに送信するよう Hermes に指示します。これがないと、Hermes はこのキーを OpenAI 自身のホストにしか送信せず、リクエストはキーなしで Phaseo に届きます。 Phaseo は Hermes に .env ファイルの場所を問い合わせる(hermes config env-path)ため、プロファイルやその他の上書き設定にも対応します。Hermes が場所を返せない場合、CLI は HERMES_HOME の .env、または ~/.hermes/.env(ネイティブ Windows では %LOCALAPPDATA%\hermes\.env)を使います。Hermes はプロバイダーのキーをこの平文のファイルに保存するため、他のキーファイルと同様に保護してください。 期限切れのキーを置き換えたりモデルを変更したりするには、phaseo hermes を再実行します。初回の実行時に保存された設定は保持されます。

Hermes を手動で設定する

Phaseo の API キーを Hermes の .env ファイルに追加します。
.env
次に、Hermes を Phaseo に向けます。
Hermes が読み込む .env ファイルの場所を確認するには、hermes config env-path を実行します。

動作を確認する

実行中の Hermes セッションを再起動して、Phaseo のエンドポイントとキーを使うようにします。hermes config get model.base_url --json を実行して https://api.phaseo.app/v1 が返ることを確認してから、短いプロンプトを送信し、設定 → 利用状況 → ログにリクエストが表示されることを確認します。

Phaseo を削除する

これにより、セットアップ時に保存した 4 つのモデル設定が復元され(設定されていなかったものは未設定に戻ります)、.env から Phaseo のブロックが削除され、~/.config/phaseo/integrations/hermes.json にある CLI の保存状態が削除され、キーが失効します。実行中の Hermes セッションを再起動して、復元された設定を読み込み直してください。

よくある問題を解決する

その他のエージェントや、すべてのエージェントに必要なプロバイダーの値については、コーディングエージェントを参照してください。
最終更新日 2026年11月5日