FRENES

Guide · Débutant · 11 min

Cursor, guide de référence : l'éditeur de code avec IA, modes, règles, prix et limites

Cursor associe édition de code et agents IA. Découvrez ses modes, ses règles, ses tarifs et une méthode pour modifier vos projets en gardant le contrôle.

Par ·

Un ordinateur portable ouvert sur un éditeur de code, avec un carnet de vérification et une tasse orange sur le bureau

Cursor réunit un éditeur de code et des agents IA capables d’explorer un projet, de préparer un plan et de modifier des fichiers. Pour l’utiliser correctement, il faut choisir le mode adapté, fournir un contexte précis, contrôler les autorisations et vérifier les changements. Son coût dépend de l’abonnement, des modèles employés et de la consommation supplémentaire.

Ce que Cursor fait, et ce qui reste votre responsabilité

Cursor permet de passer d’une question sur le code à une intervention dans le projet. Cette continuité est pratique, mais elle rapproche deux activités différentes : recevoir une explication et autoriser un programme à agir.

Un agent de code peut rechercher les fichiers concernés, proposer une correction, l’appliquer puis utiliser le terminal pour vérifier le résultat. Vous devez encore juger si la modification répond au besoin, respecte les contraintes du projet et peut être intégrée.

Prenons un exemple fictif : un formulaire accepte une adresse invalide. La demande utile précise le comportement attendu, les fichiers probablement concernés et la manière de vérifier la correction. Une demande générale d’amélioration du formulaire laisse davantage de décisions au modèle, avec un risque d’élargissement du périmètre.

Le résultat à examiner est donc un ensemble : changements dans les fichiers, commandes exécutées, tests et explication des limites. Un message annonçant que la tâche est terminée ne prouve pas que toutes les vérifications nécessaires ont été faites.

Notre article sur le fonctionnement des agents de code explique cette boucle d’actions. Ce guide présente une méthode durable pour travailler avec Cursor ; le catalogue des outils IA permet de replacer cet usage parmi les autres familles d’outils.

Choisir entre exploration, planification et modification

Commencez par décider ce que vous autorisez pour la tâche. Comprendre une architecture, choisir une approche et modifier une application ne demandent pas le même niveau d’autonomie.

CritèreAskPlanAgent
ObjectifComprendre le codePréparer une interventionRéaliser une modification
Travail attenduRecherche et explicationExploration et plan révisableÉdition et utilisation d’outils
Moment adaptéDécouverte d’un projetBesoin ambigu ou transversalPérimètre suffisamment défini
Résultat à contrôlerRéférences et raisonnementHypothèses et étapesDifférences entre fichiers et vérifications

La documentation officielle décrit Plan Mode comme une phase de recherche et de clarification avant l’écriture du code. Le plan peut être relu et corrigé avant de lancer sa réalisation. C’est utile lorsqu’une demande implique plusieurs approches possibles.

Pour une correction localisée, un plan développé n’apporte pas toujours beaucoup. Vous pouvez directement demander une intervention limitée, avec les critères d’acceptation. À l’inverse, une migration ou un changement d’authentification mérite une revue de l’approche avant toute modification.

Évitez de confondre un mode et une garantie de sécurité. Le mode organise le travail ; les permissions et les accès disponibles déterminent ce que l’environnement autorise effectivement. Avant une intervention sensible, examinez ces deux niveaux.

Prérequis : préparer un projet récupérable

Pour commencer, prévoyez un compte Cursor, une connexion réseau et un projet que vous êtes autorisé à transmettre aux services utilisés. Installez aussi l’environnement nécessaire à ce projet : l’éditeur ne remplace pas son interpréteur, son compilateur ou ses dépendances.

Choisissez d’abord un dépôt d’apprentissage ou une copie de travail sans données sensibles. Vous devez savoir comment lancer l’application et reconnaître son comportement normal. Sans ce point de comparaison, une modification peut sembler correcte tout en cassant un autre parcours.

Avant de demander quoi que ce soit à l’agent :

  • sauvegardez le travail existant et identifiez les changements déjà présents ;
  • préparez une branche dédiée si vous utilisez Git ;
  • repérez les instructions de développement et les tests disponibles ;
  • retirez les secrets et les accès de production inutiles ;
  • définissez le résultat attendu et les opérations à faire approuver.

Ne demandez pas à l’agent de nettoyer indistinctement un dossier contenant du travail non enregistré. Il peut difficilement distinguer votre modification volontaire d’un fichier temporaire sans explication.

Pour un débutant, le premier objectif est modeste : obtenir une correction compréhensible et réversible. Le guide bien travailler avec un agent de code approfondit le découpage des tâches et la relecture.

Installer Cursor et préparer la première session

1. Installer l’application de bureau

Utilisez la page officielle de téléchargement et choisissez le paquet correspondant à votre système et à l’architecture de votre machine. Cursor propose une application pour macOS, Windows et Linux, selon la page consultée le 24 octobre 2026.

Ouvrez ensuite un dossier de projet précis. Évitez de donner comme espace de travail votre dossier personnel complet ou un répertoire réunissant plusieurs clients. Un périmètre clair facilite la recherche et réduit l’exposition de fichiers sans rapport avec la tâche.

Connectez votre compte, puis examinez les réglages de confidentialité, le modèle sélectionné et les options d’exécution. Pour une première session, conservez une validation explicite des opérations que vous ne comprenez pas encore.

2. Installer la CLI seulement si vous en avez besoin

La CLI est une interface supplémentaire pour travailler depuis le terminal. Elle n’est pas nécessaire pour suivre la méthode dans l’application de bureau.

Les commandes suivantes sont celles de la documentation officielle d’installation de Cursor CLI, vérifiée le 24 octobre 2026. Sous macOS, Linux ou Windows avec WSL :

curl https://cursor.com/install -fsS | bash

Sous Windows natif, dans PowerShell :

irm 'https://cursor.com/install?win32=true' | iex

Ces commandes téléchargent puis exécutent un script. Dans un environnement professionnel administré, suivez la procédure de déploiement autorisée.

Vérifiez ensuite l’installation :

agent --version

Démarrez une session interactive :

agent

La commande de mise à jour documentée est :

agent update

3. Obtenir un état des lieux avant de modifier

Demandez d’abord une explication du projet : point d’entrée, organisation des dossiers, procédure de lancement et emplacement des tests. Exigez des chemins de fichiers pour pouvoir vérifier les réponses.

Si l’agent ne trouve pas une information, demandez-lui de le signaler. Une commande de test supposée peut produire un résultat sans rapport avec la procédure réellement utilisée par le projet.

Réaliser une première modification contrôlée

4. Formuler une demande vérifiable

Une bonne demande contient le problème, le résultat attendu, le périmètre et les contraintes. Voici un exemple de consigne à adapter :

Le formulaire accepte une adresse vide.
Repère la validation existante et explique la cause.
Propose une correction limitée à ce comportement.
N'ajoute pas de dépendance.
Ajoute ou adapte un test pertinent.
Demande mon accord avant toute opération sur une base de données.

Cette consigne est un exemple éditorial, pas une commande intégrée à Cursor. Remplacez chaque contrainte par une exigence réelle du projet.

Évitez d’additionner une correction, une refonte graphique et une réorganisation technique dans la même demande. Des changements séparés sont plus faciles à examiner et à abandonner indépendamment.

5. Relire le plan et les autorisations

Si vous utilisez Plan, contrôlez les fichiers annoncés, les hypothèses et les tests prévus. Faites préciser les zones inconnues avant de lancer la réalisation.

Lorsqu’une commande demande une autorisation, lisez son contenu et son répertoire d’exécution. Une commande qui paraît habituelle peut agir sur un service distant ou appeler un script dont les effets ne sont pas visibles dans son nom.

6. Vérifier le résultat avant l’intégration

Relisez les différences entre fichiers. Recherchez les changements hors périmètre, les suppressions, les nouvelles dépendances et les modifications de configuration.

Exécutez les vérifications pertinentes du projet, puis reproduisez le parcours utilisateur concerné. Demandez enfin un compte rendu distinguant ce qui a été exécuté, ce qui a réussi et ce qui reste à contrôler. Conservez la décision d’intégration.

Donner du contexte sans envoyer tout le dépôt

Un agent peut travailler sur une mauvaise hypothèse s’il ne voit pas les fichiers utiles. À l’inverse, accumuler des documents sans rapport rend la demande plus difficile à suivre.

Pour chaque tâche, fournissez le comportement observé, le résultat attendu et les références pertinentes : fichier, message d’erreur, test existant ou consigne d’architecture. Préférez un exemple reproductible à un long récit approximatif.

La fenêtre de contexte représente la quantité d’informations qu’un modèle peut traiter pendant un échange. Elle ne garantit ni une compréhension complète du dépôt ni la prise en compte correcte de chaque détail.

Si la conversation dérive, arrêtez les modifications et reformulez le problème à partir des faits confirmés. Une nouvelle session accompagnée d’un résumé ciblé peut être plus facile à contrôler qu’une accumulation de corrections contradictoires.

Séparez aussi les données des instructions. Un ticket, un commentaire de code ou une page externe peut contenir une injection de prompt. Son contenu ne devrait pas autoriser un transfert de fichiers, une commande ou un changement de permissions.

Une consigne pratique consiste à demander à l’agent de signaler les instructions opérationnelles trouvées dans ces contenus avant de les suivre. Cela complète les restrictions techniques, sans les remplacer.

Écrire des règles utiles et maintenables

Les règles officielles de Cursor comprennent notamment les règles utilisateur, les règles de projet, les règles d’équipe et le fichier AGENTS.md. Les règles de projet résident dans .cursor/rules avec l’extension .mdc.

Une règle peut être toujours appliquée, liée à certains fichiers, sélectionnée selon sa pertinence ou appelée manuellement. Un simple fichier Markdown placé dans .cursor/rules ne remplace pas le format attendu.

Voici un exemple éditorial de règle de projet, à adapter :

---
alwaysApply: true
---

- Lire les instructions de développement avant de modifier le projet.
- Réutiliser les conventions existantes.
- Ne pas ajouter de dépendance sans expliquer sa nécessité.
- Ne pas modifier les fichiers générés.
- Présenter les vérifications exécutées et les limites restantes.

Placez les préférences personnelles dans les règles utilisateur et les conventions collectives dans le dépôt. Réservez les règles spécialisées aux fichiers concernés.

Une règle doit exprimer une exigence vérifiable. Demander de produire du code propre laisse beaucoup d’interprétation ; demander de conserver une interface publique donne un critère concret.

Relisez les règles avec le code : une procédure périmée peut conduire l’agent à répéter une erreur. Évitez aussi les doublons contradictoires entre plusieurs fichiers d’instructions. Les règles restent des consignes au modèle, pas des barrières de sécurité.

Prix : distinguer abonnement et consommation

Au 24 octobre 2026, la documentation tarifaire officielle présente les offres suivantes en dollars, hors taxes. Les prix et les conditions doivent être revérifiés avant souscription.

Offre actuellePrix mensuelUsage inclusModèles tiers
Free0 $LimitéIndisponibles
Plus8 $BaseIndisponibles
Premium30 $Quatre fois PlusFacturés séparément
Super100 $Quinze fois PlusFacturés séparément
Ultra200 $Cinquante fois PlusFacturés séparément

Les offres actuelles relèvent de The X Subscription. Leur réserve d’usage pour les modèles Cursor est hebdomadaire et partagée entre les services concernés. Les modèles tiers accessibles à partir de Premium consomment du crédit prépayé dès leur utilisation.

Les anciens abonnements, notamment Pro et Pro+, conservent des modalités distinctes. Ne transposez donc pas une explication ancienne à une offre actuelle.

Pour budgéter, relevez votre formule exacte, le modèle utilisé, le crédit disponible et les limites de dépenses supplémentaires. Vérifiez également la recharge automatique.

Évaluez ensuite le coût sur des tâches représentatives : correction courte, exploration et modification transversale. Incluez le temps humain de relecture et les reprises nécessaires.

Le bon indicateur est le coût d’une tâche acceptée. Une réponse peu coûteuse qui exige une longue correction peut être moins intéressante qu’une intervention plus chère mais directement vérifiable.

Confidentialité, secrets et outils MCP

Selon la page de sécurité de Cursor, mise à jour le 25 août 2026, Privacy Mode empêche l’utilisation de vos données pour l’entraînement. L’éditeur décrit également des contrôles et des engagements avec ses fournisseurs de modèles. Cela ne signifie pas que le traitement reste sur votre ordinateur.

Avant d’ouvrir un dépôt confidentiel, vérifiez les engagements applicables à votre organisation, les services sollicités et les données accessibles. N’ajoutez pas de secrets à une conversation pour contourner une difficulté de configuration.

Le fichier .cursorignore limite l’accès à certains fichiers par des fonctionnalités de Cursor. La documentation des fichiers ignorés précise toutefois que les outils terminal et MCP peuvent accéder à du contenu concerné. Ce fichier ne constitue donc pas une frontière d’isolation complète.

Cursor peut connecter des outils externes via la configuration MCP officielle. Chaque connexion ajoute des capacités et des accès à examiner : lecture de documents, interrogation d’un service ou modification de données selon le serveur.

Pour commencer, branchez uniquement une source nécessaire et privilégiez la lecture seule. Vérifiez l’origine du serveur, ses permissions et la manière de révoquer ses accès.

Le tutoriel installer un serveur MCP dans Cursor détaille cette opération. Pour les environnements sensibles, le guide sécuriser un agent IA aide à organiser permissions, isolation et validation humaine.

Problèmes fréquents

L’agent modifie trop de fichiers. Arrêtez l’intervention et examinez les différences avant de poursuivre. Reformulez le périmètre et séparez la correction des améliorations facultatives. N’acceptez pas une réécriture simplement parce qu’elle est déjà produite.

La réponse décrit un fichier inexistant. Demandez le chemin exact et la vérification de son existence. Vérifiez aussi que vous avez ouvert le bon dossier. Une explication plausible peut reposer sur une convention générale plutôt que sur votre projet.

Une règle semble ignorée. Contrôlez son extension, sa portée et son mode d’application. Faites ensuite vérifier une exigence concrète. La présence d’un fichier ne prouve pas que toutes ses consignes ont été suivies.

La commande agent reste introuvable. Vérifiez que vous avez installé la CLI, puis rouvrez le terminal. Contrôlez le chemin d’installation et le PATH selon la documentation officielle. L’application de bureau et la commande du terminal sont deux installations à distinguer.

Les tests réussissent mais le problème persiste. Vérifiez que le test reproduit réellement le défaut initial. Un test ajouté après la correction peut confirmer seulement le comportement du nouveau code. Rejouez aussi le scénario utilisateur.

La consommation surprend. Consultez le modèle choisi, les crédits supplémentaires et l’activité des services partageant votre réserve. Une demande en langage naturel ne correspond pas nécessairement à un unique appel de modèle.

Limites et critères de choix

Cursor convient si vous souhaitez travailler dans un éditeur, suivre les modifications et alterner explications et interventions. Il faut cependant pouvoir consacrer du temps à la lecture du code et aux vérifications.

Pour une personne qui découvre entièrement le développement, le risque est d’accepter un projet dont elle ne comprend plus les dépendances ou le déploiement. Gardez des objectifs limités et demandez des explications sur chaque décision structurante.

Pour une équipe, évaluez aussi la gestion des comptes, les conventions partagées, la confidentialité et la procédure de revue. Une démonstration réussie sur un petit exemple ne suffit pas à décider d’un déploiement collectif.

Le comparatif Cursor et Claude Code présente les différences d’approche. Comparez surtout les outils sur le même dépôt et les mêmes critères : correction fonctionnelle, changements inutiles, vérifications, consommation et temps de relecture.

Checklist avant d’intégrer une modification

  • Le projet ouvert et les données accessibles correspondent au périmètre autorisé.
  • Le travail précédent est sauvegardé et identifiable.
  • Le mode choisi correspond à l’objectif de la session.
  • La demande contient un comportement attendu vérifiable.
  • Les règles utiles sont présentes et cohérentes.
  • Les commandes et accès sensibles ont été examinés.
  • Les différences entre fichiers ont été relues.
  • Les tests pertinents et le parcours concerné ont été vérifiés.
  • Les limites restantes sont consignées.
  • La consommation et les dépenses supplémentaires sont comprises.

Pages liées

Questions fréquentes

Peut-on utiliser Cursor sans savoir programmer ?

Vous pouvez demander des explications et des modifications simples en langage naturel. Pour publier une application, il faut néanmoins pouvoir vérifier son fonctionnement, ses dépendances et ses accès aux données. Un résultat qui s'affiche correctement ne suffit pas à valider sa sécurité.

L'installation de Cursor CLI est-elle obligatoire ?

Non, l'application de bureau permet de travailler sans installer séparément la CLI. Celle-ci sert à retrouver un agent dans le terminal ou à préparer des automatisations. Commencez par une seule interface pour comprendre les autorisations et la consommation.

Un abonnement Cursor comprend-il tous les modèles ?

Non. Les offres actuelles distinguent un usage inclus pour les modèles Cursor et une consommation supplémentaire pour les modèles tiers accessibles avec certaines formules. Les anciens abonnements conservent un fonctionnement distinct : vérifiez le nom exact de votre contrat.

Les règles Cursor empêchent-elles une commande dangereuse ?

Une règle donne une instruction au modèle ; elle ne constitue pas une interdiction technique. La protection repose aussi sur les permissions, l'isolation de l'environnement et les validations. Une consigne de prudence ne remplace donc pas la restriction des droits.

Peut-on confier un dépôt confidentiel à Cursor ?

Cela dépend des engagements de votre organisation et de la configuration retenue. Examinez les traitements de données, les fournisseurs impliqués et les outils connectés avant d'ouvrir le dépôt. Privacy Mode doit être évalué avec ces éléments, sans l'assimiler à une exécution entièrement locale.

Autres guides

Neutralité. Aucun lien d'affiliation. Aucun éditeur ne paie pour être évalué, noté ou classé. Les évaluations sont dirigées par François Chollet, neutres et factuelles, et chaque donnée est datée et sourcée. Comment nous notons