インストールと初回起動

この章では、Hermes Desktopを導入して起動を確認し、自分に合った始め方を選びます。最初からすべての機能を有効にする必要はありません。まずは「起動して、チャットが打てる」ところまでを最短で目指します。

1. インストールする

OSによって配布方法が異なります。すでにHermes AgentのCLIを導入済みなら、ターミナルから起動する方法が手早いです。

macOS・Windows

公式Downloadページを開く。
OSに合うHermes Desktopインストーラーを取得する。
ダウンロードしたインストーラーを実行する。
Hermes Desktopを起動し、ガイド付きセットアップのチャット（「こんにちは、Hermes です。」で始まる）またはチャット画面が表示されることを確認する。

配布物のファイル名、署名、更新方法は変わる可能性があります。第三者のミラーではなく公式サイトから取得してください。

CLI導入済みの場合

hermes desktop

この方法では、現在の設定、キー、セッション、スキルをDesktop Appと共有します。

Linux

公式ガイドではDesktop AppはLinuxでも動作するとされています。CLIを公式インストーラーで導入し、hermes desktopを実行する方法を確認してください。

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

シェルスクリプトを実行する前に、組織のセキュリティ方針がある場合はスクリプトの内容と配布元を確認してください。管理対象端末では管理者の手順を優先します。

2. 起動できたか確認する

次の3つが確認できれば、インストールは成功です。

Hermes Desktopのウィンドウが開く
ガイド付きセットアップのチャット、プロバイダー接続の画面、またはチャット画面が表示される
設定画面を開ける

起動に失敗する場合は問題の切り分けを確認してください。

3. ガイド付きセットアップを進める

Hermesを一度も使っていないコンピューターでデスクトップアプリを初めて開くと、設定画面ではなく短いセットアップ用のチャットが始まります。このチャットは無料体験用のモデルで動くため、APIキーやアカウントがなくても進められます。

前提: Hermes Desktopが起動し、「こんにちは、Hermes です。」で始まるセットアップチャットが表示されている。
操作: カードが1枚ずつ出るので、順に答えます。
1. 名前 ─ 呼びかけに使う名前を入力する。
2. アクセントカラー ─ 画面の強調色を選ぶ。
3. レイアウト ─ 「ベーシック（Hermes と話すために。）」か「エリート（開発者向け: ターミナル、ファイル、差分。）」を選ぶ。ベーシックはインターフェースモード「シンプル」、エリートは「詳細」に対応し、後から外観の「ウィンドウとレイアウト」で切り替えられる。
4. アプリ ─ つなぎたい外部アプリ（Connectors）を選ぶ。不要なら飛ばしてよい。
5. プラグイン ─ 入れたいプラグインを選ぶ。不要なら飛ばしてよい。
6. ツアー ─ 「クイックツアー」「すべて見せて」「スキップして何か作ろう」から選ぶ。
7. 最初のタスク ─ 提案された最初のタスクを選ぶか、自分で依頼を書く。
期待結果: セットアップが終わると通常のチャットで作業を始められます。コンピューターの性能が足りる場合は、終了時に「このコンピューターはモデルをローカルで実行できます」と表示され、「セットアップする」か「今はしない」を選べます。
途中でやめたいとき: 入力欄の「セットアップをスキップ」を押すと、ガイド付きセットアップを終了して新しいチャットが開きます。後からやり直すには、設定の詳細 > デスクトップと起動にある「オンボーディングをもう一度実行」の「もう一度実行」を押します。

ガイド付きセットアップは新規のデスクトップ環境で表示されます。すでにHermesを使っている環境や、リモートのバックエンドに接続する構成では表示されないことがあります。表示されない場合や、自分のプロバイダーをすぐ使いたい場合は、従来どおりプロバイダーからアカウント接続やAPIキー登録を行えます。無料体験モデルは初回セットアップ向けのため、日常の作業には自分で接続したプロバイダーのモデルを使ってください。

4. 3段階クイックスタート

起動できたら、自分の状況に合わせて始め方を選びます。下にいくほど設定項目が増えますが、最小限から始めて後で広げて構いません。迷ったら最小限を選んでください。

最小限 ─ まずチャットを打ちたい

「とにかく動かしたい」段階向けです。ガイド付きセットアップのあとに、プロバイダーを1つ接続すれば完結します。

設定のプロバイダーで、利用するモデルプロバイダーへサインインするか、APIキーを登録する。
チャットで使うプロバイダーとモデルを1つ選び、適用する（ツール呼び出しに対応するモデルを選ぶと、後の章の操作がそのまま使える）。
影響の小さい確認タスクからチャットを始める。

この段階では、承認モードや作業フォルダは初期設定のまま進めて問題ありません。詳しいモデル選びはモデルとプロバイダーを整えるで扱います。

標準 ─ 安全に日常使いしたい

ファイルを扱う実作業に入る前の、推奨の出発点です。最小限に次を足します。

作業フォルダを、対象プロジェクトまたは専用のテストフォルダに限定する。
設定の安全性 > 承認で、承認モードを manual（UI表示は「手動」。承認が必要な操作の前に人が確認する）に設定する。既定は smart（UI表示は「スマート」。LLMレビュアーが低リスクのコマンドを自動承認する）なので、標準の安全運用では手動へ切り替えます。
設定の安全性 > プライバシーとネットワークで「シークレットを伏せる」がオンであることを確認する。
コード編集を行うなら、安全性 > チェックポイントでファイルチェックポイントをオンにする。

安全設定の意味は安全に使う設定で詳しく扱います。チェックリストは安全に設定するための確認事項が便利です。

高度 ─ 用途ごとに作り込みたい

複数の用途を使い分けたい段階向けです。標準に次を足します。

速度や費用が気になるタスクだけ、補助モデルを別モデルに分離する。
業務継続が必要なら、別プロバイダーのフォールバックを1〜2個登録する。
外部ツールを使うならMCPを、作業手順を再利用するならスキルとプロファイルを設定する。

高度な構成は、必要が出てから一つずつ足すのが安全です。最初から全部やろうとしないでください。

つまずいたら

インストーラーが見つからない・古い: 第三者サイトではなく公式Downloadページから取得し直す。
hermes desktop が動かない: CLIが導入済みか、hermes にパスが通っているかを確認する。未導入なら公式インストーラーで入れる。
起動するがプロバイダーに繋がらない: ガイド付きセットアップをスキップした場合や表示されなかった場合も、設定画面から後で接続できる。詳細はプロバイダーを参照。
セットアップをやり直したい: 設定の詳細 > デスクトップと起動にある「オンボーディングをもう一度実行」を使う。
それでも起動しない: 問題の切り分けで症状から原因を絞り込む。

次の一歩

起動とモデル接続ができたら、いよいよ最初のチャットです。最初のチャットを成功させるに進み、安全に成功体験を積みましょう。

関連リファレンス: プロバイダー / ツールとキー