> ## 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

> Devin Desktop で Devin Local agent を利用できます。Devin CLI のエージェントハーネスをベースに、サブエージェント、サンドボックス化、計画モード、ワークツリー、権限管理を備えています。

Devin Local は、[Devin CLI](https://cli.devin.ai) と共通の次世代エージェントハーネスです。

あなたのマシン上で動作し、ローカルのファイル、ツール、環境にアクセスできます。Devin Desktop のメインのローカルエージェントです。

> [card] [モード](https://docs.devin.ai/ja/desktop/devin-local/modes.md)
>
> Code、Smart、Ask、Plan、Bypass Permissions の各モードと、実装前に計画を立てる方法。

> [card] [カスタマイズ](https://docs.devin.ai/ja/desktop/devin-local/customizations.md)
>
> プラグイン、スキル、MCPサーバー、フック、ルールと、セッションで読み込まれた内容を確認できる画面。

> [card] [権限](https://docs.devin.ai/ja/desktop/devin-local/permissions.md)
>
> 許可・ask・拒否ルール、承認リクエスト、MCPツールの権限。

> [card] [ワークツリー](https://docs.devin.ai/ja/desktop/devin-local/worktrees.md)
>
> git ワークツリーでセッションを実行し、変更をワークスペースにマージする方法。

## 主な機能

### トークン効率

Devin Local agent はプロンプトキャッシュを中心に設計されているため、ほとんどのタスクで同じ結果をより少ないトークンで得られます。

### サブエージェント

Devin Local agent は、独立した[サブエージェント](https://docs.devin.ai/ja/cli/subagents.md)を起動してサブタスクを処理させることができます。サブエージェントはフォアグラウンドとバックグラウンドのどちらでも実行できます。サブエージェントは親エージェントとツールやコードベースの前提情報を共有しますが、会話チェーンはそれぞれ独立しています。

サブエージェントの有効・無効は、`Devin Settings` の **サブエージェント (Preview)** トグルで切り替えます。

組み込みプロファイルのほかに、`agents/` 配下に Markdown ファイルを置くことで独自のサブエージェントを定義できます。構成は次のどちらでも構いません。

* **フラットファイル** — `agents/<name>.md`。ファイル名がプロファイルの識別子になります。
* **ディレクトリ** — `agents/<name>/AGENT.md`。ディレクトリ名がプロファイルの識別子になります。

これらのディレクトリが検出される場所や、プロファイルの設定方法については、[サブエージェントのドキュメント](https://docs.devin.ai/ja/cli/subagents.md)を参照してください。

### サンドボックス化

Devin Local agent は OSレベルのサンドボックス化をサポートしています。有効にすると、サンドボックスによって次の制限が強制適用されます。

* **ファイルシステムの分離** — 書き込み可能なパスは[権限スコープ](https://docs.devin.ai/ja/desktop/devin-local/permissions.md)に由来して決まり、`Read(...)` の拒否ルールで指定したパスはサンドボックス内のコマンドから参照できなくなります
* **ネットワークフィルタリング** — ドメインの許可リストと拒否リストによって、エージェントがアクセスできる宛先を制御します

Enterprise 管理者は、[チーム設定](https://cli.devin.ai/docs/enterprise/team-settings#sandbox-enforcement)から組織全体にサンドボックスの動作を強制適用できます。たとえば、すべてのユーザーにサンドボックスモードを必須にしたり、組織全体のドメインフィルタリングルールを設定したりできます。

### Quick Review

[Quick Review](https://docs.devin.ai/ja/desktop/quick-review.md) は、Devin Local agent で利用できる専用のサブエージェントです。変更内容に対するフィードバックをすばやく得られます。

## エージェントの切り替え

優先エージェントを選択していない場合、新しいタブは Devin Local で開始されます。Devin Local を利用できない場合は、代わりに最初に選択可能な [ACP エージェント](https://docs.devin.ai/ja/desktop/acp.md)が使用されます。利用可能なエージェントがない場合は、デフォルトの新規タブ UI が表示され、エージェントが利用可能になるまで待機します。*新しい*会話で使用するエージェントは、Devin Desktop 右下のエージェント選択からいつでも変更できます。なお、Devin Local は接続中でも選択できます。

![](https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-switcher.png?fit=max\&auto=format\&n=WE51TvKjsiyk1ZHl\&q=85\&s=5206df1ec64b71ae0463d56f7453aff3)

### エージェント設定

エージェント選択に Devin Local が表示されない場合は、`Devin Settings` から有効にする必要があるかもしれません。

1. `Cmd+Shift+P` (macOS) または `Ctrl+Shift+P` (Windows/Linux) でコマンドパレットを開きます
2. `Devin User Settings` を開きます
3. 「Agents」タブをクリックします
4. 「Devin Local」エージェントのトグルをオンにします
5. Devin Desktop を再起動します

![](https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-settings.png?fit=max\&auto=format\&n=WE51TvKjsiyk1ZHl\&q=85\&s=b0f42c5d3d679c55c450fd9067c34303)

### Enterprise 管理者

Devin Local は、Devin Desktop がサーバーから取得する同梱エージェントです。エージェント選択に表示されるかどうかは、チーム設定の **Devin Local Agent** で制御します。

* **Team** やその他の Enterprise以外のプランでは、デフォルトで利用可能です (個々のメンバーに対してこのアクセスが無効になっている場合を除く) 。
* **Enterprise** プランでは、デフォルトでオンになっており、管理者はメンバーに対してオフにできます。

Enterprise 管理者は、チーム設定のダッシュボードからこの設定を管理します。

* **Devin Enterprise 管理者** — **Settings → Enterprise → Devin Desktop** (`app.devin.ai/org/{orgName}/settings/desktop`) 。**機能** にある **Devin Local Agent** トグル ("Allow members to use the Devin Local agent in Devin Desktop and delegate tasks to Devin's terminal agent via ACP") を使用します。
* **Windsurf Enterprise 管理者** — [Windsurf ダッシュボード](https://windsurf.com/team/settings)。

この設定がオンの場合、Devin Desktop を再起動すると、すべてのメンバーのエージェント選択に Devin Local が表示されます。ユーザーごとのセットアップやカスタムの [ACPレジストリ設定](https://docs.devin.ai/ja/desktop/acp.md#team-registry-configuration) は必要ありません。

## 制限モード

ワークスペースを**制限モード**で開いている間は、そのワークスペースでエージェントを利用できません。Devin Local とすべての [ACP エージェント](https://docs.devin.ai/ja/desktop/acp.md) が無効になり、[フック](https://docs.devin.ai/ja/desktop/devin-local/customizations.md#hooks) も読み込み・実行されません。

ワークスペースの制限モードが解除されると、エージェントを再び利用できるようになります。

## Conversation Sharing

Devin Desktop では、完了したターンの下にあるアクションメニューから **Share conversation** を選択します。Devin CLI やその他の ACP クライアントでは `/share` を実行します。エージェントはサニタイズされたトランスクリプト (シークレットは秘匿され、システム prompt とツール定義は除外されます) をアップロードし、チームと共有するためのリンクを返します。共有機能が利用できるのは、組織が Conversation Sharing を許可していて、Devin アカウント (Windsurf 専用アカウントではない) でサインインしており、かつクライアントが共有をサポートしている場合のみです。

## 分析

Devin Local のアクティビティは、[`cascade_runs`](https://docs.devin.ai/ja/desktop/accounts/api-reference/cascade-analytics) データソース (モデル使用量、送信メッセージ数、クレジット消費量) 、[`cascade_tool_usage`](https://docs.devin.ai/ja/desktop/accounts/api-reference/cascade-analytics) データソース (Code Edit、Run Command、Search Web、MCP Tool など、ツール呼び出しごとの回数) 、[`cascade_lines`](https://docs.devin.ai/ja/desktop/accounts/api-reference/cascade-analytics) データソース (エージェントが日ごとに作成したコード行数) 、および Custom Analytics API の [Cascade データソース](https://docs.devin.ai/ja/desktop/accounts/analytics-api#cascade-data)で報告されます。

Devin Local は提案行や「モード」を追跡しません。編集は承認後にのみ実行されるため、採用行数は提案行数と同じになり、`cascade_runs` の `mode` フィールドには値が設定されません。

Devin CLI は[ハイブリッドデプロイメント](https://devin.ai/blog/self-hosted-deployment-maintenance-mode)の分析データを報告しません。

## エンタープライズ コントロール

Enterprise 管理者は、[チーム設定](https://windsurf.com/team/settings)で Devin Local エージェント を設定できます。これには、[Devin Local エージェント でのみ利用できる新しいコントロール](https://cli.devin.ai/docs/enterprise/team-settings)も含まれます。

* **サンドボックス強制** - すべてのユーザーにサンドボックスモードを必須にし、組織全体のドメインフィルタリングルールを設定します
* **きめ細かな権限設定** - エージェント が実行できる操作を、より細かい権限で制御します
* **ネットワーク強制** - 許可ドメインと拒否ドメインを使ってネットワークアクセスを制御します

組織のConversation Sharingコントロールの設定はそのまま適用されます。組織で共有が無効になっている場合、Devin Local エージェント は **Share conversation** や `/share` を提供しません。

さらに、「Enable Cascade」コントロールを使うと、レガシーの Cascade エージェント を完全に無効化できるため、チーム全体で Devin CLI で利用可能な新しいコントロールに従わせることができます。

### サポートされていないエンタープライズ コントロール

以下のレガシーなエンタープライズ コントロールは、Devin Local agent では利用できません。

* **ツール呼び出しをワークスペースに制限** - デフォルトでは、Devin Local agent はワークスペース内のファイルのみを読み取り・編集できます。
  カスタム[権限](https://cli.devin.ai/docs/reference/permissions)は、同じルールを再現できる、より柔軟な代替手段です。
* **グローバルなツール呼び出しの無効化** - 以前にツール呼び出しを完全に無効化していた場合は、代わりに 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)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.