# Dépannage (/fr/docs/verdent-for-vscode/help-support/common-issues)

> Problèmes courants, diagnostics et solutions



### Ce que vous allez apprendre [#ce-que-vous-allez-apprendre]

Procédures de dépannage courantes, étapes de diagnostic et solutions de contournement pour les problèmes connus de Verdent for VS Code.

<Info>
  Un dépannage détaillé des principaux problèmes signalés par les utilisateurs est en cours de compilation à partir des données du support. Cette page fournit des procédures de diagnostic générales. Contactez [support@verdent.ai](mailto:support@verdent.ai) pour les problèmes spécifiques non couverts ici.
</Info>

***

## Diagnostics rapides [#diagnostics-rapides]

<Tabs>
  <Tab title="Erreurs de service (les plus courantes)">
    ### « Service is experiencing high traffic. Please try again later! » [#-service-is-experiencing-high-traffic-please-try-again-later-]

    **C'est l'erreur la plus fréquemment rencontrée** par les utilisateurs. Elle indique que le service Verdent est temporairement surchargé.

    **Quand cela se produit :**

    * Pendant les périodes de forte utilisation
    * Lorsque les services backend sont fortement sollicités
    * Dégradation temporaire du service

    **Étapes de récupération (dans l'ordre) :**

    <Steps>
      <Step title="Annuler le message" stepNumber="1">
        Si l'erreur persiste, annulez le message le plus récent :

        * Cliquez sur le bouton d'annulation/retour en arrière dans l'interface de discussion
        * Renvoyez votre demande après une brève attente
      </Step>

      <Step title="Démarrer une nouvelle session" stepNumber="2">
        Si les erreurs persistent, démarrez une nouvelle session :

        * Cliquez sur le bouton « + » (Nouvelle session) dans la barre supérieure
        * Cela efface le contexte et les approbations d'outils
        * Renvoyez votre demande dans la session propre
      </Step>

      <Step title="Attendre et réessayer" stepNumber="3">
        Attendez 30 à 60 secondes et réessayez votre demande. La plupart des problèmes de service se résolvent rapidement.
      </Step>
    </Steps>

    <Warning>
      Si le problème persiste pendant plus de 5 à 10 minutes sur plusieurs sessions, consultez la \[page de statut de [Verdent](https://verdent.ai/status) ou contactez [support@verdent.ai](mailto:support@verdent.ai).
    </Warning>
  </Tab>

  <Tab title="Installation et configuration">
    ### Problèmes d'installation et de configuration [#problèmes-dinstallation-et-de-configuration]

    **Prérequis système :**

    * **Version de VS Code :** 1.90.0 ou ultérieure (requise)
    * **Connexion Internet :** connexion active requise
    * **Abonnement :** abonnement Verdent actif

    **Liste de vérification de diagnostic de base :**

    1. **Vérifiez la version de VS Code :** Aide → À propos (doit être 1.90.0 ou supérieure)
    2. **Vérifiez la connexion Internet :** Verdent nécessite une connexion active
    3. **Vérifiez l'abonnement :** assurez-vous que l'abonnement Verdent est actif
    4. **Redémarrez VS Code :** après une installation ou des modifications de configuration
    5. **Vérifiez le statut de l'extension :** Affichage → Extensions → Verdent (doit afficher « Activé »)

    **Procédure de réinstallation complète :**

    <Steps>
      <Step title="Désinstaller Verdent">
        Affichage → Extensions → Verdent → Désinstaller
      </Step>

      <Step title="Redémarrer VS Code">
        Fermez complètement puis rouvrez VS Code
      </Step>

      <Step title="Réinstaller Verdent">
        Affichage → Extensions → Recherchez « Verdent » → Installer
      </Step>
    </Steps>

    **Vérifier les journaux :**

    * Ouvrez le panneau de sortie : Affichage → Sortie
    * Sélectionnez « Verdent » dans le menu déroulant
    * Recherchez les messages d'erreur ou les traces de pile

    <Info>
      La plupart des problèmes d'installation se résolvent avec un simple rechargement de VS Code ou une réinstallation complète. Si les problèmes persistent, consultez les journaux et contactez le support avec les détails des journaux.
    </Info>
  </Tab>

  <Tab title="Authentification et compte">
    ### Impossible de se connecter à Verdent for VS Code [#impossible-de-se-connecter-à-verdent-for-vs-code]

    **Cause la plus courante :** problème de configuration de proxy

    **Solution :**

    <Steps>
      <Step title="Ouvrir les paramètres de VS Code">
        Appuyez sur `Cmd+,` (macOS) ou `Ctrl+,` (Windows/Linux)
      </Step>

      <Step title="Rechercher le paramètre de proxy">
        Recherchez « useProxy » ou « verdent.enableProxy » dans la barre de recherche des paramètres
      </Step>

      <Step title="Basculer le statut du proxy">
        Activez ou désactivez le paramètre de proxy (état inverse de l'état actuel)
      </Step>

      <Step title="Réessayer la connexion">
        Essayez à nouveau de vous connecter à Verdent
      </Step>
    </Steps>

    <Info>
      Si vous êtes derrière un pare-feu d'entreprise, vous devrez peut-être activer le paramètre de proxy. Si vous êtes sur un réseau domestique, essayez de le désactiver.
    </Info>

    ***

    ### Crédits d'essai gratuit non reçus [#crédits-dessai-gratuit-non-reçus]

    **Erreur :** les crédits d'essai gratuit n'ont pas été reçus ou l'accès à l'essai gratuit a été refusé

    **Raison :** violation des conditions d'utilisation détectée lors de l'inscription

    **Résolution :** contactez [support@verdent.ai](mailto:support@verdent.ai) pour obtenir de l'aide concernant votre accès à l'essai gratuit. L'équipe du support examinera votre compte et vous aidera à résoudre le problème.

    ***

    ### Échec de l'inscription [#échec-de-linscription]

    **Erreur :** l'inscription du compte a été rejetée ou restreinte

    **Raison :** l'inscription a enfreint les conditions d'utilisation de Verdent, entraînant une restriction d'accès

    **Résolution :** contactez [support@verdent.ai](mailto:support@verdent.ai) pour obtenir de l'aide. L'équipe du support peut examiner votre inscription et vous fournir des conseils pour résoudre le problème.

    ***

    ### Modèles manquants (Claude, GPT, Gemini) [#modèles-manquants-claude-gpt-gemini]

    **Problème :** impossible de trouver les modèles Claude, GPT ou Gemini dans la sélection de modèles

    **Raison :** restrictions géographiques imposées par les fournisseurs de modèles

    **Explication :** certains fournisseurs de modèles d'IA appliquent des restrictions régionales qui empêchent certains modèles d'être disponibles dans des zones géographiques spécifiques. Lorsque cela se produit :

    * Les modèles restreints n'apparaissent pas dans votre menu de sélection de modèles
    * Vous pouvez toujours utiliser tous les autres modèles disponibles sans interruption
    * Aucun impact sur votre abonnement ou vos crédits

    **Vérifier les modèles disponibles :** consultez [https://www.verdent.ai/regions](https://www.verdent.ai/regions) pour voir quels modèles sont disponibles dans votre région

    <Note>
      Les restrictions régionales sont définies par les fournisseurs de modèles d'IA (Anthropic, OpenAI, Google), et non par Verdent. Verdent ne peut pas outrepasser ces restrictions.
    </Note>
  </Tab>

  <Tab title="Performance">
    ### Problèmes de performance [#problèmes-de-performance]

    **Symptômes :**

    * Temps de réponse lents
    * Erreurs de fenêtre de contexte pleine
    * Délais d'expiration d'exécution des outils

    **Causes courantes et solutions :**

    | Problème                       | Cause                           | Solution                                                                             |
    | ------------------------------ | ------------------------------- | ------------------------------------------------------------------------------------ |
    | Réponses lentes                | Lecture de fichiers volumineux  | Utilisez des plages de lignes : `file_read("file.js", start_line=100, max_lines=50)` |
    | Contexte plein                 | Historique de conversation long | Déléguez à des sous-agents ou démarrez une nouvelle conversation                     |
    | Délais d'expiration des outils | Commandes bash de longue durée  | Définissez un délai explicite ou divisez en commandes plus petites                   |
    | Utilisation mémoire élevée     | Trop d'opérations parallèles    | Limitez les exécutions d'outils simultanées                                          |

    <Tip>
      Déléguez les tâches d'exploration au sous-agent @Explorer pour préserver le contexte principal.
    </Tip>
  </Tab>

  <Tab title="Erreurs d'image">
    ### Messages d'erreur liés aux images [#messages-derreur-liés-aux-images]

    **Référence rapide des erreurs courantes de traitement d'image :**

    | Message d'erreur               | Cause                                                                                                 | Solution                                                          |
    | ------------------------------ | ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
    | **Unsupported Image Type**     | Seules les images JPEG, PNG, GIF ou WebP sont prises en charge                                        | Annulez et changez le type d'image pour un format pris en charge  |
    | **Image Dimensions Too Large** | La largeur ou la hauteur de l'image ne peut pas dépasser 8000 pixels                                  | Annulez et ajustez les dimensions de l'image à 8000×8000 ou moins |
    | **Input Too Long**             | L'entrée dépasse la longueur maximale autorisée par le modèle                                         | Simplifiez votre entrée ou réduisez la taille de l'image          |
    | **File Too Large**             | La taille de l'image ne peut pas dépasser 5 Mo                                                        | Annulez et envoyez une image compressée (5 Mo maximum)            |
    | **Unreadable Image**           | Impossible de traiter l'image, le fichier est peut-être corrompu ou dans un format non pris en charge | Annulez et remplacez l'image par un fichier valide                |
  </Tab>
</Tabs>

***

## Problèmes spécifiques aux outils [#problèmes-spécifiques-aux-outils]

<Tabs>
  <Tab title="Échecs de file_edit">
    ### Échecs de file\_edit [#échecs-de-file_edit]

    **Erreur :** « Failed to find exact match »

    **Causes :**

    * Le texte a changé depuis le dernier file\_read
    * Différences d'espacement (tabulations ou espaces)
    * Chaîne non unique dans le fichier

    **Solutions :**

    ```bash
    # 1. Read file again to get current state
    file_read("file.js")

    # 2. Use larger context string for uniqueness
    file_edit("file.js",
      old_string="function foo() {\n  return 42;\n}",
      new_string="...")

    # 3. For multiple identical strings, use replace_all
    file_edit("file.js", old_string="TODO", new_string="DONE", replace_all=true)
    ```

    <Warning>
      Lisez toujours le fichier immédiatement avant de le modifier pour vous assurer de disposer de son état actuel.
    </Warning>
  </Tab>

  <Tab title="Échecs de bash">
    ### Échecs des commandes bash [#échecs-des-commandes-bash]

    **Erreur :** délai d'expiration ou échec d'exécution de la commande

    **Délai d'expiration maximal :** 120 secondes (2 minutes, limite stricte)

    **Solution :** divisez les commandes longues en opérations plus petites :

    ```bash
    # Instead of one long command, break into steps
    bash("step1")  # Completes in < 2min
    bash("step2")  # Completes in < 2min
    ```

    **Commande introuvable :**

    * Vérifiez si la commande existe : `bash("which command-name")`
    * Assurez-vous d'avoir le bon chemin ou activez d'abord l'environnement
    * Utilisez des chemins complets pour les exécutables

    **Erreurs de permission :**

    * Les commandes s'exécutent avec les permissions de l'utilisateur
    * N'utilisez `sudo` que si nécessaire et dans Manual Accept Mode
    * Vérifiez les permissions des fichiers/répertoires
  </Tab>

  <Tab title="Problèmes de recherche">
    ### La recherche ne renvoie aucun résultat [#la-recherche-ne-renvoie-aucun-résultat]

    **Problème :** grep\_file ou glob ne trouve pas les fichiers attendus

    **Vérifiez la syntaxe du motif :**

    ```bash
    # Wrong
    grep_file("*.ts")  # Missing ** for recursive

    # Correct
    grep_file("**/*.ts")  # Recursive search
    ```

    **Vérifiez les exclusions :**

    ```bash
    # Ensure not accidentally excluding target files
    glob("**/*.js", exclude=["**/dist/**", "**/node_modules/**"])
    ```

    **Sensibilité à la casse :**

    ```bash
    # Use case-insensitive search if needed
    grep_content("pattern", case_insensitive=true)
    ```
  </Tab>
</Tabs>

***

## Problèmes de sous-agents et de configuration [#problèmes-de-sous-agents-et-de-configuration]

<Tabs>
  <Tab title="Le sous-agent ne s'active pas">
    ### Le sous-agent ne s'active pas [#le-sous-agent-ne-sactive-pas]

    **Problème :** un sous-agent personnalisé ne s'active pas automatiquement

    **Liste de vérification :**

    * Emplacement du fichier : `~/.verdent/subagents/[name].md`
    * Frontmatter YAML valide avec `name` et `description`
    * La politique d'invocation correspond à l'usage (le mode strict nécessite une mention @)
    * Les recommandations « Quand l'utiliser » correspondent au modèle de la demande
    * Aucune erreur de syntaxe dans le fichier markdown

    **Tester manuellement :**

    ```
    @subagent-name perform task
    ```

    <Tip>
      Utilisez une mention @ explicite pour vérifier que le sous-agent fonctionne avant de dépanner l'invocation automatique.
    </Tip>
  </Tab>

  <Tab title="Sous-agents intégrés">
    ### Comportement des sous-agents intégrés [#comportement-des-sous-agents-intégrés]

    **Problème :** @Explorer, @Verifier ou @Code-reviewer ne se comporte pas comme prévu

    **Causes courantes :**

    * La demande ne correspond pas à la spécialisation du sous-agent
    * Contexte du sous-agent plein (rare)
    * Le contexte de la conversation principale affecte le routage

    **Solution :**

    * Utilisez une mention @ explicite pour forcer un sous-agent spécifique
    * Reformulez la demande pour correspondre à l'expertise du sous-agent
    * Démarrez une nouvelle conversation si le contexte pose problème
  </Tab>

  <Tab title="Règles AGENTS.md">
    ### AGENTS.md non appliqué [#agentsmd-non-appliqué]

    **Problème :** les règles du projet n'affectent pas le comportement de Verdent

    **Diagnostic :**

    1. **Emplacement :** le fichier doit se trouver à la racine du répertoire du projet
    2. **Syntaxe :** Markdown valide (vérifiez les erreurs de syntaxe)
    3. **Spécificité :** les règles doivent être directives : « Utilisez toujours X » et non « Essayez d'utiliser X »
    4. **Test :** démarrez une nouvelle conversation pour tester l'application effective

    **Vérification de la priorité :**

    ```markdown
    # In AGENTS.md (highest priority)
    - Use 4-space indentation

    # In VERDENT.md (lower priority)
    - Use 2-space indentation

    # Result: 4-space indentation (AGENTS.md wins)
    ```
  </Tab>

  <Tab title="Connexion MCP">
    ### Échecs de connexion MCP [#échecs-de-connexion-mcp]

    **Erreur :** impossible de se connecter au serveur MCP

    **Étapes de diagnostic :**

    1. **Vérifiez mcp.json :** syntaxe JSON valide dans `~/.verdent/mcp.json`
    2. **Serveur en cours d'exécution :** assurez-vous que le processus du serveur MCP est actif
    3. **Réseau :** vérifiez la connectivité vers le point de terminaison du serveur
    4. **Authentification :** confirmez que les identifiants sont corrects
    5. **Journaux :** consultez les journaux du serveur MCP pour connaître les détails de l'erreur

    **Solutions courantes :**

    * Redémarrez le serveur MCP
    * Vérifiez le format de la chaîne de connexion
    * Vérifiez que les règles de pare-feu autorisent le trafic MCP
    * Validez les clés ou jetons API
  </Tab>
</Tabs>

***

## Problèmes connus et solutions de contournement [#problèmes-connus-et-solutions-de-contournement]

<Tabs>
  <Tab title="Fichiers binaires">
    ### Limitations des fichiers binaires [#limitations-des-fichiers-binaires]

    **Problème :** impossible de modifier des images, des PDF, des binaires compilés

    **Solution de contournement :**

    ```bash
    # Use bash to call external tools
    bash("convert input.png -resize 50% output.png")
    bash("pdftotext document.pdf output.txt")
    ```

    <Info>
      Les modifications de fichiers binaires nécessitent des outils externes invoqués via des commandes bash.
    </Info>
  </Tab>

  <Tab title="Fichiers volumineux">
    ### Gestion des fichiers volumineux [#gestion-des-fichiers-volumineux]

    **Problème :** les fichiers de plus de 10 000 lignes provoquent des problèmes de contexte

    **Solution de contournement :**

    ```bash
    # Always use line ranges for large files
    file_read("large.log", start_line=1000, max_lines=100)

    # Search first to find relevant sections
    grep_content("ERROR", glob="large.log")
    ```

    <Tip>
      Effectuez d'abord une recherche avec grep\_content pour localiser les numéros de ligne pertinents, puis lisez uniquement ces plages spécifiques.
    </Tip>
  </Tab>

  <Tab title="Différences entre plateformes">
    ### Différences de commandes entre plateformes [#différences-de-commandes-entre-plateformes]

    **Problème :** les commandes bash diffèrent entre Windows et Unix

    **Solution de contournement :**

    ```bash
    # Use cross-platform tools when possible
    bash("npm run build")  # Works everywhere

    # Or conditional execution
    bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")
    ```

    **Bonne pratique :** utilisez des scripts npm pour assurer la compatibilité multiplateforme.
  </Tab>
</Tabs>

***

## Obtenir de l'aide supplémentaire [#obtenir-de-laide-supplémentaire]

### Canaux de support [#canaux-de-support]

**Pour les problèmes spécifiques non couverts ici :**

* **E-mail :** [support@verdent.ai](mailto:support@verdent.ai)
* **Discord :** [rejoignez la communauté Verdent](https://discord.com/invite/NGjXEZcbJq) pour un support en temps réel
* **Problèmes GitHub :** signalez des bugs ou demandez des fonctionnalités

**Lors du signalement de problèmes, incluez :**

1. La version de Verdent (depuis le panneau Extensions)
2. La version de VS Code
3. Le système d'exploitation
4. Les messages d'erreur (texte exact)
5. Les étapes de reproduction
6. Le comportement attendu par rapport au comportement observé

***

### Collecte d'informations de diagnostic [#collecte-dinformations-de-diagnostic]

**Pour aider le support à établir un diagnostic :**

```bash
# VS Code version
bash("code --version")

# System info
bash("uname -a")  # Unix
bash("systeminfo")  # Windows

# Verdent logs location
# Check VS Code Output panel → Verdent
```

***

## Voir aussi [#voir-aussi]

<CardGroup cols="2">
  <Card title="FAQ" icon="circle-question" href="/docs/verdent-for-vscode/help-support/faqs">
    Questions fréquemment posées
  </Card>

  <Card title="Limitations" icon="triangle-exclamation" href="/docs/verdent-for-vscode/help-support/limitations">
    Limitations et contraintes connues
  </Card>
</CardGroup>