Guide complet du mode Agent Cursor : automatisez votre programmation en 3 étapes (2026)

Mise à jour du 2026-06-08 : revérifié avec la doc officielle de Cursor — ouvrez Agent avec ⌘/Ctrl + I et basculez entre Agent / Ask / Plan / Debug avec Shift + Tab ; l’ancien « mode Yolo » s’appelle désormais « Auto-run » (dans les paramètres Agent, avec une liste d’autorisation de commandes en langage naturel) ; et la liste des modèles reflète maintenant les versions actuelles de Claude / GPT / Gemini ainsi que le mode Auto.

Il y a quelques jours, je corrigeais un bug et j’ai enchaîné une dizaine de tours de dialogue avec l’IA dans Cursor Chat. L’IA disait « vous pouvez modifier ainsi », je copiais le code, collais, exécutais, erreur ; je redemandais à l’IA, nouvelle proposition, copier-coller… et ainsi de suite.

Plus tard, en lançant le projet, une erreur indiquait une dépendance manquante. L’IA me disait « vous devez exécuter npm install xxx », et je devais basculer vers le terminal pour taper la commande manuellement. À ce moment-là, je me suis demandé : si l’IA sait quoi installer, pourquoi ne peut-elle pas le faire directement ?

Jusqu’à ce que je découvre le mode Agent de Cursor. Tout a changé. Agent ne se contente plus de « donner des conseils » : il exécute le travail — création de fichiers, exécution de commandes, correction de bugs. Honnêtement, la première fois, j’ai été bluffé : la programmation assistée par IA peut vraiment être aussi « automatisée ».

Cet article vous apprend à activer le mode Agent en 3 étapes, puis vous guide avec 5 cas pratiques. Vous verrez que ces tâches de développement répétitives peuvent vraiment être confiées à l’IA.

Qu’est-ce que le mode Agent ?

Une analogie simple

Si l’on compare les différents modes de Cursor à des membres d’équipe :

• Mode Chat : un conseiller — vous posez des questions, il donne des recommandations, mais l’exécution reste à votre charge
• Mode Agent : un assistant — vous décrivez la tâche, il la réalise, y compris créer des fichiers, exécuter des commandes et corriger les erreurs

C’est pourquoi Cursor qualifie officiellement Agent de « mode le plus proche de la conduite autonome » — il travaille réellement à votre place.

Le mode Agent est sorti le 24 novembre 2024 avec Cursor 0.43. À ce jour (janvier 2026), il est devenu l’outil principal de nombreux développeurs.

Agent vs Chat : quelle différence ?

Voici un tableau comparatif :

Exemple concret :

Mode Chat :

• Vous : « Crée-moi un composant de connexion »
• IA : « D’accord, voici le code… (un long bloc de code) »
• Vous : (copier-coller dans un nouveau fichier)

Mode Agent :

• Vous : « Crée-moi un composant de connexion »
• IA : (crée automatiquement Login.tsx, écrit le code, ajoute les imports nécessaires, installe les dépendances manquantes)
• Vous : (rien à faire, c’est prêt à l’emploi)

La différence est flagrante.

Les 4 capacités clés d’Agent

D’après mon expérience, Agent possède principalement ces « super-pouvoirs » :

1. Recherche automatique dans la base de code

• Recherche sémantique pour trouver rapidement le code pertinent
• Pas besoin de dire « regarde src/utils/auth.ts », il trouve tout seul

2. Création et modification automatique de plusieurs fichiers

• Peut modifier plusieurs fichiers simultanément (composant, route, API pour une nouvelle fonctionnalité)
• Style de code cohérent, imports complétés automatiquement

3. Exécution automatique de commandes terminal

• Installation de dépendances : npm install
• Démarrage du serveur : npm run dev
• Exécution des tests : npm test
• Avec le mode Yolo, exécution directe sans confirmation

4. Lecture et correction automatique des erreurs

• Lit les messages d’erreur du terminal
• Analyse la cause (dépendance manquante ? erreur de code ? problème de configuration ?)
• Corrige automatiquement, retente en cas d’échec

Activer le mode Agent en 3 étapes

Méthode 1 : raccourci clavier (le plus rapide)

C’est ma méthode habituelle, activation en 1 seconde :

• Ouvrir le panneau Agent : Mac ⌘ + I, Windows/Linux Ctrl + I
• Changer de mode : Shift + Tab fait défiler Agent / Ask / Plan / Debug

Le panneau Agent s’ouvre. (Les anciennes versions répondaient aussi à ⌘/Ctrl + . ; les versions récentes standardisent sur ⌘/Ctrl + I.)

Méthode 2 : basculement via l’interface (recommandé pour les débutants)

Pour une première utilisation, préférez l’interface pour mieux visualiser :

Vultr - Serveur cloud NVMe haute performance, 32 emplacements mondiaux, déploiement Docker en un clic

Voir les tarifs →Pub

1. Ouvrez Cursor, cliquez sur le panneau Composer à droite (ou raccourci ⌘/Ctrl + I)
2. En haut du panneau, le sélecteur de mode apparaît
3. Cliquez et sélectionnez le mode Agent
4. Le placeholder de la zone de saisie devient quelque chose comme « Tell me what to build… »

Agent est activé.

Vérifier que l’activation a réussi

Comment savoir qu’Agent est lancé ? Repérez ces signes :

• ✅ L’interface affiche « Agent mode » ou un libellé similaire
• ✅ Le placeholder diffère (plus « posez-moi une question de code », mais « dites-moi quoi construire »)
• ✅ La barre d’outils propose des options supplémentaires (comme le commutateur Yolo)

Si ces éléments n’apparaissent pas, recommencez les étapes ci-dessus.

Configuration recommandée (optionnelle mais utile)

Une fois Agent activé, je recommande de configurer ces paramètres :

1. Activer Auto-run (ex-mode Yolo)

• Emplacement : paramètres Agent (les versions récentes ont renommé « Yolo » en « Auto-run »)
• Effet : exécute les commandes terminal sans confirmation à chaque fois ; vous pouvez décrire en langage naturel quelles commandes (tests, builds, lint) peuvent s’exécuter automatiquement
• À noter : seules les commandes terminal sont auto-acceptées — les modifications de fichiers affichent toujours un diff à confirmer

Franchement, je garde généralement Auto-run activé, sauf sur des projets de production critiques.

2. Spécifique Windows : passer à Git Bash

• Pourquoi : Agent génère des commandes Linux par défaut, le CMD natif Windows peut ne pas les supporter
• Comment : Paramètres → Terminal → Profil par défaut → Git Bash

3. Choisir le modèle IA adapté

• Par défaut au quotidien : Auto (Cursor choisit le meilleur modèle selon la tâche)
• Travail multi-fichiers / refactorisations complexes : Claude Sonnet 4.6 ou Claude Opus 4.8
• Raisonnement / planification : GPT-5.5
• Très grandes bases de code : Gemini 3.1 Pro (plus grand contexte)

Les modèles disponibles évoluent avec les mises à jour de Cursor — le menu déroulant en haut du panneau de chat fait foi.

5 cas pratiques : ce qu’Agent peut réellement faire

Assez de théorie. Voici 5 scénarios réels pour voir Agent en action.

Cas 1 : créer un projet Todo List from scratch (niveau débutant)

Scénario : vous voulez rapidement une application React Todo List simple, sans configurer le projet from scratch.

Approche traditionnelle :

1. Créer le projet : npx create-react-app my-todo
2. Installer TypeScript : npm install --save-dev typescript
3. Configurer tsconfig.json
4. Créer le dossier des composants
5. Écrire TodoList.tsx, TodoItem.tsx…
6. (au moins une demi-heure)

Approche Agent :

Ouvrez Agent et saisissez :

Crée-moi un projet Todo List en React + TypeScript

Allez vous servir un verre d’eau. Au retour, Agent a déjà :

• ✅ Créé la structure de dossiers du projet
• ✅ Généré package.json
• ✅ Écrit App.tsx, TodoList.tsx, TodoItem.tsx
• ✅ Exécuté npm install
• ✅ Peut-être ajouté des styles de base

Tout le processus prend 3 à 5 minutes ; vous n’avez qu’à vérifier le code à la fin.

Conseil débutant : en cas d’erreur en cours de route, Agent retente automatiquement. D’après mes essais, le taux de succès est élevé.

Cas 2 : installation automatique de dépendances (scénario fréquent)

Scénario : vous clonez un projet GitHub, npm start affiche :

Error: Cannot find module 'axios'

Approche traditionnelle :

1. Lire l’erreur, constater qu’il manque axios
2. Exécuter npm install axios
3. Relancer, nouvelle erreur react-router-dom manquant
4. Réinstaller… (boucle sans fin)

Je rencontrais souvent ce cas, très agaçant.

Approche Agent :

Collez l’erreur à Agent :

Mon projet plante avec cette erreur, corrige-la :
Error: Cannot find module 'axios'

Agent va :

1. Analyser l’erreur, identifier axios manquant
2. Exécuter npm install axios
3. Vérifier d’autres dépendances manquantes
4. Continuer à corriger si d’autres erreurs apparaissent

Donnée réelle : d’après la communauté, le taux de succès d’Agent pour les problèmes de dépendances est d’environ 70 %. Au-delà de 2 échecs, demandez-lui d’ajouter des logs pour améliorer le taux.

Cas 3 : correction automatique de bugs (scénario central)

Scénario : votre code plante à l’exécution, sans identifier clairement le problème.

Par exemple :

function calculateTotal(items) {
  return items.reduce((sum, item) => sum + item.price, 0)
}

calculateTotal(null) // erreur

Approche traditionnelle :

1. Lire l’erreur : Cannot read property 'reduce' of null
2. Consulter la doc, chercher sur Stack Overflow
3. Comprendre qu’il faut gérer les valeurs nulles
4. Modifier le code manuellement

Approche Agent :

Sélectionnez le code et dites à Agent :

Ce code plante à l'exécution, corrige-le

Agent va :

1. Lire le log d’erreur
2. Identifier le problème : items peut être null
3. Modifier automatiquement :

function calculateTotal(items) {
  if (!items) return 0
  return items.reduce((sum, item) => sum + item.price, 0)
}

4. Vérifier que la correction fonctionne

Astuce avancée :

Railway - Plateforme de déploiement moderne, sans opérations complexes, en ligne en quelques minutes

Commencer →Pub

Si Agent échoue après 2 tentatives, essayez :

Ajoute d'abord des console.log aux endroits clés pour localiser le problème

Avec des logs, Agent localise le bug plus précisément ; le taux de succès monte à 70 %+.

C’est mon scénario le plus utilisé, bien plus rapide que le debug manuel.

Cas 4 : développement multi-fichiers (scénario avancé)

Scénario : votre projet a déjà une architecture de base, vous voulez ajouter une fonctionnalité « connexion utilisateur ».

Cette fonctionnalité nécessite :

• Créer le composant de connexion (Login.tsx)
• Ajouter la configuration des routes (routes.ts)
• Écrire la logique d’appel API (api.ts)
• Peut-être modifier la gestion d’état globale

Approche traditionnelle :

• Le mode Chat ne fournit le code que fichier par fichier
• Vous créez les fichiers et copiez-collez vous-même
• Les références entre fichiers restent à maintenir manuellement

Approche Agent :

Dites à Agent :

Ajoute une fonctionnalité de connexion utilisateur, incluant le composant, la configuration des routes et l'appel API

Agent va :

1. Rechercher dans le projet les fichiers pertinents (où sont les routes, où est l’API)
2. Modifier plusieurs fichiers simultanément :
   • Créer Login.tsx
   • Mettre à jour routes.ts avec la route de connexion
   • Ajouter la méthode login dans api.ts
   • Compléter les imports nécessaires
3. Conserver un style cohérent (composants fonctionnels si c’est le style du projet)

Voici la plus grande différence entre Agent et Chat : Agent travaille entre fichiers et comprend l’architecture globale du projet.

Une fois, j’ai demandé à Agent d’ajouter le mode sombre : 7 fichiers modifiés, tous corrects, au moins 1 heure gagnée.

Cas 5 : tests automatisés Playwright (scénario avancé)

Scénario : vous voulez ajouter des tests end-to-end sans écrire manuellement chaque cas de test.

La combinaison Agent + MCP :

Avec Playwright MCP (Model Context Protocol, protocole d’extension Cursor) configuré, Agent peut automatiser cette boucle :

Vous : Ajoute des tests E2E pour la fonctionnalité de connexion utilisateur

Agent :
1. Génère les cas de test basés sur Playwright
2. Exécute les tests automatiquement
3. Détecte l'échec (ex. sélecteur du bouton de connexion incorrect)
4. Corrige le code automatiquement
5. Relance les tests
6. Jusqu'à ce que les tests passent

Toute la boucle « besoin → test → correction » est automatisée.

Franchement, je découvre encore cette fonctionnalité, mais elle m’impressionne. Écrire des tests était la tâche la plus pénible ; maintenant l’IA peut s’en charger.

Astuces et précautions pour utiliser Agent

Après tant d’utilisation, voici mes bonnes pratiques et les pièges que j’ai rencontrés.

4 astuces pour mieux utiliser Agent

1. Des instructions précises, pas vagues

❌ Mauvaise instruction :

Optimise ce code

✅ Bonne instruction :

Réduis la complexité temporelle de cette fonction de O(n²) à O(n) en utilisant une table de hachage

Agent ne lit pas dans vos pensées : plus c’est précis, mieux c’est.

2. Fournir un contexte suffisant

Lors de la première utilisation, décrivez le projet :

C'est un projet React + TypeScript + Tailwind CSS, avec ESLint et Prettier.
Ajoute-moi une page de paramètres utilisateur.

Le code généré sera plus conforme à vos conventions.

3. Exploiter le mode Yolo (quand vous faites confiance)

Pour « créer un nouveau projet » ou « ajouter une fonctionnalité », activez Yolo pour exécuter toutes les commandes automatiquement.

Pour « modifier la logique métier centrale », désactivez Yolo et confirmez chaque opération.

4. Utiliser le mécanisme de points de contrôle

Agent crée un point de contrôle avant de modifier le code (similaire à la zone de staging Git). En cas d’erreur :

Alibaba Cloud - Choix n°1 des développeurs, 15 % de réduction exclusive sur Lighthouse

Obtenir -15 % →Pub

• Ctrl+Z pour annuler
• Ou dire à Agent : « la modification précédente pose problème, reviens à la version précédente »

N’ayez pas peur d’essayer, l’annulation est toujours possible.

Guide anti-pièges

Les erreurs que j’ai commises, pour vous éviter de les refaire :

❌ Ne pas donner une tâche trop complexe d’un coup

• Ex. « refactorise tout le projet », Agent sera aussi perdu
• Découpez : « d’abord le module Auth, puis… »

❌ Ne pas changer de fichier fréquemment pendant l’exécution d’Agent

• Cela peut interrompre son raisonnement
• Attendez la fin avant de consulter le code

❌ Ne pas laisser Agent modifier directement un projet important

• git commit d’abord pour sauvegarder l’état actuel
• Laisser Agent travailler sur une branche
• Fusionner après validation

✅ S’entraîner d’abord sur de petits projets

• Todo List, calculatrice, etc.
• Puis appliquer aux projets réels une fois à l’aise

✅ Exploiter « annuler » et « réessayer »

• En cas d’erreur, annulez, ce n’est pas grave
• Agent se trompe aussi, plusieurs tentatives sont normales

Pour conclure

En rédigeant cet article, j’ai repensé à mon parcours depuis ma première découverte de Cursor Agent.

Avant, 50 % de mon temps allait à la logique, 50 % aux tâches répétitives : créer des fichiers, copier-coller, installer des dépendances, modifier la config, corriger de petits bugs…

Avec Agent, ces tâches répétitives sont largement confiées à l’IA. Je me concentre sur « quoi faire », Agent s’occupe du reste.

Franchement, depuis que j’utilise Agent, difficile de revenir en arrière.

Essayez maintenant

Si vous êtes arrivé jusqu’ici, ouvrez Cursor et testez :

1. ⌘ + . (ou Ctrl + .) pour activer Agent
2. Commencez simple : « Corrige ce bug »
3. Ou créez un petit projet : « Fais-moi une Todo List simple »

Vous verrez qu’Agent peut économiser 30 à 50 % de votre temps de développement.

N’ayez pas peur d’essayer : en cas d’erreur, Ctrl+Z suffit. L’essentiel est de faire le premier pas.

À lire aussi (sur ce blog)

• Guide complet de l’indexation de la base de code Cursor
• Dépannage réseau Cursor complet
• Guide complet du niveau gratuit de Cursor

Ressources pour aller plus loin

Pour approfondir Agent :

Documentation officielle :

• Vue d’ensemble Cursor Agent
• Détails du mode Agent
• Fonctionnalités Cursor

Tutoriels pratiques :

• Guide débutant Cursor Agent
• Comment utiliser le mode Agent Cursor

Communauté chinoise :

• Cursor 效率之道：Agent 模式 + 7 大高级技巧
• 72 小时研究 Cursor Agents 的硬核干货
• Cursor 实战万字经验分享

Tutoriels vidéo :

• Cursor 0.43 全新升级 Agent 功能深度解析

Mot de la fin

Que voulez-vous faire avec Agent ? Corriger des bugs automatiquement, créer rapidement un projet, ou autre chose ?

Partagez vos idées ou expériences en commentaire. J’aimerais savoir ce que vous faites avec Agent.

Happy Coding! 🚀