Cursor est rapidement devenu incontournable pour le développement assisté par l'IA. J'ai récemment beaucoup utilisé cet IDE pour le développement de fonctionnalités pour Human Coders (en Ruby on Rails).
Voici mes conseils pratiques pour utiliser Cursor au mieux, bien choisir vos modèles, gérer efficacement le contexte et améliorer votre productivité.

1) Choisir le bon modèle d’IA 🧠

Le choix du modèle influence la qualité, la vitesse et le coût. Plutôt que mémoriser une liste (qui change souvent), je te conseille de raisonner en deux familles :

  • Thinking : prend des initiatives, explore, planifie, arbitre.
  • Non-Thinking : exécute une consigne claire, plus prévisible et rapide.

👉 En cas de doute, utilise Auto-select.
👉 Garde 2–3 modèles “favoris” selon tes tâches (ex : patch rapide, refactor, debug profond).

📌 Modèles de raisonnement (Thinking Models)

Caractéristiques : prennent des initiatives, explorent activement, proposent plusieurs options, planifient.
Quand les utiliser : exploration de codebase, refactoring ambitieux, problèmes complexes, bug difficile, architecture/migration.

Exemples :

  • Claude 4.5 Opus
  • Gemini 3 Pro
  • o3

📌 Modèles réactifs (Non-Thinking Models)

Caractéristiques : plus directs et prévisibles, meilleurs pour “faire exactement ce qui est demandé”.
Quand les utiliser : tâches simples, modifications précises, itérations rapides, cleanups/tests/doc.

Exemples :

  • Claude 4.5 Sonnet
  • GPT-4.1
  • Gemini 3 Flash
  • Composer 1

📌 Guide rapide de sélection

Tâche Modèles recommandés
Changements précis Claude 4.5 Sonnet, GPT-4.1, Composer 1
Exploration du code Gemini 3 Pro, Claude 4.5 Opus, o3
Planification Claude 4.5 Opus, Gemini 3 Pro
Debugging complexe o3, Claude 4.5 Opus

✅ Règle simple :

  • si tu sais exactement quoi changer → Non-Thinking
  • si tu dois comprendre / explorer / arbitrer → Thinking

👉 En cas de doute, utilisez l'option Auto-select.
👉 Créez des Modes Personnalisés pour retrouver rapidement vos combinaisons préférées (guide officiel).

2) Utilisez les @-mentions pour optimiser le contexte 🧩

Cursor est meilleur quand tu lui donnes le bon contexte, au bon endroit. Plutôt que coller de gros blocs, privilégie les @-mentions :

  • @Files : injecte un ou plusieurs fichiers précis
  • @Folders : donne un dossier (utile pour une feature transversale)
  • @Code : pointe un symbole / un extrait (fonction, classe, bloc)
  • @Docs : ajoute de la documentation (quand dispo / indexée)

✅ Objectif : réduire le bruit, augmenter la pertinence, et éviter de “noyer” le modèle.

3) Standardisez votre projet avec les Cursor Rules 📏

Les Cursor Rules te permettent d’encoder des consignes directement dans le repo, pour que Cursor les suive automatiquement (style, conventions, libs, patterns…).

Où mettre les Rules ?

  • Utilise le dossier : .cursor/rules/
  • Tu peux créer des rules en .md ou .mdc
  • Recommandation : .mdc quand tu veux du contrôle fin (via frontmatter + globs pour cibler certains fichiers)
Note : le fichier .cursorrules à la racine est considéré comme legacy dans beaucoup de setups. Préfère .cursor/rules/*.

Pourquoi utiliser les Rules ?

✅ Assurer la cohérence (ex : Tailwind, Zod, conventions Rails)
✅ Automatiser les bonnes pratiques (REST, tests, accessibilité)
✅ Gagner du temps (moins de répétitions dans les prompts)
✅ Partager avec l’équipe (versionné via Git)

Exemples concrets de règles

  • Toujours utiliser Tailwind CSS, éviter le CSS inline.
  • Utiliser systématiquement Zod pour valider les entrées serveur.
  • Respecter strictement les principes REST pour les API.
  • Ajouter un commentaire clair sur chaque fonction publique.

Créer rapidement tes Rules

  • 📄 Manuellement : ajoute un fichier dans .cursor/rules/
  • ⚙️ Via l’UI : Settings → Rules → Project Rules (selon versions)

👉 Les Rules sont versionnées dans le projet et partagées avec l’équipe via Git.

📚 Documentation Cursor Rules

4) Bien choisir le mode de l’agent 🎛️

Cursor propose plusieurs modes : choisis-les selon le niveau d’autonomie que tu veux donner à l’agent.

Mode Usage typique Comportement
Agent Tâches complexes, refactoring, multi-fichiers Explore, propose, modifie le code (et peut utiliser des outils)
Ask Apprentissage, questions, audit Analyse / explique sans modifier le code
Manual Éditions très ciblées Exécute des changements explicites et localisés
Custom Workflow perso Tu définis les capacités et les consignes

📌 Exemples de modes personnalisés utiles :

Exemple Outils utilisés Instructions typiques
Apprendre Tous les outils de recherche Explique les concepts en détail, pose des questions.
Refactorer Édition & Réapplication Améliore la structure sans nouvelles fonctionnalités.
Planifier Codebase, Lecture fichiers, Terminal Génère des plans détaillés (ex : plan.md).
Débug Recherche, Terminal, Édition & Réapplication Analyse approfondie avant correction.

Comment changer de mode rapidement :

  • Utilisez le menu déroulant dans l’Agent.
  • Raccourci clavier ⌘. pour basculer rapidement.

5) Checkpoint : revenir facilement en arrière

Cursor sauvegarde automatiquement des états intermédiaires (« Checkpoints ») vous permettant d’annuler facilement les modifications effectuées par l’Agent :

  • Cliquez sur « Restaurer Checkpoint » à côté du message précédent.
  • Cliquez sur le bouton « + » au survol d'un message passé.
⚠️ Les checkpoints ne remplacent pas Git, ils sont temporaires et stockés localement.

6) Dupliquer un Chat : explorer des pistes en parallèle

Vous pouvez explorer facilement différentes approches sans perdre votre historique actuel :

  • Cliquez sur les « trois points » (⋯) d'un message.
  • Choisissez « Dupliquer le Chat » pour créer une branche alternative.

Chaque branche conserve son propre historique.

7) Générer des diagrammes d’architecture avec Mermaid 📐

Les diagrammes facilitent la compréhension et la communication :

  • Cursor utilise peut utiliser Mermaid (flowchart, sequenceDiagram, classDiagram...) pour illustrer le flux de données ou la logique de vos systèmes.
  • Exemple de prompt :
    • « Montre-moi comment les requêtes passent du contrôleur à la base de données. »
    • « Retrace le parcours de cette variable. »

👉 Installez une extension Mermaid (VSCode) pour visualiser directement vos diagrammes.

👉 Tutoriel pour diagrammes

8) Connecter Cursor à votre navigateur web 🌐

Grâce à Browser Tools MCP, étendez Cursor pour capturer des informations du navigateur comme les logs et requêtes réseau :

  • Configurez Browser Tools MCP (installation rapide).
  • Débuguez plus rapidement en obtenant directement ces infos dans Cursor.

9) Gagnez du temps avec la file d’attente de messages 📥

L’Agent gère efficacement les tâches complexes grâce à la mise en file d’attente de messages :

  • Ajoutez une tâche : Tapez-la pendant que Cursor travaille puis validez avec Entrée.
  • Réorganisez vos tâches : Faites glisser les tâches pour changer leur ordre.
  • Forcer une tâche immédiate : Utilisez Alt+Entrée pour exécuter immédiatement.

👉 Vous visualisez clairement l'avancement et gardez facilement le contrôle.

👉 Documentation complète sur la gestion des tâches

10) Passez au Max Mode pour gérer les gros contextes 🧠📚

Par défaut, Cursor utilise déjà une grande fenêtre de contexte. Max Mode active la fenêtre de contexte maximale disponible pour les modèles qui le supportent.

Pourquoi activer Max Mode ?

  • Naviguer dans des projets volumineux / monorepos
  • Analyser des fichiers longs ou des systèmes complexes
  • Faire des refactorings qui touchent beaucoup de surface

Comment activer Max Mode ?

Dans la conversation :

  • ouvre les paramètres (icône ⚙️)
  • active Max Mode
Attention : Max Mode peut être plus lent et plus coûteux. Active-le uniquement quand tu as vraiment besoin d’un contexte élargi.
Tip : vérifie la fenêtre de contexte par modèle dans la page Models (ça varie selon le modèle).

Pour info, si vous voulez aller plus loin dans la maîtrise de Cursor, Human Coders propose une formation sur le sujet !

Formation Cursor