# よくある質問 (/ja/docs/verdent-for-vscode/help-support/faqs)

> Verdent for VS Codeに関するよくある質問



Verdentの機能、能力、使い方に関するよくある質問への回答です。

***

## はじめに [#はじめに]

<Tip>
  高度な機能に取り組む前に、クイックスタートガイドを完了してください。ドキュメント全体で登場する重要な概念を解説しています。
</Tip>

***

## よくある問題（トップ4） [#よくある問題トップ4]

<Accordion title="Verdent for VS Codeにログインできないのはなぜですか？">
  **最も多い原因：** プロキシ設定の問題

  **解決方法：**

  1. VS Codeの設定を開きます（macOS では `Cmd+,`、Windows/Linux では `Ctrl+,`）
  2. 「useProxy」または「verdent.enableProxy」を検索します
  3. プロキシ設定のオン/オフを切り替えます（現在の状態の逆にします）
  4. もう一度ログインを試します

  **説明：** 企業のファイアウォール内にいる場合は、プロキシ設定を有効にする必要があるかもしれません。家庭のネットワークを使用している場合は、無効にしてみてください。
</Accordion>

<Accordion title="無料トライアルのクレジットを受け取れなかったのはなぜですか？">
  **エラー：** 無料トライアルのクレジットを受け取れない、または無料トライアルへのアクセスが拒否された

  **理由：** 登録時に利用規約違反が検出されました

  **解決方法：** 無料トライアルへのアクセスについては [support@verdent.ai](mailto:support@verdent.ai) にお問い合わせください。サポートチームがアカウントを確認し、問題の解決をお手伝いします。
</Accordion>

<Accordion title="登録に失敗したのはなぜですか？">
  **エラー：** アカウント登録が拒否または制限された

  **理由：** 登録がVerdentの利用規約に違反したため、アクセスが制限されました

  **解決方法：** [support@verdent.ai](mailto:support@verdent.ai) にお問い合わせください。サポートチームが登録内容を確認し、問題解決のためのガイダンスを提供します。
</Accordion>

<Accordion title="Claude、GPT、Gemini のモデルが見つからないのはなぜですか？">
  **問題：** モデル選択メニューに特定の AI モデルが見つからない

  **理由：** モデルプロバイダーによる地域ベースの制限

  **説明：** 一部の AI モデルプロバイダー（Anthropic、OpenAI、Google）には地域制限があり、特定の地理的地域では特定のモデルが利用できません。この場合：

  * 制限されたモデルはモデル選択メニューに表示されません
  * 他の利用可能なすべてのモデルは中断なく使用できます
  * サブスクリプションやクレジットには影響しません

  **利用可能なモデルの確認：** お住まいの地域で利用可能なモデルを確認するには [https://www.verdent.ai/regions](https://www.verdent.ai/regions) にアクセスしてください

  **注：** 地域制限はVerdentではなく、AI モデルプロバイダーによって設定されています。Verdentはこれらの制限を上書きできません。
</Accordion>

***

<Accordion title="Visual Studio Codeとは何ですか？">
  Visual Studio Codeは、Microsoft が開発した無料のオープンソースコードエディタです。軽量でありながら強力な開発環境で、複数のプログラミング言語をサポートし、デバッグ、構文ハイライト、インテリジェントなコード補完、統合されたバージョン管理などの機能を提供します。Verdentは拡張機能としてVisual Studio Codeに直接統合され、既存のワークフローに AI 駆動のコーディング機能を追加します。
</Accordion>

<Accordion title="Verdent for VS Codeとは何ですか？">
  VerdentはVisual Studio Code向けの AI コーディングアシスタント拡張機能で、自然言語での対話を通じてコード生成、リファクタリング、デバッグ、プロジェクトのナビゲーションを支援します。

  **主な機能：**

  * ファイルツールによるコード生成と変更
  * 専用のサブエージェントによるコードベースの探索
  * bash 連携によるコマンド実行
  * ルールとMCPサーバーによるカスタム拡張
</Accordion>

<Accordion title="システム要件は何ですか？">
  **最小要件：**

  * Visual Studio Code 1.90.0 以降
  * 有効なVerdentサブスクリプション
  * インターネット接続

  **対応プラットフォーム：** macOS、Windows、Linux、WSL
</Accordion>

<Accordion title="インストール後、Verdentの使用を始めるにはどうすればよいですか？">
  1. VS CodeマーケットプレイスからVerdent拡張機能をインストールします
  2. プロンプトが表示されたらVerdentアカウントでサインインします
  3. 任意のコードファイルまたはプロジェクトを開きます
  4. Chat View を開いてVerdentとの対話を始めます

  **最初のタスクの提案：** プロジェクト構造の説明や特定のファイルのレビューをVerdentに依頼してみてください。
</Accordion>

<Accordion title="Visual Studio Codeのバージョンを確認するにはどうすればよいですか？">
  Visual Studio Codeを開き、**Help** → **About**（macOS では **Code** → **About Visual Studio Code**）を選択します。バージョン番号がダイアログに表示されます。VerdentにはVisual Studio Codeバージョン 1.90.0 以降が必要です。

  コマンドラインから確認することもできます：

  ```bash
  code --version
  ```
</Accordion>

<Accordion title="クレジットとは何ですか？">
  Verdent製品全体に共通するクレジット、料金体系、使用方法の基本については、[クレジットとプラン](/docs/account-billing/credits-and-plans)を参照してください。
</Accordion>

<Accordion title="クレジットを使い切るとどうなりますか？">
  共通のアカウントポリシーと回復方法については、[クレジットを使い切った場合の動作](/docs/account-billing/run-out-of-credits)を参照してください。
</Accordion>

<Accordion title="Verdentは私の画像を外部サーバーにアップロードしますか？">
  クリップボード経由で貼り付けた画像やファイルパスで参照された画像は、会話セッション内で処理されます。画像は永続的に保存されず、新しい会話を開始するとクリアされます。ファイルパス参照では、画像をアップロードせずにローカルで読み取ります。
</Accordion>

<Accordion title="Plan Modeとは何ですか？">
  Plan Modeは読み取り専用の実行モードで、Verdentがファイルを変更したりコマンドを実行したりせずに、コードを分析し、調査を行い、詳細な実装計画を作成します。計画を生成した後、Verdentは2つの選択肢を提示します。**Edit**（変更を依頼して計画を洗練させる）または **Start Building**（Agent Modeに切り替えて実行を開始する）です。エージェントは実行前に不確実性を取り除くため、明確化のための質問をすることができます。このモードは、変更を確定する前にアプローチを確認したい複雑なタスクに最適で、あなたの期待とVerdentの提案する解決策の間の整合性を確保します。
</Accordion>

<Accordion title="Plan Modeは実際に私のファイルにコードを書き込みますか？">
  **いいえ。** Plan Modeは厳密に読み取り専用です：

  * Verdentはファイルの読み取り、コードの検索、コードベースの分析ができます
  * Plan Mode中に**ファイルの書き込み、編集、削除は発生しません**
  * 計画は Chat View にのみ表示されます
  * コードの実行は、明示的に承認してAgent Modeに切り替えた後にのみ開始されます

  **安全性の保証：** Plan Modeが誤ってコードを変更することはありません。安全な探索と戦略の策定のために設計されています。
</Accordion>

<Accordion title="Plan ModeとAgent Modeを切り替えるにはどうすればよいですか？">
  **切り替えは Input Box から瞬時に行えます：**

  **Plan Modeに入るには：**

  * Input Box の **Switch Mode** ボタンを選択します
  * ドロップダウンから **Plan Mode** を選択します
  * または「Plan Modeに切り替えて」と伝えます

  **Plan Modeを終了するには：**

  * Input Box の **Switch Mode** ボタンを選択します
  * ドロップダウンから **Agent Mode** を選択します
  * または計画を確認した後に **Start Building** を選択します

  **モードの永続性：**

  * モードの選択は現在のセッション内で維持されます
  * 新しいセッションはデフォルトのAgent Modeで開始します
  * いつでも自由にモードを切り替えられます

  **典型的なワークフロー：** Plan Mode → 確認 → Agent Mode → 実行 → 次の複雑な機能のためにPlan Modeに戻る。
</Accordion>

<Accordion title="クリーンなコンテキストで新しい会話を始めるにはどうすればよいですか？">
  上部バーの「New Session」ボタンを選択します。これにより現在の会話履歴がクリアされ、次のタスクのためにVerdentに新しいコンテキストウィンドウが与えられます。
</Accordion>

<Accordion title="複数のプロジェクトで同時にVerdentを使用できますか？">
  はい、各VS Codeウィンドウは独立して動作します。複数のプロジェクトでVerdentを開くことができ、それぞれが独自の個別の会話コンテキストを維持します。
</Accordion>

<Accordion title="VerdentはGitHub、GitLab、Bitbucket、その他のGitプラットフォームで動作しますか？">
  はい。Verdentは標準的なGitコマンドを使用するため、ホスティングプラットフォームに関係なくあらゆるGitリポジトリで動作します。プルリクエストの作成にはVerdentが`gh` CLI を使用するためGitHubが必要ですが、その他すべてのGit操作はどこでも動作します。
</Accordion>

***

## ツールと機能 [#ツールと機能]

<Accordion title="Verdentはどのファイル形式を扱えますか？">
  **対応：** 以下を含むすべてのテキストベースのファイル形式：

  * ソースコード（JavaScript、Python、TypeScript、Java、Go など）
  * 設定ファイル（JSON、YAML、TOML、XML、ENV）
  * ドキュメント（Markdown、HTML、LaTeX）
  * ビルドファイル（package.json、Makefile、requirements.txt）

  **非対応：** バイナリファイル（画像、動画、PDF、コンパイル済みバイナリ、Office 文書）

  **回避策：** コード内でバイナリファイルを参照することはできますが、変更には外部ツールが必要です。
</Accordion>

<Accordion title="Verdentが最も得意とするプログラミング言語は何ですか？">
  **優れた対応：**

  * JavaScript、TypeScript、Python、React、Vue、Angular
  * Node.js、Go、Java/Spring、C#/.NET
  * Swift、Kotlin、Flutter

  **非常に良い対応：** Rust、C/C++、Ruby、R

  **良い対応：** PHP、Assembly、Julia

  一般的な言語は豊富なトレーニングデータにより、より強力なサポートを受けられます。
</Accordion>

<Accordion title="Verdentはどのようにファイルを読み取り、変更しますか？">
  3つのファイル操作ツール：

  * **file\_read：** 完全なファイルまたは特定の行範囲を読み取り
  * **file\_edit：** 特定のテキストパターンを置換（ターゲットを絞った変更）
  * **file\_write：** 新規ファイルの作成またはファイル全体の書き換え

  **ベストプラクティス：** 変更には`file_edit`を使用し、`file_write`は新規ファイルのみに使用します。
</Accordion>

<Accordion title="コマンド実行とは何ですか？">
  Verdentを通じてターミナルコマンドやシェルスクリプトを実行することで、テストの実行、パッケージのインストール、ビルドコマンドの実行などの操作を含みます。コマンド実行は、意図しないシステム変更を防ぐため、ほとんどの権限モードで承認が必要です。
</Accordion>

<Accordion title="Verdentは私のターミナルでコマンドを実行できますか？">
  はい、`bash`ツールを使用します。Verdentは次の条件でターミナルコマンドを実行できます：

  * 最大タイムアウト：120秒（2分）
  * `&&`によるコマンドの連結
  * クロスプラットフォーム対応（Unix では bash、Windows では PowerShell）

  **安全性：** コマンドはあなたのユーザー権限で実行されます。実行前に確認するにはManual Accept Modeを使用してください。
</Accordion>

<Accordion title="bash コマンドはどのくらいの時間実行できますか？">
  **最大タイムアウト：** 120秒（2分）

  2分を超えるコマンドは自動的に終了されます。より長い操作については、次を検討してください：

  **代替策：**

  * より小さなコマンドに分割：`bash("task1") && bash("task2")`
  * より小さな操作に分割
  * バックグラウンドで実行し、結果を別途確認
</Accordion>

<Accordion title="Multipass Generate-Test-Repair Cycle とは何ですか？">
  コードが包括的なテストに合格するまで、生成、テスト、修復を繰り返す反復的な検証プロセスです。Verdentは自動的にテストを実行し、失敗を分析し、問題を修正し、コードが正しく動作するまで複数のパスで再テストします。これにより、単なる提案ではなく、本番環境に対応したコードが提供されます。各結果には、変更内容を正確に示す詳細なサマリーとコードの差分が含まれます。
</Accordion>

<Check>
  Multipass のテストサイクルは、コードが合格するまで自動的に修正と再テストを繰り返します。これがVerdentが本番環境への対応を保証する方法です。
</Check>

***

## サブエージェントと実行 [#サブエージェントと実行]

<Accordion title="サブエージェントとは何で、いつ使うべきですか？">
  サブエージェントは、特定のタスク向けに分離されたコンテキストウィンドウを持つ専用の AI エージェントです。

  **組み込みサブエージェント：**

  * **@Explorer：** コードベースの検索、アーキテクチャに関する質問
  * **@Verifier：** 迅速な検証チェック
  * **@Code-reviewer：** セキュリティと品質のレビュー

  **使用すべき場面：** 調査、検証、レビューのタスクを委任して、メインの会話コンテキストを節約します。

  **カスタムサブエージェントの作成方法：**

  `~/.verdent/subagents/`に Markdown ファイルを作成します：

  ```markdown
  ---
  name: your-subagent
  description: Purpose description
  ---
  # System Prompt
  [Behavior definition and expertise]
  ```

  **ユースケース：** ドメイン固有の専門知識（金融、ヘルスケア）、チームのワークフロー、技術スペシャリスト。
</Accordion>

<Accordion title="コンテキストの汚染とは何ですか？">
  コンテキスト内の以前のアクションや情報が、将来のタスクに影響を与える意図しない動作パターンを生み出すことです。たとえば、コードを繰り返し更新してデプロイすると、単に実験しているだけでも、エージェントがすべてのコード更新を即時のデプロイと関連付け始めることがあります。サブエージェントは分離されたコンテキストウィンドウで動作することでコンテキストの汚染を防ぎ、各専用タスクがクリーンなコンテキストで開始でき、異なる種類の作業間での相互汚染を回避します。
</Accordion>

<Accordion title="現在どの実行モードにいるかを知るにはどうすればよいですか？">
  Verdentパネルの下部にある入力ボックスを確認してください。「Switch Permission」ボタンに現在のモード（例：「Manual」「Auto」「Plan」）が表示されます。それを選択してモードを切り替えられます。
</Accordion>

<Accordion title="Auto-Run ModeとManual Accept Modeの違いは何ですか？">
  **Auto-Run Mode：**

  * ファイル操作が承認なしで自動的に実行されます
  * コマンドは依然として許可が必要です
  * 信頼できるコードベースでより高速なワークフロー
  * バージョン管理された個人プロジェクトに最適

  **Manual Accept Mode：**

  * 保護された各操作を確認して承認します
  * 共有コードベースや本番環境でより安全
  * 実行前に何が実行されるかを正確に確認できます

  設定またはコマンドパレットからモードを切り替えます。
</Accordion>

<Accordion title="安全な操作とは何ですか？">
  変更を加えずにデータを読み取るだけの操作で、ファイルの読み取りや Web 検索が該当します。これらはAuto-Run Modeで自動的に承認されますが、ファイルの編集やコマンドの実行は安全のため依然として承認が必要です。
</Accordion>

<Accordion title="複数の権限モードを同時に使用できますか？">
  いいえ、権限モードは相互に排他的です。一度に1つだけ使用できます：

  * **Manual Accept** - デフォルト、最大限の制御
  * **Auto-Run** - 信頼できるプロジェクト向けに効率化
  * **Plan** - 読み取り専用の計画モード
  * **Skip Permissions** - 完全な自律性

  Input Box の **Switch Permission** ボタンから瞬時にモードを切り替えられます。ほとんどのユーザーは、タスクのコンテキストに基づいてモードを切り替えます（例：複雑な機能にはPlan Mode、迅速な修正には Auto-Run）。
</Accordion>

<Accordion title="Explorer エージェントを使うべき場合と、ファイルを直接読み込むべき場合はどちらですか？">
  メインのコンテキストを消費せずに発見や検索のタスクを行う場合は Explorer エージェントを使用します。変更が必要な場合のみ @メンションでファイルを直接読み込みます。Explorer は「～するすべてのファイルを見つける」という質問に最適で、@メンションは「この特定のファイルを更新する」というタスク向けです。
</Accordion>

<Accordion title="自分のプロジェクト用にカスタムサブエージェントを作成できますか？">
  はい！`~/.verdent/subagents/`にカスタムサブエージェントを作成します：

  ```markdown
  ---
  name: your-subagent
  description: Purpose description
  ---
  # System Prompt
  [Behavior definition and expertise]
  ```

  **ユースケース：** ドメイン固有の専門知識（金融、ヘルスケア）、チームのワークフロー、技術スペシャリスト。
</Accordion>

<Accordion title="複数ステップのタスクの途中でVerdentを停止できますか？">
  はい。いつでも実行を中断できます。Verdentは現在取り組んでいるステップを完了してから停止します。その時点までの進捗は保持されます。完了した内容を確認し、調整を加えて、続行するか別のアプローチを取ることができます。
</Accordion>

<Accordion title="長いタスクでVerdentが今何をしているかを知るにはどうすればよいですか？">
  ToDo リストを確認してください。リアルタイムのステータスが表示され、常に1つの項目が「進行中」とマークされます。アクティブな項目にはVerdentが現在取り組んでいる内容が正確に表示されます。完了した項目には完了マークが付き、保留中の項目には残りの作業が表示されます。
</Accordion>

<Accordion title="Verdentは私の変更を自動的にコミットしますか？">
  いいえ。Verdentは明示的に依頼した場合にのみコミットを作成します。変更をいつコミットするかは完全にあなたが制御できます。準備ができたら「すべての変更をステージしてコミットを作成して」と依頼するだけです。
</Accordion>

<Accordion title="Verdentは確認なしでリモートリポジトリにプッシュしますか？">
  いいえ。Verdentは明示的に依頼した場合にのみリモートリポジトリにプッシュします。すべてのGit操作（commit、push、merge、rebase）は安全のため、あなたの明示的な指示が必要です。
</Accordion>

***

## カスタマイズと連携 [#カスタマイズと連携]

<Accordion title="チーム向けにVerdentの動作をカスタマイズするにはどうすればよいですか？">
  3つのカスタマイズ方法：

  1. **VERDENT.md：** 個人のグローバル設定（`~/.verdent/VERDENT.md`）
  2. **AGENTS.md：** プロジェクト固有のチーム標準（プロジェクトルート、バージョン管理対象）
  3. **plan\_rules.md：** Plan Modeの出力形式（`~/.verdent/plan_rules.md`）

  チームの一貫性のため、AGENTS.md は VERDENT.md を上書きします。
</Accordion>

<Accordion title="設定変更はいつ反映されますか？">
  ほとんどのVerdentの設定は、再起動なしですぐに適用されます：

  * **権限モード：** Input Box から瞬時に切り替え
  * **モデルプリセット：** 次のリクエストに適用
  * **ルールファイル：** 新しい会話に適用（保存で再読み込みがトリガーされます）
  * **サブエージェント：** 作成後すぐに利用可能
  * **キーボードショートカット：** VS Codeで保存後に適用

  **例外：** VS Code拡張機能の設定（`verdent.enableCheckpoints`など）はすぐに有効になりますが、完全に適用するにはファイルやセッションの再オープンが必要な場合があります。
</Accordion>

<Accordion title="MCPとは何で、どのように使いますか？">
  Model Context Protocol（MCP）は、外部ツールやサービスでVerdentを拡張します：

  **設定：** Settings → MCP Servers から`~/.verdent/mcp.json`

  **機能：**

  * データベース接続（PostgreSQL、MySQL、MongoDB）
  * クラウドサービス（AWS、Azure、GCP）
  * プロジェクト管理ツール（Jira、Linear）
  * CI/CD パイプライン（Jenkins、GitHub Actions）

  **ステータス：** MCP連携のドキュメントは開発中です。セットアップのサポートについては [support@verdent.ai](mailto:support@verdent.ai) にお問い合わせください。
</Accordion>

***

## ベストプラクティスとパフォーマンス [#ベストプラクティスとパフォーマンス]

<Tip>
  ユーザーセンターでクレジット使用量を監視し、消費パターンを追跡して、効率的にワークフローを最適化しましょう。
</Tip>

<Accordion title="トークンとは何ですか？">
  コンテキストウィンドウの測定単位です。トークンは AI モデルが処理するテキストの断片（単語、単語の一部、文字）を表します。コンテキストの制限は文字数や単語数ではなくトークンで測定され、一般的な会話では数千トークンを消費します。
</Accordion>

<Accordion title="何がコンテキストウィンドウにカウントされますか？">
  セッション内のすべて：会話内のすべてのメッセージ、コンテキストに読み込まれたファイルの内容、ツールの出力（grep/検索結果、ファイルの読み取り）、システムプロンプトと指示、そしてMCPサーバーの定義です。これらのそれぞれが、合計コンテキスト容量からトークンを消費します。
</Accordion>

<Accordion title="200K と 1M のコンテキストウィンドウの違いは何ですか？">
  標準モデル（Claude 4.5 Sonnet、Haiku、GPT-5、GPT-5-Codex、MiniMax-M2）は、ほとんどのタスクに十分な`200K`トークンのコンテキストウィンドウを持っています。Claude Sonnet 4.5 は、`1000+`ファイルを含む大規模なコードベース、複雑な複数ファイルのリファクタリング、長時間の開発セッション向けに、拡張された`1M`トークンのコンテキスト（5倍大きい）を提供します。`1M`のコンテキストは、入力が`200K`トークンを超えると自動的に有効になるか、明示的に選択できます。
</Accordion>

<Accordion title="安全にコンテキストに読み込めるファイル数はどのくらいですか？">
  固定のファイル制限はありません。ファイルサイズと合計トークン数によって異なります。`200K`のコンテキストでは、大きなファイル（それぞれ`>1000`行）を`20+`読み込むことは避けてください。現在のタスクに直接関連するファイルに集中してください。`@-mentions`を選択的に使用し、多くのサンプルファイルを読み込む代わりに`AGENTS.md`ドキュメントを活用してください。`1M`のコンテキストでは、ファイルの選択ははるかに重要でなくなります。
</Accordion>

<Accordion title="コンテキスト制限に近づいているかどうかを知るにはどうすればよいですか？">
  兆候には、応答時間の遅延、数時間にわたるセッションの実行、多数の大きなファイルの読み込みなどがあります。セッションの長さとファイル数を監視してください。パフォーマンスの低下に気づいたら、現在のタスクを完了し、進捗をコミットして、クリーンなコンテキストで新しいセッションを開始してください。
</Accordion>

<Accordion title="コンテキストウィンドウの枯渇を避けるにはどうすればよいですか？">
  **戦略：**

  1. **戦略的なファイルの読み取り：** 大きなファイルには行範囲を使用
  2. **サブエージェントへの委任：** バックグラウンドの調査には Explorer/Verifier を使用
  3. **読み取り前に検索：** 関連するファイルを特定するには`grep_file`を使用
  4. **操作の分割：** 複数ステップのタスクを追跡するには`todo_update`を使用

  **経験則：** 500行を超えるファイルには行範囲を使用すべきです。
</Accordion>

<Accordion title="コンテキストは手動でリセットすべきですか、それともVerdentが自動的に行いますか？">
  コンテキストをリセットするには手動で新しいセッションを開始する必要があります。Verdentは自動的にコンテキストをクリアしません。ベストプラクティス：作業のアトミックな単位を完了し、テストし、バージョン管理にコミットした後にリセットします。`1M`トークンのコンテキストでは、リセットの必要性ははるかに少なくなります。
</Accordion>

<Accordion title="コンテキストをリセットすると作業が失われますか？">
  いいえ。コンテキストのリセットは、会話履歴とメモリに読み込まれたファイルをクリアするだけです。実際のコードの変更、コミット、ファイルの変更は保持されます。安全のため、コンテキストをリセットする前に必ず作業をバージョン管理にコミットしてください。リセット → 新しいセッションを開始 → 次のタスクの作業を続行。
</Accordion>

<Accordion title="プロンプトはどのくらい具体的にすべきですか？">
  あいまいさを排除できる程度に具体的にしますが、明白な詳細を過度に説明する必要はありません。次を含めます：正確なファイルパス、実装アプローチ、期待される結果、制約。悪い例：「コードを修正して」- 漠然としすぎ。良い例：「`ContactForm.js`のメールフィールドに入力検証を追加して、無効なメール形式を拒否して」- 明確な範囲と目標。迷ったら、より具体的にする方を選びましょう。
</Accordion>

<Accordion title="@メンションと自動ファイル読み込みの違いは何ですか？">
  Verdentはプロンプト内で名前で言及されたファイルと、同じディレクトリ内の関連ファイルを自動的に読み込みます。`@-mentions`（`@filename.js`）は、ファイルがコンテキストに含まれることを明示的に保証します。これは、密結合されたファイルを扱う場合、あるファイルのパターンを別のファイルに適用するために参照する場合、または大規模なコードベースで自動検出がコンテキストを見逃す可能性がある場合に重要です。「～と同じパターンに従って」とVerdentに依頼する際は、正確なコード参照を確保するため、必ず`@-mentions`を使用してください。
</Accordion>

<Accordion title="セッション中、すべてのプロンプトでプロジェクトのコンテキストを繰り返す必要がありますか？">
  いいえ。Verdentはセッション内で会話のコンテキストを維持するため、すでに説明したアーキテクチャの詳細や規約を繰り返す必要はありません。ただし、重要な制約がある場合や、セッションが長くなった場合（`100+`メッセージ）は、重要なコンテキストを再度述べてください。より良いアプローチ：技術スタック、コーディング標準、パターンなどの永続的なコンテキストを文書化するためにプロジェクトルール（`AGENTS.md`）を使用すれば、それらを繰り返す必要は決してありません。
</Accordion>

<Accordion title="Verdentが私のプロンプトを正しく理解または従わない場合はどうすればよいですか？">
  反復的な改善を使用します：出力を確認し、何が間違っているかを特定し、フォローアップのプロンプトで修正を提供します。例：「検証ロジックは良いですが、手動チェックの代わりに Joi スキーマ検証を使用してください。`ProductController.js`の検証パターンに合わせてください。」説明を求めることもできます：「Context API の代わりに Redux を使ったのはなぜですか？」と尋ね、理解に基づいて改善します。同じプロンプトを繰り返さず、何が失敗したかに基づいて調整してください。
</Accordion>

<Accordion title="通常モードの代わりにPlan Modeを使うべきはどんなときですか？">
  Plan Modeは次の場合に使用します：大規模なリファクタリングやアーキテクチャの変更、実行前に範囲を確認したい複数ファイルの変更、要件が不確かな複雑なタスク、または実装前にVerdentに明確化のための質問をしてもらいたい場合。Plan Modeを省略する場合：シンプルで明確に定義されたタスク、迅速なバグ修正、ルーチン操作。Plan Modeはオーバーヘッドが増えますが、複雑な作業での高くつくミスを防ぎます。
</Accordion>

<Accordion title="タスクに適したモデルプリセットを選ぶにはどうすればよいですか？">
  モデルプリセットをタスクの複雑さと予算に合わせます：

  **Efficiency を使用（Sonnet より3.2倍効率的）：**

  * 迅速なバグ修正とシンプルなコード生成
  * ルーチン操作と高頻度のタスク
  * 深さよりも速度が重要な場合

  **Balance を使用（1x ベースライン）- デフォルト：**

  * 一般的な開発と日常的なコーディング
  * 機能の実装とコードレビュー
  * ほとんどのシナリオでバランスの取れたパフォーマンス

  **Performance を使用（0.5x の効率、2倍のコスト）：**

  * 複雑なアーキテクチャの決定
  * 広範なコンテキストを必要とする大規模なコードベース（200k 以上のトークン）
  * 高度なデバッグとリファクタリング

  **プロのヒント：** ほとんどのユーザーは Balance をデフォルトのまま使用し、コンテキスト制限に達したときや深い推論が必要なときにのみ Performance に切り替えます。
</Accordion>

***

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

<Accordion title="ファイアウォールや接続の問題をトラブルシューティングするにはどうすればよいですか？">
  Verdentが AI サービスに接続できない場合は、以下の一般的な問題を確認してください：

  **基本的な接続性のテスト：**

  * アクティブなインターネットアクセスがあることを確認
  * 他の HTTPS サービスにアクセスして、アウトバウンド接続が機能することを確認

  **企業/エンタープライズ環境：**

  * ネットワーク管理者に連絡してVerdentのAPIエンドポイントをホワイトリストに追加
  * ファイアウォールを通じてアウトバウンド HTTPS トラフィックが許可されていることを確認
  * プロキシサーバーがAPIリクエストを通過させるよう適切に構成されているか確認
  * SSL/TLS 検査ではVerdentエンドポイントに例外が必要な場合があります

  **一般的な症状：**

  * 拡張機能がハングまたはタイムアウトしているように見える
  * 正しい認証情報にもかかわらず認証に失敗する

  ファイアウォールの構成後も問題が続く場合は、ホワイトリストに追加する具体的なエンドポイントの詳細についてVerdentサポートにお問い合わせください。
</Accordion>

<Accordion title="AGENTS.md のルールが適用されません。なぜですか？">
  **確認事項：**

  * **場所：** ファイルがプロジェクトルートディレクトリにあるか
  * **構文：** 有効な Markdown か
  * **具体性：** ルールが指示的であるか（「～してみて」ではなく「常に～する」）
  * **新規テスト：** 適用をテストするために新しい会話を開始

  **優先順位：** プロジェクト固有の動作では AGENTS.md が VERDENT.md を上書きします。
</Accordion>

<Accordion title="'file_edit failed to find exact match' エラーを修正するにはどうすればよいですか？">
  **原因：**

  * 最後の読み取り以降にテキストが変更された
  * 空白の違い（スペース対タブ）
  * 文字列がファイル内で一意でない

  **解決方法：**

  * ファイルを再度読み取って現在の内容を取得
  * 一意性のためにより大きなコンテキスト文字列を提供
  * 複数の同一文字列には`replace_all=true`を使用
  * file\_path が正しいことを確認
</Accordion>

<Accordion title="カスタムサブエージェントが自動的に呼び出されないのはなぜですか？">
  **確認事項：**

  * **場所：** ファイルが`~/.verdent/subagents/[name].md`にあるか
  * **呼び出しポリシー：** 厳格なポリシーでは明示的な @メンションが必要
  * **YAML フロントマター：** 有効な構文か
  * **「使用すべき場面」のガイドライン：** リクエストのパターンに一致しているか

  **テスト：** サブエージェントが動作することを確認するには、明示的な @メンションを使用します：`@your-subagent do task`
</Accordion>

***

## 関連項目 [#関連項目]

<CardGroup cols="2">
  <Card title="ツールリファレンス" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    完全なツール機能
  </Card>

  <Card title="トラブルシューティング" icon="triangle-exclamation" href="/docs/verdent-for-vscode/help-support/common-issues">
    よくある問題と解決方法
  </Card>
</CardGroup>