> ## Documentation Index > Fetch the complete documentation index at: https://docs.devin.ai/llms.txt > Use this file to discover all available pages before exploring further. # Devin Local Agent > Devin DesktopでDevin Local agentを利用する。サブエージェント、サンドボックス、Plan mode、ワークツリー、permissionsを備えたDevin CLIのエージェントハーネスです。 Devin Localは、[Devin CLI](https://cli.devin.ai)と共通の次世代エージェントハーネスです。 お使いのマシン上で動作し、ローカルのファイル、ツール、環境にアクセスできます。Devin Desktopの主要なローカルエージェントです。 以前Cascadeを使用していた場合は、Command Paletteから**Devin: Open Cascade Migration Wizard**コマンドを実行すると、ガイドに従ってワークフローとMemoriesを一度に移行できます。
## 主な改善点
Cascade の初回リリース以降、モデルの性能は大きく向上しました。Devin Local は、こうした進歩を効率的に活用できるよう、ゼロから設計・構築されています。
### トークン効率
Devin Local agent は大幅にトークン効率が高く、特にプロンプトキャッシュを重視しています。ほとんどのタスクで、同じ結果を得るのに Cascade より最大30%少ないトークンで済みます。
### サブエージェント
Devin Local agent は、独立した[サブエージェント](/ja/cli/subagents)を起動し、サブタスクを処理できます。サブエージェントはフォアグラウンドまたはバックグラウンドで動作します。親エージェントとツールおよびコードベースの前提情報を共有しますが、それぞれ独自の会話チェーン内で動作します。 サブエージェントは、`Devin Settings` の **Subagents (Preview)** トグルで制御されます。 組み込みプロファイルに加えて、次のいずれかのレイアウトで、`agents/` 配下に Markdown ファイルとして独自のサブエージェントを定義できます。 * **フラットファイル** — `agents/.md`。ファイル名がプロファイルの識別子になります。 * **ディレクトリ** — `agents//AGENT.md`。ディレクトリ名がプロファイルの識別子になります。 これらのディレクトリが検出される場所とプロファイルの設定方法については、[サブエージェントのドキュメント](/ja/cli/subagents)を参照してください。
### サンドボックス
Devin Local agent は、OSレベルのサンドボックスをサポートしています。有効にすると、サンドボックスによって次の制御が適用されます。 * **ファイルシステムの分離** — 書き込み可能なパスは権限スコープに基づいて決まり、`Read(...)` の拒否ルールによりサンドボックス化されたコマンドからパスが非表示になります * **ネットワークフィルタリング** — ドメインの許可リストと拒否リストによって、エージェントがアクセスできる先を制御します Enterprise 管理者は、[チーム設定](https://cli.devin.ai/docs/enterprise/team-settings#sandbox-enforcement)を通じて、すべてのユーザーにサンドボックスモードを必須にしたり、組織全体のドメインフィルタリングルールを設定したりするなど、組織全体でサンドボックスの動作を強制できます。
### Quick Review
[Quick Review](/ja/desktop/quick-review) は、変更内容に対してすばやくフィードバックを得るための、Devin Local agent で利用できる専用のサブエージェントです。
## エージェントの切り替え
優先するエージェントを選択していない場合、新しいタブでは Devin Local が起動します。Devin Local を利用できない場合は、選択可能な最初の [ACP エージェント](/ja/desktop/acp) が使用されます。利用できるエージェントが 1 つもない場合は、デフォルトの新規タブ UI が表示され、いずれかが利用可能になるまで待機します。新しい会話が Cascade で開始されることはありませんが、既存の Cascade の会話は履歴やサイドバーから引き続き利用できます。Devin Desktop の右下にあるエージェントセレクターから、いつでも*新しい*会話で使用するエージェントを変更できます。Devin Local は接続中でも選択できます。
### エージェント設定
エージェントセレクターに Devin Local が表示されない場合は、`Devin Settings` で有効にする必要がある可能性があります。 1. `Cmd+Shift+P` (macOS) または `Ctrl+Shift+P` (Windows/Linux) で Command Palette を開きます 2. `Devin User Settings` を開きます 3. 「Agents」タブをクリックします 4. 「Devin Local」エージェントをオンにします 5. Devin Desktop を再起動します
### Enterprise 管理者
Devin Local は、Devin Desktop がサーバーから取得する同梱エージェントです。エージェントセレクターに表示されるかどうかは、**Devin Local Agent** のチーム設定で制御されます。 * **Team** およびその他の非 Enterprise プランでは、デフォルトで利用できます (各メンバーでこのアクセスが無効になっている場合を除きます) 。 * **Enterprise** プランでは利用制限があるため、管理者がメンバー向けに有効化する必要があります。 Enterprise 管理者は、チーム設定ダッシュボードからこれを管理します。 * **Devin Enterprise 管理者** — **Settings → Enterprise → Windsurf** (`app.devin.ai/org/{orgName}/settings/windsurf`)。**Features** で **Devin Local Agent** (「メンバーが Devin Desktop で Devin Local agent を利用し、ACP 経由でタスクを Devin の terminal agent に委任できるようにする」) を有効にします。 * **Windsurf Enterprise 管理者** — [Windsurf ダッシュボード](https://windsurf.com/team/settings)。 有効にすると、Devin Desktop を再起動した後、Devin Local がすべてのメンバーのエージェントセレクターに表示されます。ユーザーごとのセットアップやカスタムの [ACP registry config](/ja/desktop/acp#team-registry-configuration) は不要です。
## モード
Devin Local には、[Cascade のモード](/ja/desktop/cascade/modes)とは別に独自のモードがあります。Devin CLI と同じエージェントハーネスを共有しているため、エージェントモード (Normal、Plan、Ask) と[権限モード](/ja/cli/reference/permissions)も同じです。利用可能なモードの一覧と、それらを切り替えるスラッシュコマンドについては、[基本コマンド](/ja/cli/essential-commands)を参照してください。
### Plan mode
Plan mode は読み取り専用の調査モードです。エージェントはコードベースを調査し、対応方針をまとめ、実装を行う前に承認を求めます。 プランは `~/.devin/plans/plan-.md` の永続的な Markdown ファイルに保存されるため、編集したり、後で見直したり、新しいセッションに引き継いだりできます。 プロンプトにキーワード `megaplan` (`ultraplan` や `masterplan` も使用可能) を含めると、セッションが Plan mode に切り替わり、エージェントがより綿密にプランを作成します。プランを書き始める前に、少なくとも 1 つの確認質問をします。
## ワークツリーでのセッション
git ワークツリー内で Devin Local セッションを実行すると、エージェントはメインのワークスペースに影響を与えずに編集、ビルド、テストを行えます。 セッションの開始時に、エージェントのロケーションセレクターから場所を選択します。 * **新しいワークツリー** — Devin Desktop がセッション用の新しいワークツリーを作成します。 * **既存のワークツリー** — セレクターの **ローカル** サブメニューから、既存のワークツリーを選択します。 エージェントの作業が完了したら、セッションの **マージ** をクリックして、ワークツリーの変更をワークスペースに反映します。 ワークツリーは、ディスク上の場所やクリーンアップの動作を含め、Cascade セッションと共有されます。詳細は[ワークツリー](/ja/desktop/cascade/worktrees)を参照してください。
## カスタマイズ
カスタマイズ画面には、Devin Local セッションで読み込まれているすべての項目 (ルール、スキル、フック、MCPサーバー、プラグイン) と、リポジトリ、組織、アカウントで利用可能な項目が一覧表示されます。 エージェント Space の新しいタブのメニューから **Open customizations** を選択するか、エージェントのサイドバーで Devin Local セッションを右クリックして開くことができます。 ここでいう **Plugins** は、Devin *agent* プラグインを指します。これらは、スキル、ルール、フック、MCPサーバー、サブエージェントをエージェントに追加するインストール可能なバンドルです。[plugins](/ja/cli/extensibility/plugins/overview) を参照してください。 これらは、Devin を JetBrains、VS Code、その他のエディターで利用できるようにする [Windsurf Plugins](/ja/windsurf/plugins/getting-started) や、Devin Desktop 内にインストールする [editor extensions](/ja/desktop/recommended-extensions) とは関係ありません。いずれもエージェントではなく IDE を拡張するものです。
## 制限モード
ワークスペースを**制限モード**で開いている場合、そのワークスペースではエージェントを利用できません。Cascade、Devin Local、すべての[ACP エージェント](/ja/desktop/acp)が無効になり、[フック](/ja/cli/extensibility/hooks/overview)も読み込まれず、実行されません。 ワークスペースが制限モードでなくなると、エージェントを再び利用できるようになります。
## 違い
### 権限モデル
Devin Local では、[自動実行レベル](/ja/desktop/terminal#auto-execution-levels) の代わりに、エージェントが実行できる操作をより細かく制御する権限システムを採用しています。 * **拒否ルール**は操作を完全にブロックします (最優先) * **Ask** ルールは常に承認を求めます * **Allow** ルールは確認なしで操作を自動承認します 権限は、ファイルの読み取り、ファイルの書き込み、コマンドの実行、HTTP リクエスト、MCP ツールに適用範囲を限定できます。プロジェクト、ユーザー、または組織レベルで設定できます。ルールの構文については、[権限](/ja/cli/reference/permissions)を参照してください。 グロブを使用して記述された権限ルール (たとえば `Read(**/*.pem)`) は、セッション内のすべてのワークスペースディレクトリ (開始後に追加されたディレクトリを含む) に対して照合されます。
#### 権限リクエストへの対応
エージェントが承認を求めると、リクエストカードにはいくつかの応答方法が表示されます。 * **コマンドを編集** — カード内のコマンドをクリックすると、承認前に変更できます。魔法の杖アクションでは、変更内容を自然言語で指定すると、高速モデルがコマンドを書き換え、確認できるようにします。 * **キーボード ショートカット** — マウスを使わずにリクエストを承認、常に許可、または拒否できます。ショートカットのヒントは、ボタンとドロップダウンの項目に表示されます。 * **セッション全体の許可** — セッション中に付与した承認は、そのセッション内の以降のすべてのリクエストに適用されます。そのため、ルートエージェントとそのサブエージェントは、すでに許可したスコープについて再度確認を求めません。
### MCP の権限
Cascade とは異なり、Devin Local agent のデフォルト設定では、MCP ツールを呼び出す前に承認を求めます。agent が MCP ツールを呼び出そうとすると、現在のセッションに限って、または永続的に、その特定のツール、もしくはその MCPサーバー上のすべてのツールを許可できます。 Enterprise 管理者は、信頼できる統合で毎回確認が求められないように、特定の MCPサーバー やツールをデフォルトで許可できます。これらのルールの設定方法については、[ツールベースの権限](/ja/cli/reference/permissions#tool-based-permissions)を参照してください。
### MCP の再認証
サーバーに保存されている OAuth 認証情報の有効期限が切れると、Devin Local の MCP リスト、marketplace カード、サーバー詳細ページに **認証が必要** の状態が表示されます。 **認証** をクリックすると、保存されている認証情報が消去され、ブラウザでの認可フローが再実行されます。
### MCPサーバーの設定
Devin Local agent では、MCPサーバーはローカルマシン上の[設定ファイル](https://cli.devin.ai/docs/extensibility/mcp/configuration)で設定します。 ファイルの場所は、スコープによって決まります。 | スコープ | 場所 | チームと共有されるか | | ----------- | ----------------------------- | ---------------------- | | プロジェクト | `.devin/config.json` | はい (バージョン管理にチェックインされる) | | ローカルオーバーライド | `.devin/config.local.json` | いいえ (gitignore 対象) | | ユーザー | `~/.config/devin/config.json` | いいえ |
## スキル
スキルは、Devin Local agent で実行できることを拡張する、モデルが呼び出して利用する再利用可能な指示セット (必要に応じてスクリプトを含む) です。Devin Local は [Devin CLI](https://cli.devin.ai) と同じエージェントハーネスを共有しているため、同じスキル形式と検出メカニズムを利用します。 また、スキルは、Devin Local agent でサポートされていない Cascade の Memories やワークフローを移行するための推奨手段でもあります ([制限事項](#limitations) を参照) 。繰り返し使う手順を一度定義しておけば、該当する場合にエージェントが自動的に実行します。 スキルの作成、設定、スコープの指定方法について詳しくは、[Devin CLI のスキル ドキュメント](/ja/cli/extensibility/skills/overview)を参照してください。
## 制限事項
この差は双方向にあります。[plugins](/ja/cli/extensibility/plugins/overview) と [subagents](/ja/cli/subagents) には Cascade に相当する機能がまったくなく、最近のリリースでは [plan mode](/ja/desktop/devin-local#plan-mode) と [merging worktree sessions](/ja/desktop/devin-local#worktree-sessions) が Cascade と同等になりました。以下に、このエージェントにまだない Cascade の機能を示します。 現在、Devin Local agent では次の機能はサポートされていません。 * **Memories** — Devin Local agent では、セッションをまたいで Memories は保持されません。**Devin: Open Cascade Migration Wizard** コマンドを使用して、重要な Memories を [skills](/ja/desktop/cascade/skills) に移行してください。 * **Workflows** — Devin Local agent では Workflows は利用できません。**Devin: Open Cascade Migration Wizard** コマンドを使用して、Workflows を [skills](/ja/desktop/cascade/skills) に移行してください。 * **Code Lenses** - 現在、[code lenses](/ja/desktop/command/windsurf-related-features) から Devin Local agent をトリガーすることはできません。 * **App Deploys** - Devin Local agent は App Deploys をサポートしていません。 * **Conversation Sharing** - Devin Local agent では Conversation Sharing はまだ利用できません。 * **Arena Mode** - [アリーナモード](/ja/desktop/cascade/arena) は Devin Local agent では利用できません。 Devin Local agent は、永続的な前提情報と再利用可能なワークフローを提供するための [ルール and AGENTS.md files](https://cli.devin.ai/docs/extensibility/rules) と [skills](https://cli.devin.ai/docs/extensibility/skills/overview) をサポートしています。
### 分析
Devin Local のアクティビティは、[`cascade_runs`](/ja/desktop/accounts/api-reference/cascade-analytics) データソース (モデル使用量、送信メッセージ数、クレジット消費量) 、[`cascade_tool_usage`](/ja/desktop/accounts/api-reference/cascade-analytics) データソース (Code Edit、Run Command、Search Web、MCP Tool など、ツール呼び出しごとの回数) 、[`cascade_lines`](/ja/desktop/accounts/api-reference/cascade-analytics) データソース (エージェントが日ごとに作成したコード行数) 、および Custom Analytics API の [Cascade データソース](/ja/desktop/accounts/analytics-api#cascade-data)で報告されます。 Cascade とは異なり、Devin Local は動作時に特定の提案行や「モード」を追跡しません。編集は承認後にのみ実行されるため、採用行数は提案行数と同じになり、`cascade_runs` の `mode` フィールドには値が設定されません。 Devin CLI は[ハイブリッドデプロイメント](https://devin.ai/blog/self-hosted-deployment-maintenance-mode)の分析データを報告しません。
### エンタープライズ コントロール
Enterprise 管理者は、[チーム設定](https://windsurf.com/team/settings)で Devin Local agent を設定できます。これには、[Devin Local agent でのみ利用できる新しいコントロール](https://cli.devin.ai/docs/enterprise/team-settings)も含まれます。 * **サンドボックス強制** - すべてのユーザーにサンドボックスモードを必須にし、組織全体のドメインフィルタリングルールを設定します * **きめ細かな権限設定** - agent が実行できる操作を、より細かい権限で制御します * **ネットワーク強制** - 許可ドメインと拒否ドメインを使ってネットワークアクセスを制御します さらに、「Enable Cascade」コントロールを使うと、レガシーの Cascade agent を完全に無効化できるため、チーム全体で Devin CLI で利用可能な新しいコントロールに従わせることができます。
#### サポートされていないエンタープライズ コントロール
以下のレガシーなエンタープライズ コントロールは、Devin Local agent では利用できません。 * **ツール呼び出しをワークスペースに制限** - デフォルトでは、Devin Local agent はワークスペース内のファイルのみを読み取り・編集できます。 カスタム[権限](https://cli.devin.ai/docs/reference/permissions)は、同じルールを再現できる、より柔軟な代替手段です。 * **App Deploys** - App Deploys は、Devin Local agent ではまだサポートされていません。 * **Conversation Sharing** - Conversation Sharing は、Devin Local agent ではまだサポートされていません。 * **グローバルなツール呼び出しの無効化** - 以前にツール呼び出しを完全に無効化していた場合は、代わりに Devin CLI 用の同等の[権限ポリシー](https://cli.devin.ai/docs/reference/permissions)を作成してください。 以下のレガシー コントロールは、Enterprise CLI 権限設定をまだ実装していない場合、フォールバックとして引き続き適用されます。 * **ターミナルコマンドの自動実行** - Devin Local agent は、自動実行レベルではなく、独自の[権限モデル](https://cli.devin.ai/docs/reference/permissions)を使用します。こちらを利用することを推奨しますが、古いコントロールもフォールバックとして引き続き適用されます。 * **ターミナルの許可リスト** - 特定のターミナルコマンドを許可するには、Devin CLI 用に同等の[権限ポリシー](https://cli.devin.ai/docs/reference/permissions)を実装してください。 * **ターミナルの拒否リスト** - 特定のターミナルコマンドを拒否するには、Devin CLI 用に同等の[権限ポリシー](https://cli.devin.ai/docs/reference/permissions)を実装してください。
## 関連資料
* [Devin CLI クイックスタート](https://cli.devin.ai/docs) * [基本コマンド](https://cli.devin.ai/docs/essential-commands) * [拡張性の概要](https://cli.devin.ai/docs/extensibility) * [チーム設定](https://cli.devin.ai/docs/enterprise/team-settings)