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

> Utilisez le Local Agent de Devin dans Devin Desktop : le moteur d’agent de Devin CLI, avec sous-agents, sandboxing, mode de planification, arbres de travail et autorisations.

Devin Local est notre moteur d’agent de nouvelle génération, partagé avec [Devin CLI](https://cli.devin.ai).

Il s’exécute sur votre machine, avec accès à vos fichiers, outils et environnement locaux, et constitue l’agent local principal de Devin Desktop.

> [card] [Modes](https://docs.devin.ai/fr/desktop/devin-local/modes.md)
>
> Code, Intelligent, Ask, Plan et Bypass Permissions, et comment planifier avant d’implémenter.

> [card] [Personnalisations](https://docs.devin.ai/fr/desktop/devin-local/customizations.md)
>
> Extensions, skills, serveurs MCP, hooks et règles, ainsi que l’interface qui affiche les éléments chargés par une session.

> [card] [Autorisations](https://docs.devin.ai/fr/desktop/devin-local/permissions.md)
>
> Règles allow, ask et deny, demandes d’approbation et autorisations des outils MCP.

> [card] [Arbres de travail](https://docs.devin.ai/fr/desktop/devin-local/worktrees.md)
>
> Exécutez une session dans un worktree Git, puis fusionnez ses modifications dans votre espace de travail.

## Fonctionnalités clés

### Efficacité en tokens

Le Local Agent de Devin repose sur la mise en cache des prompts : pour un même résultat, la plupart des tâches consomment ainsi moins de tokens.

### Sous-agents

Le Local Agent de Devin peut lancer des [sous-agents](https://docs.devin.ai/fr/cli/subagents.md) indépendants pour prendre en charge des sous-tâches, au premier plan ou en arrière-plan. Les sous-agents partagent les outils et le contexte de la base de code avec l'agent parent, mais s'exécutent dans leur propre chaîne de conversation.

Les sous-agents s'activent et se désactivent via l'option **Subagents (Preview)** dans `Devin Settings`.

Outre les profils intégrés, vous pouvez définir vos propres sous-agents sous forme de fichiers Markdown dans `agents/`, selon l'une des deux structures suivantes :

* **Fichier unique** — `agents/<name>.md`, où le nom du fichier sert d'identifiant au profil.
* **Répertoire** — `agents/<name>/AGENT.md`, où le nom du répertoire sert d'identifiant au profil.

Consultez la [documentation des sous-agents](https://docs.devin.ai/fr/cli/subagents.md) pour savoir où ces répertoires sont détectés et comment configurer un profil.

### Sandboxing

Le Local Agent de Devin prend en charge l’isolation en bac à sable au niveau du système d’exploitation. Lorsqu’elle est activée, le sandbox impose :

* **Isolation du système de fichiers** — les chemins accessibles en écriture sont dérivés de vos [portées des autorisations](https://docs.devin.ai/fr/desktop/devin-local/permissions.md), et les règles de refus `Read(...)` masquent certains chemins aux commandes exécutées dans le sandbox
* **Filtrage réseau** — des listes d’autorisation et des listes de refus de domaines déterminent les ressources auxquelles l’agent peut accéder

Les Enterprise Admin peuvent imposer le comportement du sandbox à l’ensemble de l’organisation via les [Team Settings](https://cli.devin.ai/docs/enterprise/team-settings#sandbox-enforcement), notamment en rendant le mode bac à sable obligatoire pour tous les utilisateurs et en configurant des règles de filtrage des domaines à l’échelle de l’organisation.

### Revue rapide

La [Revue rapide](https://docs.devin.ai/fr/desktop/quick-review.md) est un sous-agent dédié, disponible avec le Local Agent de Devin, qui permet d’obtenir rapidement un retour sur vos modifications.

## Changer d’agent

Lorsque vous n’avez pas choisi d’agent préféré, les nouveaux onglets démarrent avec Devin Local. Si Devin Local ne vous est pas accessible, l’onglet utilise à la place le premier [agent ACP](https://docs.devin.ai/fr/desktop/acp.md) sélectionnable ; si aucun agent n’est disponible, il affiche l’UI par défaut d’un nouvel onglet et attend qu’un agent le devienne. Vous pouvez à tout moment changer d’agent pour les *nouvelles* conversations à l’aide du sélecteur d’agent, situé en bas à droite de Devin Desktop. Devin Local reste sélectionnable même pendant sa connexion.

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

### Paramètres de l’agent

Si Devin Local n’apparaît pas dans le sélecteur d’agent, vous devrez peut-être l’activer depuis `Devin Settings` :

1. Ouvrez la palette de commandes avec `Cmd+Shift+P` (macOS) ou `Ctrl+Shift+P` (Windows/Linux)
2. Ouvrez `Devin User Settings`
3. Cliquez sur l’onglet « Agents »
4. Activez l’agent « Devin Local »
5. Redémarrez 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 Admins

Devin Local est un agent intégré que Devin Desktop récupère depuis le serveur. Son affichage dans le sélecteur d’agent dépend du paramètre d’équipe **Devin Local Agent** :

* Sur le forfait **Team** et les autres forfaits non-Entreprise, il est disponible par défaut (sauf si cet accès a été désactivé pour un membre donné).
* Sur les forfaits **Enterprise**, il est activé par défaut, et un administrateur peut le désactiver pour les membres.

Les Enterprise Admins gèrent ce paramètre depuis le tableau de bord Team Settings :

* **Devin Enterprise Admins** — **Settings → Enterprise → Devin Desktop** (`app.devin.ai/org/{orgName}/settings/desktop`). Dans **Fonctionnalités**, utilisez le bouton bascule **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 Admins** — depuis le [tableau de bord Windsurf](https://windsurf.com/team/settings).

Lorsque ce paramètre est activé, Devin Local apparaît dans le sélecteur d’agent de tous les membres une fois Devin Desktop redémarré. Aucune configuration par utilisateur ni [configuration personnalisée du registre ACP](https://docs.devin.ai/fr/desktop/acp.md#team-registry-configuration) n’est requise.

## Mode Restreint

Lorsqu'un espace de travail est ouvert en **Mode Restreint**, les agents n'y sont pas disponibles : Devin Local et tous les [agents ACP](https://docs.devin.ai/fr/desktop/acp.md) sont désactivés, et les [hooks](https://docs.devin.ai/fr/desktop/devin-local/customizations.md#hooks) ne sont ni chargés ni exécutés.

Les agents redeviennent disponibles dès que l'espace de travail quitte le Mode Restreint.

## Partage de conversation

Dans Devin Desktop, choisissez **Partager la conversation** dans le menu d’actions situé sous un tour terminé ; dans Devin CLI ou un autre client ACP, exécutez `/share`. L’agent téléverse un transcript nettoyé (secrets masqués, prompts système et définitions d’outils supprimés) et renvoie un lien à partager avec votre équipe. Le partage n’est proposé que si votre organisation l’autorise, que vous êtes connecté avec un compte Devin (et non un compte Windsurf uniquement) et que le client prend en charge cette fonctionnalité.

## Analyses

L’activité de Devin Local est rapportée dans la source de données [`cascade_runs`](https://docs.devin.ai/fr/desktop/accounts/api-reference/cascade-analytics) (utilisation des modèles, messages envoyés et consommation de crédits), la source de données [`cascade_tool_usage`](https://docs.devin.ai/fr/desktop/accounts/api-reference/cascade-analytics) (nombre d’appels par outil, notamment Code Edit, Run Command, Search Web et MCP Tool), la source de données [`cascade_lines`](https://docs.devin.ai/fr/desktop/accounts/api-reference/cascade-analytics) (nombre quotidien de lignes de code écrites par l’agent), ainsi que dans la [source de données Cascade](https://docs.devin.ai/fr/desktop/accounts/analytics-api#cascade-data) de l’API Custom Analytics.

Devin Local ne suit pas les lignes suggérées ni les « modes » : une modification n’est appliquée qu’après votre approbation. Les lignes acceptées sont donc égales aux lignes suggérées, et le champ `mode` de `cascade_runs` n’est pas renseigné.

Devin CLI ne fournit pas de données d’analyse pour les [déploiements hybrides](https://devin.ai/blog/self-hosted-deployment-maintenance-mode).

## Contrôles Enterprise

Les administrateurs Enterprise peuvent configurer le Local Agent de Devin via les [paramètres de l’équipe](https://windsurf.com/team/settings), y compris les [nouveaux contrôles disponibles uniquement avec le Local Agent de Devin](https://cli.devin.ai/docs/enterprise/team-settings) :

* **Application du mode sandbox** - Exiger le mode sandbox pour tous les utilisateurs et configurer des règles de filtrage de domaines à l’échelle de l’organisation
* **Autorisations granulaires** - Contrôler les actions que l’agent peut effectuer avec des autorisations plus précises
* **Contrôle du réseau** - Contrôler l’accès au réseau à l’aide de domaines autorisés et bloqués

Le contrôle de partage des conversations de l’organisation est respecté : lorsque le partage est désactivé pour l’organisation, le Local Agent de Devin ne propose ni **Partager la conversation** ni `/share`.

De plus, le contrôle « Activer Cascade » peut être utilisé pour désactiver entièrement l’ancien agent Cascade afin de garantir que votre équipe applique les nouveaux contrôles disponibles avec Devin CLI.

### Contrôles Enterprise non pris en charge

Les anciens contrôles Enterprise suivants ne sont pas disponibles avec le Local Agent de Devin :

* **Limiter les appels d’outil à l’espace de travail** - par défaut, le Local Agent de Devin peut uniquement lire et modifier les fichiers dans l’espace de travail.
  Des [autorisations](https://cli.devin.ai/docs/reference/permissions) personnalisées offrent une alternative plus flexible pour reproduire les mêmes règles.
* **Appels d’outil globaux désactivés** - Si vous avez déjà désactivé complètement les appels d’outil, créez plutôt une [politique d’autorisation](https://cli.devin.ai/docs/reference/permissions) équivalente pour Devin CLI.

Les anciens contrôles suivants continueront à être appliqués comme solution de secours si vous n’avez pas encore mis en place une configuration d’autorisations CLI Enterprise :

* **Exécuter automatiquement les commandes du Terminal** - Le Local Agent de Devin utilise son propre [modèle d’autorisations](https://cli.devin.ai/docs/reference/permissions) au lieu de niveaux d’exécution automatique ; nous vous recommandons d’utiliser ce modèle à la place, mais l’ancien contrôle continuera tout de même à être appliqué comme solution de secours.
* **Listes d’autorisation du Terminal** - Mettez en place une [politique d’autorisation](https://cli.devin.ai/docs/reference/permissions) équivalente pour Devin CLI afin d’autoriser des commandes de terminal spécifiques.
* **Listes de refus du Terminal** - Mettez en place une [politique d’autorisation](https://cli.devin.ai/docs/reference/permissions) équivalente pour Devin CLI afin de refuser des commandes de terminal spécifiques.

## Pour aller plus loin

* [Démarrage rapide de Devin CLI](https://cli.devin.ai/docs)
* [Commandes essentielles](https://cli.devin.ai/docs/essential-commands)
* [Vue d’ensemble de l’extensibilité](https://cli.devin.ai/docs/extensibility)
* [Team Settings](https://cli.devin.ai/docs/enterprise/team-settings)


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