Passer au contenu principal

​
Problèmes d’installation

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 :
export https_proxy=http://your-proxy:port
curl -fsSL https://cli.devin.ai/install.sh | bash
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 : 
    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 :
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
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
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 :
irm https://static.devin.ai/cli/setup.ps1 | iex
Sinon, depuis Git Bash ou CMD, vous pouvez lancer PowerShell explicitement :
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.

​
Problèmes d’authentification

Si la connexion via le navigateur ne fonctionne pas :
  1. Essayez la procédure manuelle par jeton pour les sessions distantes/SSH : 
    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
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 ou Windsurf Auth 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
Les jetons d’authentification expirent périodiquement. Exécutez simplement :
devin auth login
pour actualiser vos identifiants.

​
Problèmes de réseau et de proxy

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 :
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 :
{
  "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 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).
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 :
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
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.
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 :
# 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.

​
Problèmes d’environnement d’exécution

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

​
Problèmes avec les serveurs MCP

Si un serveur MCP ne démarre pas :
  1. Vérifiez que la commande fonctionne hors de Devin CLI : 
    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
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
Par défaut, les outils MCP demandent une approbation. Pour approuver automatiquement des outils spécifiques, ajoutez-les à votre configuration des autorisations :
{
  "permissions": {
    "allow": ["mcp__github__list_issues"]
  }
}

​
Obtenir de l’aide

Si vous rencontrez toujours des problèmes :
  • Contacter l’assistance par e-mail : 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