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

> Verdent のインストールとセットアップを順を追って解説するガイド



このガイドでは、Visual Studio Code Marketplace から Verdent for VS Code をインストールし、初回認証を完了するまでの手順を説明します。

***

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

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

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

* **Visual Studio Code**: バージョン 1.90.0 以上
* **オペレーティングシステム**: macOS 11以上、Windows 10以上、または Linux（Ubuntu 20.04以上、Debian 10以上、RHEL 8以上）
* **インターネット接続**: AI サービスとの通信にアクティブな接続が必要です

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

* **Git**: バージョン管理との連携とコード変更の追跡に使用します

詳しい互換性情報は [システム要件](/docs/verdent-for-vscode/getting-started/system-requirements) を参照してください。

***

## 拡張機能のインストール [#拡張機能のインストール]

Verdent for VS Code は Visual Studio Code Marketplace を通じて配布されています。

<Tabs>
  <Tab title="VS Code Marketplace">
    <Steps>
      <Step title="Marketplace にアクセス">
        ブラウザで [Verdent 拡張機能ページ](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) を開きます。
      </Step>

      <Step title="Install をクリック">
        Marketplace ページで **Install** ボタンをクリックします。
      </Step>

      <Step title="VS Code で開く">
        VS Code が自動的に開き、インストール処理が始まります。
      </Step>
    </Steps>
  </Tab>

  <Tab title="拡張機能パネル">
    <Steps>
      <Step title="VS Code を開く">
        コンピューターで Visual Studio Code を起動します。
      </Step>

      <Step title="拡張機能を開く">
        左サイドバーの拡張機能アイコン（4つの四角形のアイコン）をクリックするか、次のショートカットを押します。

        * **macOS**: `Cmd+Shift+X`
        * **Windows/Linux**: `Ctrl+Shift+X`
      </Step>

      <Step title="Verdent を検索">
        拡張機能パネル上部の検索ボックスに「Verdent」と入力します。検索結果から Verdent AI が提供する「Verdent」を探します。
      </Step>

      <Step title="インストール">
        Verdent 拡張機能の横にある **Install** ボタンをクリックします。通常、インストールは数秒で完了します。
      </Step>
    </Steps>
  </Tab>

  <Tab title="コマンドライン">
    ```bash
    code --install-extension verdentai.verdent
    ```

    この方法は次のような場合に便利です。

    * 自動化されたセットアップスクリプト
    * SSH 経由のリモートサーバーへのインストール
    * CI/CD 環境の設定
    * 複数のマシンへの一括インストール
  </Tab>
</Tabs>

<Tip>
  VS Code の Settings Sync を使用している場合、拡張機能リストを同期すると、新しいマシンに Verdent が自動的にインストールされます。
</Tip>

***

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

インストール後、拡張機能を使い始めるには Verdent アカウントで認証する必要があります。

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

<Steps>
  <Step title="Verdent を開く">
    インストール後、VS Code のサイドバーにある Verdent アイコンをクリックします。Sign In / Sign Up のオプションが表示されます。
  </Step>

  <Step title="サインイン">
    **Sign In** をクリックします。VS Code に「Do you want Code to open the external website?」というポップアップが表示されるので、**Open** をクリックします。
  </Step>

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

  <Step title="VS Code を承認">
    プロンプトが表示されたら、Verdent アカウントへの VS Code のアクセスを許可します。
  </Step>

  <Step title="VS Code に戻る">
    認証が完了したら VS Code に戻ります。Verdent パネルに入力インターフェースが表示されるようになります。
  </Step>
</Steps>

**所要時間の目安:** インストールとセットアップ全体で2〜3分です。

### 初期設定（任意） [#初期設定任意]

Verdent for VS Code は、認証後すぐに使えるよう設計されており、最小限の設定で利用できます。

**デフォルト設定:**

* **権限モード**: Auto-Run Mode（安全な操作を自動承認）
* **モデルプリセット**: Balance（パフォーマンスとコストの最適なバランス）
* **コンテキスト管理**: 自動

**任意のカスタマイズ:**

これらの設定は後から Verdent パネルで調整できます。

* **権限モード** - Manual Accept、Auto-Run、Plan Mode、Skip Permissions から選択します
* **モデル選択** - Performance、Balance、Efficiency のプリセット、または特定のモデルを選択します
* **ワークスペース設定** - プロジェクト固有の設定を構成します

<Note>
  ほとんどのユーザーは、サインイン後に追加設定なしですぐに Verdent を使い始められます。詳細設定は必要に応じて調整できます。
</Note>

***

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

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

### 見た目での確認 [#見た目での確認]

1. **サイドバーアイコン** - VS Code のサイドバー（左側）に Verdent アイコンがあるか確認します
2. **拡張機能リスト** - 拡張機能パネル（`Cmd+Shift+X` / `Ctrl+Shift+X`）を開き、「Verdent」がチェックマーク付きでインストール済みと表示されていることを確認します

### 動作の確認 [#動作の確認]

<Steps>
  <Step title="Verdent パネルを開く">
    サイドバーの Verdent アイコンをクリックするか、`Cmd+L`（macOS）/ `Ctrl+L`（Windows/Linux）を押します。
  </Step>

  <Step title="テストプロンプトを送信">
    入力ボックスに「Explain what this workspace contains」のような簡単なリクエストを入力してみます。
  </Step>

  <Step title="応答を受け取る">
    Verdent がワークスペースを解析し、数秒以内に応答を返します。
  </Step>
</Steps>

**成功を示す目安:**

* サイドバーに Verdent アイコンが表示されている
* アカウントの認証に成功している
* プロンプトを送信して応答を受け取れる

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

確認に失敗した場合は、次の解決策を試してください。

| 問題               | 解決策                                |
| ---------------- | ---------------------------------- |
| サイドバーアイコンが表示されない | VS Code を再起動するか、拡張機能の更新を確認します      |
| プロンプトに応答がない      | インターネット接続とファイアウォール設定を確認します         |
| 拡張機能が見つからない      | VS Code のバージョンが1.90.0以上であることを確認します |

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

***

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

<CardGroup cols="2">
  <Card title="クイックスタート" icon="rocket" href="/docs/verdent-for-vscode/getting-started/quick-start">
    Verdent で最初のタスクを5分で完了します
  </Card>

  <Card title="コアコンセプト" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    サブエージェント、実行モード、マルチエージェントアーキテクチャを理解します
  </Card>
</CardGroup>