Accueil › Cursor › Installation

Installer Cursor : guide complet pour Windows, macOS et Linux

Cursor s’installe en moins de 5 minutes sur les trois plateformes. Téléchargez l’installeur depuis cursor.com, lancez-le, connectez-vous, et vous êtes prêt à coder avec l’IA. Vos extensions, thèmes et raccourcis VS Code sont importables en un clic.

Cursor est l’IDE IA le plus utilisé en 2026, avec plus d’un million de développeurs payants. Construit sur la base de VS Code, il ajoute des fonctionnalités d’IA profondément intégrées : complétion prédictive (Tab), édition en langage naturel (Cmd+K), chat contextuel (Cmd+L), Composer multi-fichiers et mode Agent autonome. L’installation est volontairement simple, mais quelques étapes de configuration initiale font la différence entre une expérience basique et une productivité maximale. Ce guide couvre tout, de la vérification des prérequis jusqu’à votre première utilisation concrète.

Prérequis avant l’installation

Configuration système

Cursor ne demande pas de matériel puissant. Les fonctionnalités IA sont exécutées dans le cloud, pas sur votre machine. Voici les prérequis :

La connexion internet est indispensable pour les fonctionnalités IA (Tab completion, Chat, Agent, Composer). L’éditeur lui-même fonctionne hors ligne pour l’édition basique, mais vous perdez toute l’assistance IA.

Outils complémentaires recommandés

Git est essentiel. Cursor utilise Git pour le contrôle de version, le clonage de dépôts, et les checkpoints de l’Agent mode. Si vous ne l’avez pas encore, installez-le avant Cursor.

Node.js (version 18+) est nécessaire si vous comptez utiliser le Model Context Protocol (MCP) pour connecter des services externes à Cursor. Pas indispensable pour commencer, mais utile pour les workflows avancés.

Python si vous développez en Python. Cursor ne l’inclut pas. Installez Python 3.x et vérifiez qu’il est dans votre PATH.

Installation sur Windows

Rendez-vous sur cursor.com/download. Le site détecte automatiquement votre OS et propose le bon installeur. Téléchargez le fichier .exe (environ 200 Mo, version x64 par défaut, ARM64 aussi disponible).

Double-cliquez sur l’installeur téléchargé (CursorUserSetup-x64-0.48.x.exe ou similaire). Suivez l’assistant d’installation. Les options incluent le choix du répertoire, la création de raccourcis bureau et l’intégration dans le menu Démarrer. Acceptez les permissions demandées.

L’installation prend généralement moins de 2 minutes. Une fois terminée, Cursor se lance automatiquement. Si ce n’est pas le cas, retrouvez-le dans le menu Démarrer ou via le raccourci bureau.

CLI Cursor sur Windows

Cursor installe automatiquement la commande cursor dans le PATH. Vérifiez dans PowerShell :

cursor --version

Vous pouvez ouvrir un projet directement depuis le terminal avec cursor . dans n’importe quel répertoire.

Installation sur macOS

Sur cursor.com/download, téléchargez le fichier .dmg. Deux versions existent : Intel (x64) et Apple Silicon (ARM64). Le site propose la bonne version automatiquement, mais vérifiez si vous avez un doute (menu Apple > À propos de ce Mac > Puce).

Ouvrez le .dmg, glissez Cursor dans le dossier Applications. Au premier lancement, macOS peut afficher un avertissement de sécurité (« Application téléchargée depuis Internet »). Cliquez sur « Ouvrir » ou autorisez l’application dans Préférences Système > Sécurité et confidentialité.

CLI Cursor sur macOS

Après le premier lancement, ouvrez la palette de commandes (Cmd+Shift+P) et tapez « Install ‘cursor’ command in PATH ». Cela ajoute la commande cursor à votre terminal. Vérifiez :

cursor --version
# Ouvrir le répertoire courant dans Cursor
cursor .

Installation sur Linux

Cursor propose plusieurs formats pour Linux :

AppImage (recommandé pour la plupart des distributions) : téléchargez le fichier .AppImage, rendez-le exécutable, et lancez-le.

# Télécharger (vérifiez l'URL exacte sur cursor.com/download)
chmod +x cursor-*.AppImage
./cursor-*.AppImage

Note : sur Ubuntu 22.04+, le package libfuse2 peut être nécessaire pour exécuter les AppImage :

sudo apt install libfuse2

.deb pour Ubuntu/Debian :

sudo dpkg -i cursor_*.deb
sudo apt install -f  # Résoudre les dépendances manquantes

.rpm pour Fedora/RHEL :

sudo rpm -i cursor_*.rpm

Premier lancement et configuration initiale

Au premier démarrage, Cursor affiche un écran de bienvenue avec plusieurs étapes de configuration.

Créer un compte ou se connecter

Cursor nécessite un compte pour activer les fonctionnalités IA. Vous pouvez vous inscrire avec un email ou via Google/GitHub. Un essai Pro de 14 jours est automatiquement activé, ce qui vous donne accès à toutes les fonctionnalités sans restriction. Après les 14 jours, vous basculerez sur le plan Hobby (gratuit avec limitations) ou pourrez souscrire un abonnement Pro ($20/mois).

Importer les paramètres VS Code

Si vous venez de VS Code, Cursor propose d’importer automatiquement vos extensions, thèmes, raccourcis clavier et paramètres. Acceptez cette importation : elle rend la transition transparente. Vos extensions VS Code fonctionnent directement dans Cursor (c’est le même écosystème d’extensions).

Si vous préférez repartir de zéro, vous pouvez ignorer cette étape et installer les extensions manuellement depuis le marketplace intégré.

Choisir le schéma de raccourcis

Cursor propose de garder les raccourcis VS Code par défaut ou d’utiliser des raccourcis optimisés pour l’IA. Les raccourcis essentiels à retenir :

Configurer le mode Privacy

Si vous travaillez sur du code propriétaire ou sensible, activez le Privacy Mode dans Settings > Cursor Settings > Privacy. Ce mode garantit que votre code n’est pas stocké sur les serveurs de Cursor ni utilisé pour l’entraînement des modèles. C’est une certification SOC 2 qui le soutient. Pour les plans Enterprise, des audit logs et des contrôles administrateurs granulaires sont disponibles.

Configurer les modèles IA

Dans Settings > Models, vous accédez à la liste des modèles IA disponibles. Par défaut, Cursor propose Claude Sonnet 4.6, GPT-4.1, Gemini, et d’autres modèles premium.

Mode Auto (recommandé pour commencer)

Le mode Auto laisse Cursor choisir automatiquement le meilleur modèle pour chaque tâche. C’est illimité sur tous les plans payants et ne consomme pas (ou très peu) de crédits. C’est le meilleur point de départ : vous bénéficiez de l’IA sans vous soucier du choix du modèle.

Ajouter des modèles custom

Vous pouvez ajouter des modèles non inclus par défaut. C’est particulièrement utile pour connecter DeepSeek (API ultra low-cost), un modèle local via Ollama, ou une version spécifique de Claude/GPT via votre propre clé API.

Dans Settings > Models, cliquez « Add model », entrez le nom du modèle, activez « Override OpenAI Base URL », et renseignez l’URL et la clé API du fournisseur. Le modèle apparaît ensuite dans le sélecteur du Chat, du Composer et de l’édition inline.

Exemples de configurations courantes :

L’ajout de DeepSeek comme modèle custom est une stratégie d’optimisation des coûts très populaire : vous gardez le mode Auto (illimité) pour les tâches courantes, et vous basculez sur DeepSeek ($0,28/1M tokens) pour les tâches intermédiaires, ce qui préserve vos crédits Cursor pour les modèles premium.

Premiers pas avec Cursor

Ouvrir votre premier projet

File > Open Folder pour ouvrir un projet existant. Cursor va automatiquement indexer votre codebase avec son modèle d’embedding propriétaire. Cette indexation permet au Chat et à l’Agent de comprendre votre projet entier, pas seulement le fichier ouvert. L’indexation initiale peut prendre quelques secondes à quelques minutes selon la taille du projet.

Tester le Chat IA

Ouvrez le chat avec Cmd+L (ou Ctrl+L). Posez une question sur votre code : « Explique-moi la structure de ce projet » ou « Comment fonctionne l’authentification dans ce codebase ? ». Le modèle accède à l’ensemble de votre projet grâce à l’indexation, ce qui produit des réponses contextuelles et précises.

Utilisez les mentions @ pour pointer l’IA vers des fichiers, fonctions ou dossiers spécifiques. Par exemple : @package.json Quelles sont les dépendances principales ?

Tester l’édition inline

Sélectionnez un bloc de code, puis appuyez sur Cmd+K. Tapez une instruction en langage naturel : « Ajoute la gestion d’erreurs » ou « Convertis en async/await ». Cursor modifie le code sélectionné et affiche un diff avant application. Acceptez avec Entrée ou rejetez avec Échap.

Tester le mode Agent

Le mode Agent (Cmd+I) est la fonctionnalité la plus puissante. Décrivez une tâche complexe : « Ajoute un endpoint REST pour la gestion des utilisateurs avec validation Zod et tests unitaires ». L’Agent navigue dans votre codebase, crée et modifie les fichiers nécessaires, exécute des commandes dans le terminal, et produit un résultat complet. Chaque changement est suivi par Git, ce qui permet un rollback facile.

La Tab Completion : l’IA invisible

La Tab completion est la fonctionnalité que vous utiliserez le plus sans même y penser. Cursor prédit votre prochaine frappe en fonction du contexte (fichier ouvert, modifications récentes, structure du projet) et propose une complétion. Appuyez sur Tab pour accepter, continuez à taper pour ignorer. Ce n’est pas un simple autocomplete comme dans VS Code : Cursor utilise un modèle propriétaire entraîné spécifiquement pour la complétion de code, qui comprend le contexte multi-fichiers.

La Tab completion est illimitée sur tous les plans payants (y compris en mode Auto). C’est l’un des meilleurs arguments pour passer de VS Code + Copilot à Cursor : la complétion est plus contextuelle car elle accède à votre codebase entier, pas seulement au fichier courant.

Créer un fichier .cursorrules

Pour des résultats optimaux dès le premier jour, créez un fichier .cursorrules à la racine de votre projet. Ce fichier contient des instructions persistantes que l’IA suivra pour toutes les interactions dans ce projet. Par exemple :

# .cursorrules
- Utiliser TypeScript strict avec les types de retour explicites
- Suivre les conventions du projet (camelCase, fichiers en kebab-case)
- Toujours inclure la gestion d'erreurs
- Commenter en français
- Préférer les fonctions pures quand c'est possible

Ce fichier fait une différence significative dans la qualité du code généré. Sans .cursorrules, l’IA fait des choix génériques. Avec, elle respecte vos conventions spécifiques dès la première requête.

Dépannage courant

Cursor ne démarre pas

Vérifiez que vous avez au moins 1 Go d’espace disque libre. Redémarrez votre machine. Si le problème persiste, désinstallez et réinstallez depuis cursor.com. Sur Linux, vérifiez que libfuse2 est installé pour les AppImage.

Les fonctionnalités IA ne fonctionnent pas

Vérifiez que vous êtes connecté (icône en bas à gauche de la fenêtre). Vérifiez votre connexion internet. Si vous êtes derrière un proxy d’entreprise, configurez-le dans Settings > Proxy. Redémarrez Cursor après la modification.

Extensions VS Code manquantes après import

Certaines extensions spécifiques à VS Code peuvent ne pas être 100% compatibles avec Cursor. Le marketplace de Cursor est basé sur celui de VS Code, mais quelques extensions propriétaires Microsoft (comme les Remote extensions) peuvent nécessiter une alternative. En général, 95%+ des extensions fonctionnent directement.

Cursor est lent sur un gros projet

L’indexation d’un très gros codebase peut consommer de la RAM. Utilisez un fichier .cursorignore (similaire à .gitignore) pour exclure les dossiers volumineux non pertinents : node_modules/, .git/, dist/, build/, fichiers binaires. Cela réduit la taille de l’index et accélère les réponses de l’IA.

Un fichier .cursorindexingignore permet un contrôle plus fin en excluant des fichiers de l’indexation IA sans les masquer de l’arborescence de fichiers. C’est utile pour les gros dossiers de données ou de logs que vous voulez voir mais que l’IA n’a pas besoin de comprendre.

Configuration derrière un proxy d’entreprise

Si vous êtes dans un réseau d’entreprise avec un proxy, Cursor doit être configuré pour y accéder. Ouvrez Settings > Proxy et renseignez l’URL de votre proxy. Si votre proxy utilise un certificat auto-signé, vous devrez peut-être ajouter le certificat dans les paramètres de confiance de votre OS. Les pare-feu d’entreprise qui bloquent les WebSocket peuvent empêcher les fonctionnalités IA de fonctionner. Demandez à votre équipe réseau d’autoriser les connexions vers les domaines de Cursor (*.cursor.com, *.anthropic.com, *.openai.com).

La mise à jour automatique échoue

Si Cursor ne parvient pas à se mettre à jour, téléchargez la dernière version manuellement depuis cursor.com/download et réinstallez par-dessus l’installation existante. Vos paramètres, extensions et projets récents sont conservés. Sur Linux, les AppImage nécessitent un téléchargement manuel de chaque nouvelle version (pas de mise à jour in-place). Surveillez les releases sur le site officiel.

Et ensuite ?

L’installation n’est que le début. Cursor révèle sa puissance quand vous maîtrisez ses fonctionnalités avancées :

Configurez des .cursorrules pour que l’IA respecte vos conventions de code. Maîtrisez le Composer pour les modifications multi-fichiers. Explorez le mode Agent pour les tâches complexes et autonomes. Ajoutez DeepSeek comme modèle custom pour réduire vos coûts de 90%. Découvrez les raccourcis pour accélérer votre workflow.

Conseil : passez la première semaine à utiliser principalement le Chat (Cmd+L) et l’édition inline (Cmd+K). Familiarisez-vous avec la logique de l’IA avant de passer au Composer et à l’Agent mode. La courbe d’apprentissage est courte, et les gains de productivité sont immédiats.