# Foire aux questions (/fr/docs/verdent-for-vscode/help-support/faqs)

> Questions courantes sur Verdent for VS Code



Réponses aux questions fréquemment posées sur les fonctionnalités, les capacités et l'utilisation de Verdent.

***

## Prise en main [#prise-en-main]

<Tip>
  Terminez le guide de démarrage rapide avant de vous plonger dans les fonctionnalités avancées, il couvre les concepts essentiels qui reviennent tout au long de la documentation.
</Tip>

***

## Problèmes courants (Top 4) [#problèmes-courants-top-4]

<Accordion title="Pourquoi ne puis-je pas me connecter à Verdent for VS Code ?">
  **Cause la plus fréquente :** Problème de configuration du proxy

  **Solution :**

  1. Ouvrez les paramètres de VS Code (`Cmd+,` sur macOS ou `Ctrl+,` sur Windows/Linux)
  2. Recherchez « useProxy » ou « verdent.enableProxy »
  3. Activez/désactivez le paramètre de proxy (l'opposé de l'état actuel)
  4. Essayez de vous reconnecter

  **Explication :** 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.
</Accordion>

<Accordion title="Pourquoi n'ai-je pas reçu mes crédits d'essai gratuit ?">
  **Erreur :** Les crédits d'essai gratuit n'ont pas été reçus ou l'accès à l'essai gratuit a été refusé

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

  **Solution :** Contactez [support@verdent.ai](mailto:support@verdent.ai) pour obtenir de l'aide concernant votre accès à l'essai gratuit. L'équipe d'assistance examinera votre compte et vous aidera à résoudre le problème.
</Accordion>

<Accordion title="Pourquoi mon inscription a-t-elle échoué ?">
  **Erreur :** L'inscription du compte a été rejetée ou restreinte

  **Raison :** L'inscription enfreignait les conditions d'utilisation de Verdent, ce qui a entraîné une restriction d'accès

  **Solution :** Contactez [support@verdent.ai](mailto:support@verdent.ai) pour obtenir de l'aide. L'équipe d'assistance peut examiner votre inscription et vous fournir des conseils pour résoudre le problème.
</Accordion>

<Accordion title="Pourquoi ne puis-je pas trouver les modèles Claude, GPT ou Gemini ?">
  **Problème :** Impossible de trouver certains modèles d'IA dans le menu de sélection des modèles

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

  **Explication :** Certains fournisseurs de modèles d'IA (Anthropic, OpenAI, Google) appliquent des restrictions régionales qui empêchent certains modèles d'être disponibles dans des zones géographiques spécifiques. Dans ce cas :

  * Les modèles restreints n'apparaîtront pas dans votre menu de sélection des 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

  **Remarque :** Les restrictions régionales sont définies par les fournisseurs de modèles d'IA, et non par Verdent. Verdent ne peut pas outrepasser ces restrictions.
</Accordion>

***

<Accordion title="Qu'est-ce que Visual Studio Code ?">
  Visual Studio Code est un éditeur de code gratuit et open source développé par Microsoft. Il s'agit d'un environnement de développement léger mais puissant qui prend en charge plusieurs langages de programmation et propose des fonctionnalités telles que le débogage, la coloration syntaxique, la complétion de code intelligente et le contrôle de version intégré. Verdent s'intègre directement dans Visual Studio Code sous forme d'extension, ajoutant des capacités de codage assistées par IA à votre flux de travail existant.
</Accordion>

<Accordion title="Qu'est-ce que Verdent for VS Code ?">
  Verdent est une extension d'assistant de codage IA pour Visual Studio Code qui aide à la génération de code, au refactoring, au débogage et à la navigation dans les projets grâce à des conversations en langage naturel.

  **Capacités clés :**

  * Génération et modification de code via des outils de fichiers
  * Exploration de la base de code avec des sous-agents spécialisés
  * Exécution de commandes via une intégration bash
  * Extensibilité personnalisée via des règles et des serveurs MCP
</Accordion>

<Accordion title="Quelle est la configuration système requise ?">
  **Configuration minimale requise :**

  * Visual Studio Code 1.90.0 ou supérieur
  * Abonnement Verdent actif
  * Connexion Internet

  **Plateformes prises en charge :** macOS, Windows, Linux, WSL
</Accordion>

<Accordion title="Comment commencer à utiliser Verdent après l'installation ?">
  1. Installez l'extension Verdent depuis la marketplace VS Code
  2. Connectez-vous avec votre compte Verdent lorsque vous y êtes invité
  3. Ouvrez un fichier de code ou un projet
  4. Ouvrez la vue de chat et commencez à converser avec Verdent

  **Suggestion de première tâche :** Demandez à Verdent d'expliquer la structure de votre projet ou de passer en revue un fichier spécifique.
</Accordion>

<Accordion title="Comment vérifier ma version de Visual Studio Code ?">
  Ouvrez Visual Studio Code et allez dans **Aide** → **À propos** (ou **Code** → **À propos de Visual Studio Code** sur macOS). Le numéro de version s'affiche dans la boîte de dialogue. Verdent nécessite Visual Studio Code version 1.90.0 ou supérieure.

  Vous pouvez également vérifier via la ligne de commande :

  ```bash
  code --version
  ```
</Accordion>

<Accordion title="Que sont les crédits ?">
  Consultez [Crédits et offres](/docs/account-billing/credits-and-plans) pour la définition commune des crédits, des niveaux tarifaires et des bases d'utilisation à travers les produits Verdent.
</Accordion>

<Accordion title="Que se passe-t-il si je suis à court de crédits ?">
  Consultez [Que se passe-t-il si vous êtes à court de crédits](/docs/account-billing/run-out-of-credits) pour connaître la politique de compte commune et les options de récupération.
</Accordion>

<Accordion title="Est-ce que Verdent envoie mes images vers des serveurs externes ?">
  Les images collées via le presse-papiers ou référencées par chemin de fichier sont traitées au sein de votre session de conversation. Les images ne sont pas stockées de façon permanente et sont effacées lorsque vous démarrez une nouvelle conversation. Les références par chemin de fichier lisent l'image localement sans la téléverser.
</Accordion>

<Accordion title="Qu'est-ce que Plan Mode ?">
  Plan Mode est un mode d'exécution en lecture seule dans lequel Verdent analyse le code, effectue des recherches et crée des plans d'implémentation détaillés sans modifier de fichiers ni exécuter de commandes. Après avoir généré un plan, Verdent propose deux options : **Modifier** (pour demander des modifications et affiner le plan) ou **Commencer la construction** (pour passer en Agent Mode et commencer l'exécution). L'agent peut poser des questions de clarification pour lever les incertitudes avant l'exécution. Ce mode est idéal pour les tâches complexes où vous souhaitez examiner l'approche avant de vous engager dans des modifications, garantissant l'alignement entre vos attentes et la solution proposée par Verdent.
</Accordion>

<Accordion title="Est-ce que Plan Mode écrit réellement du code dans mes fichiers ?">
  **Non.** Plan Mode est strictement en lecture seule :

  * Verdent peut lire des fichiers, rechercher dans le code et analyser votre base de code
  * **Aucune écriture, modification ou suppression de fichier** ne se produit pendant Plan Mode
  * Les plans sont affichés uniquement dans la vue de chat
  * L'exécution du code ne commence qu'après votre approbation explicite et le passage en Agent Mode

  **Garantie de sécurité :** Plan Mode ne peut pas modifier accidentellement votre code. Il est conçu pour une exploration sûre et l'élaboration de stratégies.
</Accordion>

<Accordion title="Comment basculer entre Plan Mode et Agent Mode ?">
  **Le basculement est instantané via la zone de saisie :**

  **Pour entrer en Plan Mode :**

  * Cliquez sur le bouton **Changer de mode** dans la zone de saisie
  * Sélectionnez **Plan Mode** dans le menu déroulant
  * OU dites : « Passer en Plan Mode »

  **Pour quitter Plan Mode :**

  * Cliquez sur le bouton **Changer de mode** dans la zone de saisie
  * Sélectionnez **Agent Mode** dans le menu déroulant
  * OU choisissez **Commencer la construction** après avoir examiné un plan

  **Persistance du mode :**

  * Le choix du mode persiste au sein de la session en cours
  * Les nouvelles sessions démarrent dans le Agent Mode par défaut
  * Vous pouvez changer de mode librement à tout moment

  **Flux de travail typique :** Plan Mode → examen → Agent Mode → exécution → retour à Plan Mode pour la prochaine fonctionnalité complexe.
</Accordion>

<Accordion title="Comment démarrer une nouvelle conversation avec un contexte propre ?">
  Cliquez sur le bouton « Nouvelle session » dans la barre supérieure. Cela efface l'historique de conversation en cours et offre à Verdent une nouvelle fenêtre de contexte pour votre prochaine tâche.
</Accordion>

<Accordion title="Puis-je utiliser Verdent dans plusieurs projets simultanément ?">
  Oui, chaque fenêtre VS Code fonctionne indépendamment. Vous pouvez avoir Verdent ouvert dans plusieurs projets, chacun conservant son propre contexte de conversation distinct.
</Accordion>

<Accordion title="Est-ce que Verdent fonctionne avec GitHub, GitLab, Bitbucket et d'autres plateformes Git ?">
  Oui. Verdent utilise des commandes Git standard, il fonctionne donc avec n'importe quel dépôt Git quelle que soit la plateforme d'hébergement. Pour créer des pull requests, Verdent utilise la CLI `gh` qui nécessite GitHub, mais toutes les autres opérations Git fonctionnent universellement.
</Accordion>

***

## Outils et capacités [#outils-et-capacités]

<Accordion title="Avec quels formats de fichiers Verdent peut-il travailler ?">
  **Pris en charge :** Tous les formats de fichiers texte, notamment :

  * Code source (JavaScript, Python, TypeScript, Java, Go, etc.)
  * Fichiers de configuration (JSON, YAML, TOML, XML, ENV)
  * Documentation (Markdown, HTML, LaTeX)
  * Fichiers de build (package.json, Makefile, requirements.txt)

  **Non pris en charge :** Fichiers binaires (images, vidéos, PDF, binaires compilés, documents Office)

  **Contournement :** Référencez les fichiers binaires dans le code, mais les modifications nécessitent des outils externes.
</Accordion>

<Accordion title="Quels langages de programmation Verdent prend-il le mieux en charge ?">
  **Excellente prise en charge :**

  * JavaScript, TypeScript, Python, React, Vue, Angular
  * Node.js, Go, Java/Spring, C#/.NET
  * Swift, Kotlin, Flutter

  **Très bonne prise en charge :** Rust, C/C++, Ruby, R

  **Bonne prise en charge :** PHP, Assembleur, Julia

  Les langages courants bénéficient d'une prise en charge plus solide en raison de l'important volume de données d'entraînement.
</Accordion>

<Accordion title="Comment Verdent lit-il et modifie-t-il les fichiers ?">
  Trois outils d'opération sur les fichiers :

  * **file\_read :** Lire des fichiers complets ou des plages de lignes spécifiques
  * **file\_edit :** Remplacer des motifs de texte spécifiques (modifications ciblées)
  * **file\_write :** Créer de nouveaux fichiers ou réécrire complètement des fichiers

  **Bonne pratique :** Utilisez `file_edit` pour les modifications, `file_write` uniquement pour les nouveaux fichiers.
</Accordion>

<Accordion title="Qu'est-ce que l'exécution de commandes ?">
  L'exécution de commandes de terminal ou de scripts shell via Verdent, y compris des opérations telles que l'exécution de tests, l'installation de paquets ou l'exécution de commandes de build. L'exécution de commandes nécessite une approbation dans la plupart des modes de permission afin d'éviter des modifications système non souhaitées.
</Accordion>

<Accordion title="Verdent peut-il exécuter des commandes dans mon terminal ?">
  Oui, à l'aide de l'outil `bash`. Verdent peut exécuter des commandes de terminal avec :

  * Délai d'expiration maximal : 120 secondes (2 minutes)
  * Enchaînement de commandes avec `&&`
  * Prise en charge multiplateforme (bash sous Unix, PowerShell sous Windows)

  **Sécurité :** Les commandes s'exécutent avec vos permissions utilisateur. Utilisez Manual Accept Mode pour les examiner avant exécution.
</Accordion>

<Accordion title="Combien de temps les commandes bash peuvent-elles s'exécuter ?">
  **Délai d'expiration maximal :** 120 secondes (2 minutes)

  Les commandes dépassant 2 minutes seront automatiquement interrompues. Pour les opérations plus longues, envisagez :

  **Alternatives :**

  * Diviser en commandes plus petites : `bash("task1") && bash("task2")`
  * Diviser en opérations plus petites
  * Exécuter en arrière-plan et vérifier les résultats séparément
</Accordion>

<Accordion title="Qu'est-ce que le cycle multi-passes de génération, test et réparation ?">
  Un processus de vérification itératif dans lequel le code est généré, testé et réparé jusqu'à ce qu'il réussisse des tests complets. Verdent exécute automatiquement les tests, analyse les échecs, corrige les problèmes et effectue de nouveaux tests en plusieurs passes jusqu'à ce que le code fonctionne correctement. Cela permet de fournir du code prêt pour la production, et non de simples suggestions. Chaque résultat inclut des résumés détaillés et des diffs de code montrant exactement ce qui a changé.
</Accordion>

<Check>
  Les cycles de test multi-passes corrigent et retestent automatiquement le code jusqu'à ce qu'il réussisse, c'est ainsi que Verdent garantit la préparation à la production.
</Check>

***

## Sous-agents et exécution [#sous-agents-et-exécution]

<Accordion title="Que sont les sous-agents et quand dois-je les utiliser ?">
  Les sous-agents sont des agents IA spécialisés dotés de fenêtres de contexte isolées pour des tâches spécifiques.

  **Sous-agents intégrés :**

  * **@Explorer :** Recherches dans la base de code, questions d'architecture
  * **@Verifier :** Vérifications de validation rapides
  * **@Code-reviewer :** Revues de sécurité et de qualité

  **Quand les utiliser :** Déléguez les tâches de recherche, de validation ou de revue pour économiser le contexte de la conversation principale.

  **Comment créer des sous-agents personnalisés :**

  Créez un fichier markdown dans `~/.verdent/subagents/` :

  ```markdown
  ---
  name: your-subagent
  description: Purpose description
  ---
  # System Prompt
  [Behavior definition and expertise]
  ```

  **Cas d'usage :** Expertise spécifique à un domaine (finance, santé), flux de travail d'équipe, spécialistes technologiques.
</Accordion>

<Accordion title="Qu'est-ce que la pollution de contexte ?">
  Lorsque des actions et informations précédentes dans le contexte créent des schémas de comportement non intentionnels qui affectent les tâches futures. Par exemple, si vous mettez à jour du code de manière répétée puis le déployez, l'agent peut commencer à associer toutes les mises à jour de code à un déploiement immédiat, même lorsque vous ne faites qu'expérimenter. Les sous-agents évitent la pollution de contexte en fonctionnant avec des fenêtres de contexte isolées, permettant à chaque tâche spécialisée de démarrer avec un contexte propre et d'éviter la contamination croisée entre différents types de travail.
</Accordion>

<Accordion title="Comment savoir dans quel mode d'exécution je me trouve actuellement ?">
  Regardez la zone de saisie en bas du panneau Verdent. Le bouton « Changer de permission » affiche votre mode actuel (par exemple, « Manuel », « Auto », « Plan »). Vous pouvez cliquer dessus pour changer de mode.
</Accordion>

<Accordion title="Quelle est la différence entre Auto-Run Mode et Manual Accept Mode ?">
  **Auto-Run Mode :**

  * Les opérations sur les fichiers s'exécutent automatiquement sans approbation
  * Les commandes nécessitent toujours une permission
  * Flux de travail plus rapide pour les bases de code de confiance
  * Idéal pour les projets individuels avec contrôle de version

  **Manual Accept Mode :**

  * Examinez et approuvez chaque opération protégée
  * Plus sûr pour les bases de code partagées ou de production
  * Voyez exactement ce qui sera exécuté avant l'exécution

  Changez de mode via les paramètres ou la palette de commandes.
</Accordion>

<Accordion title="Que sont les opérations sûres ?">
  Des opérations qui ne font que lire des données sans apporter de modifications : lectures de fichiers et recherches web. Celles-ci sont automatiquement approuvées en Auto-Run Mode, tandis que les modifications de fichiers et l'exécution de commandes nécessitent toujours une approbation pour des raisons de sécurité.
</Accordion>

<Accordion title="Puis-je utiliser plusieurs modes de permission en même temps ?">
  Non, les modes de permission s'excluent mutuellement - vous ne pouvez en utiliser qu'UN à la fois :

  * **Acceptation manuelle** - Par défaut, contrôle maximal
  * **Exécution automatique** - Simplifié pour les projets de confiance
  * **Plan** - Mode de planification en lecture seule
  * **Ignorer les permissions** - Autonomie complète

  Vous pouvez changer de mode instantanément via le bouton **Changer de permission** dans la zone de saisie. La plupart des utilisateurs alternent entre les modes selon le contexte de la tâche (par exemple, Plan Mode pour les fonctionnalités complexes, Exécution automatique pour les corrections rapides).
</Accordion>

<Accordion title="Quand dois-je utiliser l'agent Explorer plutôt que de charger les fichiers directement ?">
  Utilisez l'agent Explorer pour les tâches de découverte et de recherche sans consommer le contexte principal. Chargez les fichiers directement avec des mentions @ uniquement lorsque vous devez les modifier. Explorer est idéal pour les questions du type « trouve tous les fichiers qui... », tandis que les mentions @ conviennent aux tâches du type « mets à jour ce fichier spécifique ».
</Accordion>

<Accordion title="Puis-je créer des sous-agents personnalisés pour mon projet ?">
  Oui ! Créez des sous-agents personnalisés dans `~/.verdent/subagents/` :

  ```markdown
  ---
  name: your-subagent
  description: Purpose description
  ---
  # System Prompt
  [Behavior definition and expertise]
  ```

  **Cas d'usage :** Expertise spécifique à un domaine (finance, santé), flux de travail d'équipe, spécialistes technologiques.
</Accordion>

<Accordion title="Puis-je arrêter Verdent au milieu d'une tâche à plusieurs étapes ?">
  Oui. Vous pouvez interrompre l'exécution à tout moment. Verdent terminera l'étape en cours sur laquelle il travaille, puis s'arrêtera. La progression jusqu'à ce point est préservée. Vous pouvez examiner ce qui a été fait, apporter des ajustements et soit continuer, soit adopter une approche différente.
</Accordion>

<Accordion title="Comment savoir ce que fait Verdent en ce moment lors d'une tâche longue ?">
  Observez la liste de tâches. Elle affiche l'état en temps réel avec un élément marqué « en cours » à tout moment. L'élément actif montre exactement sur quoi Verdent travaille actuellement. Les éléments terminés sont marqués comme terminés, et les éléments en attente montrent ce qu'il reste à faire.
</Accordion>

<Accordion title="Est-ce que Verdent valide automatiquement mes modifications ?">
  Non. Verdent ne crée des commits que lorsque vous le demandez explicitement. Vous gardez un contrôle total sur le moment où les modifications sont validées. Demandez simplement « Stage toutes les modifications et crée un commit » lorsque vous êtes prêt.
</Accordion>

<Accordion title="Est-ce que Verdent va pousser vers des dépôts distants sans demander ?">
  Non. Verdent ne pousse vers des dépôts distants que lorsque vous le demandez explicitement. Toutes les opérations Git (commit, push, merge, rebase) nécessitent votre instruction explicite pour des raisons de sécurité.
</Accordion>

***

## Personnalisation et intégration [#personnalisation-et-intégration]

<Accordion title="Comment personnaliser le comportement de Verdent pour mon équipe ?">
  Trois méthodes de personnalisation :

  1. **VERDENT.md :** Préférences globales personnelles (`~/.verdent/VERDENT.md`)
  2. **AGENTS.md :** Standards d'équipe spécifiques au projet (racine du projet, sous contrôle de version)
  3. **plan\_rules.md :** Format de sortie de Plan Mode (`~/.verdent/plan_rules.md`)

  AGENTS.md prévaut sur VERDENT.md pour assurer la cohérence de l'équipe.
</Accordion>

<Accordion title="Quand les modifications de configuration prennent-elles effet ?">
  La plupart des paramètres de Verdent s'appliquent immédiatement sans nécessiter de redémarrage :

  * **Modes de permission :** Basculement instantané via la zone de saisie
  * **Préréglages de modèle :** S'appliquent à la prochaine requête
  * **Fichiers de règles :** S'appliquent aux nouvelles conversations (l'enregistrement déclenche le rechargement)
  * **Sous-agents :** Disponibles immédiatement après la création
  * **Raccourcis clavier :** S'appliquent après l'enregistrement dans VS Code

  **Exception :** Les paramètres de l'extension VS Code (comme `verdent.enableCheckpoints`) prennent effet immédiatement, mais peuvent nécessiter de rouvrir les fichiers ou les sessions pour une application complète.
</Accordion>

<Accordion title="Qu'est-ce que MCP et comment l'utiliser ?">
  Model Context Protocol (MCP) étend Verdent avec des outils et services externes :

  **Configuration :** `~/.verdent/mcp.json` via Paramètres → Serveurs MCP

  **Capacités :**

  * Connexions à des bases de données (PostgreSQL, MySQL, MongoDB)
  * Services cloud (AWS, Azure, GCP)
  * Outils de gestion de projet (Jira, Linear)
  * Pipelines CI/CD (Jenkins, GitHub Actions)

  **Statut :** Documentation d'intégration MCP en cours de développement. Contactez [support@verdent.ai](mailto:support@verdent.ai) pour obtenir de l'aide à la configuration.
</Accordion>

***

## Bonnes pratiques et performance [#bonnes-pratiques-et-performance]

<Tip>
  Surveillez l'utilisation des crédits dans le centre utilisateur pour suivre les tendances de consommation et optimiser votre flux de travail en termes d'efficacité.
</Tip>

<Accordion title="Qu'est-ce qu'un token ?">
  L'unité de mesure des fenêtres de contexte. Les tokens représentent des fragments de texte (mots, parties de mots ou caractères) que le modèle d'IA traite. Les limites de contexte sont mesurées en tokens plutôt qu'en caractères ou en mots, une conversation typique consommant des milliers de tokens.
</Accordion>

<Accordion title="Qu'est-ce qui compte dans ma fenêtre de contexte ?">
  Tout ce qui se trouve dans votre session : tous les messages de la conversation, le contenu des fichiers chargés dans le contexte, les sorties d'outils (résultats de grep/recherche, lectures de fichiers), les prompts système et les instructions, et les définitions de serveurs MCP. Chacun de ces éléments consomme des tokens de votre capacité de contexte totale.
</Accordion>

<Accordion title="Quelle est la différence entre les fenêtres de contexte de 200K et 1M ?">
  Les modèles standard (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2) disposent d'une fenêtre de contexte de `200K` tokens suffisante pour la plupart des tâches. Claude Sonnet 4.5 offre un contexte étendu de `1M` tokens (5 fois plus grand) pour les grandes bases de code avec des fichiers `1000+`, le refactoring complexe multi-fichiers ou les longues sessions de développement. Le contexte `1M` s'active automatiquement lorsque l'entrée dépasse `200K` tokens, ou peut être sélectionné explicitement.
</Accordion>

<Accordion title="Combien de fichiers puis-je charger en toute sécurité dans le contexte ?">
  Il n'y a pas de limite fixe de fichiers - cela dépend de la taille des fichiers et du nombre total de tokens. Pour les contextes de `200K`, évitez de charger `20+` gros fichiers (`>1000` lignes chacun). Concentrez-vous sur les fichiers directement pertinents pour votre tâche en cours. Utilisez `@-mentions` de manière sélective et exploitez la documentation `AGENTS.md` plutôt que de charger de nombreux fichiers d'exemple. Avec un contexte de `1M`, le choix des fichiers devient beaucoup moins critique.
</Accordion>

<Accordion title="Comment savoir si j'approche des limites de contexte ?">
  Les signes incluent des temps de réponse plus lents, des sessions qui durent plusieurs heures, ou de nombreux gros fichiers chargés. Surveillez la durée de votre session et le nombre de fichiers. Lorsque vous remarquez une dégradation des performances, terminez votre tâche en cours, validez votre progression, puis démarrez une nouvelle session avec un contexte propre.
</Accordion>

<Accordion title="Comment éviter l'épuisement de la fenêtre de contexte ?">
  **Stratégies :**

  1. **Lecture stratégique des fichiers :** Utilisez des plages de lignes pour les gros fichiers
  2. **Déléguer aux sous-agents :** Explorer/Verifier pour la recherche en arrière-plan
  3. **Rechercher avant de lire :** Utilisez `grep_file` pour identifier les fichiers pertinents
  4. **Fractionner les opérations :** Utilisez `todo_update` pour suivre les tâches à plusieurs étapes

  **Règle empirique :** Les fichiers de plus de 500 lignes devraient utiliser des plages de lignes.
</Accordion>

<Accordion title="Dois-je réinitialiser manuellement le contexte ou Verdent le fait-il automatiquement ?">
  Vous devez démarrer manuellement une nouvelle session pour réinitialiser le contexte - Verdent n'efface pas automatiquement le contexte. Bonne pratique : réinitialisez après avoir terminé une unité de travail atomique, effectué les tests et validé dans le contrôle de version. Pour les contextes de `1M` tokens, les réinitialisations sont nécessaires beaucoup moins fréquemment.
</Accordion>

<Accordion title="La réinitialisation du contexte fera-t-elle perdre mon travail ?">
  Non - la réinitialisation du contexte efface uniquement l'historique de la conversation et les fichiers chargés en mémoire. Vos modifications de code réelles, vos commits et vos modifications de fichiers sont préservés. Validez toujours votre travail dans le contrôle de version avant de réinitialiser le contexte, par sécurité. Réinitialiser → démarrer une nouvelle session → continuer à travailler sur la tâche suivante.
</Accordion>

<Accordion title="À quel point mes prompts doivent-ils être précis ?">
  Soyez suffisamment précis pour éliminer toute ambiguïté, mais n'expliquez pas trop les détails évidents. Incluez : les chemins de fichiers exacts, l'approche d'implémentation, les résultats attendus et les contraintes. Mauvais exemple : « Corrige le code » - trop vague. Bon exemple : « Ajoute une validation de saisie au champ email dans `ContactForm.js` pour rejeter les formats d'email invalides » - portée et objectif clairs. Dans le doute, préférez être plus précis.
</Accordion>

<Accordion title="Quelle est la différence entre les mentions @ et le chargement automatique de fichiers ?">
  Verdent charge automatiquement les fichiers mentionnés par leur nom dans les prompts ainsi que les fichiers associés dans le même répertoire. Les `@-mentions` (`@filename.js`) garantissent explicitement qu'un fichier est présent dans le contexte, ce qui est essentiel lorsque vous travaillez avec des fichiers étroitement couplés, que vous référencez des motifs d'un fichier pour les appliquer à un autre, ou lorsque la détection automatique pourrait manquer du contexte dans de grandes bases de code. Utilisez toujours `@-mentions` lorsque vous demandez à Verdent de « suivre le même modèle que... » afin de garantir une référence de code exacte.
</Accordion>

<Accordion title="Dois-je répéter le contexte du projet dans chaque prompt au cours d'une session ?">
  Non - Verdent maintient le contexte de la conversation au sein d'une session, vous n'avez donc pas besoin de répéter les détails d'architecture ou les conventions déjà évoqués. Cependant, pour les contraintes critiques ou lorsque les sessions deviennent longues (`100+` messages), reformulez le contexte important. Meilleure approche : utilisez des règles de projet (`AGENTS.md`) pour documenter le contexte persistant comme la stack technique, les standards de code et les modèles - vous n'aurez alors jamais besoin de les répéter.
</Accordion>

<Accordion title="Que faire si Verdent ne comprend pas ou ne suit pas correctement mon prompt ?">
  Utilisez un affinement itératif : examinez le résultat, identifiez ce qui ne va pas, puis apportez des corrections dans un prompt de suivi. Exemple : « La logique de validation est bonne, mais utilise la validation de schéma Joi au lieu de vérifications manuelles. Fais correspondre le modèle de validation dans `ProductController.js`. » Vous pouvez également demander des explications : « Pourquoi as-tu utilisé Redux au lieu de Context API ? » puis affiner en fonction de la compréhension. Ne répétez pas le même prompt - ajustez en fonction de ce qui a échoué.
</Accordion>

<Accordion title="Quand dois-je utiliser Plan Mode plutôt que le mode normal ?">
  Utilisez Plan Mode pour : les grands refactorings ou changements architecturaux, les modifications multi-fichiers où vous souhaitez examiner la portée avant l'exécution, les tâches complexes pour lesquelles vous êtes incertain des exigences, ou lorsque vous souhaitez que Verdent vous interroge avec des questions de clarification avant l'implémentation. Évitez Plan Mode pour : les tâches simples et bien définies, les corrections de bugs rapides ou les opérations routinières. Plan Mode ajoute une surcharge mais évite des erreurs coûteuses sur des travaux complexes.
</Accordion>

<Accordion title="Comment choisir le bon préréglage de modèle pour ma tâche ?">
  Adaptez le préréglage de modèle à la complexité de la tâche et au budget :

  **Utilisez Efficiency (3,2 fois plus efficace que Sonnet) :**

  * Corrections de bugs rapides et génération de code simple
  * Opérations routinières et tâches à haute fréquence
  * Lorsque la vitesse compte plus que la profondeur

  **Utilisez Balance (référence 1x) - Par défaut :**

  * Développement général et codage quotidien
  * Implémentation de fonctionnalités et revues de code
  * Performance équilibrée pour la plupart des scénarios

  **Utilisez Performance (efficacité 0,5x, coût 2x) :**

  * Décisions architecturales complexes
  * Grandes bases de code nécessitant un contexte étendu (200k+ tokens)
  * Débogage et refactoring sophistiqués

  **Conseil de pro :** La plupart des utilisateurs gardent Balance par défaut et ne passent à Performance que lorsqu'ils atteignent les limites de contexte ou ont besoin d'un raisonnement approfondi.
</Accordion>

***

## Dépannage [#dépannage]

<Accordion title="Comment résoudre les problèmes de pare-feu ou de connexion ?">
  Si Verdent ne parvient pas à se connecter aux services d'IA, vérifiez ces problèmes courants :

  **Testez la connectivité de base :**

  * Vérifiez que vous disposez d'un accès Internet actif
  * Essayez d'accéder à d'autres services HTTPS pour confirmer que les connexions sortantes fonctionnent

  **Environnements d'entreprise :**

  * Contactez votre administrateur réseau pour mettre en liste blanche les points de terminaison API de Verdent
  * Assurez-vous que le trafic HTTPS sortant est autorisé à travers votre pare-feu
  * Vérifiez si les serveurs proxy sont correctement configurés pour laisser passer les requêtes API
  * L'inspection SSL/TLS peut nécessiter des exceptions pour les points de terminaison Verdent

  **Symptômes courants :**

  * L'extension semble se bloquer ou expirer
  * Échecs d'authentification malgré des identifiants corrects

  Si les problèmes persistent après la configuration du pare-feu, contactez le support Verdent pour obtenir des détails spécifiques sur les points de terminaison à mettre en liste blanche.
</Accordion>

<Accordion title="Mes règles AGENTS.md ne sont pas appliquées. Pourquoi ?">
  **Vérifiez :**

  * **Emplacement :** Fichier dans le répertoire racine du projet
  * **Syntaxe :** Markdown valide
  * **Spécificité :** Les règles sont directives (« Utilise toujours... » et non « Essaie d'utiliser... »)
  * **Nouveau test :** Démarrez une nouvelle conversation pour tester l'application

  **Priorité :** AGENTS.md prévaut sur VERDENT.md pour le comportement spécifique au projet.
</Accordion>

<Accordion title="Comment corriger les erreurs « file_edit failed to find exact match » ?">
  **Causes :**

  * Le texte a changé depuis la dernière lecture
  * Différences d'espacement (espaces vs tabulations)
  * Chaîne non unique dans le fichier

  **Solutions :**

  * Relisez le fichier pour obtenir le contenu actuel
  * Fournissez une chaîne de contexte plus large pour l'unicité
  * Utilisez `replace_all=true` pour plusieurs chaînes identiques
  * Vérifiez que file\_path est correct
</Accordion>

<Accordion title="Pourquoi mon sous-agent personnalisé ne s'invoque-t-il pas automatiquement ?">
  **Vérifiez :**

  * **Emplacement :** Fichier dans `~/.verdent/subagents/[name].md`
  * **Politique d'invocation :** Une politique stricte nécessite une mention @ explicite
  * **En-tête YAML :** Syntaxe valide
  * **Directives « Quand l'utiliser » :** Correspondance avec votre schéma de requête

  **Test :** Utilisez une mention @ explicite pour vérifier que le sous-agent fonctionne : `@your-subagent do task`
</Accordion>

***

## Voir aussi [#voir-aussi]

<CardGroup cols="2">
  <Card title="Référence des outils" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    Capacités complètes des outils
  </Card>

  <Card title="Dépannage" icon="triangle-exclamation" href="/docs/verdent-for-vscode/help-support/common-issues">
    Problèmes courants et solutions
  </Card>
</CardGroup>