Cursor IDE : Tutoriel Complet en Français

1. Qu'est-ce que Cursor ?

Cursor est un IDE « AI-native » développé par Anysphere (San Francisco). Contrairement à GitHub Copilot qui est un plugin ajouté à VS Code, Cursor est l'IDE. C'est un fork complet de VS Code, ce qui signifie qu'il est 100% compatible avec vos extensions, thèmes et raccourcis VS Code existants — la migration est quasi-instantanée.

La différence fondamentale : l'IA n'est pas dans une barre latérale attendant vos questions. Elle est intégrée dans chaque aspect de l'éditeur — elle lit votre dépôt entier, planifie des modifications multi-fichiers, exécute des commandes terminal, et vérifie ses changements via vos tests.

2. Les fonctionnalités clés

3. Installation et migration depuis VS Code

Cursor est disponible pour macOS, Windows et Linux. L'installation prend moins de 2 minutes :

1. Téléchargez Cursor depuis cursor.com

2. Lancez l'installateur (une application standard, pas de terminal)

3. Au premier lancement, Cursor propose d'importer vos paramètres VS Code :

4. Connectez-vous avec votre compte Cursor ou créez-en un (Hobby gratuit, ou Pro pour 20$/mois)

5. Ouvrez un projet (File → Open Folder) et commencez à coder

4. Tab : l'autocomplétion intelligente

La fonctionnalité Tab est le cœur de Cursor au quotidien. Contrairement à l'autocomplétion classique (un mot ou une ligne), Tab prédit des blocs entiers de code basés sur le contexte de votre projet.

Tab utilise un modèle propriétaire spécialisé (issu de l'acquisition de Supermaven) optimisé pour la vitesse : les prédictions apparaissent en temps réel pendant que vous tapez, sans latence perceptible.

Ce qui rend Tab différent : il ne complète pas juste la syntaxe, il comprend votre intention. Si vous commencez à écrire un test, il anticipe les assertions basées sur la structure de votre code. Si vous ajoutez un champ à un modèle, il propose de mettre à jour les composants associés.

5. Agent Mode et Background Agents

Le Agent Mode (introduit avec la version 0.50 en 2025) est la fonctionnalité phare qui distingue Cursor des simples outils d'autocomplétion. Au lieu de proposer des suggestions, l'agent agit :

Comment ça marche : Vous décrivez une tâche en langage naturel. L'agent planifie les étapes, parcourt votre codebase, modifie les fichiers nécessaires, exécute des commandes terminal, et vérifie le résultat — le tout avec votre approbation à chaque étape.

Exemple de prompt AgentRefactore le module UserService pour gérer la réinitialisation
de mot de passe :
- Ajouter une méthode forgotPassword
- Créer le template email
- Mettre à jour les routes API
- Ajouter le formulaire frontend

Les Background Agents vont encore plus loin : ils exécutent des tâches en arrière-plan pendant que vous travaillez sur autre chose. Vous pouvez lancer plusieurs agents en parallèle, chacun sur une branche Git différente, et les superviser via Mission Control.

6. Composer : édition multi-fichiers

Composer est l'outil d'édition multi-fichiers de Cursor. Ouvrez Composer avec Ctrl+I (ou Cmd+I sur Mac) et décrivez le changement souhaité :

ComposerAjoute la validation des emails dans le formulaire d'inscription.
Utilise Zod pour le schéma de validation, ajoute le message d'erreur
dans le composant SignupForm, et mets à jour le test associé.

Composer analyse votre instruction, identifie les fichiers à modifier (schéma, composant, test), génère un diff pour chaque fichier, et vous laisse approuver ou modifier les changements.

C'est la fonctionnalité qui a conquis les développeurs : renommer des variables, mettre à jour des APIs, changer des patterns de code — sur 20 fichiers en même temps. Pour beaucoup, ça justifie le prix de l'abonnement à lui seul.

7. Serveurs MCP dans Cursor

Cursor supporte nativement le Model Context Protocol (MCP), ce qui permet de connecter l'IDE à des outils externes : GitHub, bases de données, navigateurs, documentation…

Ajoutez un fichier .cursor/mcp.json à la racine de votre projet :

.cursor/mcp.json

Avec MCP activé, l'agent Cursor peut directement créer des PRs, requêter votre base de données, ou naviguer sur le web sans quitter l'éditeur.

8. Cursor vs Copilot vs Windsurf vs Claude Code

9. Tarification 2026

En juin 2025, Cursor est passé d'un modèle basé sur des requêtes à un système de crédits. Chaque plan inclut un quota de crédits mensuels, et l'excédent est facturé à l'usage.

10. Bonnes pratiques

Commencez par Tab, pas par Agent : La productivité au quotidien vient surtout de l'autocomplétion Tab. Maîtrisez-la d'abord avant de vous lancer dans les workflows agentiques complexes.

Utilisez @ pour donner du contexte : Dans le chat ou Composer, tapez @fichier.ts pour forcer Cursor à lire un fichier spécifique. @docs permet de référencer la documentation. @web pour une recherche web.

Créez un fichier .cursorrules : Équivalent du CLAUDE.md pour Claude Code. Placez-le à la racine de votre projet avec vos conventions : stack technique, patterns préférés, style de code. L'agent le respectera automatiquement.

Lisez toujours les diffs : L'agent est puissant mais pas infaillible. Les modifications touchant à l'authentification, aux paiements, ou à la sécurité méritent une relecture attentive humaine.

Combinez avec Claude Code : Beaucoup de développeurs utilisent Cursor pour le dev quotidien (autocomplétion, petits changements) et Claude Code pour le refactoring lourd et les tâches qui nécessitent un agent terminal autonome.

11. FAQ