File di configurazione

La CLI di Devin usa file JSON (con supporto ai commenti) per la configurazione. Questa pagina descrive tutte le opzioni disponibili.

Percorsi dei file

File	Scopo
`~/.config/devin/config.json`	Settings a livello di utente
`.devin/config.json`	Settings del progetto (incluse nel commit)
`.devin/config.local.json`	Override locali del progetto (ignorate da Git)
`~/.config/devin/mcp_config.json`	Server MCP a livello di utente
`.devin/mcp_config.json`	Server MCP del progetto (incluse nel commit)
`.devin/mcp_config.local.json`	Server MCP locali del progetto (ignorate da Git)
File di policy di sistema	Settings a livello di macchina, gestite dall’amministratore (`system.json`)

Su Windows, i percorsi della configurazione utente sono %APPDATA%\devin\config.json e %APPDATA%\devin\mcp_config.json (ad es. C:\Users\<you>\AppData\Roaming\devin\config.json), non ~\.config\devin\.

I server MCP sono stati spostati nei file dedicati mcp_config.json nella versione v3000.3 (la release Local 3.6). Le versioni precedenti li memorizzano invece nella chiave mcpServers dei file di configurazione principali; le versioni più recenti migrano automaticamente all’avvio tutte le voci mcpServers trovate lì. Vedi mcpServers.

Riferimento completo della configurazione

Configurazione utente
Configurazione del progetto

// ~/.config/devin/config.json
{
  // Comportamento dell'agente
  "agent": {
    "model": "swe-1-6-fast",           // Modello predefinito
    "show_history_on_continue": true  // Mostra i messaggi quando riprendi
  },

  // Tema
  "theme_mode": null,            // "light", "dark", "terminal-dark", "terminal-light", "nocolor" oppure null (automatico)

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

  // Visualizzazione
  "show_path": false,             // Mostra la CWD nel bordo del campo di input
  "unicode_mode": "auto",         // "auto", "unicode" oppure "ascii"
  "show_hints": true,             // Mostra i suggerimenti tra un turno e l'altro

  // Completamento dei file
  "include_gitignored_files": false, // Include i file ignorati da git nei completamenti @

  // Accesso ai file
  "respect_gitignore": false,        // Impedisce l'accesso degli strumenti ai percorsi ignorati da git

  // Attribuzione di commit e PR
  "attribution": true,            // Aggiunge "Generated with Devin" / Co-Authored-By ai commit e alle PR

  // Subagent
  "subagents_enabled": true,      // Consente all'agente di generare subagent

  // Override delle associazioni di tasti, indicizzati per contesto e poi action
  "keymap": {
    "global": { "clear_screen": "ctrl-shift-k" }
  },

  // Aggiornamenti
  "auto_update": true,            // Installa le nuove versioni in background

  // Override delle associazioni di tasti (contesto -> action -> specifica/e del tasto)
  "keymap": {},

  // Notifiche
  "notify": "smart",              // "never" | "smart" | "always" — notifiche nel terminale

  // Impostazioni proxy per il traffico HTTP della CLI
  "proxy": {
    "mode": "system",           // "system" | "manual" | "off"
    "url": null,                // URL del proxy (obbligatorio per la modalità manuale)
    "no_proxy": null            // Elenco di esclusione separato da virgole
  },

  // Filtraggio di rete della sandbox
  "sandbox": {
    "allowed_domains": [],       // Allowlist di domini (vuoto = nessun filtro)
    "denied_domains": [],        // Denylist di domini (ha la precedenza)
    "network_mode": "full"       // "full" oppure "limited" (solo GET/HEAD/OPTIONS)
  },

  // Importa le impostazioni da altri strumenti
  "read_config_from": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}

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

  // Importa le impostazioni da altri strumenti
  "read_config_from": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}

Riferimento opzioni

Le opzioni contrassegnate con Solo utente possono essere impostate solo nella configurazione utente (~/.config/devin/config.json; %APPDATA%\devin\config.json in Windows). Solo permissions, read_config_from e hooks sono disponibili nelle configurazioni di progetto. Anche mcpServers può essere impostato a entrambi i livelli, ma si trova nei file dedicati mcp_config.json (vedi mcpServers).

agent (solo utente)

Opzione	Tipo	Predefinito	Descrizione
`model`	string	`"swe-1-6-fast"`	Modello di IA predefinito
`show_history_on_continue`	boolean	`true`	Mostra i messaggi precedenti alla ripresa di una sessione

theme_mode (solo utente)

Valore	Comportamento
`null`	Rilevamento automatico (chiede alla prima esecuzione)
`"light"`	Tema chiaro
`"dark"`	Tema scuro
`"terminal-dark"`	Tema scuro quantizzato a 16 colori ANSI (rispetta lo schema di colori del terminale)
`"terminal-light"`	Tema chiaro quantizzato a 16 colori ANSI (rispetta lo schema di colori del terminale)
`"nocolor"`	Nessun output a colori (monocromatico, utile per i terminali VT100)

autorizzazioni

Consulta Autorizzazioni per la documentazione completa.

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

mcpServers

Mappa che associa il nome del server alla relativa configurazione. Supporta sia i comandi locali (stdio) sia i server HTTP remoti. Vedi Configurazione MCP. Dalla versione v3000.3 (la release Local 3.6), i server MCP si trovano in file dedicati: ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json su Windows), .devin/mcp_config.json e .devin/mcp_config.local.json. Nelle versioni precedenti, la chiave mcpServers si trova direttamente nei file di configurazione principali; le versioni più recenti la migrano automaticamente nei file dedicati all’avvio.

// 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 (solo utente)

Mostra il percorso della directory di lavoro corrente nel bordo del campo di input. Quando è abilitato, il bordo superiore del campo di input mostra il CWD in formato semplificato (ad es. ~/projects/my-app).

Valore	Comportamento
`false`	Nascosto (predefinito)
`true`	Mostra il percorso del CWD nel bordo del campo di input

unicode_mode (solo utente)

Determina se l’interfaccia utente del terminale usa simboli Unicode o alternative compatibili con ASCII. Imposta "ascii" se il terminale o il font non visualizzano correttamente i glifi Unicode (ad es. se il simbolo ⏺ appare come un riquadro).

Valore	Comportamento
`"auto"`	Rileva il supporto Unicode dall’ambiente (predefinito)
`"unicode"`	Usa sempre simboli Unicode
`"ascii"`	Usa sempre caratteri compatibili con ASCII

show_hints (solo utente)

Mostra suggerimenti occasionali tra un turno e l’altro (ad es. “Lo sapevi? Usa /model per passare da un modello disponibile all’altro”). Utile per scoprire le funzionalità della CLI; impostalo su false per disattivarli una volta che hai preso confidenza.

Valore	Comportamento
`true`	Mostra suggerimenti occasionalmente (predefinito)
`false`	Non mostra mai i suggerimenti

include_gitignored_files (solo utente)

Include i file ignorati da git nei risultati del completamento tab @. Quando questa opzione è abilitata, i file che corrispondono ai criteri di .gitignore compariranno nei completamenti delle menzioni @. È utile se conservi documentazione o altri file in directory ignorate da git che vuoi poter richiamare.

Valore	Comportamento
`false`	Esclude i file ignorati da git dai completamenti (predefinito)
`true`	Include i file ignorati da git nei completamenti `@`

respect_gitignore (solo utente)

Controlla se l’agente rispetta .gitignore durante la lettura o la scrittura di file tramite i tool. Se abilitata, le chiamate ai tool che accedono a percorsi esclusi da .gitignore vengono bloccate. Questa impostazione è separata da include_gitignored_files, che influisce solo sul completamento nella tab @.

Valore	Comportamento
`false`	L’agente può accedere a tutti i file indipendentemente da `.gitignore` (predefinito)
`true`	Blocca l’accesso dei tool ai percorsi esclusi da `.gitignore`

attribution (solo utente)

Controlla se l’agente aggiunge l’attribuzione a Devin nei commit e nelle pull request che crea. Quando è abilitata, il corpo dei commit e delle PR include una riga Generated with [Devin] e il trailer Co-Authored-By: Devin. Imposta su false per omettere entrambi, così non verrà aggiunta alcuna attribuzione a Devin.

Valore	Comportamento
`true`	Aggiunge la riga `Generated with [Devin]` e il trailer `Co-Authored-By` ai commit e alle PR (predefinito)
`false`	Omette qualsiasi attribuzione a Devin da commit e PR

subagents_enabled (solo utente)

Stabilisci se l’agente può delegare il lavoro ai subagent. Se disabilitata, gli strumenti run_subagent e read_subagent vengono rimossi e l’agente esegue tutto il lavoro autonomamente. La modifica di questa impostazione viene applicata in tempo reale: una sessione in esecuzione la recepisce senza dover essere riavviata.

Valore	Comportamento
`true`	L’agent può avviare subagent (impostazione predefinita)
`false`	I subagent sono disabilitati per questo utente

La policy dell’organizzazione ha la precedenza: se un admin ha disabilitato i subagent per la tua org (tramite l’impostazione Default subagent model), i subagent rimangono disabilitati indipendentemente da questa impostazione.

keymap (solo utente)

Sovrascrivi le scorciatoie da tastiera predefinite della CLI. La sezione contiene una tabella di contesti (global, editor, input, list, …), ciascuno dei quali associa i nomi delle azioni ai tasti che le attivano. Le azioni non elencate mantengono le impostazioni predefinite integrate.

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

Valore	Significato
`"ctrl-shift-k"`	Una singola combinazione di tasti associata all’azione
`["ctrl-r", "f3"]`	Più combinazioni di tasti, ciascuna delle quali attiva l’azione
`[]`	Rimuove l’associazione dell’azione

Una combinazione di tasti è un elenco di modificatori separati da - (ctrl, alt, shift), seguito dal nome di un tasto (un carattere o un tasto denominato come enter, esc, tab, home, page-up, f5). L’ordine dei modificatori non è rilevante e la corrispondenza non distingue tra maiuscole e minuscole, tranne nel caso di un singolo carattere maiuscolo, che associa il tasto con Maiusc ("K" equivale a "shift-k").

Esegui /shortcuts per visualizzare ogni azione con il relativo identificatore context.action — gli stessi identificatori usati qui — e riassegnare le combinazioni in modo interattivo. Le associazioni impostate lì vengono salvate in questa sezione.

global.cancel (Ctrl+C) non può essere dissociato, quindi puoi sempre interrompere un agente in esecuzione. Le voci non valide, i contesti o le azioni sconosciuti e gli override che entrerebbero in conflitto con un’altra scorciatoia nello stesso contesto vengono segnalati all’avvio e ripristinano il valore predefinito integrato.

auto_update (solo utente)

Controlla l’aggiornamento automatico in background su macOS e Linux. Quando è abilitato, le nuove release vengono scaricate e attivate mentre Devin CLI è in esecuzione, così alla successiva esecuzione di devin viene usata automaticamente la versione più recente. La sessione attualmente in esecuzione non è interessata: la sostituzione del collegamento simbolico current ha effetto solo all’avvio successivo. L’aggiornamento è progettato per essere sicuro anche in caso di interruzione: ogni passaggio sul filesystem viene preparato in un percorso temporaneo e reso effettivo con una ridenominazione atomica, mentre gli aggiornamenti concorrenti vengono serializzati tramite un lock su file. Se si esce durante l’aggiornamento, l’installazione non può rimanere in uno stato danneggiato — al successivo avvio verrà semplicemente usata la versione precedente. Si applica solo alle installazioni gestite autonomamente (curl | bash su macOS/Linux). Le installazioni incluse in un altro prodotto (ad es. Windsurf) ignorano questa impostazione e si aggiornano tramite l’applicazione principale.

Value	Behavior
`true`	Scarica e installa le nuove versioni in background (predefinito)
`false`	Verifica solo la presenza di nuove versioni; installa manualmente tramite `/update`

keymap (solo utente)

Sovrascrive le scorciatoie da tastiera. Gli override sono definiti in base al contesto e poi all’action: l’identificatore context.action mostrato per ciascuna scorciatoia in /shortcuts (ad es. 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"]
    }
  }
}

Valore	Comportamento
`"<spec>"`	Associa l’action a un singolo tasto
`["<spec>", ...]`	Associa l’action a più tasti (tutti la attivano)
`[]`	Rimuove l’associazione dell’action

Gli override sostituiscono completamente le impostazioni predefinite integrate per quell’action; le action non elencate mantengono le proprie impostazioni predefinite. Non è possibile rimuovere l’associazione di Ctrl+C (annulla). Le voci non valide (nomi sconosciuti, combinazioni di tasti errate, valori di tipo errato o override in conflitto con un’altra associazione nello stesso contesto) vengono segnalate come avvisi all’avvio e ignorate; il resto della configurazione viene comunque applicato. Una combinazione di tasti è composta da zero o più modificatori separati da -, seguiti da un nome di tasto (ad es. ctrl-shift-p, alt-enter, f5, K). Modificatori: ctrl/control/c, alt/meta/option/opt/m, shift/s. Tasti denominati: enter, esc, tab, backspace, delete, insert, up, down, left, right, home, end, page-up, page-down, space, f1–f24. Qualsiasi altro singolo carattere associa il tasto corrispondente (con distinzione tra maiuscole e minuscole: K associa Maiusc+K); usa - per il tasto meno (ctrl--). Puoi anche riassegnare i tasti interattivamente: in /shortcuts, premi Enter su una riga di scorciatoia, quindi premi il nuovo tasto; la modifica viene salvata in questa sezione keymap. Consulta Personalizzazione delle associazioni di tasti.

notify

Controlla le notifiche del terminale quando l’agente termina o richiede input dell’utente. La CLI scrive un carattere BEL (attiva il campanello del terminale / campanello visivo), una sequenza di escape OSC 9 (attiva una notifica di sistema in iTerm2 e nei terminali compatibili) e una sequenza OSC 777 (notifica desktop in rxvt-unicode e altri terminali). I terminali che non riconoscono queste sequenze le ignorano senza problemi.

Value	Behavior
`"never"`	Nessuna notifica
`"smart"`	Invia una notifica solo quando la finestra del terminale non è attiva (usa la segnalazione del focus tramite OSC) (predefinito)
`"always"`	Invia una notifica per ogni evento pertinente, indipendentemente dal focus

read_config_from

Controlla l’importazione da configurazioni di altri strumenti AI:

Opzione	Tipo	Predefinito	Descrizione
`cursor`	boolean/null	`true`	Importa da `.cursor/rules/`
`windsurf`	boolean/null	`true`	Importa da `.windsurf/rules/`
`claude`	boolean/null	`true`	Importa da `.claude/`

Imposta su false per disattivare un’importazione specifica. null viene considerato come true.

proxy (solo utente)

Configura come la CLI instrada il proprio traffico HTTP/HTTPS in uscita (chiamate API, aggiornamenti, server MCP, ecc.). Questo non influisce sulla connettività di rete dei processi figlio nella sandbox (vedi sandbox più sotto). Il campo mode seleziona la strategia proxy:

Modalità	Comportamento
`"system"` (predefinito)	Usa le variabili d’ambiente (`HTTP_PROXY`, `HTTPS_PROXY`, `ALL_PROXY`) e il PAC (Proxy Auto-Configuration) nativo della piattaforma su macOS e Windows
`"manual"`	Instrada tutto il traffico della CLI tramite l’`url` specificato
`"off"`	Si connette direttamente — senza proxy

Opzione	Tipo	Predefinito	Descrizione
`mode`	string	`"system"`	Strategia proxy: `"system"`, `"manual"` oppure `"off"`
`url`	string/null	`null`	URL del proxy. Obbligatorio quando `mode` è `"manual"`. Supporta gli schemi `http://`, `https://` e `socks5://`
`no_proxy`	string/null	`null`	Elenco di host/domini separati da virgole che bypassano il proxy. Usa la stessa sintassi della variabile d’ambiente `NO_PROXY` (ad es. `"localhost,127.0.0.1,.corp.example.com"`). Si applica in qualsiasi modalità

Esempio — proxy aziendale:

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

Esempio — disattivare il proxy:

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

Gli amministratori possono impostare lo stesso blocco proxy nel file di configurazione di sistema a livello di macchina. L’impostazione Enterprise ha la precedenza; configurare un proxy in entrambi i file genera un errore — rimuovi la sezione proxy dalla tua configurazione utente se la tua organizzazione la gestisce.

sandbox (solo utente)

Il filtraggio di rete della sandbox è attualmente instabile. Se ti serve questa funzionalità, contatta il referente del tuo account per conoscere le tempistiche di stabilizzazione.

Configura il filtraggio di rete a livello di dominio per la sandbox. Quando --sandbox è attivo e il filtraggio dei domini è configurato, viene avviato un proxy di rete gestito sull’interfaccia loopback e la sandbox limita tutto il traffico dei processi figli affinché venga instradato attraverso di esso.

Per una panoramica completa di come funziona la sandbox — inclusa l’applicazione forzata in Enterprise e come interagiscono le impostazioni Enterprise e utente — consulta la documentazione della sandbox.

Il flag --sandbox applica a livello di sistema operativo i percorsi scrivibili e le regole deny. I percorsi radice scrivibili derivano dagli ambiti Write(...) concessi più le directory del workspace; tutto il resto è leggibile, eccetto i percorsi nascosti dalle regole deny di Read(...). Gli ambiti Write(...) concessi durante la sessione espandono dinamicamente la sandbox per i comandi successivi.

Se viene passato --sandbox ma la risoluzione della sandbox non riesce (ad es. gli strumenti di sandboxing non sono disponibili sulla piattaforma corrente), la CLI si rifiuterà di avviarsi invece di eseguirsi senza sandbox. Questo comportamento fail-closed garantisce che l’intento di sicurezza di --sandbox non venga mai eluso silenziosamente.

Opzione	Tipo	Predefinito	Descrizione
`allowed_domains`	string[]	`[]`	Pattern di dominio consentiti dal proxy. Quando non è vuoto, sono consentiti solo i domini corrispondenti (modalità allowlist)
`denied_domains`	string[]	`[]`	Pattern di dominio sempre bloccati. Le regole di blocco hanno la precedenza sulle regole di autorizzazione
`network_mode`	string	`"full"`	`"full"` consente tutti i metodi HTTP; `"limited"` consente solo GET/HEAD/OPTIONS

Sintassi dei pattern di dominio:

Pattern	Corrispondenza
`example.com`	Solo corrispondenza esatta
`*.example.com`	Qualsiasi sottodominio (non il dominio principale)
`**.example.com`	Dominio principale e qualsiasi sottodominio

Esempio:

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

Il filtraggio dei domini si applica quando la sandbox è attiva (--sandbox). Senza --sandbox, la sezione della sandbox viene ignorata.

Per i team Enterprise, gli admin possono impostare un override per gli elenchi di domini tramite Team Settings. Le allowlist Enterprise prevalgono (sostituiscono il tuo allowed_domains locale), mentre le denylist Enterprise sono additive (si uniscono al tuo denied_domains locale).

JSON con commenti

I file di configurazione supportano i commenti in stile JavaScript:

{
  // Commenti di riga
  "agent": {
    "model": "sonnet"  // Commenti inline
  },
  /* Commenti
     a blocco */
  "permissions": {}
}

Per iniziare

Integrazioni dell'Editor

Estensibilità

Enterprise

Riferimento

Changelog

File di configurazione

Percorsi dei file

Riferimento completo della configurazione

Riferimento opzioni

agent (solo utente)

theme_mode (solo utente)

autorizzazioni

mcpServers

show_path (solo utente)

unicode_mode (solo utente)

show_hints (solo utente)

include_gitignored_files (solo utente)

respect_gitignore (solo utente)

attribution (solo utente)

subagents_enabled (solo utente)

keymap (solo utente)

auto_update (solo utente)

keymap (solo utente)

notify

read_config_from

proxy (solo utente)

sandbox (solo utente)

JSON con commenti

​Percorsi dei file

​Riferimento completo della configurazione

​Riferimento opzioni

​agent (solo utente)

​theme_mode (solo utente)

​autorizzazioni

​mcpServers

​show_path (solo utente)

​unicode_mode (solo utente)

​show_hints (solo utente)

​include_gitignored_files (solo utente)

​respect_gitignore (solo utente)

​attribution (solo utente)

​subagents_enabled (solo utente)

​keymap (solo utente)

​auto_update (solo utente)

​keymap (solo utente)

​notify

​read_config_from

​proxy (solo utente)

​sandbox (solo utente)

​JSON con commenti

Percorsi dei file

Riferimento completo della configurazione

Riferimento opzioni

agent (solo utente)

theme_mode (solo utente)

autorizzazioni

mcpServers

show_path (solo utente)

unicode_mode (solo utente)

show_hints (solo utente)

include_gitignored_files (solo utente)

respect_gitignore (solo utente)

attribution (solo utente)

subagents_enabled (solo utente)

keymap (solo utente)

auto_update (solo utente)

keymap (solo utente)

notify

read_config_from

proxy (solo utente)

sandbox (solo utente)

JSON con commenti