Accueil › Windsurf › Installation

Installer Windsurf : guide complet pour chaque OS

Windsurf s’installe en quelques minutes sur macOS, Windows et Linux. C’est un IDE standalone (fork de VS Code) qui inclut Cascade, un agent IA agentique capable de comprendre votre codebase entier et d’exécuter des tâches multi-fichiers de manière autonome. L’installation est gratuite, et vous pouvez importer vos paramètres VS Code ou Cursor en un clic.

Prérequis

Windsurf est un IDE complet, pas un plugin. Il remplace (ou coexiste avec) votre éditeur actuel. Avant de commencer :

Configuration minimale : 8 Go de RAM minimum, 16 Go recommandés pour le mode Codebase context sur les gros projets. Windsurf consomme environ 400 à 600 Mo de RAM au repos. Un processeur récent et une connexion internet active sont nécessaires (Cascade nécessite les serveurs de Windsurf, pas de mode hors ligne).

Systèmes d’exploitation supportés : macOS 12 (Monterey) ou supérieur, Windows 10/11, et la plupart des distributions Linux modernes (Ubuntu 22.04+, Fedora, Debian). Sur macOS, les versions antérieures à 10.15 ne sont pas supportées.

Coexistence avec d’autres IDE : Windsurf et Cursor peuvent être installés sur la même machine sans conflit. Ils ne partagent pas les fichiers de configuration ni les extensions. Vous pouvez aussi garder VS Code installé en parallèle.

Installation sur macOS

Méthode 1 : Téléchargement direct

Étape 1 : Rendez-vous sur windsurf.com/download et téléchargez le fichier .dmg pour macOS.

Étape 2 : Ouvrez le .dmg et glissez Windsurf dans votre dossier Applications.

Étape 3 : Lancez Windsurf. macOS peut afficher un avertissement de sécurité au premier lancement (app téléchargée depuis Internet). Allez dans Préférences Système > Sécurité et cliquez « Ouvrir quand même ».

Méthode 2 : Homebrew

Si vous utilisez Homebrew, l’installation tient en une commande :

brew install --cask windsurf

Homebrew gère les mises à jour automatiquement via brew upgrade --cask windsurf. La version actuelle nécessite macOS 12 minimum.

Ajouter Windsurf au PATH

Pour lancer Windsurf depuis le terminal, ouvrez la Palette de commandes (⌘+⇧+P) et exécutez « Install ‘windsurf’ command in PATH ». Ensuite :

# Ouvrir un projet dans Windsurf depuis le terminal
windsurf /chemin/vers/votre/projet

# Ouvrir le dossier courant
windsurf .

Installation sur Windows

Étape 1 : Téléchargez l’installateur .exe depuis windsurf.com/download.

Étape 2 : Exécutez l’installateur. Suivez les étapes du wizard. L’installation ajoute automatiquement Windsurf au menu Démarrer.

Étape 3 : Lancez Windsurf depuis le menu Démarrer ou le raccourci bureau. L’assistant de configuration se lance au premier démarrage.

Pour utiliser Windsurf depuis le terminal (PowerShell ou cmd), ajoutez le dossier d’installation au PATH via la Palette de commandes, ou lancez windsurf . si le PATH a été configuré automatiquement.

Installation sur Linux

Ubuntu / Debian (.deb)

# Télécharger le paquet .deb
wget https://windsurf-stable.codeiumdata.com/linux-deb/x86_64/windsurf_latest.deb

# Installer
sudo dpkg -i windsurf_latest.deb

Fedora / RHEL (.rpm)

# Ajouter le dépôt
sudo rpm --import https://packages.windsurf.dev/gpg.key
sudo dnf config-manager --add-repo https://packages.windsurf.dev/rpm/windsurf.repo

# Installer
sudo dnf install windsurf-ide

AppImage (universel)

Un AppImage est aussi disponible sur la page de téléchargement. Rendez-le exécutable (chmod +x Windsurf.AppImage) et lancez-le directement. Pas besoin d’installation système.

Configuration initiale (onboarding)

Au premier lancement, Windsurf vous guide à travers un assistant de configuration en quatre étapes :

1. Migration depuis VS Code ou Cursor

Si vous venez de VS Code ou Cursor, Windsurf propose d’importer automatiquement vos paramètres, extensions, keybindings, et thèmes. Sélectionnez ce que vous voulez importer (tout, juste les paramètres, juste les extensions, ou rien). Si vous importez un thème depuis VS Code, il écrasera le thème choisi à l’étape suivante.

Si vous préférez repartir de zéro, sélectionnez « Start fresh ». Vous pourrez toujours importer plus tard via la Palette de commandes.

2. Keybindings

Choisissez entre les raccourcis par défaut de VS Code ou les raccourcis Vim. Puisque Windsurf est un fork de VS Code, les raccourcis par défaut vous seront immédiatement familiers si vous venez de VS Code ou Cursor.

3. Thème

Sélectionnez un thème parmi les options par défaut. Vous pouvez changer à tout moment dans les paramètres. Les abonnés payants peuvent personnaliser l’icône de l’application (macOS uniquement pour le moment).

4. Création de compte

Windsurf nécessite un compte pour fonctionner (même sur le plan gratuit). Inscrivez-vous avec votre email ou via OAuth (Google, GitHub). L’inscription est gratuite. Une fois authentifié, cliquez « Open Windsurf » pour accéder à l’IDE.

Si l’authentification échoue dans le navigateur, vous pouvez vous connecter manuellement et fournir un code d’authentification directement dans l’IDE.

Découvrir l’interface

L’interface de Windsurf ressemble à VS Code avec un panneau supplémentaire sur la droite : Cascade. C’est l’agent IA de Windsurf, accessible avec ⌘+L (macOS) ou Ctrl+L (Windows/Linux).

Cascade : l’agent IA

Cascade est le cœur de Windsurf. Contrairement à un simple chat, Cascade est un agent complet qui peut lire plusieurs fichiers, planifier des modifications multi-étapes, exécuter des commandes terminal, et expliquer son raisonnement. Il comprend l’intégralité de votre codebase via le mode « Codebase context ».

Cascade fonctionne en deux modes principaux : Write (modifications de code) et Chat (questions et explications). En mode Write, Cascade peut créer, modifier et supprimer des fichiers. En mode Chat, il répond à vos questions sans toucher au code. Consultez notre guide complet sur Windsurf Cascade.

Tab Completions (Supercomplete)

En plus de Cascade, Windsurf propose des complétions de code inline (Tab completions) similaires à celles de GitHub Copilot. Elles sont illimitées sur tous les plans (même le gratuit) et ne consomment pas de crédits. Les suggestions apparaissent en gris pendant que vous tapez, et vous les acceptez avec Tab.

Inline Edit (⌘+K / Ctrl+K)

Pour des modifications ciblées, sélectionnez du code et appuyez sur ⌘+K (macOS) ou Ctrl+K (Windows/Linux). Décrivez la modification en langage naturel (par exemple « Ajoute la gestion d’erreur » ou « Convertis en TypeScript »). Windsurf applique le changement directement dans l’éditeur.

Configuration recommandée

Fichier .windsurfrules

Le fichier .windsurfrules à la racine de votre projet est l’équivalent du .github/copilot-instructions.md de Copilot. C’est un fichier de prompt système persistant qui guide le comportement de Cascade. Sans ce fichier, Cascade fonctionne avec des réglages par défaut conservateurs.

# .windsurfrules

## Stack
- TypeScript strict, React 19, Next.js 15
- Prisma ORM avec PostgreSQL
- Vitest pour les tests

## Conventions
- Fonctions fléchées uniquement
- Imports absolus avec @/
- Commentaires en français, code en anglais

## Ce qu'il ne faut PAS faire
- Ne jamais utiliser any
- Ne pas modifier le schéma DB sans demander
- Ne pas installer de nouvelles dépendances sans validation

C’est le levier de productivité le plus sous-estimé de Windsurf. Investissez 10 minutes pour écrire un bon fichier .windsurfrules et la qualité des réponses de Cascade s’améliorera drastiquement. Pour des règles qui s’appliquent à tous vos projets, Windsurf supporte des règles globales dans les paramètres utilisateur. Consultez notre guide dédié sur les Windsurf rules.

Paramètres Cascade

Dans les paramètres Windsurf (⌘+, ou Ctrl+,, section AI), configurez :

Auto-run terminal commands : quand activé, Cascade peut exécuter des commandes terminal (npm install, tests, etc.) sans demander votre confirmation. Désactivez cette option si vous préférez valider chaque commande.

File creation permissions : contrôlez si Cascade peut créer de nouveaux fichiers ou seulement modifier les fichiers existants.

Auto-lint : Cascade corrige automatiquement les erreurs de lint dans le code qu’il génère. Si une modification produit des erreurs de lint, Cascade les corrige dans une étape suivante, sans coût de crédits supplémentaire.

Serveurs MCP

Windsurf supporte les serveurs MCP (Model Context Protocol) pour étendre les capacités de Cascade avec des outils externes. Configurez-les dans les paramètres Windsurf (page dédiée). Les cas d’usage courants : connecter Cascade à une base de données, à Sentry pour le monitoring d’erreurs, à Linear pour la gestion de tâches, ou au serveur GitHub MCP pour accéder aux issues et PR.

Plans et prix après installation

Windsurf a refondu ses tarifs le 18 mars 2026, passant d’un système de crédits à des quotas journaliers et hebdomadaires :

Les Tab completions sont gratuites et illimitées sur tous les plans. Le modèle SWE-1 (modèle interne de Windsurf optimisé pour le code) est disponible sans coût de quotas. Les modèles premium tiers (Claude Sonnet 4.6, GPT-5.4, Gemini) consomment vos quotas. Les utilisateurs Free et Pro peuvent aussi connecter leur propre clé API (BYOK) pour éviter de consommer les quotas Windsurf. Pour les détails tarifaires, consultez notre page Windsurf prix.

Dépannage courant

Cascade ne propose pas de suggestions

Vérifiez votre connexion internet (Cascade nécessite une connexion active). Assurez-vous que vous êtes connecté à votre compte Windsurf (icône en haut à droite). Si vous êtes sur le plan gratuit, vérifiez que vous n’avez pas épuisé vos quotas quotidiens ou hebdomadaires. Essayez de redémarrer Windsurf.

Extensions manquantes après migration

Certaines extensions VS Code ne sont pas compatibles avec Windsurf. Les extensions propriétaires et les extensions d’autocomplétion IA (Copilot, Tabnine) ne fonctionneront pas. Windsurf ne supporte pas l’installation depuis des marketplaces externes. Si une extension critique manque, vérifiez si une alternative est disponible dans l’écosystème Open VSX.

Proxy d’entreprise

Si vous êtes derrière un proxy d’entreprise, configurez les paramètres réseau dans les settings Windsurf. La configuration proxy est similaire à celle de VS Code :

{
  "http.proxy": "http://proxy.company.com:8080",
  "http.proxyStrictSSL": false
}

Performance lente sur gros projets

Si Windsurf ralentit sur des projets volumineux, limitez l’indexation en excluant les dossiers non pertinents. Dans les paramètres, configurez indexing.excludePatterns pour exclure node_modules, .git, dist, et les fichiers de logs.

Windsurf vs les alternatives : pourquoi installer Windsurf ?

Si vous hésitez entre Windsurf et d’autres outils, voici le positionnement. Windsurf se distingue par Cascade, son agent IA agentique qui comprend l’ensemble de votre codebase et exécute des tâches multi-fichiers de manière autonome. C’est plus puissant que le chat de Copilot (qui se limite au fichier actif sauf avec @workspace), et plus accessible que Claude Code (qui nécessite le terminal).

Par rapport à Cursor, Windsurf est 5 $ moins cher (20 $ vs 20 $ après la refonte de mars 2026, contre 15 $ avant), avec un modèle interne (SWE-1) qui ne consomme pas de quotas. Le mode Arena (janvier 2026) permet de comparer deux modèles côte à côte directement dans l’IDE, une fonctionnalité unique. Consultez notre comparatif détaillé Windsurf vs Cursor.

Par rapport à Copilot, Windsurf offre une expérience agentique plus profonde dans l’IDE mais perd sur la compatibilité multi-IDE (Windsurf est un IDE standalone, Copilot fonctionne dans 6+ éditeurs) et l’intégration GitHub native.

Windsurf Next : les fonctionnalités en avant-première

Windsurf Next est la version pré-release de l’IDE. Vous pouvez y accéder pour tester les nouvelles fonctionnalités avant leur sortie stable. Les fonctionnalités sont d’abord déployées sur Windsurf Next, puis intégrées dans la version stable quelques jours ou semaines plus tard.

Téléchargez Windsurf Next depuis la page de releases officielle. Il s’installe séparément de la version stable, vous pouvez avoir les deux en parallèle.

Premiers pas après l’installation

Ouvrez un projet existant. Utilisez File > Open Folder ou windsurf . depuis le terminal. Windsurf indexe automatiquement votre codebase pour le mode Codebase context.

Testez les Tab completions. Ouvrez un fichier de code et commencez à taper. Les suggestions apparaissent en gris. Tab pour accepter. L’expérience est identique à VS Code + Copilot.

Ouvrez Cascade. ⌘+L (macOS) ou Ctrl+L (Windows/Linux). Demandez « Explique l’architecture de ce projet » ou « Quels sont les endpoints API définis ? ». Cascade parcourt votre codebase et répond en contexte.

Créez votre fichier .windsurfrules. C’est le premier geste à faire pour améliorer la qualité des réponses. Consultez notre guide Windsurf rules.

Essayez le mode Write. Dans Cascade, décrivez une tâche : « Ajoute un endpoint GET /api/health qui retourne le statut du serveur et la version ». Cascade crée le fichier, écrit le code, et propose de lancer les tests.

Pour des prompts efficaces avec Cascade, consultez notre page Windsurf prompts.