# Guide de démarrage rapide (/fr/docs/verdent-for-vscode/getting-started/quick-start)

> Démarrez avec Verdent en quelques minutes



Ce guide de démarrage rapide vous permettra d'utiliser le flux de travail Plan-Verify-Code de Verdent en moins de 15 minutes. Vous installerez l'extension, effectuerez votre première tâche et comprendrez le flux de travail principal lorsque vous travaillez avec Verdent for VS Code.

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

* Installer Verdent for VS Code depuis la marketplace
* Vous authentifier et vérifier votre configuration
* Effectuer votre première tâche assistée par IA
* Comprendre les modes d'exécution (Manual Accept, Auto-Run, Plan Mode)
* Utiliser les fonctionnalités essentielles pour le codage quotidien

### Prérequis [#prérequis]

Avant de commencer, assurez-vous d'avoir :

* Visual Studio Code installé sur votre système
* Une connexion internet active
* Un compte d'abonnement Verdent (ou démarrez avec l'essai gratuit de 7 jours)

***

## Étape 1 : Installer Verdent [#étape-1--installer-verdent]

<Tabs>
  <Tab title="Marketplace Visual Studio Code">
    Visitez la [page d'extension Verdent](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) et sélectionnez **Install**.
  </Tab>

  <Tab title="Panneau Extensions">
    1. Ouvrez Visual Studio Code
    2. Appuyez sur `Ctrl+Shift+X` (ou `Cmd+Shift+X` sur macOS)
    3. Recherchez "Verdent"
    4. Sélectionnez **Install**
  </Tab>

  <Tab title="Ligne de commande">
    ```bash
    code --install-extension verdentai.verdent
    ```
  </Tab>
</Tabs>

***

## Étape 2 : Commencer à utiliser Verdent [#étape-2--commencer-à-utiliser-verdent]

<Steps>
  <Step title="Ouvrir Visual Studio Code">
    Ouvrez Visual Studio Code dans le dossier de votre projet.
  </Step>

  <Step title="Accéder à Verdent">
    Cliquez sur l'icône Verdent dans la barre latérale ou appuyez sur `Ctrl+L` (Windows/Linux) / `Cmd+L` (macOS).
  </Step>

  <Step title="Se connecter">
    Connectez-vous lorsque vous y êtes invité pour vous authentifier avec votre compte Verdent.
  </Step>
</Steps>

***

## Étape 3 : Votre première tâche [#étape-3--votre-première-tâche]

Commençons par une tâche simple et non destructive qui démontre la compréhension de votre espace de travail par Verdent.

**Ouvrez un projet dans VS Code**, puis essayez l'un de ces prompts dans la zone de saisie de Verdent :

```
What kind of project is this?
```

Verdent analysera la structure de votre espace de travail, lira les fichiers clés et expliquera le type d'application sur laquelle vous travaillez. Cela démontre une conscience du contexte sans effectuer de modifications.

**Vous devriez voir :**

* Verdent analysant les fichiers de votre espace de travail
* Un résumé du type de projet, des technologies et de la structure
* Aucune modification de fichier (analyse en lecture seule)

**Essayez ces prompts de suivi :**

```
Explain what this project does
```

```
What dependencies does this project have?
```

```
Show me the main entry point of this application
```

Chaque prompt vous aide à vérifier que Verdent peut accéder à votre espace de travail et comprend votre base de code.

<Tip>
  Ces prompts exploratoires sont parfaits pour comprendre des bases de code inconnues. Verdent lit les fichiers selon les besoins sans vous obliger à ajouter manuellement du contexte.
</Tip>

***

## Étape 4 : Effectuer votre première modification de code [#étape-4--effectuer-votre-première-modification-de-code]

Maintenant, demandons à Verdent de créer quelque chose. Essayez cette tâche simple :

```
Create a hello_world.txt file with a greeting message
```

**Ce qui se passe :**

1. **Verdent propose la modification** Vous verrez un aperçu montrant le fichier à créer et son contenu
2. **Demande d'autorisation** En mode Auto Run Mode (par défaut), Verdent approuvera automatiquement la création du fichier
3. **Vous approuvez** Sélectionnez "Accept" ou approuvez la modification
4. **Fichier créé** Verdent crée le fichier et confirme l'achèvement

**Comprendre les autorisations :**

Manual Accept Mode garantit qu'aucune modification indésirable ne se produit sans votre approbation. Vous verrez des demandes d'autorisation pour :

* Les modifications et créations de fichiers
* Les exécutions de commandes
* L'utilisation d'outils (première utilisation de chaque type d'outil)

Cela vous donne un contrôle total et vous aide à comprendre quelles opérations Verdent effectue pour différentes tâches.

<Note>
  Manual Accept Mode est le point de départ recommandé pour les nouveaux utilisateurs. Une fois à l'aise, vous pouvez passer à Auto-Run Mode ou Plan Mode pour différents flux de travail.
</Note>

***

## Étape 5 : Utiliser Plan Mode pour les tâches complexes [#étape-5--utiliser-plan-mode-pour-les-tâches-complexes]

Plan Mode est le mode de planification en lecture seule de Verdent, où vous pouvez examiner les approches avant l'exécution. Essayons-le :

**Passer en Plan Mode :**

Cliquez sur le bouton **Switch Mode** dans la zone de saisie et sélectionnez **Plan Mode**

**Essayez une tâche de planification :**

```
Suggest ways to build a website for my project
```

**Ce qui se passe :**

1. **Verdent analyse votre projet** Il lit les fichiers et comprend la structure et les exigences de votre projet
2. **Création d'un plan détaillé** Indique quelles technologies utiliser, quelles pages créer et comment structurer le site web
3. **Aucune modification** Plan Mode est en lecture seule. Verdent ne peut pas modifier de fichiers tant que vous ne l'avez pas explicitement approuvé
4. **Clarification interactive** Verdent peut poser des questions sur les préférences de conception, le public cible ou les fonctionnalités avant de finaliser le plan

**Pourquoi utiliser Plan Mode :**

* **Exploration sûre** - Comprendre des bases de code inconnues sans modifications accidentelles
* **Revue de code** - Analyser la qualité et l'architecture avant d'effectuer des modifications
* **Planification stratégique** - Décomposer des tâches complexes en étapes vérifiables
* **Réduction de l'incertitude** - Verdent pose des questions de clarification pour lever toute ambiguïté

<Tip>
  Utilisez Plan Mode pour toute tâche où vous souhaitez examiner l'approche avant de vous engager dans l'exécution. C'est particulièrement utile pour apprendre comment Verdent appréhende votre base de code.
</Tip>

**Pour exécuter le plan :**

Après avoir examiné le plan, Verdent présente deux options :

* Choisissez **Edit** pour demander des modifications ou poser des questions de clarification
* Choisissez **Start Building** pour passer en Agent Mode et commencer l'exécution

***

## Étape 6 : Comprendre les modes d'exécution [#étape-6--comprendre-les-modes-dexécution]

Verdent propose plusieurs modes d'exécution adaptés à différents flux de travail :

**Modes d'autorisation :**

| Mode                      | Description                                                                                                                                                               | Quand l'utiliser                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| **Manual Accept**         | Demande une autorisation à la première utilisation de chaque outil                                                                                                        | Apprentissage et développement général avec un contrôle maximal             |
| **Auto-Run** (par défaut) | Accepte automatiquement les opérations sûres (lectures de fichiers, recherches web) ; les modifications de fichiers et les commandes nécessitent toujours une approbation | Projets de confiance et prototypage rapide                                  |
| **Plan Mode**             | Mode lecture seule pour l'analyse et la planification sans modification de fichiers                                                                                       | Tâches complexes et revue de code                                           |
| **Skip Permissions**      | Fonctionnement entièrement autonome contournant toutes les invites                                                                                                        | Environnements isolés et sûrs, comme les tests automatisés ou les sandboxes |

**Mode supplémentaire :**

* **Think Hard Mode** - Budget de réflexion maximal pour le raisonnement complexe et les décisions architecturales

<Warning>
  Skip Permissions Mode supprime toutes les vérifications de sécurité. À utiliser uniquement dans des environnements isolés et jetables où les erreurs n'ont aucune conséquence.
</Warning>

***

## Actions essentielles [#actions-essentielles]

Voici les actions clés que vous utiliserez quotidiennement dans Verdent for VS Code :

| Action             | Comment y accéder                                              | Description                                                |
| ------------------ | -------------------------------------------------------------- | ---------------------------------------------------------- |
| Ouvrir Verdent     | `Cmd+L` / `Ctrl+L` ou cliquer sur l'icône de la barre latérale | Ouvre le panneau Verdent                                   |
| New Session        | Cliquer sur "New Session" dans la barre supérieure             | Démarre une nouvelle conversation avec un contexte vierge  |
| Add Context        | Cliquer sur le bouton "Add Context"                            | Référencer des fichiers avec des mentions @                |
| Add Images         | Cliquer sur le bouton "Add Images or Files"                    | Téléverser des captures d'écran, maquettes ou diagrammes   |
| Switch Mode        | Cliquer sur le bouton "Switch Mode"                            | Basculer entre les modes Agent/Plan/Chat                   |
| Change Model       | Cliquer sur le sélecteur de modèle                             | Choisir les préréglages Performance/Balance/Efficiency     |
| Think Hard         | Cliquer sur le bouton "Think Hard Mode"                        | Activer le raisonnement étendu pour les tâches complexes   |
| Switch Permissions | Cliquer sur le bouton "Switch Permission"                      | Changer le mode d'autorisation                             |
| View History       | Cliquer sur "Project History" dans la barre supérieure         | Parcourir les sessions passées                             |
| User Center        | Cliquer sur "User Center" dans la barre supérieure             | Vérifier le solde de crédits et les informations du compte |
| Settings           | Cliquer sur "Settings" dans la barre supérieure                | Configurer les serveurs MCP, les sous-agents, les règles   |

***

## Astuces pour les débutants [#astuces-pour-les-débutants]

<Accordion title="Commencer par des prompts exploratoires">
  Avant d'effectuer des modifications, laissez Verdent comprendre votre base de code :

  ```
  Analyze the database schema
  ```

  ```
  Explain the authentication flow
  ```

  Cela enrichit le contexte de Verdent sur votre projet et l'aide à formuler de meilleures suggestions.
</Accordion>

<Accordion title="Soyez précis dans vos demandes">
  Au lieu de : "corrige le bug"

  Essayez : "corrige le bug de connexion dans `LoginForm.tsx` où les utilisateurs voient un écran vide après avoir saisi des identifiants incorrects"

  Des prompts précis conduisent à des solutions plus exactes et moins d'itérations.
</Accordion>

<Accordion title="Utilisez Plan Mode pour du code inconnu">
  Lorsque vous travaillez avec du code que vous ne comprenez pas entièrement, utilisez d'abord Plan Mode :

  ```
  Refactor the authentication module to use async/await instead of callbacks
  ```

  Examinez le plan, choisissez **Edit** pour poser des questions de clarification et l'affiner, puis choisissez **Start Building** une fois que vous êtes confiant.
</Accordion>

<Accordion title="Décomposez les tâches complexes en étapes">
  Pour les fonctionnalités à plusieurs étapes, travaillez de manière incrémentale :

  ```
  1. Create a new database table for user profiles
  ```

  Puis après l'achèvement :

  ```
  2. Create an API endpoint to get and update profiles
  ```

  Cela maintient la clarté et vous permet de vérifier chaque étape.
</Accordion>

<Accordion title="Exploitez les mentions @ pour le contexte">
  Référencez explicitement les fichiers si nécessaire :

  ```
  @components/UserProfile.tsx refactor this component to use hooks
  ```

  Cela garantit que Verdent se concentre sur le bon contexte pour votre tâche.
</Accordion>

<Accordion title="Utilisez des sous-agents pour des tâches spécialisées">
  Verdent inclut trois sous-agents intégrés :

  * `@Explorer` - Exploration rapide de la base de code et découverte de fichiers
  * `@Verifier` - Validation et vérifications rapides du code
  * `@Code-reviewer` - Revue complète de la sécurité et de la qualité

  Exemple :

  ```
  @Explorer find all API endpoints in this project
  ```
</Accordion>

***

## Problèmes courants [#problèmes-courants]

<Tabs>
  <Tab title="Extension non visible dans la barre latérale">
    **Solution :** Redémarrez VS Code. Si elle est toujours absente, vérifiez l'installation dans le panneau Extensions (`Cmd+Shift+X` / `Ctrl+Shift+X`) et confirmez que "Verdent" apparaît dans la liste.
  </Tab>

  <Tab title="Les prompts ne reçoivent pas de réponse">
    **Solution :**

    1. Vérifiez que la connexion internet est active
    2. Vérifiez que les paramètres de pare-feu/proxy autorisent le HTTPS vers les services Verdent
    3. Confirmez qu'il vous reste des crédits dans User Center
    4. Essayez un prompt plus simple pour tester la connectivité
  </Tab>

  <Tab title="Les demandes d'autorisation sont trop fréquentes">
    **Solution :** Passez en Auto-Run Mode à l'aide du bouton "Switch Permission". Cela approuve automatiquement les opérations de lecture sûres tout en continuant à demander une approbation pour les modifications de fichiers et les commandes.
  </Tab>
</Tabs>

***

## Obtenir de l'aide [#obtenir-de-laide]

* **Communauté Discord** : [https://discord.com/invite/NGjXEZcbJq](https://discord.com/invite/NGjXEZcbJq) - Communauté active avec assistance en temps réel
* **Documentation** : Parcourez les autres guides de cette documentation
* **Retours** : Utilisez le bouton Feedback dans la barre supérieure de Verdent pour signaler des problèmes ou suggérer des améliorations

***

## FAQ [#faq]

<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 "Switch Permission" affiche votre mode actuel (par exemple, "Manual", "Auto", "Plan"). Vous pouvez cliquer dessus pour changer de mode.
</Accordion>

<Accordion title="Que se passe-t-il si je n'ai plus de crédits ?">
  Les requêtes standard basées sur les crédits s'arrêtent lorsque votre solde atteint zéro. Attendez le renouvellement de votre prochain cycle de facturation ou achetez une recharge de crédits ponctuelle pour continuer.
</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, et chacun conserve son propre contexte de conversation distinct.
</Accordion>

<Accordion title="Comment démarrer une nouvelle conversation avec un contexte vierge ?">
  Cliquez sur le bouton "New Session" dans la barre supérieure. Cela efface l'historique de conversation actuel et donne à Verdent une nouvelle fenêtre de contexte pour votre prochaine tâche.
</Accordion>

***

## Prochaines étapes [#prochaines-étapes]

Vous avez installé Verdent, effectué votre première tâche et appris le flux de travail principal. Voici où aller ensuite :

<CardGroup cols="2">
  <Card title="Concepts fondamentaux" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    Comprendre les sous-agents, l'architecture multi-agents et la gestion du contexte
  </Card>

  <Card title="Flux de travail courants" icon="code" href="/docs/verdent-for-vscode/common-workflows/multi-step-tasks">
    Guides étape par étape pour les tâches à plusieurs étapes, les grandes bases de code et le contrôle de version
  </Card>
</CardGroup>
