> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration avancée

> Configurations avancées de Windsurf, notamment la prise en charge de SSH, des Dev Containers, de WSL, les paramètres du marketplace des extensions, et l'accès aux fichiers .gitignore pour Cascade.

Toutes les configurations avancées se trouvent dans Windsurf Settings, accessibles via le menu déroulant en haut à droite → Windsurf Settings ou via la Palette de commandes (Ctrl/⌘+Maj+P) → Open Windssurf Settings Page.

<div id="enabling-cascade-access-to-gitignore-files">
  # Activer l’accès de Cascade aux fichiers .gitignore
</div>

Pour permettre à Cascade d’accéder aux fichiers correspondant aux motifs de votre fichier .gitignore de projet, ouvrez vos paramètres Windsurf et allez à « Cascade Gitignore Access ». Par défaut, cette option est désactivée. Pour autoriser l’accès, activez-la en cliquant sur le commutateur.

<div id="ssh-support">
  # Prise en charge de SSH
</div>

La prise en charge SSH habituelle dans VSCode est sous licence Microsoft ; nous avons donc implémenté la nôtre spécialement pour Windsurf. Elle nécessite que [OpenSSH](https://www.openssh.com/) soit installé, mais s’appuie sinon sur très peu de dépendances et devrait « simplement fonctionner » comme d’habitude. Vous pouvez accéder à SSH via `Remote-SSH` dans la Palette de commandes, ou via le bouton `Open a Remote Window` en bas à gauche.
Cette extension fonctionne très bien pour nos besoins internes, mais il existe quelques limites et bogues connus :

* Nous ne prenons actuellement en charge que la connexion en SSH à des hôtes distants sous Linux.

* L’extension Microsoft habituelle « Remote - SSH » (ainsi que l’extension [open-remote-ssh](https://github.com/jeanp413/open-remote-ssh)) ne fonctionnera pas — ne les installez pas, car elles entrent en conflit avec notre prise en charge.

* Nous n’avons pas encore toutes les fonctionnalités de l’extension SSH de Microsoft. Nous couvrons surtout l’essentiel : la connexion à un hôte. Si vous avez des demandes de fonctionnalités, dites-le-nous !

* Pour accéder à un devcontainer sur un hôte distant après connexion via SSH, utilisez la Palette de commandes (Ctrl/Cmd+Shift+P) et choisissez l’une des options suivantes :

<Frame>
  <img src="https://mintcdn.com/codeium/N8HSATTxHA_U1q9o/assets/windsurf/ssh-devcontainer-options.png?fit=max&auto=format&n=N8HSATTxHA_U1q9o&q=85&s=954ffbef6cbc583dcfb0a472bf38c141" width="394" height="65" data-path="assets/windsurf/ssh-devcontainer-options.png" />
</Frame>

* Le transfert d’agent SSH est activé par défaut et utilisera la dernière connexion de Windsurf à cet hôte. En cas de problème, essayez de recharger la fenêtre pour réinitialiser la connexion.

* Sous Windows, vous verrez des fenêtres `cmd.exe` lorsqu’il vous sera demandé votre mot de passe. C’est normal — nous les supprimerons bientôt.

* En cas de problème, vérifiez d’abord que vous pouvez vous connecter à votre hôte distant avec la commande `ssh` dans un terminal. Si le problème persiste, incluez la sortie de l’onglet `Output > Remote SSH (Windsurf)` dans tout rapport de bogue !

<div id="dev-containers">
  # Conteneurs de développement
</div>

Windsurf prend en charge les conteneurs de développement sur Mac, Windows et Linux pour les workflows locaux et distants (via SSH).

Prérequis :

* Local : Docker doit être installé sur votre machine et accessible depuis le terminal Windsurf.
* Distant via SSH : connectez-vous à un hôte distant avec Windsurf Remote-SSH. Docker doit être installé et accessible sur l’hôte distant (depuis le shell distant). Votre projet doit inclure un fichier `devcontainer.json` ou une configuration équivalente.

Commandes disponibles (dans les fenêtres locales et distantes) :

1. `Dev Containers: Open Folder in Container`
   * Ouvrir un nouveau workspace à l’aide d’un `devcontainer.json` spécifié.
2. `Dev Containers: Reopen in Container`
   * Rouvrir le workspace actuel dans un nouveau conteneur défini par votre `devcontainer.json`.
3. `Dev Containers: Attach to Running Container`
   * Se connecter à un conteneur Docker en cours d’exécution et y attacher votre workspace actuel. Si le conteneur ne respecte pas la [Development Container Specification](https://containers.dev/implementors/spec/), Windsurf effectuera une détection au mieux de l’utilisateur distant et de l’environnement.
4. `Dev Containers: Reopen Folder Locally`
   * Lorsqu’il est connecté à un conteneur de développement, se déconnecter et rouvrir le workspace sur le système de fichiers local.
5. `Dev Containers: Show Windsurf Dev Containers Log`
   * Ouvrir la sortie du journal Dev Containers pour le dépannage.

Ces commandes sont disponibles depuis la Palette de commandes et s’affichent également lorsque vous cliquez sur le bouton `Open a Remote Window` en bas à gauche (y compris lorsque vous êtes connecté à un hôte distant via SSH).

Connexe :

* `Remote Explorer: Focus on Dev Containers (Windsurf) View` — ouvrir rapidement la vue Dev Containers.

<div id="wsl-beta">
  # WSL (bêta)
</div>

Depuis la version 1.1.0, Windsurf prend en charge Windows Subsystem for Linux en bêta. Vous devez déjà avoir configuré WSL sur votre machine Windows.

Vous pouvez accéder à WSL en cliquant sur le bouton `Open a Remote Window` en bas à gauche, ou via `Remote-WSL` dans la Palette de commandes.

<div id="extension-marketplace">
  # Marketplace des extensions
</div>

Vous pouvez changer le marketplace utilisé pour télécharger des extensions. Pour ce faire, allez dans `Windsurf Settings` et modifiez le paramètre Marketplace URL dans la section `General`.

<Frame>
  <img src="https://mintcdn.com/codeium/bVGscI7v3lPUsThV/assets/windsurf/marketplace.png?fit=max&auto=format&n=bVGscI7v3lPUsThV&q=85&s=6c7f06982ae1e5792aa12b1f1970b667" width="3420" height="2130" data-path="assets/windsurf/marketplace.png" />
</Frame>

<div id="windsurf-plugins">
  ## Windsurf Plugins
</div>

<AccordionGroup>
  <Accordion title="Windsurf Pyright">
    Recherchez « Windsurf Pyright » ou collez `@id:codeium.windsurfPyright` dans la barre de recherche des extensions.
  </Accordion>
</AccordionGroup>