# 設定とカスタマイズ (/ja/docs/verdent-for-vscode/configuration/settings)
> ワークフローに合わせて Verdent をカスタマイズする
Verdent for VS Code には、開発ワークフロー、コーディングの好み、チーム標準に合わせて調整できる豊富な設定オプションがあります。VS Code のネイティブ設定インターフェースから各種設定を構成し、キーボードショートカットをカスタマイズし、専用の動作を定義するルールやサブエージェントを作成できます。
### このページで学べること [#このページで学べること]
* Verdent 向けに VS Code の拡張機能設定を構成する
* 効率的なワークフローのためにキーボードショートカットをカスタマイズする
* エージェントの動作をパーソナライズするルールを作成・管理する
* 専門タスク向けのカスタムサブエージェントを構築する
### 前提条件 [#前提条件]
* Verdent for VS Code がインストールされ、認証済みであること
* VS Code の設定にアクセスできること（`Cmd+,` または `Ctrl+,`）
* ルールファイル用の JSON の基本的な理解（任意）
***
## VS Code 拡張機能の設定 [#vs-code-拡張機能の設定]
Verdent for VS Code の設定は、設定の種類とスコープに応じて複数の場所からアクセスします。
### 設定へのアクセス [#設定へのアクセス]
**拡張機能の設定（VS Code ネイティブ）:**
1. VS Code の設定を開きます: `Cmd+,`（macOS）または `Ctrl+,`（Windows/Linux）
2. 設定の検索バーで「Verdent」を検索します
3. 拡張機能の設定を変更します（例: `verdent.enableCheckpoints`）
**Verdent 固有の設定:**
Verdent の上部バーにある **Settings** ボタンを選択すると、次にアクセスできます。
* **Rules** - User Rules、Project Rules、Plan Rules
* **MCP Servers** - Model Context Protocol の設定
* **Subagents** - カスタムサブエージェントの管理
**チャット内のコントロール:**
多くの設定は、Verdent パネル下部の入力ボックスから直接切り替えられます。
* **Switch Permission** - Manual Accept、Auto-Run、Plan、Skip Permissions
* **Switch Mode** - Agent、Plan、Chat の各モード
* **Switch/Customize AI Model** - Performance、Balance、Efficiency のプリセット
* **Think Hard Mode** - 複雑な推論のための最大思考予算
* **Add Context** - @メンションでファイルを添付
* **Add Images or Files** - スクリーンショットやドキュメントを追加
* **Add Subagent** - 専用サブエージェントに委任
設定の変更は VS Code を再起動することなく即座に反映されます。
***
## 利用可能な拡張機能の設定 [#利用可能な拡張機能の設定]
Verdent for VS Code には、VS Code の設定インターフェースから構成できる **2 つの中核的な拡張機能設定** があります。
| 設定 | 型 | デフォルト | 説明 |
| --------------------------- | --------- | ------ | -------------------------------------------------------------------------------- |
| `verdent.enableCheckpoints` | `boolean` | `true` | 拡張機能が git を使ってタスク中のワークスペースのチェックポイントを保存できるようにします。大きなワークスペースではパフォーマンスに影響する場合があります。 |
| `verdent.enableProxy` | `boolean` | `true` | ネットワーク接続でのプロキシサポートを有効にします。企業のファイアウォールやプロキシサーバー経由で利用するユーザーに必要です。 |
これらが Verdent 向けの VS Code 拡張機能設定のすべてです。その他の設定オプション（Rules、Subagents、MCP Servers）は、拡張機能の上部バーにある Verdent の Settings メニューから管理します。
***
## 入力ボックスのコントロールリファレンス [#入力ボックスのコントロールリファレンス]
Verdent パネル下部の入力ボックスからは、各種設定コントロールにすばやくアクセスできます。
| コントロール | 用途 | オプション |
| ----------------------------- | ------------------- | ------------------------------------------------------------- |
| **Add Context** | @メンションでファイルを添付 | @filename、@foldername |
| **Add Images or Files** | スクリーンショットやドキュメントを追加 | 画像、PDF、テキストファイルをアップロード |
| **Add Subagent** | 専用エージェントに委任 | @Verifier、@Explorer、@Code-reviewer、カスタムサブエージェント |
| **Switch Mode** | 実行モードを切り替え | Agent Mode、Plan Mode、Chat Mode |
| **Switch/Customize AI Model** | モデルプリセットまたは特定モデルを選択 | Performance（コスト 1〜2 倍）、Balance（コスト 1 倍）、Efficiency（コスト 0.3 倍） |
| **Think Hard Mode** | 拡張推論を有効化 | 複雑な問題に対してオン/オフを切り替え |
| **Switch Permission** | 権限レベルを変更 | Manual Accept（デフォルト）、Auto-Run、Plan、Skip Permissions |
### 権限モード [#権限モード]
* すべての操作に承認が必要
* 完全な可視性とコントロール
* 学習、不慣れなコードベース、本番コードに最適
* コマンドには承認が必要、ファイル操作は自動
* 権限プロンプトを削減
* 信頼できるプロジェクト、ラピッドプロトタイピングに最適
* 読み取り専用の分析と計画立案
* 計画立案中はコードを変更しない
* 複雑な変更、アーキテクチャの意思決定に最適
* 承認プロンプトなしで完全に自律実行
* 最速の実行だがリスクは最も高い
* 自動化環境、CI/CD に最適
### モデルプリセット [#モデルプリセット]
* **コスト:** ベースラインの 1 倍
* **モデル:** Claude-4.5-sonnet
* **最適な用途:** 一般的な開発、日常的なコーディング、機能実装
* **コスト:** Balance ベースラインの 1〜2 倍
* **モデル:** Claude-4.5-sonnet-1m（1M トークンのコンテキスト）
* **最適な用途:** 複雑なアーキテクチャ、大規模コードベース、200k トークンを超えるタスク
* **コスト:** Sonnet より 3.2 倍効率的（クレジット 70% 節約）
* **モデル:** Claude-4.5-haiku
* **最適な用途:** 簡単な修正、シンプルなタスク、定型的な操作
***
## キーボードショートカットのカスタマイズ [#キーボードショートカットのカスタマイズ]
### デフォルトのショートカット [#デフォルトのショートカット]
**主要ショートカット:**
* **macOS:** `Cmd+L` - Verdent パネルを開く/フォーカス
* **Windows/Linux:** `Ctrl+L` - Verdent パネルを開く/フォーカス
* コマンド: `verdent.addToChat`
* コマンドパレットおよびエディタのコンテキストから動作
これは、コーディングの流れを中断することなく、VS Code 内のどこからでもすばやく Verdent にアクセスするための必須ショートカットです。
**追加コマンド:**
コマンドパレットから利用可能（デフォルトのショートカットはカスタマイズ可能）:
* `verdent.addFeedBack` - フィードバックを送信
* `verdent.addTerminalOutputToChat` - ターミナル出力を Verdent に追加
* `verdent.addToChatBySearch` - 検索で Verdent に追加
* `verdent.centerButtonClicked` - ユーザーセンター
* `verdent.historyButtonClicked` - プロジェクト履歴
* `verdent.mcpButtonClicked` - MCP Server を追加
* `verdent.openInNewTabByParams` - 新しいタブで開く
* `verdent.plusButtonClicked` - 新しいセッション
* `verdent.rulesButtonClicked` - ルール設定
* `verdent.SettingClicked` - 設定メニュー
* `verdent.subagentButtonClicked` - サブエージェントを追加
### ショートカットのカスタマイズ [#ショートカットのカスタマイズ]
Verdent のすべてのキーボードショートカットは、VS Code の標準的なキーバインドシステムでカスタマイズできます。
ほとんどのユーザーに推奨 - ショートカットを管理するためのビジュアルインターフェースです。
`Cmd+K Cmd+S`（macOS）または `Ctrl+K Ctrl+S`（Windows/Linux）を押します
検索ボックスに「Verdent」と入力して Verdent のコマンドを絞り込みます
任意のコマンドの横にある鉛筆アイコンを選択し、希望のキーの組み合わせを押して、Enter を押して保存します
上級ユーザー向け - 直接 JSON で設定でき、バージョン管理にも適しています。
`Cmd+Shift+P`（macOS）または `Ctrl+Shift+P`（Windows/Linux）を押します
「Preferences: Open Keyboard Shortcuts (JSON)」と入力して選択します
```json macOS
{
"key": "cmd+shift+v",
"command": "verdent.addToChat"
}
```
```json Windows/Linux
{
"key": "ctrl+shift+v",
"command": "verdent.addToChat"
}
```
**カスタマイズの範囲:**
* すべての Verdent コマンドを再割り当て可能
* 同じコマンドに複数のショートカットを割り当て可能
* デフォルトのショートカットを削除可能
* 変更は VS Code の Settings Sync で複数のマシン間で同期
### プラットフォーム別のショートカット [#プラットフォーム別のショートカット]
Verdent は VS Code のプラットフォーム別キーボード規約に従います。
| プラットフォーム | 修飾キーのパターン |
| ----------------- | ----------------------------- |
| **macOS** | 主要ショートカットは `Cmd`、代替は `Option` |
| **Windows/Linux** | 主要ショートカットは `Ctrl`、代替は `Alt` |
**一般的なパターン:**
* 設定: `Cmd+,`（macOS）vs `Ctrl+,`（Windows/Linux）
* コマンドパレット: `Cmd+Shift+P`（macOS）vs `Ctrl+Shift+P`（Windows/Linux）
* Keyboard Shortcuts: `Cmd+K Cmd+S`（macOS）vs `Ctrl+K Ctrl+S`（Windows/Linux）
***
## カスタム指示とペルソナ [#カスタム指示とペルソナ]
Verdent for VS Code は AI の動作をカスタマイズする 2 つの仕組みをサポートしています。好みやガイドラインを定義する **Rules** と、専門タスク向けのペルソナを定義する **Subagents** です。
### ルールシステム [#ルールシステム]
ルールは、コーディングセッション中に Verdent がどのように動作・応答するかを定義します。ルールは Markdown ファイルに保存され、会話を通じて継続的に適用されます。
#### 3 種類のルール [#3-種類のルール]
**1. User Rules（VERDENT.md）:**
* **場所:** `~/.verdent/`（グローバル設定ディレクトリ）
* **スコープ:** すべてのプロジェクトのすべての会話に適用
* **目的:** 個人のコーディングの好み、コミュニケーションスタイル、ドキュメント標準
**2. Project Rules（AGENTS.md）:**
* **場所:** プロジェクトのルートディレクトリまたはワークスペース
* **スコープ:** 現在のプロジェクトにのみ適用
* **バージョン管理:** チーム全体の標準として git にコミット可能
* **目的:** プロジェクト固有のコーディング標準、アーキテクチャパターン、テスト要件
**3. Plan Rules（plan\_rules.md）:**
* **場所:** `~/.verdent/`（グローバル設定ディレクトリ）
* **スコープ:** すべてのプロジェクトで Plan Mode を使う際に適用
* **目的:** 計画の内容、形式、詳細度をカスタマイズ
#### ルールの作成と編集 [#ルールの作成と編集]
Verdent の上部バーにある **Settings** ボタンを選択し、ドロップダウンから **Rules** を選択します
必要に応じて **User Rules**、**Project Rules**、**Plan Rules** を選択します
ルールファイルは VS Code エディタで開きます。Markdown 形式で明確かつ指示的な内容を記述します
ファイルを保存します。ルールは現在および今後のセッションで即座に適用されます。再起動は不要です
**User Rules の例:**
```markdown
# Code Style Preferences
- Always use functional React components with hooks
- Prefer TypeScript over JavaScript
- Add JSDoc comments for all exported functions
- Provide explanations before showing code
```
**Project Rules の例:**
```markdown
## Testing instructions
- Run `pnpm turbo run test --filter ` to run all checks
- Fix test and type errors until suite is green
- Add or update tests for code changes
## PR instructions
- Title format: []
- Always run `pnpm lint` and `pnpm test` before committing
```
#### ルールの保存と適用 [#ルールの保存と適用]
| ルールの種類 | 場所 | スコープ | バージョン管理 |
| ------------- | -------------------------- | --------------------- | ----------------- |
| User Rules | `~/.verdent/VERDENT.md` | すべてのプロジェクト | 個人用、共有されない |
| Project Rules | `<project>/AGENTS.md` | 現在のプロジェクト | チームの一貫性のためにコミット可能 |
| Plan Rules | `~/.verdent/plan_rules.md` | すべてのプロジェクト（Plan Mode） | 個人用、共有されない |
**設定の優先順位:**
ルールが競合する場合、Verdent は次の優先順位で適用します。
1. **Project Rules（AGENTS.md）** - 最優先（プロジェクト固有）
2. **User Rules（VERDENT.md）** - グローバルなユーザー設定
3. **デフォルトの動作** - Verdent の組み込みデフォルト
<Tip>
AGENTS.md をバージョン管理にコミットすると、プロジェクト固有のコーディング標準をチーム全体で共有できます。各メンバーのワークスペースは自動的にプロジェクトルールに従いつつ、VERDENT.md で個人の好みを維持できます。
</Tip>
***
## Subagents [#subagents]
サブエージェントは、特定のタスクを処理するためのカスタムシステムプロンプトと独立したコンテキストウィンドウを持つ専用 AI エージェントです。
### 組み込みサブエージェント [#組み込みサブエージェント]
Verdent には、設定なしですぐに利用できる 3 つのデフォルトサブエージェントが含まれています。
<Tabs>
<Tab title="@Verifier">
* 迅速なコードチェックと検証
* フルレビューなしの高速バリデーション
* 用途: 簡易な動作確認、構文チェック、コミット前チェック
</Tab>
<Tab title="@Explorer">
* 高速なコードベースの探索とナビゲーション
* ファイルをすばやく見つけ、コードベースに関する質問に回答
* 用途: 不慣れなコードベースの探索、コンポーネントの発見、構造の理解
</Tab>
<Tab title="@Code-reviewer">
* 即時のコード品質評価
* セキュリティ、保守性、パフォーマンスの問題を特定
* 用途: コミット前レビュー、セキュリティ監査、パフォーマンス最適化
</Tab>
</Tabs>
### カスタムサブエージェントの作成 [#カスタムサブエージェントの作成]
<Steps>
<Step title="サブエージェント設定にアクセス">
Verdent の上部バーで **Settings** → **Subagents** を選択します
</Step>
<Step title="新しいサブエージェントを作成">
新しいサブエージェントを作成するか、`~/.verdent/subagents/` に移動して YAML フロントマター付きの Markdown ファイルを作成します
</Step>
<Step title="サブエージェントの動作を定義">
サブエージェントの性格、解釈スタイル、タスクへのアプローチを定めるシステムプロンプトを記述します
</Step>
<Step title="呼び出しポリシーを指定">
サブエージェントをいつ使うか（厳格な呼び出しか柔軟な呼び出しか）を定義します
</Step>
</Steps>
**サブエージェントのファイル形式:**
```markdown
---
name: security-reviewer
description: Security-focused code review specialist
---
# System Prompt
You are a security-focused code reviewer. When analyzing code:
- Prioritize security vulnerabilities (SQL injection, XSS, auth flaws)
- Use skeptical, critical tone - assume code is vulnerable until proven otherwise
- Provide specific remediation steps with code examples
- Reference OWASP Top 10 and security best practices
- Never approve code with unresolved security issues
Invocation policy (strict): Only run security-reviewer if user explicitly requests it.
When to use the security-reviewer agent:
- User requests security review of authentication/authorization logic
- User asks to audit code for vulnerabilities
- User needs security assessment before deployment
When NOT to use:
- General code review without security focus
- Opening or reading files without analysis
```
### サブエージェントの管理 [#サブエージェントの管理]
**Settings → Subagents** から次のことができます。
* **Edit:** システムプロンプト、ツール権限、設定を変更
* **Copy:** バリエーションやテンプレート用にサブエージェントを複製
* **Delete:** 使用していないサブエージェントを削除
* **Enable/Disable:** 削除せずに利用可否を切り替え
### サブエージェントの使用 [#サブエージェントの使用]
**組み込みサブエージェント:**
* @メンションで参照: `@Verifier`、`@Explorer`、`@Code-reviewer`
* 適切なタスクタイプが検出されると自動的に呼び出される
**カスタムサブエージェント:**
* 入力ボックスの **Add Subagent** ボタンを選択
* ドロップダウンから選択
* メインエージェントが適切なタスクを自動的に委任
### サブエージェントとルールの違い [#サブエージェントとルールの違い]
| 観点 | Rules | Subagents |
| ----------- | ----------------- | --------------------- |
| **適用タイミング** | 継続的に、すべての応答で | 特定タスクに対してオンデマンド |
| **コンテキスト** | 共有のメインコンテキストウィンドウ | 独立した別個のコンテキスト |
| **動作** | 好みとガイドライン | タスク固有の動作ペルソナ |
| **呼び出し** | 常に有効 | 自動または手動での委任 |
| **目的** | 何を好むかを定義する | 誰がどのようにタスクを処理するかを定義する |
**ワークフローの例:**
1. **User Rule:** 「すべての新規関数にユニットテストを生成する」
2. **メインエージェント:** テスト生成の必要性を検出
3. **Test Generator サブエージェントに委任:** 専門的で包括的なテストアプローチ
4. **サブエージェント:** 独立したコンテキストで完全なテストスイートを生成
5. **メインエージェント:** 結果を受け取り、コンテキストを汚染せずに続行
<Tip>
Settings → Subagents の **Copy** ボタンを使うか、`~/.verdent/subagents/` からサブエージェントの Markdown ファイルを直接共有することで、チームメンバーとサブエージェントを共有できます。
</Tip>
***
## FAQ（よくある質問） [#faqよくある質問]
<Accordion title="設定変更はいつ反映されますか？">
ほとんどの Verdent 設定は、再起動なしで即座に反映されます。
* **権限モード:** 入力ボックスから即座に切り替え
* **モデルプリセット:** 次のリクエストに適用
* **ルールファイル:** 新しい会話に適用（保存でリロードがトリガーされる）
* **サブエージェント:** 作成後すぐに利用可能
* **キーボードショートカット:** VS Code で保存後に適用
**例外:** VS Code の拡張機能設定（`verdent.enableCheckpoints` など）は即座に反映されますが、完全に適用するにはファイルやセッションを開き直す必要がある場合があります。
</Accordion>
<Accordion title="ルールとサブエージェントの違いは何ですか？">
**Rules** はグローバルに「何を好むか」を定義します。
* すべての会話に継続的に適用
* コーディング標準、コミュニケーションスタイル、好み
* Markdown ファイルに保存（VERDENT.md、AGENTS.md、plan\_rules.md）
* 常にバックグラウンドで有効
**Subagents** は「誰が」「どのように」特定のタスクを処理するかを定義します。
* 特定のタスクタイプに対してオンデマンドで呼び出し
* カスタムシステムプロンプトを持つ専門的な動作ペルソナ
* 独立したコンテキストウィンドウ（メインコンテキストを汚染しない）
* @メンションによる自動または手動の委任
**例:** ルールは「新規関数にユニットテストを生成する」と定めます。Test Generator サブエージェントが、包括的なテスト手法で実際のテスト作成を担います。
</Accordion>
<Accordion title="複数の権限モードを同時に使えますか？">
いいえ、権限モードは排他的で、一度に 1 つしか使用できません。
* **Manual Accept** - デフォルト、最大限のコントロール
* **Auto-Run** - 信頼できるプロジェクト向けに合理化
* **Plan** - 読み取り専用の計画立案モード
* **Skip Permissions** - 完全な自律実行
入力ボックスの **Switch Permission** ボタンから即座にモードを切り替えられます。多くのユーザーはタスクの状況に応じてモードを切り替えています（例: 複雑な機能には Plan Mode、簡単な修正には Auto-Run）。
</Accordion>
<Accordion title="タスクに合ったモデルプリセットはどう選べばよいですか？">
モデルプリセットはタスクの複雑さと予算に合わせて選びます。
**Efficiency を使う場合（Sonnet より 3.2 倍効率的）:**
* 簡単なバグ修正やシンプルなコード生成
* 定型的な操作や高頻度のタスク
* 深さよりも速度が重要なとき
**Balance を使う場合（ベースラインの 1 倍）- デフォルト:**
* 一般的な開発や日常的なコーディング
* 機能実装やコードレビュー
* ほとんどの場面でバランスの取れたパフォーマンス
**Performance を使う場合（効率 0.5 倍、コスト 2 倍）:**
* 複雑なアーキテクチャの意思決定
* 広範なコンテキスト（200k トークン以上）を要する大規模コードベース
* 高度なデバッグやリファクタリング
**プロのヒント:** ほとんどのユーザーは Balance をデフォルトのまま使い、コンテキストの上限に達したときや深い推論が必要なときだけ Performance に切り替えます。
</Accordion>
***
## 関連項目 [#関連項目]
<CardGroup cols="2">
<Card title="プラン優先のワークフロー" icon="sitemap" href="/docs/verdent-for-vscode/configuration/plan-workflows">
AI 支援によるタスク計画と承認ワークフローを構成する
</Card>
<Card title="設定の最適化" icon="sliders" href="/docs/verdent-for-vscode/configuration/tuning">
速度、コスト、パフォーマンスの最適化に向けて設定を調整する
</Card>
</CardGroup>