> ## 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 CLIと同じエージェントハーネスを、Devin Desktop内で直接利用できます。
Devin Localは、[Devin CLI](https://cli.devin.ai)と共通の次世代エージェントハーネスです。
お使いのマシン上で動作し、ローカルのファイル、ツール、環境にアクセスできます。将来的には、主要なローカルエージェントとしてCascadeを置き換えることを想定しています。
Devin Localは現在プレビュー版で、Cascadeと比べるといくつかの[制限事項](#limitations)があります。Devin Localは、Devin DesktopのJetBrainsプラグインではサポートされていません。
## 主な改善点
Cascade の初回リリース以降、モデルの性能は大きく向上しました。Devin Local は、こうした進歩を効率的に活用できるよう、ゼロから設計・構築されています。
### トークン効率
Devin Local agent は大幅にトークン効率が高く、特にプロンプトキャッシュを重視しています。ほとんどのタスクで、同じ結果を得るのに Cascade より最大30%少ないトークンで済みます。
### サブエージェント
Devin Local agent は、独立した[サブエージェント](https://cli.devin.ai/docs/subagents)を起動し、サブタスクを処理できます。サブエージェントはフォアグラウンドまたはバックグラウンドで動作します。親エージェントとツールおよびコードベースの前提情報を共有しますが、それぞれ独自の会話チェーン内で動作します。
### サンドボックス
Devin Local agent は、OSレベルのサンドボックスをサポートしています。有効にすると、サンドボックスによって次の制御が適用されます。
* **ファイルシステムの分離** — 読み取りおよび書き込みが可能なパスは、権限スコープに基づいて決まります
* **ネットワークフィルタリング** — ドメインの許可リストと拒否リストによって、エージェントがアクセスできる先を制御します
Enterprise 管理者は、[チーム設定](https://cli.devin.ai/docs/enterprise/team-settings#sandbox-enforcement)を通じて、すべてのユーザーにサンドボックスモードを必須にしたり、組織全体のドメインフィルタリングルールを設定したりするなど、組織全体でサンドボックスの動作を強制できます。
### Quick Review
[Quick Review](/ja/desktop/quick-review) は、変更内容に対してすばやくフィードバックを得るための、Devin Local agent で利用できる専用のサブエージェントです。
## エージェントの切り替え
ほとんどの場合、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 を再起動します
また、`devin.cascade.enabled` 設定で Cascade を完全に無効にすることもできます。
## 違い
### 権限モデル
Devin Local では、[自動実行レベル](/ja/desktop/terminal#auto-execution-levels) の代わりに、エージェントが実行できる操作をより細かく制御する権限システムを採用しています。
* **Deny** ルールは操作を完全にブロックします (最優先)
* **Ask** ルールは常に承認を求めます
* **Allow** ルールは確認なしで操作を自動承認します
権限は、ファイルの読み取り、ファイルの書き込み、コマンドの実行、HTTP リクエスト、MCP ツールに適用範囲を限定できます。プロジェクト、ユーザー、または組織レベルで設定できます。
### MCP の権限
Cascade とは異なり、Devin Local agent のデフォルト設定では、MCP ツールを呼び出す前に承認を求めます。agent が MCP ツールを呼び出そうとすると、現在のセッションに限って、または永続的に、その特定のツール、もしくはその MCPサーバー上のすべてのツールを許可できます。
Enterprise 管理者は、信頼できる統合で毎回確認が求められないように、特定の MCPサーバー やツールをデフォルトで許可できます。これらのルールの設定方法については、[ツールベースの権限](/ja/cli/reference/permissions#tool-based-permissions)を参照してください。
### 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)を参照してください。
## 制限事項
現在、Devin Local agent では次の機能はサポートされていません。
* **Memories** — Devin Local agent では、セッションをまたいで Memories は保持されません。重要な Memories は [skills](/ja/desktop/cascade/skills) に移行してください。
* **Workflows** — Devin Local agent では Workflows は利用できません。Workflows は [skills](/ja/desktop/cascade/skills) に移行してください。
* **Codemaps** — Devin Local agent はまだ [codemaps](/ja/desktop/codemaps) を読み取れません。
* **Code Lenses** - 現在、[code lenses](/ja/desktop/command/windsurf-related-features) から Devin Local agent をトリガーすることはできません。
* **Fast Context** - Devin Local はコードの探索にサブエージェントを利用しますが、Cascade と同じ Fast Context の UI はありません。
* **App Deploys** - Devin Local agent は App Deploys をサポートしていません。
* **Browser previews** - Devin Local agent は、DOM 要素セレクターツールを含む IDE 内の [browser previews](/ja/desktop/previews) をまだサポートしていません。
* **Conversation Sharing** - Devin Local agent では Conversation Sharing はまだ利用できません。
Devin Local agent は、永続的な前提情報と再利用可能なワークフローを提供するための [rules and AGENTS.md files](https://cli.devin.ai/docs/extensibility/rules) と [skills](https://cli.devin.ai/docs/extensibility/skills/overview) をサポートしています。
### Analytics
Devin Local agent では、Cascade が収集する analytics の一部がまだレポートされません。以下のデータは Cascade では収集されますが、Devin Local では**収集されません**。
* **Tool usage** — [`cascade_tool_usage`](/ja/desktop/accounts/api-reference/cascade-analytics) データソース (Code Edit、Run Command、Search Web、MCP Tool など、ツールごとの呼び出し回数) には、Cascade セッションのみが含まれます。Devin Local agent による tool call はレポートされません。Devin Local agent で tool usage を監視または制限するには、代わりに [hooks](/ja/cli/extensibility/hooks/overview) と [permissions](/ja/cli/reference/permissions) を利用してください。
* **提案および採用された行数** — [`cascade_lines`](/ja/desktop/accounts/api-reference/cascade-analytics) データソース (1 日あたりの、提案および採用されたコード行数) には、Devin Local agent が書いたコードは含まれません。
* **Write/Read mode** — Devin Local agent は Cascade mode をレポートしないため、`cascade_runs` データソースの `mode` フィールドは、Devin Local のアクティビティについては設定されません。
Devin Local のアクティビティは、引き続き [`cascade_runs`](/ja/desktop/accounts/api-reference/cascade-analytics) データソース (model usage、送信メッセージ数、credit consumption) および Custom Analytics API の [Cascade Data source](/ja/desktop/accounts/analytics-api#cascade-data) に含まれます。
Devin CLI は、[hybrid deployments](https://devin.ai/blog/self-hosted-deployment-maintenance-mode) の analytics をレポートしません。
### エンタープライズ コントロール
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 ではまだサポートされていません。
* **チームで Cascade を有効または無効にする** - この設定が制御するのはレガシー Cascade agent のみであり、Devin Local agent や Devin CLI には適用されません。
* **グローバルなツール呼び出しの無効化** - 以前にツール呼び出しを完全に無効化していた場合は、代わりに 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)