設定の最適化

ワークフローの要件に応じて、速度・コスト・徹底度のバランスを取れるように Verdent for VS Code を最適化します。最適なパフォーマンスを得るために、モデルプリセット、実行モード、コンテキスト管理戦略を設定します。

最適化の対象

コストとパフォーマンスのバランスを取るためのモデルプリセット選択
ワークフロー効率化のための実行モード設定
大規模コードベース向けのコンテキスト管理
プロジェクトごと・ワークスペースごとのカスタマイズ

ワークフローに合わせた設定の調整

モデルプリセットの選択

タスクの複雑さと予算に応じて、適切なモデルプリセットを選択します。

プリセット	コスト	コスト効率	適した用途
Efficiency	約 0.3 倍 Balance（70% 削減）	Sonnet より 3.2 倍効率的	シンプルなタスク、簡単な修正、ラピッドプロトタイピング
Balance（デフォルト）	1 倍（基準）	1 倍（基準）	一般的な開発タスク、日常的なコーディング
Performance	1〜2 倍 Balance	効率 0.5 倍（コスト 2 倍、1M コンテキスト）	複雑なアーキテクチャ上の判断、込み入ったリファクタリング

追加モデル:

Claude-4.5-sonnet: バランスの取れた汎用モデル（1 倍基準）
Claude-4.5-sonnet-1m: 複雑なタスク向けの拡張コンテキスト（入力が 200k トークンを超えると効率 0.5 倍、コスト 2 倍）
Claude-4.5-haiku: 最速かつ最も経済的（Sonnet より 3.2 倍効率的）
GPT-5 / GPT-5-codex: 推論と創造性に重点（ベータ、Sonnet より 1.3 倍効率的）
Minimax-m2: 高速かつコスト効率的（ベータ、11 月 10 日まで無料）

実行モードの設定

承認プロンプトなしで完全に自律実行
権限に関する中断がない
最もリスクが高い — 自動化された環境でのみ使用してください

コマンドは承認が必要、ファイル操作は自動
権限プロンプトを削減
危険な操作には安全性を保ちつつ、リスクを低減

すべての操作に承認が必要
完全な可視性と制御
最も遅いが最も安全 — 学習や本番コードに最適

実行前の戦略的なプランニング
読み取り専用の分析フェーズ
変更前にレビューして承認

Think Hard Mode

複雑な推論タスクで有効にします。

徹底度: 高度な問題に対する最大の推論深度
速度: 拡張された思考予算により低下
適した用途: アーキテクチャ上の判断、複雑なデバッグ、込み入った分析

速度と徹底度のトレードオフ

タスクの要件に応じて、実行速度と分析深度のバランスを取ります。

設定:

モデル: Efficiency プリセット（Claude-4.5-haiku）
権限モード: Auto-Run Mode
実行モード: 直接実行のための Agent Mode
ユースケース: 簡単な修正、定型的な操作、シンプルなタスク

メリット:

最速の応答時間
中断を最小限に
Balance プリセットと比べて 70% のコスト削減

設定:

モデル: Performance プリセット（Claude-4.5-sonnet-1m）
権限モード: Manual Accept Mode
実行モード: 戦略的レビューのための Plan Mode
Think Hard: 高度な推論のために有効化
ユースケース: 複雑な機能、本番コード、アーキテクチャ上の判断

メリット:

最大のコンテキストウィンドウ（1M トークン）
完全な可視性と制御
複雑な問題に対する深い推論
実行前のレビュー

ほとんどのユーザーは、設定を切り替えながら使うことでメリットを得られます。

簡単な修正: Efficiency + Agent Mode
複雑な機能: Balance/Performance + Plan Mode
探索: 戦略立案には Plan Mode、実行には Agent Mode

戦略: 万能な 1 つの設定ではなく、タスクの種類に応じて設定を変えます。

信頼できるプロジェクトでは Auto-Run Mode を使うと、危険な操作への安全性を保ちながら権限プロンプトを削減できます。これにより、重要な保護を犠牲にせずワークフローを効率化できます。

ワークスペースレベルの設定

Verdent は、チーム全体で一貫性を保つために、プロジェクトごと・ワークスペースごとの設定をサポートします。

プロジェクト固有の設定

プロジェクトルール（AGENTS.md）:

場所: プロジェクトのルートディレクトリまたはワークスペースフォルダ
適用範囲: 現在のプロジェクトのみに適用
バージョン管理: チーム全体の標準として git にコミット
内容: コーディング標準、テスト要件、アーキテクチャパターン

例:

# Project Rules

## Code Standards
- Use TypeScript strict mode
- Generate unit tests for all new functions
- Follow MVC pattern

## Testing
- All endpoints require input validation
- Run tests before committing

VS Code のワークスペース設定

拡張機能の設定をワークスペースレベルで構成します。

場所: ワークスペースのルートにある .vscode/settings.json

例:

{
  "verdent.enableCheckpoints": true
}

設定の優先順位

設定が競合した場合、Verdent は次の優先順位を適用します。

プロジェクトルール（AGENTS.md） - 最優先（プロジェクト固有）
ワークスペース設定 - VS Code のワークスペースレベルの設定
ユーザールール（VERDENT.md） - グローバルなユーザー設定
デフォルト設定 - Verdent の組み込みデフォルト

プロジェクト固有のカスタマイズ

大規模プロジェクトのコンテキスト管理

複雑な操作を、別のコンテキストウィンドウを持つサブエージェントに委任します
メインのコンテキストを消費するのはサブエージェントの結果のみで、プロセス全体ではありません
メインコンテキストが実装の詳細で埋まるのを防ぎます

@filename を使って、関連するファイルだけを明示的に追加します
不必要にプロジェクト全体をコンテキストに読み込まない
焦点を絞った分析のために特定のコンポーネントを対象にします

大きなタスクを、完了可能な小さな単位に分割します
個別の機能やコンポーネントごとに新しいセッションを開始します
自然な区切りによってコンテキストの枯渇を防ぎます

実行コンテキストを消費する前にアプローチをレビューします
誤った実装で無駄になるコンテキストを削減します
Plan Mode は独立したコンテキスト管理を持ちます

パフォーマンスの最適化

チェックポイントを選択的に有効化:

verdent.enableCheckpoints の設定はバージョン管理に git を使用します。

非常に大きなリポジトリではパフォーマンスに影響する場合があります
チェックポイント機能が必要なときだけ有効にします
大規模コードベースで最大のパフォーマンスを得るには無効にします

チェックポイントは重要なタスクに限って選択的に有効にしてください。過剰なチェックポイントは、価値を加えることなくワークフローを遅くします。

モデルの選択:

シンプルで独立したタスクには Efficiency プリセット（Haiku）を使用
コンテキストの多い操作には Performance プリセット（Sonnet-1M）を確保
一般的な作業には Balance プリセット

実行モード:

Auto-Run Mode は権限プロンプトで消費されるコンテキストを削減します
Skip Permissions Mode は自動化された環境での効率を最大化します

複数ワークスペースのシナリオでは、ワークスペースを切り替えると適切なプロジェクトルールが自動的に適用されます。手動での設定切り替えは不要です。

複数ワークスペースの設定により、プロジェクトの種類（開発か本番か、モノレポかマイクロサービスか）ごとに設定を最適化できます。