# クイックスタートガイド (/ja/docs/verdent-for-vscode/getting-started/quick-start)
> Verdent を数分で使い始める
このクイックスタートガイドでは、15分以内に Verdent の Plan-Verify-Code ワークフローを使えるようになります。拡張機能をインストールし、最初のタスクを完了して、Verdent for VS Code を使う際のコアワークフローを理解します。
### 学べること [#学べること]
* マーケットプレイスから Verdent for VS Code をインストールする
* 認証してセットアップを確認する
* AI 支援による最初のタスクを完了する
* 実行モード（Manual Accept、Auto-Run、Plan Mode）を理解する
* 日々のコーディングに欠かせない機能を使う
### 前提条件 [#前提条件]
始める前に、次のものを用意してください。
* システムに Visual Studio Code がインストールされていること
* 有効なインターネット接続
* 有効な Verdent サブスクリプションアカウント（または7日間の無料トライアルから開始）
***
## ステップ1: Verdent をインストールする [#ステップ1-verdent-をインストールする]
[Verdent 拡張機能ページ](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) を開き、**Install** を選択します。
1. Visual Studio Code を開きます
2. `Ctrl+Shift+X`（macOS では `Cmd+Shift+X`）を押します
3. 「Verdent」を検索します
4. **Install** を選択します
```bash
code --install-extension verdentai.verdent
```
***
## ステップ2: Verdent を使い始める [#ステップ2-verdent-を使い始める]
プロジェクトフォルダで Visual Studio Code を開きます。
サイドバーの Verdent アイコンを選択するか、`Ctrl+L`（Windows/Linux）/ `Cmd+L`（macOS）を押します。
プロンプトが表示されたら、Verdent アカウントでサインインして認証します。
***
## ステップ3: 最初のタスク [#ステップ3-最初のタスク]
まずは、Verdent がワークスペースをどのように理解するかを示す、シンプルで非破壊的なタスクから始めましょう。
**VS Code でプロジェクトを開き**、Verdent の入力ボックスで次のプロンプトのいずれかを試してください。
```
What kind of project is this?
```
Verdent はワークスペースの構造を分析し、主要なファイルを読み取って、どのような種類のアプリケーションを扱っているかを説明します。これは変更を加えずにコンテキストを把握する様子を示しています。
**次のような動作が確認できます。**
* Verdent がワークスペース内のファイルを分析する
* プロジェクトの種類、技術、構造の要約
* ファイルの変更なし（読み取り専用の分析）
**次のフォローアッププロンプトも試してください。**
```
Explain what this project does
```
```
What dependencies does this project have?
```
```
Show me the main entry point of this application
```
これらのプロンプトはいずれも、Verdent がワークスペースにアクセスでき、コードベースを理解していることを確認するのに役立ちます。
これらの探索的なプロンプトは、馴染みのないコードベースを理解するのに最適です。Verdent は手動でコンテキストを追加しなくても、必要に応じてファイルを読み取ります。
***
## ステップ4: 最初のコード変更を行う [#ステップ4-最初のコード変更を行う]
次に、Verdent に何かを作成させてみましょう。次のシンプルなタスクを試してください。
```
Create a hello_world.txt file with a greeting message
```
**何が起こるか:**
1. **Verdent が変更を提案する**作成されるファイルとその内容を示すプレビューが表示されます
2. **許可リクエスト** Auto Run Mode（デフォルト）では、Verdent がファイル作成時に自動承認します
3. **承認する** 「Accept」を選択するか、変更を承認します
4. **ファイル作成** Verdent がファイルを作成し、完了を確認します
**許可の仕組み:**
Manual Accept Mode は、承認なしに不要な変更が行われないようにします。次の操作で許可プロンプトが表示されます。
* ファイルの編集と作成
* コマンドの実行
* ツールの使用（各ツールタイプの初回使用時）
これにより完全にコントロールでき、さまざまなタスクで Verdent がどのような操作を行うかを学べます。
Manual Accept Mode は新規ユーザーにおすすめの出発点です。慣れてきたら、別のワークフローに合わせて Auto-Run Mode や Plan Mode に切り替えられます。
***
## ステップ5: 複雑なタスクに Plan Mode を使う [#ステップ5-複雑なタスクに-plan-mode-を使う]
Plan Mode は Verdent の読み取り専用の計画モードで、実行前にアプローチをレビューできます。試してみましょう。
**Plan Mode に切り替える:**
入力ボックスの **Switch Mode** ボタンを選択し、**Plan Mode** を選択します
**計画タスクを試す:**
```
Suggest ways to build a website for my project
```
**何が起こるか:**
1. **Verdent がプロジェクトを分析する**ファイルを読み取り、プロジェクトの構造と要件を理解します
2. **詳細な計画を作成する**使用する技術、作成するページ、ウェブサイトの構成方法を示します
3. **変更なし**Plan Mode は読み取り専用です。明示的に承認するまで Verdent はファイルを変更できません
4. **対話的な確認**Verdent は計画を確定する前に、デザインの好み、ターゲット層、機能について質問することがあります
**Plan Mode を使う理由:**
* **安全な探索** - 誤った変更をせずに馴染みのないコードベースを理解する
* **コードレビュー** - 変更を加える前に品質とアーキテクチャを分析する
* **戦略的な計画** - 複雑なタスクをレビュー可能なステップに分解する
* **不確実性の低減** - Verdent が明確化のための質問をして曖昧さを取り除く
実行に取りかかる前にアプローチをレビューしたいタスクには、すべて Plan Mode を使いましょう。Verdent がコードベースをどう捉えているかを学ぶ際には特に役立ちます。
**計画を実行するには:**
計画をレビューした後、Verdent は2つの選択肢を提示します。
* **Edit** を選択して変更を依頼したり、明確化のための質問をしたりする
* **Start Building** を選択して Agent Mode に切り替え、実行を開始する
***
## ステップ6: 実行モードを理解する [#ステップ6-実行モードを理解する]
Verdent は、さまざまなワークフローに合わせた複数の実行モードを提供します。
**許可モード:**
| モード | 説明 | 使う場面 |
| -------------------- | ------------------------------------------------ | ------------------------- |
| **Manual Accept** | 各ツールの初回使用時に許可を求める | 最大限のコントロールで学習や一般的な開発を行う場合 |
| **Auto-Run**（デフォルト） | 安全な操作（ファイル読み取り、Web検索）を自動承認する。ファイル編集とコマンドはなお承認が必要 | 信頼できるプロジェクトや迅速なプロトタイピング |
| **Plan Mode** | ファイルを変更せずに分析と計画を行う読み取り専用モード | 複雑なタスクやコードレビュー |
| **Skip Permissions** | すべてのプロンプトをバイパスする完全自律動作 | 自動テストやサンドボックスなど隔離された安全な環境 |
**追加モード:**
* **Think Hard Mode** - 複雑な推論やアーキテクチャ上の判断のための最大の思考予算
Skip Permissions Mode はすべての安全チェックを無効にします。失敗しても影響のない、隔離された使い捨て環境でのみ使用してください。
***
## 主要なアクション [#主要なアクション]
Verdent for VS Code で日々使う主要なアクションは次のとおりです。
| アクション | アクセス方法 | 説明 |
| ----------- | ---------------------------------- | --------------------------------------- |
| Verdent を開く | `Cmd+L` / `Ctrl+L` またはサイドバーアイコンを選択 | Verdent パネルを開く |
| 新規セッション | 上部バーの「New Session」を選択 | クリーンなコンテキストで新しい会話を開始する |
| コンテキストの追加 | 「Add Context」ボタンを選択 | @メンションでファイルを参照する |
| 画像の追加 | 「Add Images or Files」ボタンを選択 | スクリーンショット、モックアップ、図をアップロードする |
| モードの切り替え | 「Switch Mode」ボタンを選択 | Agent/Plan/Chat モードを切り替える |
| モデルの変更 | モデルセレクターを選択 | Performance/Balance/Efficiency プリセットを選ぶ |
| Think Hard | 「Think Hard Mode」ボタンを選択 | 複雑なタスクに対して拡張推論を有効にする |
| 許可の切り替え | 「Switch Permission」ボタンを選択 | 許可モードを変更する |
| 履歴の表示 | 上部バーの「Project History」を選択 | 過去のセッションを参照する |
| User Center | 上部バーの「User Center」を選択 | クレジット残高とアカウント情報を確認する |
| 設定 | 上部バーの「Settings」を選択 | MCP サーバー、サブエージェント、ルールを設定する |
***
## 初心者向けの便利なヒント [#初心者向けの便利なヒント]
変更を加える前に、Verdent にコードベースを理解させましょう。
```
Analyze the database schema
```
```
Explain the authentication flow
```
これにより Verdent のプロジェクトに関するコンテキストが構築され、より良い提案ができるようになります。
「fix the bug」ではなく、
「fix the login bug in `LoginForm.tsx` where users see a blank screen after entering wrong credentials」のように書きましょう。
具体的なプロンプトはより正確な解決につながり、反復回数も減らせます。
完全には理解していないコードを扱うときは、まず Plan Mode を使いましょう。
```
Refactor the authentication module to use async/await instead of callbacks
```
計画をレビューし、**Edit** を選択して明確化のための質問をして調整し、確信が持てたら **Start Building** を選択します。
複数ステップの機能では、段階的に進めましょう。
```
1. Create a new database table for user profiles
```
完了後に次のように続けます。
```
2. Create an API endpoint to get and update profiles
```
これにより明確さを保ち、各ステップを検証できます。
必要に応じてファイルを明示的に参照しましょう。
```
@components/UserProfile.tsx refactor this component to use hooks
```
これにより、Verdent がタスクに対して適切なコンテキストに集中できます。
Verdent には3つの組み込みサブエージェントが含まれています。
* `@Explorer` - 高速なコードベース探索とファイル検出
* `@Verifier` - 迅速なコード検証とチェック
* `@Code-reviewer` - 包括的なセキュリティと品質のレビュー
例:
```
@Explorer find all API endpoints in this project
```
***
## よくある問題 [#よくある問題]
**解決策:** VS Code を再起動します。それでも表示されない場合は、拡張機能パネル（`Cmd+Shift+X` / `Ctrl+Shift+X`）でインストールを確認し、「Verdent」がリストに表示されることを確認します。
**解決策:**
1. インターネット接続が有効か確認します
2. ファイアウォール/プロキシ設定が Verdent サービスへの HTTPS を許可しているか確認します
3. User Center にクレジット残高が残っているか確認します
4. より簡単なプロンプトで接続をテストしてみます
**解決策:** 「Switch Permission」ボタンで Auto-Run Mode に切り替えます。これにより安全な読み取り操作は自動承認され、ファイル編集とコマンドは引き続き承認を求められます。
***
## ヘルプを受ける [#ヘルプを受ける]
* **Discord コミュニティ**: [https://discord.com/invite/NGjXEZcbJq](https://discord.com/invite/NGjXEZcbJq) - リアルタイムサポートが受けられる活発なコミュニティ
* **ドキュメント**: このドキュメント内の他のガイドを参照する
* **フィードバック**: Verdent の上部バーにある Feedback ボタンで問題を報告したり改善を提案したりする
***
## よくある質問 [#よくある質問]
Verdent パネル下部の入力ボックスを見てください。「Switch Permission」ボタンに現在のモード（例: 「Manual」「Auto」「Plan」）が表示されます。選択するとモードを切り替えられます。
クレジットベースの標準リクエストは、残高がゼロになると停止します。次の請求サイクルでの更新を待つか、一回限りのクレジットのチャージを購入して続行してください。
はい。各 VS Code ウィンドウは独立して動作します。複数のプロジェクトで Verdent を開いておくことができ、それぞれが独自の会話コンテキストを保持します。
上部バーの「New Session」ボタンを選択します。これにより現在の会話履歴がクリアされ、次のタスクのために Verdent に新しいコンテキストウィンドウが与えられます。
***
## 次のステップ [#次のステップ]
Verdent をインストールし、最初のタスクを完了して、コアワークフローを学びました。次に進む先は次のとおりです。
サブエージェント、マルチエージェントアーキテクチャ、コンテキスト管理を理解する
複数ステップのタスク、大規模なコードベース、バージョン管理の手順別ガイド