クイックスタートガイド

このクイックスタートガイドでは、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 をインストールする

Verdent 拡張機能ページを開き、Install を選択します。

Visual Studio Code を開きます
Ctrl+Shift+X（macOS では Cmd+Shift+X）を押します
「Verdent」を検索します
Install を選択します

code --install-extension verdentai.verdent

ステップ2: Verdent を使い始める

Visual Studio Code を開く

プロジェクトフォルダで Visual Studio Code を開きます。

Verdent にアクセスする

サイドバーの Verdent アイコンを選択するか、Ctrl+L（Windows/Linux）/ Cmd+L（macOS）を押します。

サインインする

プロンプトが表示されたら、Verdent アカウントでサインインして認証します。

ステップ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: 最初のコード変更を行う

次に、Verdent に何かを作成させてみましょう。次のシンプルなタスクを試してください。

Create a hello_world.txt file with a greeting message

何が起こるか:

Verdent が変更を提案する作成されるファイルとその内容を示すプレビューが表示されます
許可リクエスト Auto Run Mode（デフォルト）では、Verdent がファイル作成時に自動承認します
承認する 「Accept」を選択するか、変更を承認します
ファイル作成 Verdent がファイルを作成し、完了を確認します

許可の仕組み:

Manual Accept Mode は、承認なしに不要な変更が行われないようにします。次の操作で許可プロンプトが表示されます。

ファイルの編集と作成
コマンドの実行
ツールの使用（各ツールタイプの初回使用時）

これにより完全にコントロールでき、さまざまなタスクで Verdent がどのような操作を行うかを学べます。

Manual Accept Mode は新規ユーザーにおすすめの出発点です。慣れてきたら、別のワークフローに合わせて Auto-Run Mode や Plan Mode に切り替えられます。

ステップ5: 複雑なタスクに Plan Mode を使う

Plan Mode は Verdent の読み取り専用の計画モードで、実行前にアプローチをレビューできます。試してみましょう。

Plan Mode に切り替える:

入力ボックスの Switch Mode ボタンを選択し、Plan Mode を選択します

計画タスクを試す:

Suggest ways to build a website for my project

何が起こるか:

Verdent がプロジェクトを分析するファイルを読み取り、プロジェクトの構造と要件を理解します
詳細な計画を作成する使用する技術、作成するページ、ウェブサイトの構成方法を示します
変更なしPlan Mode は読み取り専用です。明示的に承認するまで Verdent はファイルを変更できません
対話的な確認Verdent は計画を確定する前に、デザインの好み、ターゲット層、機能について質問することがあります

Plan Mode を使う理由:

安全な探索 - 誤った変更をせずに馴染みのないコードベースを理解する
コードレビュー - 変更を加える前に品質とアーキテクチャを分析する
戦略的な計画 - 複雑なタスクをレビュー可能なステップに分解する
不確実性の低減 - Verdent が明確化のための質問をして曖昧さを取り除く

実行に取りかかる前にアプローチをレビューしたいタスクには、すべて Plan Mode を使いましょう。Verdent がコードベースをどう捉えているかを学ぶ際には特に役立ちます。

計画を実行するには:

計画をレビューした後、Verdent は2つの選択肢を提示します。

Edit を選択して変更を依頼したり、明確化のための質問をしたりする
Start Building を選択して Agent Mode に切り替え、実行を開始する

ステップ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 を使う

完全には理解していないコードを扱うときは、まず 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」がリストに表示されることを確認します。

解決策:

インターネット接続が有効か確認します
ファイアウォール/プロキシ設定が Verdent サービスへの HTTPS を許可しているか確認します
User Center にクレジット残高が残っているか確認します
より簡単なプロンプトで接続をテストしてみます

解決策: 「Switch Permission」ボタンで Auto-Run Mode に切り替えます。これにより安全な読み取り操作は自動承認され、ファイル編集とコマンドは引き続き承認を求められます。

ヘルプを受ける

Discord コミュニティ: https://discord.com/invite/NGjXEZcbJq - リアルタイムサポートが受けられる活発なコミュニティ
ドキュメント: このドキュメント内の他のガイドを参照する
フィードバック: Verdent の上部バーにある Feedback ボタンで問題を報告したり改善を提案したりする

よくある質問

現在どの実行モードにいるか確認するには？

Verdent パネル下部の入力ボックスを見てください。「Switch Permission」ボタンに現在のモード（例: 「Manual」「Auto」「Plan」）が表示されます。選択するとモードを切り替えられます。

クレジットを使い切るとどうなりますか？

クレジットベースの標準リクエストは、残高がゼロになると停止します。次の請求サイクルでの更新を待つか、一回限りのクレジットのチャージを購入して続行してください。

複数のプロジェクトで同時に Verdent を使えますか？

はい。各 VS Code ウィンドウは独立して動作します。複数のプロジェクトで Verdent を開いておくことができ、それぞれが独自の会話コンテキストを保持します。

クリーンなコンテキストで新しい会話を始めるには？

上部バーの「New Session」ボタンを選択します。これにより現在の会話履歴がクリアされ、次のタスクのために Verdent に新しいコンテキストウィンドウが与えられます。