Les meilleures pratiques pour utiliser Cursor efficacement 🚀 (Tutoriel complet)

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é et le coût des résultats. Voici comment sélectionner :

📌 Modèles de raisonnement (Thinking Models)

• Caractéristiques : prennent des initiatives, explorent activement et proposent des solutions autonomes.
• Quand les utiliser : exploration, refactoring ambitieux, problèmes complexes.
• Exemples : claude-4-opus, gemini-2.5-pro, o3 (plus lent, mais très puissant).

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

• Caractéristiques : attendent des instructions explicites, prévisibles, faciles à piloter.
• Quand les utiliser : tâches simples ou modifications précises.
• Exemples : claude-4-sonnet, gpt-4.1.

📌 Guide rapide de sélection :

👉 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 @-symboles optimiser le contexte 🧩

Cursor est plus efficace avec un contexte précis : Privilégiez les @-symboles

👉 Utilisez @file, @folder, @code... pour cibler précisément le contexte pertinent (voir tous les @-symboles).

3) Standardisez votre projet avec les Cursor Rules

Les Cursor Rules vous permettent d'intégrer directement dans votre projet des consignes claires que Cursor respectera automatiquement. Elles sont stockées dans le fichier .cursor/rules.

Pourquoi utiliser les Rules ?

• ✅ Assurer la cohérence (ex : utiliser Tailwind, validation avec Zod).
• ✅ Automatiser les bonnes pratiques (REST, commentaires systématiques).
• ✅ Gagner du temps en évitant de répéter vos préférences.

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 vos Rules :

• 📄 Manuellement : Éditez simplement le fichier .cursor/rules.
• ⚡️ Automatiquement : Tapez /Generate Cursor Rules après un échange pertinent pour extraire automatiquement les consignes utiles.

👉 Les Cursor Rules sont versionnées dans votre projet et partagées avec l'équipe via Git.

📚 Documentation Cursor Rules

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

L’Agent Cursor possède différents modes adaptés à chaque besoin :

Vous pouvez également faire vos propres modes personnalisés.

📌 Exemples de modes personnalisés utiles :

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

Cursor utilise par défaut une fenêtre de contexte de 128k tokens, soit environ 10 000 lignes de code. Mais pour travailler avec une base de code très volumineuse ou un contexte particulièrement riche (projets complexes, analyses détaillées…), vous pouvez activer le Max Mode.

Pourquoi activer le Max Mode ?

• Fenêtre de contexte maximale : jusqu’à 1M de tokens avec Gemini 2.5 Pro et GPT 4.1.
• Lecture de fichiers améliorée : L'outil de base Read File lit jusqu'à 750 lignes en Max Mode (contre 250 lignes en mode standard).
• Idéal pour :
  • Naviguer dans des projets volumineux ou des monorepos.
  • Analyser en détail des fichiers longs ou complexes.
  • Réaliser des refactorings sur de larges systèmes.

Comment activer le Max Mode ?

• Cliquez sur l’icône ⚙️ (paramètres) de votre conversation.
• Activez l’option Max Mode.

👉 Attention : Le Max Mode consomme davantage de ressources, il est donc légèrement plus lent et coûteux à l'utilisation. Activez-le uniquement quand le contexte élargi est réellement nécessaire !