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

# Dépannage

> Problèmes courants et solutions

<div id="installation-issues">
  ## Problèmes d’installation
</div>

<AccordionGroup>
  <Accordion title="Échec de la commande d’installation (macOS / Linux / WSL)">
    Si le script d’installation ne parvient pas à se télécharger :

    1. Vérifiez votre connexion Internet
    2. Vérifiez que curl est installé : `which curl`
    3. Essayez avec une sortie détaillée : `curl -fsSL -v https://cli.devin.ai/install.sh | bash`

    Si vous êtes derrière un proxy d’entreprise, vous devrez peut-être configurer les paramètres du proxy :

    ```bash theme={null}
    export https_proxy=http://your-proxy:port
    curl -fsSL https://cli.devin.ai/install.sh | bash
    ```
  </Accordion>

  <Accordion title="Échec de la commande d’installation (Windows)">
    Si le script d’installation PowerShell échoue :

    1. Vérifiez votre connexion Internet
    2. Assurez-vous d’exécuter PowerShell en tant qu’utilisateur standard (pas en tant qu’administrateur, sauf si nécessaire)
    3. Si vous voyez une erreur de stratégie d’exécution, essayez :
       ```powershell theme={null}
       Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
       irm https://static.devin.ai/cli/setup.ps1 | iex
       ```
    4. Si vous êtes derrière un proxy d’entreprise, configurez les paramètres du proxy dans PowerShell avant d’exécuter la commande d’installation

    Au lieu d’utiliser le script PowerShell, vous pouvez aussi télécharger et exécuter directement le programme d’installation autonome :

    * [x86\_64](https://static.devin.ai/cli/devin-updater-x86_64-pc-windows.exe)
    * [ARM64](https://static.devin.ai/cli/devin-updater-aarch64-pc-windows.exe)
  </Accordion>

  <Accordion title="Autorisation refusée pendant l’installation">
    Le programme d’installation a besoin d’un accès en écriture pour installer le binaire. Si vous voyez des erreurs d’autorisation :

    1. Vérifiez que l’emplacement d’installation dispose des autorisations d’écriture
    2. N’exécutez pas le programme d’installation avec `sudo` — cela peut entraîner des problèmes de propriétaire
    3. Si vous installez dans un répertoire système, assurez-vous que votre utilisateur dispose des autorisations appropriées
  </Accordion>

  <Accordion title="Binaire introuvable après l’installation">
    Si l’installation se termine mais que `devin` reste introuvable :

    **macOS / Linux / WSL :**

    1. Redémarrez votre terminal ou exécutez `source ~/.bashrc` (ou `~/.zshrc`)
    2. Vérifiez si l’emplacement du binaire figure dans votre PATH : `echo $PATH`
    3. Vérifiez que le binaire existe : `ls -la ~/.local/bin/devin` (ou à l’emplacement d’installation affiché pendant la configuration)

    **Windows :**

    1. Redémarrez votre session PowerShell
    2. Vérifiez si l’emplacement du binaire figure dans votre PATH : `$env:PATH -split ';'`
    3. Vérifiez que le binaire existe à l’emplacement d’installation affiché pendant la configuration
  </Accordion>

  <Accordion title="Commande 'irm' ou 'iex' introuvable (Windows)">
    `irm` et `iex` sont des alias PowerShell. Si vous voyez cette erreur, c’est que vous exécutez la commande d’installation dans Git Bash ou CMD au lieu de PowerShell.

    **Correctif :** Ouvrez **PowerShell** et exécutez-y la commande d’installation :

    ```powershell theme={null}
    irm https://static.devin.ai/cli/setup.ps1 | iex
    ```

    Sinon, depuis Git Bash ou CMD, vous pouvez lancer PowerShell explicitement :

    ```bash theme={null}
    powershell -Command "irm https://cli.devin.ai/install.ps1 | iex"
    ```

    Après l’installation, vous pouvez utiliser Devin CLI depuis **PowerShell**, **Windows Terminal** ou **Git Bash**.
  </Accordion>
</AccordionGroup>

***

<div id="authentication-issues">
  ## Problèmes d'authentification
</div>

<AccordionGroup>
  <Accordion title="Échec de connexion ou délai d’attente dépassé">
    Si la connexion via le navigateur ne fonctionne pas :

    1. Essayez la procédure manuelle par jeton pour les sessions distantes/SSH :
       ```bash theme={null}
       devin auth login --force-manual-token-flow
       ```
    2. Vérifiez que votre navigateur peut accéder à l’URL d’authentification
    3. Vérifiez que l’accès à Devin CLI est activé pour votre compte Enterprise
  </Accordion>

  <Accordion title="'Non autorisé' ou erreurs d’autorisation">
    Si vous voyez des erreurs d’autorisation après vous être connecté :

    1. Vérifiez que votre compte dispose de l’autorisation requise pour accéder à Devin CLI. Vous devrez peut-être demander à votre administrateur. Pour les entreprises, consultez [Devin Auth](/fr/cli/enterprise/devin-auth#configuring-access) ou [Legacy Windsurf Auth](/fr/cli/enterprise/windsurf-auth#prerequisites) pour savoir comment configurer l’accès.
    2. Essayez de vous déconnecter puis de vous reconnecter : `devin auth logout && devin auth login`
    3. Vérifiez l’état de votre authentification : `devin auth status`
  </Accordion>

  <Accordion title="Jeton rejeté ou révoqué">
    Les jetons d’API de Devin CLI n’expirent pas par défaut. Si un jeton enregistré a été révoqué ou n’est plus accepté, supprimez-le avant de vous reconnecter :

    ```bash theme={null}
    devin auth logout && devin auth login
    ```

    pour remplacer vos identifiants enregistrés.
  </Accordion>
</AccordionGroup>

***

<div id="network-proxy-issues">
  ## Problèmes de réseau et de proxy
</div>

<AccordionGroup>
  <Accordion title="Les connexions échouent derrière un proxy d’entreprise">
    Le CLI fait transiter son propre trafic HTTPS sortant (authentification, mises à jour, appels d’API de modèle, serveurs MCP) par un proxy lorsqu’un proxy est configuré. Il existe deux façons de le définir :

    **Variables d’environnement** — le mode proxy `system`, utilisé par défaut, les prend en charge :

    ```bash theme={null}
    export HTTPS_PROXY=http://proxy.corp.example.com:8080
    export HTTP_PROXY=http://proxy.corp.example.com:8080
    export ALL_PROXY=socks5://proxy.corp.example.com:1080   # facultatif, SOCKS5
    export NO_PROXY=localhost,127.0.0.1,.internal.corp      # hôtes à exclure du proxy
    ```

    **`config.json`** — s’applique quel que soit l’environnement :

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

    Consultez la [référence de configuration `proxy`](/fr/cli/reference/configuration/config-file#proxy) pour voir toutes les options. Sur macOS et Windows, le mode `system` prend également en charge les paramètres PAC (Proxy Auto-Configuration) natifs de la plateforme.

    Si votre proxy effectue une inspection TLS, le CLI utilise le magasin de certificats de votre système d’exploitation. Installez donc l’autorité de certification racine du proxy au niveau du système d’exploitation (Trousseau d’accès sur macOS, magasin de certificats Windows ou bundle de certificats d’autorité de certification de votre distribution sur Linux).
  </Accordion>

  <Accordion title="Capturer les logs HTTP complets pour le débogage">
    Pour obtenir une visibilité complète sur le cycle de vie des requêtes (DNS, pool de connexions, négociation TLS, en-têtes, redirections et nouvelles tentatives), augmentez le niveau de log avec `RUST_LOG` et envoyez aussi les logs vers votre terminal avec `CHISEL_LOG_STDOUT` :

    ```bash theme={null}
    RUST_LOG="chisel=trace,windsurf_api_client=trace,connect_rpc=trace,reqwest=trace,hyper=trace,hyper_util=trace,rustls=trace" \
      CHISEL_LOG_STDOUT=1 \
      devin auth login
    ```

    Ce que chaque cible ajoute :

    * `chisel`, `windsurf_api_client`, `connect_rpc` — la journalisation propre au CLI des requêtes et de l’authentification
    * `reqwest=trace` — gestion de haut niveau des requêtes/réponses et des redirections
    * `hyper=trace` / `hyper_util=trace` — établissement des connexions, mise en pool et tramage HTTP/1.1 et HTTP/2
    * `rustls=trace` — détails de la négociation TLS (utile pour les problèmes de proxy et de certificat)

    Utilisez `CHISEL_LOG_STDERR=1` au lieu de `CHISEL_LOG_STDOUT=1` si vous ne voulez pas que les logs soient mêlés à la sortie de la commande. (La journalisation vers stdout est automatiquement désactivée dans le REPL interactif et le mode ACP afin d’éviter de corrompre leur sortie.)

    Les logs sont aussi toujours écrits dans un fichier de log propre à chaque exécution dans le répertoire de données du CLI, quelle que soit la valeur de ces variables d’environnement :

    * **macOS / Linux:** `~/.local/share/devin/cli/logs/devin_<timestamp>_<pid>.log`
    * **Windows:** `%APPDATA%\devin\cli\logs\devin_<timestamp>_<pid>.log`

    <Warning>
      Les logs au niveau trace peuvent inclure des données sensibles, comme des en-têtes `Authorization` et des tokens. Nettoyez la sortie des logs avant de la partager.
    </Warning>
  </Accordion>

  <Accordion title="Inspecter l’intégralité des corps de requête et de réponse">
    `RUST_LOG` expose le cycle de vie des requêtes, mais pas les charges utiles complètes. Pour capturer l’intégralité des corps de requête et de réponse, faites passer le CLI par un proxy d’interception tel que [mitmproxy](https://mitmproxy.org/) :

    ```bash theme={null}
    # Terminal 1 — démarrer le proxy d’interception :
    mitmproxy --listen-port 8080

    # Terminal 2 — faire pointer le CLI vers celui-ci :
    export HTTPS_PROXY=http://127.0.0.1:8080
    devin auth login
    ```

    Comme le CLI s’appuie sur le magasin de certificats du système d’exploitation, installez d’abord le certificat d’autorité de certification de mitmproxy (`~/.mitmproxy/mitmproxy-ca-cert.pem`) dans votre magasin de confiance système — sinon, la connexion TLS au proxy échouera.
  </Accordion>
</AccordionGroup>

***

<div id="runtime-issues">
  ## Problèmes d’environnement d’exécution
</div>

<AccordionGroup>
  <Accordion title="Modèle non disponible">
    Si vous voyez des erreurs indiquant qu’un modèle n’est pas disponible :

    1. Vérifiez si votre entreprise restreint les modèles disponibles dans [Team Settings](/fr/cli/enterprise/team-settings)
    2. Vérifiez que le nom du modèle est correct — utilisez `/model` pour voir les options disponibles
    3. Essayez un autre modèle : `devin --model sonnet -- your prompt`
  </Accordion>

  <Accordion title="Limitation de débit ou quota dépassé">
    Si vous atteignez les limites d’utilisation :

    1. Attendez quelques minutes avant de réessayer
    2. Consultez le tableau de bord d’utilisation de votre organisation pour vérifier l’état du quota
    3. Contactez votre administrateur si vous avez besoin de limites plus élevées
  </Accordion>

  <Accordion title="L’agent semble bloqué ou ne répond plus">
    Si l’agent cesse de répondre :

    1. Appuyez sur `Ctrl+C` pour interrompre l’opération en cours
    2. Essayez `/clear` pour démarrer une nouvelle session
    3. Vérifiez votre connexion réseau
    4. Redémarrez Devin CLI
  </Accordion>
</AccordionGroup>

***

<div id="mcp-server-issues">
  ## Problèmes avec les serveurs MCP
</div>

<AccordionGroup>
  <Accordion title="Le serveur ne démarre pas">
    Si un serveur MCP ne démarre pas :

    1. Vérifiez que la commande fonctionne hors de Devin CLI :
       ```bash theme={null}
       npx -y @modelcontextprotocol/server-github
       ```
    2. Vérifiez que toutes les variables d’environnement requises sont définies
    3. Recherchez les messages d’erreur dans la sortie du serveur
  </Accordion>

  <Accordion title="Les outils n’apparaissent pas">
    Si les outils MCP ne s’affichent pas :

    1. Le serveur peut avoir besoin d’un instant pour s’initialiser — attendez quelques secondes
    2. Vérifiez que le serveur est correctement configuré dans votre fichier de configuration
    3. Vérifiez que votre entreprise autorise les serveurs MCP dans les [Team Settings](/fr/cli/enterprise/team-settings)
  </Accordion>

  <Accordion title="Autorisation refusée pour les outils MCP">
    Par défaut, les outils MCP demandent une approbation. Pour approuver automatiquement des outils spécifiques, ajoutez-les à votre configuration des autorisations :

    ```json theme={null}
    {
      "permissions": {
        "allow": ["mcp__github__list_issues"]
      }
    }
    ```
  </Accordion>
</AccordionGroup>

***

<div id="getting-help">
  ## Obtenir de l’aide
</div>

Si vous rencontrez toujours des problèmes :

* **Contacter l’assistance par e-mail :** [support@cognition.ai](mailto:support@cognition.ai)
* **Signaler un bug :** Utilisez la commande `/bug` dans Devin CLI pour signaler directement les problèmes aux développeurs de Devin CLI
* **Vérifier les mises à jour :** Exécutez `devin update` pour vous assurer d’utiliser la dernière version