Cursor : Guide Complet et Avis Détaillé en 2026

L'IDE IA le plus utilisé, disséqué

Mars 2026. Cursor dépasse les 2 millions d'utilisateurs actifs et génère plus de 500 millions de dollars de revenus annuels. Valorisé à 10 milliards de dollars, c'est l'IDE IA le plus adopté par les développeurs professionnels. Pourtant, la documentation officielle est en anglais et les guides existants survolent les fonctionnalités avancées.

Ce guide couvre tout : installation, fonctionnalités clés, mode Agent, personnalisation, pricing et limites honnêtes. Pour un comparatif avec la concurrence, voir Cursor vs Windsurf. Pour un premier projet concret, voir Débuter le Vibe Coding en 30 minutes.

Installation et premier lancement

De VS Code à Cursor en 5 minutes

Cursor est un fork de VS Code. Concrètement, l'interface est identique : même layout, même terminal intégré, même marketplace d'extensions. La migration se fait en trois étapes :

1. Télécharger Cursor depuis cursor.com
2. Au premier lancement, Cursor propose d'importer les extensions, thèmes et raccourcis depuis VS Code
3. Accepter l'import — tout est transféré en quelques secondes

Les extensions VS Code fonctionnent nativement. ESLint, Prettier, GitLens, Tailwind IntelliSense — tout marche sans configuration supplémentaire. La transition est transparente.

Configuration recommandée

Quelques réglages à activer dès le départ dans les Settings (Ctrl+,) :

// .vscode/settings.json
{
  "cursor.cpp.enablePartialAccepts": true,
  "cursor.general.enableShadowWorkspace": true,
  "editor.cursorSmoothCaretAnimation": "on",
  "editor.minimap.enabled": false
}

enablePartialAccepts permet d'accepter les suggestions mot par mot (Tab pour un mot, Ctrl+→ pour tout). enableShadowWorkspace donne à l'agent un espace de travail invisible pour tester ses modifications avant de les appliquer.

Les fonctionnalités clés

Tab — L'autocomplétion IA

La fonctionnalité la plus utilisée. Cursor prédit la suite du code en temps réel et propose des suggestions via la touche Tab. Contrairement à GitHub Copilot, Cursor ne se contente pas de compléter la ligne en cours — l'outil anticipe des blocs entiers de 10-20 lignes.

L'autocomplétion est contextuelle : Cursor analyse le fichier ouvert, les fichiers adjacents et l'historique des modifications récentes. Sur un projet Next.js avec des composants Tailwind, les suggestions respectent les conventions du projet dès le premier jour.

Le chat intégré et le choix des modèles

Le panneau de chat (Ctrl+L) permet de poser des questions sur le code, demander des explications ou générer du code. Plusieurs modèles sont disponibles : Claude Sonnet (recommandé pour le code), GPT-4o (rapide), Gemini (contexte long).

Le chat comprend les références contextuelles. Taper @filename inclut un fichier dans le contexte. @Codebase lance une recherche sémantique dans tout le projet. @Web cherche sur internet. Ces mécanismes sont plus puissants que le chat de Copilot.

Codebase Indexing — Le contexte projet

C'est l'avantage technique majeur de Cursor. Au premier lancement sur un projet, l'outil indexe l'intégralité du codebase : fichiers, imports, types, relations entre modules. Cette indexation alimente toutes les autres fonctionnalités.

Sur un projet de 500 fichiers TypeScript, Cursor comprend qu'un composant UserCard utilise le type User défini dans src/types/user.ts, exporté par src/lib/api.ts. Quand on demande une modification de UserCard, l'agent sait quels fichiers sont impactés. GitHub Copilot n'offre pas cette profondeur d'analyse.

Le mode Composer

Le Composer (Ctrl+I) est le mode d'édition inline. On sélectionne du code, on décrit la modification voulue en langage naturel, Cursor propose un diff. C'est plus rapide que le chat pour les modifications ciblées : renommer une variable, extraire une fonction, ajouter une gestion d'erreur.

Le Composer peut opérer sur plusieurs fichiers simultanément. On sélectionne les fichiers concernés dans le panneau et la modification est cohérente à travers le projet. C'est le mode le plus utilisé pour les refactorings.

Le mode Agent — Le vrai différenciateur

Comment ça fonctionne

L'Agent Mode (Ctrl+I → Agent) est le mode le plus avancé de Cursor. L'agent a accès au terminal, au système de fichiers, aux outils de build et au navigateur. On décrit une tâche en langage naturel et l'agent exécute les étapes nécessaires : créer des fichiers, modifier du code, installer des dépendances, lancer des tests.

Concrètement, demander "Ajoute une page /about avec les métadonnées SEO et un test unitaire" déclenche une séquence autonome : création du fichier page, écriture du composant, configuration des métadonnées, écriture du test, exécution du test pour vérifier que tout passe.

Test sur un projet réel

Sur un projet Next.js App Router avec 180 fichiers TypeScript, l'Agent Mode a été testé sur trois tâches :

Tâche 1 — Ajouter un endpoint API : l'agent crée le fichier route.ts, le schéma de validation Zod, le handler avec gestion d'erreur, et un fichier de test. Résultat : fonctionnel du premier coup, 3 fichiers créés en 45 secondes.

Tâche 2 — Refactoring d'un composant : migration d'un composant de 200 lignes vers une architecture avec sous-composants. L'agent identifie les responsabilités, crée 4 fichiers, met à jour les imports dans 6 fichiers consommateurs. Résultat : fonctionnel après une correction manuelle mineure sur un import de type.

Tâche 3 — Debug d'un bug CSS : un problème de z-index sur un menu dropdown. L'agent lance l'app en mode dev, identifie le conflit via les DevTools, propose un fix et vérifie visuellement. Résultat : résolu, mais l'agent a mis 2 minutes là où un développeur expérimenté aurait mis 30 secondes.

Les limites de l'agent

L'agent n'est pas infaillible. Sur les tâches longues (plus de 10 fichiers modifiés), il peut perdre le fil du contexte et introduire des incohérences. Sur les modifications CSS complexes, l'agent tâtonne plus qu'un humain. Sur les architectures non conventionnelles, il revient souvent aux patterns standard qu'il connaît.

La règle : l'agent excelle sur les tâches bien définies de 1 à 5 fichiers. Au-delà, mieux vaut découper en sous-tâches.

Cursor Rules et personnalisation

Les fichiers .cursorrules

C'est la fonctionnalité méconnue la plus utile. Un fichier .cursorrules à la racine du projet définit le comportement de l'IA pour ce projet spécifique. C'est l'équivalent d'un brief permanent :

# .cursorrules
Tu travailles sur un projet Next.js 16 avec TypeScript strict.
- Utilise toujours les Server Components par défaut
- Tailwind CSS 4 avec @theme layer (pas tailwind.config.ts)
- Validation avec Zod, jamais de any
- Les composants exportent un type Props explicite
- Pas de console.log en production

L'IA respecte ces règles pour toutes les suggestions, le chat et l'agent. Sur un projet avec des conventions strictes, le gain de productivité est immédiat — plus besoin de corriger les mêmes erreurs de convention à chaque génération.

Configurer le comportement par projet

Au-delà de .cursorrules, Cursor permet de configurer le modèle par défaut, les fichiers à ignorer lors de l'indexation (.cursorignore), et les instructions système pour le chat. Pour les équipes, ces fichiers se versionnent dans Git — tout le monde partage les mêmes conventions IA.

Pricing en détail

Recommandation : le plan Pro à 20 USD/mois est le point d'entrée pour un usage sérieux. Le plan Hobby suffit pour tester l'outil pendant une semaine. Ultra se justifie pour un usage intensif quotidien de l'agent (plus de 50 requêtes/jour). Le détail des coûts globaux du vibe coding est dans Le Vrai Coût du Vibe Coding en 2026.

Attention : depuis juin 2025, Cursor utilise un système de crédits. Les requêtes longues (agent sur gros projets) consomment plus de crédits que les requêtes courtes (autocomplétion). Le prix effectif peut dépasser le forfait affiché pour les utilisateurs intensifs.

Limites honnêtes

Performances sur les gros repos

Sur les monorepos de plus de 1000 fichiers, l'indexation initiale peut prendre plusieurs minutes. Les suggestions deviennent parfois lentes et l'agent perd en pertinence. Sur un projet de 50-200 fichiers, aucun problème. Au-delà, il faut utiliser .cursorignore pour exclure les dossiers volumineux (node_modules, dist, fixtures de test).

Privacy et données dans le cloud

Par défaut, le code est envoyé aux serveurs de Cursor pour alimenter les modèles. Le mode "Privacy Mode" existe et garantit que le code n'est pas stocké ni utilisé pour l'entraînement. Pour les projets sensibles (code propriétaire, données médicales, finance), c'est un point à vérifier avec l'équipe sécurité.

La dépendance au modèle choisi

La qualité des suggestions varie selon le modèle. Claude Sonnet excelle sur le code TypeScript et les architectures complexes. GPT-4o est plus rapide mais parfois plus générique. Gemini gère mieux les très longs contextes. Il faut tester et choisir — il n'y a pas de modèle universellement meilleur.

Verdict

Cursor mérite sa position d'IDE IA le plus utilisé en 2026. L'indexation du codebase, le mode Agent et les Cursor Rules forment un trio qui n'a pas d'équivalent chez la concurrence.

Pour un développeur individuel, le plan Pro à ~18 EUR/mois est rentabilisé en quelques heures de travail. La migration depuis VS Code est indolore et réversible.

Les limites sont réelles : performances sur les gros repos, privacy par défaut dans le cloud, dépendance à la qualité du modèle. Mais pour un projet de taille moyenne avec des conventions claires, Cursor transforme le workflow de développement.

Pour comparer avec les alternatives : Cursor vs Windsurf pour les IDE IA, GitHub Copilot pour l'assistant code le plus accessible, Claude Code pour l'agent CLI autonome.