# インストール (/ja/docs/verdent-manager/getting-started/installation)

> Verdent のインストールとセットアップを手順ごとに解説するガイド



このガイドでは、Verdent のダウンロード、プラットフォーム別のインストール、そして Verdent アカウントでの認証までを順を追って説明します。

***

## 動作要件 [#動作要件]

Verdent をインストールする前に、システムが次の前提条件を満たしていることを確認してください。

### システム要件 [#システム要件]

* **オペレーティングシステム**: macOS 11 以上、または Windows 10 以上（64 ビット）。互換性の詳細は [対応オペレーティングシステム](/docs/verdent-manager/getting-started/supported-operating-systems) を参照してください。
* **Git**: バージョン 2.20 以上。Verdent はワークスペースの分離に Git worktree を使用します。プロジェクトフォルダが Git リポジトリである必要はありませんが、一部の機能では Git が必要で、必要に応じて Verdent がリポジトリの初期化をガイドする場合があります。
  * **macOS:** Git は Xcode Command Line Tools に同梱されています。`xcode-select --install` でインストールするか、Homebrew を使用します: `brew install git`。
  * **Windows:** [git-scm.com/download/win](https://git-scm.com/download/win) から公式インストーラーをダウンロードし、デフォルトのオプションのまま進めます。
  * ターミナルで `git --version` を実行して確認します。
* **インターネット接続**: AI サービスとの通信のためにアクティブな接続が必要です

### 任意（ただし推奨） [#任意ただし推奨]

* **ディスク容量**: 2 GB 以上の空き（大規模なリポジトリ、worktree、キャッシュ用にさらに多くを推奨）

***

## ダウンロード [#ダウンロード]

Verdent は公式サイトからダウンロードします:

**[verdent.ai/download](https://verdent.ai/download)**

お使いのオペレーティングシステムを選択し、適切なインストーラーをダウンロードします。

***

## macOS へのインストール [#macos-へのインストール]

<Steps>
  <Step title="ダウンロード">
    [verdent.ai/download](https://verdent.ai/download) から `.dmg` ファイルをダウンロードします
  </Step>

  <Step title="DMG を開く">
    ダウンロードした `.dmg` ファイルをダブルクリックしてマウントします
  </Step>

  <Step title="インストール">
    Verdent のアイコンを Applications フォルダにドラッグします
  </Step>

  <Step title="起動">
    Applications を開き、Verdent をダブルクリックします
  </Step>

  <Step title="セキュリティの承認">
    プロンプトが表示された場合は、**System Settings → Privacy & Security**（macOS 13 以上）または **System Preferences → Security & Privacy**（それ以前の macOS）を開き、**Open Anyway** をクリックします
  </Step>
</Steps>

**対応 macOS バージョン:**

* macOS 11（Big Sur）以降
* Intel および Apple Silicon に対応

***

## Windows へのインストール [#windows-へのインストール]

<Steps>
  <Step title="ダウンロード">
    [verdent.ai/download](https://verdent.ai/download) から `.exe` インストーラーをダウンロードします
  </Step>

  <Step title="インストーラーの実行">
    ダウンロードした `.exe` ファイルをダブルクリックします
  </Step>

  <Step title="UAC プロンプト">
    ユーザーアカウント制御のプロンプトが表示されたら **Yes** をクリックします
  </Step>

  <Step title="インストールオプション">
    インストーラーの指示に従います（ビルドによってはカスタムインストール先を指定できない場合があります）
  </Step>

  <Step title="完了">
    **Install** をクリックして完了を待ちます
  </Step>

  <Step title="起動">
    **Finish** をクリックして Verdent を起動するか、スタートメニューから見つけます
  </Step>
</Steps>

**対応 Windows バージョン:**

* Windows 10
* Windows 11
* 64 ビットのみ

***

## 認証とセットアップ [#認証とセットアップ]

インストール後、アプリケーションを使い始めるには Verdent アカウントで認証する必要があります。

### 初回認証 [#初回認証]

<Steps>
  <Step title="Verdent を起動">
    Applications（macOS）またはスタートメニュー（Windows）から Verdent を開きます。ウェルカム画面が表示されます。
  </Step>

  <Step title="サインイン">
    **Sign In** をクリックします。ブラウザが開き、Verdent の認証ページに移動します。
  </Step>

  <Step title="ブラウザでの認証">
    Verdent アカウントの資格情報（メール / パスワード、または Google や GitHub などの OAuth プロバイダー）でサインインします。
  </Step>

  <Step title="アプリに戻る">
    認証が完了したら Verdent に戻ります。メイン画面が表示されます。
  </Step>

  <Step title="プロジェクトを開く">
    **Open Project** を選択してディレクトリを選ぶか、再度利用する場合は **Recent Projects** を選択します。
  </Step>
</Steps>

***

## インストールの確認 [#インストールの確認]

次の簡単なチェックで、インストールが正しく動作していることを確認します。

### 視覚的な確認 [#視覚的な確認]

1. **アプリケーションアイコン** - Verdent が Applications（macOS）またはスタートメニュー（Windows）に表示される
2. **サインイン済み** - 認証後にアプリ内でアカウントの状態（アバターやメールなど）を確認できる

### 機能の確認 [#機能の確認]

<Steps>
  <Step title="プロジェクトを開く">
    Verdent でディレクトリを開きます。
  </Step>

  <Step title="テストプロンプトを送信">
    入力ボックスに「このプロジェクトには何が含まれているか説明して」のような簡単なリクエストを試します。
  </Step>

  <Step title="応答を受け取る">
    Verdent がプロジェクトを分析し、まもなく応答を返すはずです。
  </Step>
</Steps>

**成功の目安:**

* Verdent がエラーなく起動する
* アカウントの認証に成功している
* プロンプトを送信し、応答を受け取れる

<Warning>
  Verdent の AI 機能にはアクティブなインターネット接続が必要です。プロンプトに応答がない場合は、ネットワーク接続を確認し、ファイアウォールが Verdent の API エンドポイントへの外向き HTTPS を許可していることを確認してください。
</Warning>

***

## インストールのトラブルシューティング [#インストールのトラブルシューティング]

<Tabs>
  <Tab title="macOS のセキュリティ">
    **問題:** 「Verdent は開発元を確認できないため開けません」

    **解決策:**

    1. **System Settings → Privacy & Security**（macOS 13 以上）または **System Preferences → Security & Privacy**（それ以前の macOS）を開きます
    2. Verdent に関する警告メッセージを見つけます
    3. **Open Anyway** をクリックします
    4. **Open** をクリックして確定します
  </Tab>

  <Tab title="Windows Defender">
    **問題:** Windows Defender がインストールをブロックする

    **解決策:**

    1. SmartScreen のポップアップで **More info** をクリックします
    2. Verdent を公式サイトからダウンロードし、提供元を信頼できる場合は **Run anyway** をクリックします
    3. インストールを続行します
  </Tab>
</Tabs>

***

## よくある質問 [#よくある質問]

<AccordionGroup>
  <Accordion title="Verdent を VS Code 拡張機能と併用してインストールできますか？">
    はい。Verdent と VS Code 拡張機能は独立したアプリケーションです。両方を使用でき、同じクレジットプールとアカウントを共有します。
  </Accordion>

  <Accordion title="Verdent を更新するには？">
    Verdent は起動時に自動的に更新を確認します。更新が利用可能になると:

    1. 通知が表示されます
    2. **Update** をクリックしてダウンロードとインストールを行います
    3. アプリケーションを再起動します

    アプリのメニューから手動で確認することもできます（例: **Help → Check for Updates**）。
  </Accordion>

  <Accordion title="Verdent をアンインストールするには？">
    **macOS:** Verdent を Applications からゴミ箱にドラッグします

    **Windows:** **Settings → Apps → Verdent → Uninstall** または **Control Panel → Programs and Features** を使用します
  </Accordion>
</AccordionGroup>

***

## 次のステップ [#次のステップ]

<CardGroup cols="2">
  <Card title="クイックスタート" icon="rocket" href="/docs/verdent-manager/getting-started/quick-start">
    最初のプロジェクトを追加してタスクを割り当てる
  </Card>

  <Card title="Manager" icon="user-tie" href="/docs/verdent-manager/core-features/manager">
    Manager がどのように作業を計画、割り当て、追跡するかを学ぶ
  </Card>
</CardGroup>