Fichier de configuration

Le CLI Devin utilise des fichiers JSON (avec prise en charge des commentaires) comme fichiers de configuration. Cette page documente toutes les options disponibles.

Emplacement des fichiers

Fichier	Rôle
`~/.config/devin/config.json`	Paramètres globaux de l’utilisateur
`.devin/config.json`	Paramètres du projet (versionnés)
`.devin/config.local.json`	Dérogations locales du projet (ignorées par Git)
`~/.config/devin/mcp_config.json`	Serveurs MCP globaux de l’utilisateur
`.devin/mcp_config.json`	Serveurs MCP du projet (versionnés)
`.devin/mcp_config.local.json`	Serveurs MCP locaux du projet (ignorés par Git)
Fichier de politique système	Paramètres à l’échelle de la machine, gérés par l’administrateur (`system.json`)

Sous Windows, les chemins des fichiers de configuration utilisateur sont %APPDATA%\devin\config.json et %APPDATA%\devin\mcp_config.json (par ex. C:\Users\<you>\AppData\Roaming\devin\config.json), et non ~\.config\devin\.

Les serveurs MCP ont été déplacés vers les fichiers dédiés mcp_config.json dans la version 3000.3 (la version Local 3.6). Les versions antérieures les stockent à la place dans la clé mcpServers des principaux fichiers de configuration ; les versions plus récentes migrent automatiquement au démarrage toutes les entrées mcpServers qui s’y trouvent. Consultez mcpServers.

Référence complète de la configuration

Configuration utilisateur
Configuration du projet

// ~/.config/devin/config.json
{
  // Comportement de l'agent
  "agent": {
    "model": "swe-1-6-fast",           // Modèle par défaut
    "show_history_on_continue": true  // Afficher les messages à la reprise
  },

  // Thème
  "theme_mode": null,            // "light", "dark", "terminal-dark", "terminal-light", "nocolor" ou null (auto)

  // Autorisations
  "permissions": {
    "allow": [],
    "deny": [],
    "ask": []
  },

  // Affichage
  "show_path": false,             // Afficher le CWD dans la bordure du champ de saisie
  "unicode_mode": "auto",         // "auto", "unicode" ou "ascii"
  "show_hints": true,             // Afficher des conseils entre les échanges

  // Complétion de fichiers
  "include_gitignored_files": false, // Inclure les fichiers ignorés par Git dans les complétions @

  // Accès aux fichiers
  "respect_gitignore": false,        // Bloquer l'accès des outils aux chemins ignorés par Git

  // Attribution des commits et des PR
  "attribution": true,            // Ajouter "Generated with Devin" / Co-Authored-By aux commits et aux PR

  // Sous-agents
  "subagents_enabled": true,      // Autoriser l'agent à lancer des sous-agents

  // Dérogations de raccourcis clavier, indexées par contexte puis par action
  "keymap": {
    "global": { "clear_screen": "ctrl-shift-k" }
  },

  // Mises à jour
  "auto_update": true,            // Installer les nouvelles versions en arrière-plan

  // Dérogations de raccourcis clavier (contexte -> action -> spécification(s) de touche)
  "keymap": {},

  // Notifications
  "notify": "smart",              // "never" | "smart" | "always" — notifications du terminal

  // Paramètres de proxy pour le trafic HTTP du CLI
  "proxy": {
    "mode": "system",           // "system" | "manual" | "off"
    "url": null,                // URL du proxy (requise en mode manuel)
    "no_proxy": null            // Liste d'exclusion séparée par des virgules
  },

  // Filtrage réseau du sandbox
  "sandbox": {
    "allowed_domains": [],       // Liste d’autorisation de domaines (vide = aucun filtrage)
    "denied_domains": [],        // Liste de refus de domaines (prioritaire)
    "network_mode": "full"       // "full" ou "limited" (GET/HEAD/OPTIONS uniquement)
  },

  // Importer les paramètres depuis d'autres outils
  "read_config_from": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}

// .devin/config.json
{
  // Autorisations
  "permissions": {
    "allow": [],
    "deny": [],
    "ask": []
  },

  // Importer les paramètres depuis d'autres outils
  "read_config_from": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}

Référence des options

Les options marquées Utilisateur uniquement ne peuvent être définies que dans la configuration utilisateur (~/.config/devin/config.json; %APPDATA%\devin\config.json sous Windows). Seuls permissions, read_config_from et hooks peuvent être définis dans les configurations de projet. mcpServers peut également être défini aux deux niveaux, mais se trouve dans les fichiers dédiés mcp_config.json (voir mcpServers).

agent (utilisateur uniquement)

Option	Type	Par défaut	Description
`model`	string	`"swe-1-6-fast"`	Modèle d’IA par défaut
`show_history_on_continue`	boolean	`true`	Afficher les messages précédents lors de la reprise d’une session

theme_mode (utilisateur uniquement)

Valeur	Comportement
`null`	Détection automatique (invite lors de la première exécution)
`"light"`	Thème clair
`"dark"`	Thème sombre
`"terminal-dark"`	Thème sombre limité à 16 couleurs ANSI (respecte le jeu de couleurs du terminal)
`"terminal-light"`	Thème clair limité à 16 couleurs ANSI (respecte le jeu de couleurs du terminal)
`"nocolor"`	Aucun affichage en couleur (monochrome, utile pour les terminaux VT100)

autorisations

Voir Autorisations pour la documentation complète.

{
  "permissions": {
    "allow": ["Read(**)", "Exec(git)"],
    "deny": ["Exec(sudo)"],
    "ask": ["Write(**/.env*)"]
  }
}

mcpServers

Correspondance entre le nom du serveur et sa configuration. Prend en charge à la fois les commandes locales (stdio) et les serveurs HTTP distants. Voir Configuration MCP. Depuis la version v3000.3 (la release Local 3.6), les serveurs MCP sont stockés dans des fichiers dédiés : ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json sous Windows), .devin/mcp_config.json et .devin/mcp_config.local.json. Dans les versions antérieures, la clé mcpServers se trouve directement dans les fichiers de configuration principaux ; les versions plus récentes la migrent automatiquement vers les fichiers dédiés au démarrage.

// mcp_config.json
{
  "mcpServers": {
    "server-name": {
      "command": "executable",
      "args": ["arg1", "arg2"],
      "env": { "KEY": "value" }
    },
    "remote-server": {
      "url": "https://mcp.example.com/mcp",
      "transport": "http"
    }
  }
}

show_path (utilisateur uniquement)

Affiche le chemin du répertoire de travail actuel dans la bordure du champ de saisie. Lorsque cette option est activée, la bordure supérieure de la zone de saisie affiche votre CWD mis en forme (p. ex. ~/projects/my-app).

Valeur	Comportement
`false`	Masqué (par défaut)
`true`	Affiche le chemin du CWD dans la bordure du champ de saisie

unicode_mode (utilisateur uniquement)

Détermine si l’interface du terminal utilise des symboles Unicode ou des alternatives compatibles ASCII. Définissez cette option sur "ascii" si votre terminal ou votre police n’affiche pas correctement les glyphes Unicode (par ex. si le symbole ⏺ s’affiche comme un carré).

Valeur	Comportement
`"auto"`	Détecte la prise en charge d’Unicode à partir de l’environnement (par défaut)
`"unicode"`	Utilise toujours des symboles Unicode
`"ascii"`	Utilise toujours des caractères compatibles ASCII

show_hints (utilisateur uniquement)

Affiche ponctuellement des astuces entre les échanges (par ex. « Le saviez-vous : utilisez /model pour passer d’un modèle disponible à l’autre »). Utile pour découvrir les fonctionnalités de la CLI ; définissez cette option sur false pour ne plus les afficher une fois que vous vous êtes familiarisé avec elles.

Valeur	Comportement
`true`	Affiche des astuces ponctuellement (par défaut)
`false`	N’affiche jamais d’astuces

include_gitignored_files (utilisateur uniquement)

Inclut les fichiers ignorés par Git dans les résultats de complétion de l’onglet @. Lorsqu’elle est activée, les fichiers correspondant aux règles de .gitignore apparaissent dans les complétions de mention @. Cette option est utile si vous stockez de la documentation ou d’autres fichiers dans des répertoires ignorés par Git auxquels vous souhaitez faire référence.

Valeur	Comportement
`false`	Exclut les fichiers ignorés par Git des complétions (par défaut)
`true`	Inclut les fichiers ignorés par Git dans les complétions `@`

respect_gitignore (utilisateur uniquement)

Détermine si l’agent respecte .gitignore lorsqu’il lit ou écrit des fichiers via des outils. Lorsqu’elle est activée, les appels d’outils qui accèdent à des chemins ignorés par Git sont bloqués. Cette option est distincte de include_gitignored_files, qui n’affecte que l’autocomplétion de @ avec la touche Tab.

Valeur	Comportement
`false`	L’agent peut accéder à tous les fichiers, indépendamment de `.gitignore` (par défaut)
`true`	Bloque l’accès des outils aux chemins ignorés par Git

attribution (utilisateur uniquement)

Détermine si l’agent ajoute une attribution à Devin dans les commits et les pull requests qu’il crée. Lorsqu’elle est activée, le corps des commits et des PR inclut une ligne Generated with [Devin] ainsi qu’un pied de page Co-Authored-By: Devin. Définissez cette option sur false pour omettre les deux, afin qu’aucune attribution à Devin ne soit ajoutée.

Valeur	Comportement
`true`	Ajoute la ligne `Generated with [Devin]` et le pied de page `Co-Authored-By` aux commits et aux PR (par défaut)
`false`	Omet toute attribution à Devin des commits et des PR

subagents_enabled (utilisateur uniquement)

Détermine si l’agent peut déléguer des tâches à des sous-agents. Lorsqu’ils sont désactivés, les outils run_subagent et read_subagent sont supprimés et l’agent effectue donc tout le travail lui-même. Toute modification de ce paramètre est appliquée en temps réel : une session en cours la prend en compte sans redémarrage.

Valeur	Comportement
`true`	L’agent peut lancer des sous-agents (par défaut)
`false`	Les sous-agents sont désactivés pour cet utilisateur

La politique de l’organisation prévaut : si un administrateur a désactivé les sous-agents pour votre organisation (via le paramètre Modèle de sous-agent par défaut), les sous-agents restent désactivés, quel que soit ce paramètre.

keymap (utilisateur uniquement)

Remplacez les raccourcis clavier intégrés de la CLI. Cette section contient un tableau de contextes (global, editor, input, list, …), chacun associant des noms d’actions aux touches qui les déclenchent. Les actions non répertoriées conservent leurs raccourcis intégrés par défaut.

{
  "keymap": {
    "global": {
      "clear_screen": "ctrl-shift-k",
      "history_search": ["ctrl-r", "f3"]
    },
    "editor": {
      "beginning_of_line": "home"
    }
  }
}

Valeur	Signification
`"ctrl-shift-k"`	Une spécification de touche associée à l’action
`["ctrl-r", "f3"]`	Plusieurs spécifications de touches, dont l’une quelconque déclenche l’action
`[]`	Supprime l’association de l’action

Une spécification de touche est une liste de modificateurs séparés par des - (ctrl, alt, shift), suivie d’un nom de touche (un caractère ou une touche nommée telle que enter, esc, tab, home, page-up, f5). L’ordre des modificateurs n’a pas d’importance et la correspondance ne tient pas compte de la casse, sauf qu’un caractère majuscule seul associe la touche avec Maj ("K" équivaut à "shift-k").

Exécutez /shortcuts pour afficher chaque action avec son identifiant context.action — les mêmes identifiants qu’ici — et modifier les associations de manière interactive. Les associations que vous y définissez sont enregistrées dans cette section.

global.cancel (Ctrl+C) ne peut pas être dissocié. Vous pouvez donc toujours interrompre un agent en cours d’exécution. Les entrées non valides, les contextes ou actions inconnus, ainsi que les dérogations qui entreraient en conflit avec un autre raccourci dans le même contexte, sont signalés au démarrage et remplacés par la valeur par défaut intégrée.

auto_update (utilisateur uniquement)

Contrôle la mise à jour automatique en arrière-plan sur macOS et Linux. Lorsqu’elle est activée, les nouvelles versions sont téléchargées et activées pendant l’exécution de Devin CLI, de sorte que le prochain appel à devin utilise automatiquement la dernière version. La session en cours n’est pas affectée — le remplacement du lien symbolique current ne prend effet qu’au prochain lancement. La mise à jour est conçue pour résister aux interruptions : chaque étape au niveau du système de fichiers est préparée dans un chemin temporaire, puis appliquée via un renommage atomique, et les processus de mise à jour concurrents sont sérialisés à l’aide d’un verrou de fichier. Quitter au milieu d’une mise à jour ne peut pas laisser l’installation dans un état défectueux — vous redémarrerez simplement sur l’ancienne version. S’applique uniquement aux installations gérées par l’utilisateur (curl | bash sur macOS/Linux). Les installations fournies avec un autre produit (p. ex. Windsurf) ignorent ce paramètre et se mettent à jour via leur application hôte.

Valeur	Comportement
`true`	Télécharge et installe les nouvelles versions en arrière-plan (par défaut)
`false`	Vérifie uniquement la présence de nouvelles versions ; installez-les manuellement via `/update`

keymap (utilisateur uniquement)

Redéfinissez les raccourcis clavier. Les dérogations sont définies par contexte, puis par action — l’identifiant context.action affiché pour chaque raccourci dans /shortcuts (p. ex. editor.insert_newline) :

{
  "keymap": {
    "global": {
      "clear_screen": "ctrl-shift-k",
      "history_search": ["ctrl-r", "f5"],
      "feedback_up": []
    },
    "editor": {
      "insert_newline": ["shift-enter", "alt-enter", "ctrl-j"]
    }
  }
}

Valeur	Comportement
`"<spec>"`	Associe l’action à une seule touche
`["<spec>", ...]`	Associe l’action à plusieurs touches (toutes la déclenchent)
`[]`	Dissocie l’action

Les dérogations remplacent entièrement les valeurs par défaut intégrées de cette action ; les actions non répertoriées conservent leurs valeurs par défaut. Ctrl+C (annuler) ne peut pas être dissocié. Les entrées non valides (noms inconnus, spécifications de touches incorrectes, valeurs d’un type incorrect ou dérogations en conflit avec une autre association dans le même contexte) sont signalées comme avertissements au démarrage et ignorées — le reste de la configuration est tout de même appliqué. Une spécification de touche se compose de zéro ou plusieurs modificateurs séparés par -, suivis d’un nom de touche (par ex. ctrl-shift-p, alt-enter, f5, K). Modificateurs : ctrl/control/c, alt/meta/option/opt/m, shift/s. Touches nommées : enter, esc, tab, backspace, delete, insert, up, down, left, right, home, end, page-up, page-down, space, f1–f24. Tout autre caractère unique associe cette touche (sensible à la casse : K associe Maj+K) ; utilisez - pour la touche moins (ctrl--). Vous pouvez également réattribuer les touches de manière interactive : dans /shortcuts, appuyez sur Enter sur une ligne de raccourci, puis sur la nouvelle touche — la modification est enregistrée dans cette section keymap. Consultez Personnaliser les associations de touches.

notify

Contrôle les notifications du terminal lorsque l’agent a terminé ou requiert une intervention de l’utilisateur. L’interface CLI écrit un caractère BEL (déclenche la sonnerie du terminal ou une alerte visuelle), une séquence d’échappement OSC 9 (déclenche une notification système dans iTerm2 et les terminaux compatibles) et une séquence OSC 777 (notification de bureau dans rxvt-unicode et d’autres terminaux). Les terminaux qui ne reconnaissent pas ces séquences les ignorent sans problème.

Valeur	Comportement
`"never"`	Aucune notification
`"smart"`	Notifie uniquement lorsque la fenêtre du terminal n’est pas active (utilise le signalement de focus OSC) (par défaut)
`"always"`	Notifie à chaque événement applicable, quel que soit le focus

read_config_from

Contrôle l’importation depuis les configurations d’autres outils d’IA :

Option	Type	Par défaut	Description
`cursor`	boolean/null	`true`	Importe depuis `.cursor/rules/`
`windsurf`	boolean/null	`true`	Importe depuis `.windsurf/rules/`
`claude`	boolean/null	`true`	Importe depuis `.claude/`

Définissez l’option sur false pour désactiver une importation spécifique. null est traité comme true.

proxy (utilisateur uniquement)

Configure la manière dont l’interface CLI achemine son propre trafic HTTP/HTTPS sortant (appels d’API, mises à jour, serveurs MCP, etc.). Cela n’affecte pas le trafic réseau des processus enfants du sandbox (voir sandbox ci-dessous). Le champ mode sélectionne la stratégie de proxy :

Mode	Comportement
`"system"` (par défaut)	Respecte les variables d’environnement (`HTTP_PROXY`, `HTTPS_PROXY`, `ALL_PROXY`) ainsi que le PAC (Proxy Auto-Configuration) natif de la plateforme sur macOS et Windows
`"manual"`	Achemine tout le trafic de l’interface CLI via l’`url` spécifiée
`"off"`	Se connecte directement — sans proxy

Option	Type	Par défaut	Description
`mode`	string	`"system"`	Stratégie de proxy : `"system"`, `"manual"` ou `"off"`
`url`	string/null	`null`	URL du proxy. Obligatoire lorsque `mode` vaut `"manual"`. Prend en charge les schémas `http://`, `https://` et `socks5://`
`no_proxy`	string/null	`null`	Liste d’hôtes/domaines séparés par des virgules qui contournent le proxy. Utilise la même syntaxe que la variable d’environnement `NO_PROXY` (p. ex. `"localhost,127.0.0.1,.corp.example.com"`). S’applique dans tous les modes

Exemple — proxy d’entreprise :

{
  "proxy": {
    "mode": "manual",
    "url": "http://proxy.corp.example.com:8080",
    "no_proxy": "localhost,127.0.0.1,.internal.corp"
  }
}

Exemple — désactiver le proxy :

{
  "proxy": {
    "mode": "off"
  }
}

Les administrateurs peuvent définir le même bloc proxy dans le fichier de configuration système à l’échelle de la machine. Le paramètre Enterprise est prioritaire, et configurer un proxy dans les deux fichiers constitue une erreur : supprimez la section proxy de votre configuration utilisateur si votre organisation la gère.

sandbox (utilisateur uniquement)

Le filtrage réseau du sandbox est actuellement instable. Si vous avez besoin de cette fonctionnalité, veuillez contacter votre responsable de compte pour connaître le calendrier de stabilisation.

Configurez le filtrage réseau au niveau des domaines pour le sandbox. Lorsque --sandbox est actif et que le filtrage de domaine est configuré, un proxy réseau géré démarre sur l’interface loopback, et le sandbox force tout le trafic des processus enfants à y transiter.

Pour une vue d’ensemble complète du fonctionnement du sandbox — y compris l’application au niveau Enterprise et la manière dont les paramètres Enterprise et utilisateur interagissent — consultez la documentation du sandbox.

L’indicateur --sandbox applique les chemins accessibles en écriture et les règles deny au niveau du système d’exploitation. Les racines accessibles en écriture sont dérivées des périmètres Write(...) accordés ainsi que des répertoires de l’espace de travail ; tout le reste est lisible, à l’exception des chemins masqués par les règles de refus Read(...). Les périmètres Write(...) accordés en cours de session étendent dynamiquement le sandbox pour les commandes suivantes.

Si --sandbox est spécifié mais que l’initialisation du sandbox échoue (par ex., si les outils de sandboxing ne sont pas disponibles sur la plateforme actuelle), la CLI refusera de démarrer au lieu de s’exécuter sans sandbox. Ce comportement de type fail-closed garantit que l’objectif de sécurité de --sandbox n’est jamais contourné silencieusement.

Option	Type	Par défaut	Description
`allowed_domains`	string[]	`[]`	Motifs de domaines autorisés via le proxy. Lorsqu’elle n’est pas vide, seuls les domaines correspondants sont autorisés (mode liste d’autorisation)
`denied_domains`	string[]	`[]`	Motifs de domaines toujours bloqués. Les règles de refus priment sur les règles d’autorisation
`network_mode`	string	`"full"`	`"full"` autorise toutes les méthodes HTTP ; `"limited"` autorise uniquement GET/HEAD/OPTIONS

Syntaxe des motifs de domaine :

Modèle	Correspond à
`example.com`	Correspondance exacte uniquement
`*.example.com`	Tout sous-domaine (pas le domaine racine)
`**.example.com`	Domaine racine et tout sous-domaine

Exemple :

{
  "sandbox": {
    "allowed_domains": [
      "github.com",
      "**.npmjs.org",
      "**.crates.io",
      "**.pypi.org"
    ],
    "denied_domains": ["evil.example.com"],
    "network_mode": "full"
  }
}

Le filtrage des domaines s’applique lorsque le sandbox est actif (--sandbox). Sans --sandbox, la section sandbox est ignorée.

Pour les Teams Enterprise, les admins peuvent redéfinir les listes de domaines via Team Settings. Les listes d’autorisation Enterprise prévalent (elles remplacent vos allowed_domains locaux), tandis que les listes de refus Enterprise sont additives (elles sont fusionnées avec vos denied_domains locaux).

JSON avec commentaires

Les fichiers de configuration prennent en charge les commentaires de type JavaScript :

{
  // Commentaires de ligne
  "agent": {
    "model": "sonnet"  // Commentaires en ligne
  },
  /* Commentaires
     de bloc */
  "permissions": {}
}

Prise en main

Intégrations d’éditeur

Extensibilité

Entreprise

Référence

Changelog

Fichier de configuration

Emplacement des fichiers

Référence complète de la configuration

Référence des options

agent (utilisateur uniquement)

theme_mode (utilisateur uniquement)

autorisations

mcpServers

show_path (utilisateur uniquement)

unicode_mode (utilisateur uniquement)

show_hints (utilisateur uniquement)

include_gitignored_files (utilisateur uniquement)

respect_gitignore (utilisateur uniquement)

attribution (utilisateur uniquement)

subagents_enabled (utilisateur uniquement)

keymap (utilisateur uniquement)

auto_update (utilisateur uniquement)

keymap (utilisateur uniquement)

notify

read_config_from

proxy (utilisateur uniquement)

sandbox (utilisateur uniquement)

JSON avec commentaires

​Emplacement des fichiers

​Référence complète de la configuration

​Référence des options

​agent (utilisateur uniquement)

​theme_mode (utilisateur uniquement)

​autorisations

​mcpServers

​show_path (utilisateur uniquement)

​unicode_mode (utilisateur uniquement)

​show_hints (utilisateur uniquement)

​include_gitignored_files (utilisateur uniquement)

​respect_gitignore (utilisateur uniquement)

​attribution (utilisateur uniquement)

​subagents_enabled (utilisateur uniquement)

​keymap (utilisateur uniquement)

​auto_update (utilisateur uniquement)

​keymap (utilisateur uniquement)

​notify

​read_config_from

​proxy (utilisateur uniquement)

​sandbox (utilisateur uniquement)

​JSON avec commentaires

Emplacement des fichiers

Référence complète de la configuration

Référence des options

agent (utilisateur uniquement)

theme_mode (utilisateur uniquement)

autorisations

mcpServers

show_path (utilisateur uniquement)

unicode_mode (utilisateur uniquement)

show_hints (utilisateur uniquement)

include_gitignored_files (utilisateur uniquement)

respect_gitignore (utilisateur uniquement)

attribution (utilisateur uniquement)

subagents_enabled (utilisateur uniquement)

keymap (utilisateur uniquement)

auto_update (utilisateur uniquement)

keymap (utilisateur uniquement)

notify

read_config_from

proxy (utilisateur uniquement)

sandbox (utilisateur uniquement)

JSON avec commentaires