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

# Configuration

> Comment configurer le comportement de Devin CLI avec des fichiers de configuration

Devin CLI se configure à l’aide de fichiers JSON (prenant en charge les commentaires) aux niveaux utilisateur et projet. Ces fichiers de configuration définissent le modèle de l’agent, les autorisations, les serveurs MCP, etc.

***

<div id="config-file-locations">
  ## Emplacements des fichiers de configuration
</div>

<Tabs>
  <Tab title="Configuration utilisateur">
    **Chemin :** `~/.config/devin/config.json`

    Vos paramètres personnels par défaut qui s’appliquent à tous les projets. C’est ici que vous définissez votre modèle préféré, le thème et les permissions globales.

    Vous pouvez également placer un fichier `AGENTS.md` dans ce répertoire (`~/.config/devin/AGENTS.md`) pour définir des [règles globales](/fr/cli/extensibility/rules#global-rules) qui s’appliquent à chaque projet.

    <Note>
      Sous Windows, ce chemin est `%APPDATA%\devin\config.json` (généralement `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="Configuration du projet">
    **Chemin :** `.devin/config.json` (à la racine de votre projet)

    Configuration partagée par l’équipe et versionnée. Utilisez-la pour les serveurs MCP spécifiques au projet, les politiques d’autorisation et les paramètres d’import.

    ```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="Remplacements locaux">
    **Chemin :** `.devin/config.local.json`

    Remplacements personnels pour ce projet qui ne sont pas commités dans Git (automatiquement ignorés par Git). Utilisez-les pour les secrets, les clés d’API et les préférences personnelles.

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

***

<div id="what-you-can-configure">
  ## Ce que vous pouvez configurer
</div>

<CardGroup cols={2}>
  <Card title="Modèle" icon="brain" href="/fr/cli/models">
    Choisissez le modèle d’IA qui fait fonctionner l’agent — de Claude Opus à GPT 5.2, en passant par Gemini 3.
  </Card>

  <Card title="Autorisations" icon="shield" href="/fr/cli/reference/permissions">
    Approuvez à l’avance les actions sûres, bloquez les actions dangereuses et contrôlez ce que l’agent peut faire sans demander de confirmation.
  </Card>

  <Card title="Serveurs MCP" icon="server" href="/fr/cli/extensibility/mcp/configuration">
    Connectez des serveurs d’outils externes pour GitHub, Linear, les bases de données et toute API personnalisée.
  </Card>

  <Card title="Importation depuis des outils externes" icon="arrow-right-to-bracket" href="/fr/cli/extensibility/rules">
    Importez des règles, des skills et de la configuration depuis Cursor, Windsurf et Claude Code.
  </Card>
</CardGroup>

***

<div id="quick-start">
  ## Démarrage rapide
</div>

Pour commencer le plus rapidement possible, créez un `.devin/config.json` à la racine de votre projet :

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

Cela approuve à l’avance les lectures de fichiers et les commandes courantes, pour éviter que l’agent ne vous demande une confirmation à chaque action.

<Tip>
  Vous pouvez également configurer Devin CLI de manière interactive : lorsque l’agent demande une autorisation, choisissez d’enregistrer cette décision dans la configuration de votre projet ou dans vos paramètres utilisateur pour les prochaines fois.
</Tip>

***

<div id="project-vs-user-settings">
  ## Settings du projet vs de l’utilisateur
</div>

Les Settings ne sont pas tous disponibles à chaque niveau. Les configurations de projet (`.devin/config.json` et `.devin/config.local.json`) prennent en charge :

* **`permissions`** — règles d’autorisation, de refus et de demande
* **`mcpServers`** — définitions de serveurs MCP
* **`read_config_from`** — importation des Settings depuis Cursor, Windsurf et Claude
* **`hooks`** — hooks du cycle de vie ([voir Hooks](/fr/cli/extensibility/hooks/overview))

Tous les autres Settings — y compris `agent` (modèle), `theme_mode`, `unicode_mode`, `show_path`, `sandbox` et les autres options d’affichage et de comportement — sont **réservés à la configuration utilisateur** et ne peuvent être définis que dans la configuration utilisateur (`~/.config/devin/config.json`; `%APPDATA%\devin\config.json` sous Windows).

***

<div id="configuration-precedence">
  ## Ordre de priorité de la configuration
</div>

Pour les Settings qui prennent en charge plusieurs niveaux, les sources ayant la priorité la plus élevée l’emportent :

| Priorité           | Source                                                                                  | Partagé ?            |
| ------------------ | --------------------------------------------------------------------------------------- | -------------------- |
| 1 (la plus élevée) | Settings de l’organisation / du Team                                                    | Oui (entreprise)     |
| 2                  | Autorisations de session (approbations interactives)                                    | Non (en mémoire)     |
| 3                  | Local au projet (`.devin/config.local.json`)                                            | Non (ignoré par Git) |
| 4                  | Projet (`.devin/config.json`)                                                           | Oui (validé)         |
| 5 (la plus basse)  | Utilisateur (`~/.config/devin/config.json`; `%APPDATA%\devin\config.json` sous Windows) | Non (personnel)      |

Les autorisations sont fusionnées entre les différents niveaux, tandis que les serveurs MCP sont fusionnés par nom (en cas de doublon, la source ayant la priorité la plus élevée l’emporte).

<Note>
  Les Settings au niveau de l’organisation (entreprise) ne peuvent **jamais** être remplacés par la configuration du projet ou de l’utilisateur. Consultez [Ordre de priorité de la configuration](/fr/cli/reference/configuration/global-vs-local) pour plus de détails sur le fonctionnement de la fusion.
</Note>

***

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

<Warning>
  Devin CLI ne prend pas en charge les fichiers `.codeiumignore`. Si vous utilisez l’autocomplétion de Codeium et si vous avez configuré des motifs d’exclusion, ces motifs ne s’appliqueront pas à Devin CLI.
</Warning>

***

<div id="learn-more">
  ## En savoir plus
</div>

<CardGroup cols={2}>
  <Card title="Référence complète de la configuration" icon="file-code" href="/fr/cli/reference/configuration/config-file">
    Liste complète de toutes les options de configuration et de leur format.
  </Card>

  <Card title="Ordre de priorité de la configuration" icon="layer-group" href="/fr/cli/reference/configuration/global-vs-local">
    Comment les Settings globaux, du projet et locaux interagissent entre eux.
  </Card>
</CardGroup>