# Installation (/fr/docs/verdent-for-vscode/getting-started/installation)

> Guide étape par étape pour installer et configurer Verdent



Ce guide vous accompagne dans l'installation de Verdent for VS Code depuis la Marketplace Visual Studio Code et dans la réalisation de l'authentification initiale.

***

## Prérequis [#prérequis]

Avant d'installer Verdent, assurez-vous que votre système répond à ces prérequis :

### Configuration système requise [#configuration-système-requise]

* **Visual Studio Code** : version 1.90.0 ou supérieure
* **Système d'exploitation** : macOS 11+, Windows 10+, ou Linux (Ubuntu 20.04+, Debian 10+, RHEL 8+)
* **Connexion internet** : une connexion active est nécessaire pour la communication avec le service d'IA

### Optionnel mais recommandé [#optionnel-mais-recommandé]

* **Git** : pour l'intégration au contrôle de version et le suivi des modifications de code

Consultez [Configuration système requise](/docs/verdent-for-vscode/getting-started/system-requirements) pour des informations détaillées sur la compatibilité.

***

## Installation de l'extension [#installation-de-lextension]

Verdent for VS Code est distribué via la Marketplace Visual Studio Code.

<Tabs>
  <Tab title="Marketplace VS Code">
    <Steps>
      <Step title="Accéder à la Marketplace">
        Accédez à la \[page d'extension [Verdent](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) dans votre navigateur.
      </Step>

      <Step title="Cliquer sur Installer">
        Cliquez sur le bouton **Installer** sur la page de la marketplace.
      </Step>

      <Step title="Ouvrir dans VS Code">
        VS Code s'ouvrira automatiquement et démarrera le processus d'installation.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Panneau des extensions">
    <Steps>
      <Step title="Ouvrir VS Code">
        Lancez Visual Studio Code sur votre ordinateur.
      </Step>

      <Step title="Accéder aux extensions">
        Cliquez sur l'icône Extensions dans la barre latérale gauche (icône à quatre carrés) ou appuyez sur :

        * **macOS** : `Cmd+Shift+X`
        * **Windows/Linux** : `Ctrl+Shift+X`
      </Step>

      <Step title="Rechercher Verdent">
        Saisissez "Verdent" dans le champ de recherche en haut du panneau des extensions. Recherchez "Verdent" par Verdent AI dans les résultats.
      </Step>

      <Step title="Installer">
        Cliquez sur le bouton **Installer** à côté de l'extension Verdent. L'installation prend généralement quelques secondes.
      </Step>
    </Steps>
  </Tab>

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

    Cette méthode est utile pour :

    * Les scripts de configuration automatisés
    * Les installations sur serveur distant via SSH
    * La configuration d'environnements CI/CD
    * L'installation rapide sur plusieurs machines
  </Tab>
</Tabs>

<Tip>
  Si vous utilisez la synchronisation des paramètres de VS Code, Verdent s'installera automatiquement sur les nouvelles machines lors de la synchronisation de votre liste d'extensions.
</Tip>

***

## Authentification et configuration [#authentification-et-configuration]

Après l'installation, vous devrez vous authentifier avec votre compte Verdent pour commencer à utiliser l'extension.

### Authentification initiale [#authentification-initiale]

<Steps>
  <Step title="Ouvrir Verdent">
    Après l'installation, cliquez sur l'icône Verdent dans la barre latérale de VS Code. Vous verrez les options de connexion / inscription.
  </Step>

  <Step title="Se connecter">
    Cliquez sur **Se connecter**. VS Code affichera une fenêtre demandant "Voulez-vous que Code ouvre le site externe ?" - cliquez sur **Ouvrir**.
  </Step>

  <Step title="Authentification dans le navigateur">
    Votre navigateur s'ouvrira sur la page d'authentification de Verdent. Connectez-vous avec les identifiants de votre compte Verdent (e-mail/mot de passe ou fournisseurs OAuth comme Google, GitHub, etc.).
  </Step>

  <Step title="Autoriser VS Code">
    Accordez à VS Code l'accès à votre compte Verdent lorsque vous y êtes invité.
  </Step>

  <Step title="Retourner dans VS Code">
    Retournez dans VS Code une fois l'authentification terminée. Le panneau Verdent affichera désormais l'interface de saisie.
  </Step>
</Steps>

**Durée totale :** 2 à 3 minutes pour l'installation et la configuration complètes.

### Configuration initiale (optionnelle) [#configuration-initiale-optionnelle]

Verdent for VS Code est conçu pour une utilisation immédiate après authentification, avec un minimum de configuration requise.

**Paramètres par défaut :**

* **Mode d'autorisation** : Auto-Run Mode (approbation automatique pour les opérations sûres)
* **Préréglage du modèle** : Équilibré (combinaison optimale performance/coût)
* **Gestion du contexte** : Automatique

**Personnalisation optionnelle :**

Vous pouvez ajuster ces paramètres plus tard depuis le panneau Verdent :

* **Mode d'autorisation** - Choisissez Accepter manuellement, Exécution automatique, Plan Mode, ou Ignorer les autorisations
* **Sélection du modèle** - Sélectionnez les préréglages Performance, Équilibré, Efficacité ou des modèles spécifiques
* **Paramètres de l'espace de travail** - Configurez des préférences spécifiques au projet

<Note>
  La plupart des utilisateurs peuvent commencer à utiliser Verdent immédiatement après la connexion, sans configuration supplémentaire. Les paramètres avancés peuvent être ajustés selon les besoins.
</Note>

***

## Vérification de l'installation [#vérification-de-linstallation]

Confirmez que votre installation fonctionne correctement grâce à ces vérifications simples :

### Vérification visuelle [#vérification-visuelle]

1. **Icône dans la barre latérale** - Recherchez l'icône Verdent dans la barre latérale de VS Code (côté gauche)
2. **Liste des extensions** - Ouvrez le panneau des extensions (`Cmd+Shift+X` / `Ctrl+Shift+X`) et confirmez que "Verdent" apparaît comme installé avec une coche

### Vérification fonctionnelle [#vérification-fonctionnelle]

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

  <Step title="Envoyer un prompt de test">
    Essayez une demande simple comme "Explique le contenu de cet espace de travail" dans le champ de saisie.
  </Step>

  <Step title="Recevoir une réponse">
    Verdent doit analyser votre espace de travail et fournir une réponse en quelques secondes.
  </Step>
</Steps>

**Indicateurs de réussite :**

* Icône Verdent visible dans la barre latérale
* Compte authentifié avec succès
* Possibilité d'envoyer des prompts et de recevoir des réponses

### Dépannage [#dépannage]

Si la vérification échoue, essayez ces solutions :

| Problème                           | Solution                                                        |
| ---------------------------------- | --------------------------------------------------------------- |
| Icône absente de la barre latérale | Redémarrez VS Code ou vérifiez les mises à jour de l'extension  |
| Les prompts ne répondent pas       | Vérifiez la connexion internet et les paramètres du pare-feu    |
| Extension introuvable              | Assurez-vous que la version de VS Code est 1.90.0 ou supérieure |

<Warning>
  Verdent nécessite une connexion internet active. Si les prompts ne répondent pas, vérifiez votre connectivité réseau et assurez-vous que la configuration de votre pare-feu autorise le trafic HTTPS sortant vers les points de terminaison API de Verdent.
</Warning>

***

## Étapes suivantes [#étapes-suivantes]

<CardGroup cols="2">
  <Card title="Démarrage rapide" icon="rocket" href="/docs/verdent-for-vscode/getting-started/quick-start">
    Terminez votre première tâche avec Verdent en 5 minutes
  </Card>

  <Card title="Concepts fondamentaux" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    Comprenez les sous-agents, les modes d'exécution et l'architecture multi-agents
  </Card>
</CardGroup>
