> ## Content Index
> Fetch the complete content index at: https://www.camilleroux.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Cursor AI : le guide complet en français [2026]
- URL: https://www.camilleroux.com/les-meilleures-pratiques-pour-utiliser-cursor-efficacement-guide-complet/
- Published: 2025-07-15T08:55:48.000Z
- Updated: 2026-04-02T16:38:51.000Z
- Description: Tutoriel Cursor AI : comment bien l'utiliser, choisir les modèles, gérer le contexte et booster votre productivité. Guide pratique avec exemples concrets.
- Author: Camille Roux

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**

![](https://www.camilleroux.com/content/images/2026/01/Capture-d---e--cran-2026-01-16-a---02.35.07.png)

👉 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](https://docs.cursor.com/guides/selecting-models?ref=camilleroux.com)).

## 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](https://docs.cursor.com/context/rules?ref=camilleroux.com)

## 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](https://docs.cursor.com/guides/tutorials/architectural-diagrams?ref=camilleroux.com)

## 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](https://docs.cursor.com/guides/tutorials/web-development?ref=camilleroux.com)).
- Débuguez plus rapidement en obtenant directement ces infos dans Cursor.

![](https://www.camilleroux.com/content/images/2025/07/image-3.png)

## 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](https://docs.cursor.com/agent/planning?ref=camilleroux.com)

## 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 ](https://www.humancoders.com/formations/cursor?ref=camilleroux.com)