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

# Configurazione

> Come configurare il comportamento di Devin CLI tramite file di configurazione

Devin CLI si configura tramite file JSON (con supporto per i commenti) a livello utente e di progetto. Questi file di configurazione definiscono il modello dell'agente, le autorizzazioni, i server MCP e altro ancora.

***

<div id="config-file-locations">
  ## Posizioni dei file di configurazione
</div>

<Tabs>
  <Tab title="Configurazione utente">
    **Percorso:** `~/.config/devin/config.json`

    Le impostazioni predefinite personali che si applicano a tutti i progetti. Qui puoi impostare il modello, il tema e le autorizzazioni globali che preferisci.

    Puoi anche inserire un file `AGENTS.md` in questa directory (`~/.config/devin/AGENTS.md`) per definire [regole globali](/it/cli/extensibility/rules#global-rules) valide per ogni progetto.

    <Note>
      Su Windows, questo percorso è `%APPDATA%\devin\config.json` (in genere `C:\Users\<you>\AppData\Roaming\devin\config.json`).
    </Note>

    ```json theme={null}
    {
      "agent": { "model": "claude-sonnet-4.5" },
      "permissions": {
        "allow": ["Read(**)", "Exec(git)"]
      }
    }
    ```
  </Tab>

  <Tab title="Configurazione del progetto">
    **Percorso:** `.devin/config.json` (nella cartella radice del progetto)

    Configurazione condivisa del team inclusa nel controllo versione. Usala per server MCP specifici del progetto, criteri di autorizzazione e impostazioni di importazione.

    ```json theme={null}
    {
      "permissions": {
        "allow": ["Exec(npm run)", "Read(src/**)"],
        "deny": ["Exec(sudo)"]
      },
      "mcpServers": {
        "github": {
          "command": "npx",
          "args": ["-y", "@modelcontextprotocol/server-github"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Override locali">
    **Percorso:** `.devin/config.local.json`

    Override personali per questo progetto che non vengono inclusi in git (ignorati automaticamente da git). Usali per segreti, chiavi API e override delle preferenze personali.

    ```json theme={null}
    {
      "mcpServers": {
        "github": {
          "env": { "GITHUB_TOKEN": "ghp_your_token" }
        }
      }
    }
    ```
  </Tab>
</Tabs>

***

<div id="what-you-can-configure">
  ## Cosa puoi configurare
</div>

<CardGroup cols={2}>
  <Card title="Modello" icon="brain" href="/it/cli/models">
    Scegli quale modello di IA alimenta l'agente — da Claude Opus a GPT 5.2 a Gemini 3.
  </Card>

  <Card title="Autorizzazioni" icon="shield" href="/it/cli/reference/permissions">
    Pre-approva le azioni sicure, blocca quelle pericolose e controlla cosa può fare l'agente senza dover chiedere conferma.
  </Card>

  <Card title="Server MCP" icon="server" href="/it/cli/extensibility/mcp/configuration">
    Collega server di tool esterni per GitHub, Linear, database e qualsiasi API personalizzata.
  </Card>

  <Card title="Importazione di tool esterni" icon="arrow-right-to-bracket" href="/it/cli/extensibility/rules">
    Importa regole, skill e configurazioni da Cursor, Windsurf e Claude Code.
  </Card>
</CardGroup>

***

<div id="quick-start">
  ## Guida rapida
</div>

Il modo più rapido per iniziare è creare un file `.devin/config.json` nella directory radice del progetto:

```json theme={null}
{
  "permissions": {
    "allow": [
      "Read(**)",
      "Exec(git)",
      "Exec(npm run)"
    ]
  }
}
```

In questo modo approvi in anticipo la lettura dei file e i comandi più comuni, così l'agente non ti chiederà conferma per ogni azione.

<Tip>
  Puoi anche configurare Devin CLI in modo interattivo: quando l'agente chiede l'autorizzazione, scegli di salvare la decisione nelle impostazioni del progetto o dell'utente per le volte successive.
</Tip>

***

<div id="project-vs-user-settings">
  ## Settings di progetto e utente
</div>

Non tutte le impostazioni sono disponibili a tutti i livelli. Le configurazioni di progetto (`.devin/config.json` e `.devin/config.local.json`) supportano:

* **`permissions`** — regole `allow`, `deny` e `ask`
* **`mcpServers`** — definizioni di server MCP
* **`read_config_from`** — importa le impostazioni da Cursor, Windsurf e Claude
* **`hooks`** — hook del ciclo di vita ([vedi Hooks](/it/cli/extensibility/hooks/overview))

Tutte le altre impostazioni — incluse `agent` (modello), `theme_mode`, `unicode_mode`, `show_path`, `sandbox` e altre opzioni di visualizzazione e comportamento — sono **disponibili solo nella configurazione utente** e possono essere impostate solo nel file di configurazione utente (`~/.config/devin/config.json`; `%APPDATA%\devin\config.json` su Windows).

***

<div id="configuration-precedence">
  ## Precedenza della configurazione
</div>

Per le Settings che supportano più livelli, prevalgono le origini con priorità più alta:

| Priorità      | Origine                                                                          | Condivisa?           |
| ------------- | -------------------------------------------------------------------------------- | -------------------- |
| 1 (più alta)  | Settings dell'organizzazione / del team                                          | Sì (enterprise)      |
| 2             | Autorizzazioni della sessione (approvazioni interattive)                         | No (in memoria)      |
| 3             | Progetto locale (`.devin/config.local.json`)                                     | No (ignorato da git) |
| 4             | Progetto (`.devin/config.json`)                                                  | Sì (con commit)      |
| 5 (più bassa) | Utente (`~/.config/devin/config.json`; `%APPDATA%\devin\config.json` su Windows) | No (personale)       |

Le autorizzazioni vengono unite tra i vari livelli, mentre i server MCP vengono uniti per nome (a parità di nome, prevale l'origine con priorità più alta).

<Note>
  Le Settings a livello di organizzazione (enterprise) **non possono mai** essere sovrascritte dalla configurazione di progetto o dell'utente. Consulta [Configuration Precedence](/it/cli/reference/configuration/global-vs-local) per tutti i dettagli sul funzionamento dell'unione.
</Note>

***

<div id="limitations">
  ## Limitazioni
</div>

<Warning>
  Devin CLI non supporta i file `.codeiumignore`. Se usi il completamento automatico di Codeium e hai configurato dei pattern di esclusione, questi pattern non verranno applicati a Devin CLI.
</Warning>

***

<div id="learn-more">
  ## Scopri di più
</div>

<CardGroup cols={2}>
  <Card title="Riferimento completo per la configurazione" icon="file-code" href="/it/cli/reference/configuration/config-file">
    Elenco completo di tutte le opzioni di configurazione e del relativo formato.
  </Card>

  <Card title="precedenza della configurazione" icon="layer-group" href="/it/cli/reference/configuration/global-vs-local">
    Come interagiscono le impostazioni globali, di progetto e locali e quale prevale.
  </Card>
</CardGroup>