Tutoriel Cursor 2026 : débuter avec Agent en 15 minutes

Ce tutoriel Cursor en français montre comment utiliser Cursor si vous l'ouvrez pour la première fois. Il suit la documentation officielle de Cursor au 1er novembre 2026, date à laquelle la version actuelle était Cursor IDE 3.27.

Un mot sur la méthode : l'équipe NxCode a rédigé ce guide à partir de ces documents et n'a pas exécuté les étapes sur une installation neuve. NxCode est notre propre produit, un créateur d'applications par IA, distinct de Cursor. Quand le guide dit ce que vous devriez voir, cela vient de la documentation : votre écran peut donc différer légèrement. Quand les pages officielles se contredisent ou laissent un vide, nous le disons.

Si vous avez lu un ancien tutoriel Cursor, attendez-vous à quelques surprises. Le mode Composer, Cmd+K Inline Edit et le mode Chat séparé ont tous disparu de la documentation actuelle.

Votre parcours de 15 minutes

Minutes	Ce que vous faites	Ce que vous obtenez
0–3	Installer, vous connecter, ouvrir un dossier d'entraînement	Cursor fonctionne sur votre ordinateur
3–5	Découvrir les deux fenêtres et quelques raccourcis	Vous savez où se trouve Agent
5–10	Lancer la première tâche avec Ask, puis Agent	Une petite page améliorée par Agent
10–12	Examiner les changements et les tester	Vous savez ce qu'Agent a réellement fait
12–14	Vous entraîner à restaurer un checkpoint	Vous savez annuler
14–15	Ajouter une règle de projet	Agent suit vos préférences

Qu'est-ce que Cursor ?

Cursor est un éditeur de code avec un agent IA intégré. Vous décrivez une tâche en langage courant, et Agent lit votre projet, modifie des fichiers et peut exécuter des commandes.

Si vous avez utilisé VS Code, l'éditeur vous semblera familier. Les raccourcis d'édition habituels sont les mêmes, et vous pouvez importer vos extensions, thèmes, réglages et raccourcis clavier.

Trois choses se passent dans Cursor au quotidien :

Agent prend en charge des tâches sur l'ensemble de votre projet.
Tab prédit ce que vous allez taper quand vous écrivez le code vous-même.
Rules indique à Agent comment traiter votre projet.

Cursor convient aux personnes qui veulent travailler avec du code, ou apprendre à le faire. Si vous voulez seulement une application finie et que lire des diffs ne vous intéresse pas, votre besoin est différent : nous en parlons plus bas, dans « Quand utiliser un autre outil ». NxCode est une option dans ce cas.

Installer Cursor et l'ouvrir pour la première fois

Étape 1 : télécharger

Rendez-vous sur cursor.com/download et choisissez votre système.

Système	Prérequis	Quoi télécharger
macOS	12 ou ultérieur	`.dmg`, pour Apple Silicon ou Intel
Windows	10 ou ultérieur	`.exe`, x64 ou ARM64, chacun avec des installateurs System et User
Linux	Debian/Ubuntu ou RHEL/Fedora	Dépôt apt ou yum en priorité, AppImage également disponible

Sur Linux, le quickstart officiel privilégie les dépôts apt et yum, car ils ajoutent une icône de bureau, les mises à jour automatiques et l'outil en ligne de commande.

Étape 2 : ouvrir Cursor et se connecter

L'ordre officiel est court : télécharger, ouvrir, se connecter, choisir un dossier, commencer par une petite tâche. Il vous faut un compte.

La connexion à Cursor peut vous envoyer vers une page xAI partagée, aux couleurs de Grok ou de xAI. C'est normal, car les nouveaux comptes commencent désormais sur The X Subscription, l'abonnement sous lequel Cursor est vendu. Se connecter ne fusionne pas les comptes et ne change pas l'offre.

Les anciens guides citent « choisir votre modèle d'IA » parmi les étapes du premier lancement. La documentation actuelle ne contient pas cette étape. Vous pouvez définir un modèle par défaut plus tard dans Cursor Settings > Models, ou en changer pendant une conversation.

La documentation ne dit pas non plus si l'on arrive d'abord dans l'Agents Window ou dans l'éditeur à la première ouverture. La section suivante montre comment passer de l'un à l'autre : les deux points de départ conviennent.

Étape 3 : choisir une offre

Commencez sur Free ($0, usage limité), passez à Plus ($8/mois) si les limites interrompent votre travail, et ne choisissez Premium ($30/mois) que si vous avez besoin de Cloud Agents, de modèles tiers ou de vos propres clés API.

Les prix sont hors taxes. Au-delà viennent Super ($100) et Ultra ($200). Pour le détail, consultez notre guide des prix de Cursor ou la page de tarifs officielle. N'achetez que sur le site officiel ou par achat intégré, car la page de tarifs indique que Cursor n'autorise aucun revendeur ni vendeur tiers ("not authorize any resellers or third-party sellers").

Étape 4 : facultatif, récupérer votre configuration VS Code

L'import des réglages de VS Code n'est plus décrit comme une étape du premier lancement. Si vous le souhaitez, appuyez sur Cmd+Shift+J (Ctrl+Shift+J sur Windows et Linux) pour ouvrir Cursor Settings, puis allez dans General > Account > VS Code Import > Import.

Les extensions de Cursor viennent d'Open VSX, pas du VS Code Marketplace, et toutes n'y sont pas. Si l'une d'elles manque après l'import, c'est probablement la raison.

Vérifiez l'éditeur avant d'installer quoi que ce soit. Le 29 octobre 2026, Cursor a signalé une extension malveillante se faisant passer pour Anthropic.claude-code (versions 2.1.312 et 2.1.313) dans sa marketplace.

Découvrir l'interface

Deux fenêtres : Agents Window et l'éditeur

Cursor a deux interfaces principales, et la documentation précise que les deux restent prises en charge. Vous pouvez les garder ouvertes en même temps.

	Agents Window	Éditeur (IDE)
Organisé autour	Des agents	De vos fichiers
Idéal pour	Plusieurs dépôts, agents en parallèle, travail local, cloud et SSH	Lire et modifier le code à côté d'Agent
Comment y accéder	Cmd+Shift+P, puis Open Agents Window	Cmd+Shift+P, puis Open IDE

Sur Windows et Linux, la palette de commandes s'ouvre avec Ctrl+Shift+P.

Quelques fonctionnalités n'existent que dans l'Agents Window, notamment les espaces de travail multiples, la nouvelle vue diff, les agents cloud en parallèle et l'interface native Worktrees.

Pour votre premier jour, utilisez l'éditeur. Vous voyez le fichier et la conversation côte à côte, ce qui facilite le suivi de ce que fait Agent.

Le panneau Agent

Dans l'éditeur, appuyez sur Cmd+I (Ctrl+I) pour ouvrir le panneau latéral. La documentation l'appelle "Agent panel", et le tableau des raccourcis "Sidepanel". C'est la même chose.

Dans le panneau, vous utiliserez :

La zone de saisie pour votre demande. Faites-y glisser ou collez des images, ou utilisez le micro pour la voix.
Le menu des modes, qui permet de passer entre Agent, Ask, Plan et Debug.
Le sélecteur de modèle en haut de la zone de saisie.
@ pour désigner quelque chose de précis, et / pour appeler des skills et des commandes.

La liste officielle actuelle de @ est courte : un fichier ou un dossier comme @index.html ou @src/components/, @Terminals, @Chats, @Commit (Diff of Working State), @Branch (Diff with Main) et @Browser. Si vous ne savez pas quel fichier compte, laissez @ de côté. La documentation indique qu'Agent trouve les fichiers pertinents grâce à sa propre recherche.

Les anciens tutoriels enseignent @codebase, @docs et @web. Ils ne figurent pas dans la liste actuelle, et nous n'avons pas pu confirmer qu'ils fonctionnent encore.

La barre latérale comporte aussi une page Customize, qui rassemble au même endroit plugins, skills, MCP, sous-agents, règles, commandes et hooks. Vous l'utiliserez plus tard.

Les termes à connaître : ce que les noms signifient aujourd'hui

De nombreux noms de Cursor ont changé. Ce tableau indique ce que chacun signifie aujourd'hui.

Terme	Ce qu'il signifie aujourd'hui	Si un ancien tutoriel dit
Composer	Le modèle maison de Cursor, actuellement Composer 2.5, décrit comme rapide et économique	« mode Composer » : ne figure plus dans la documentation, utilisez Agent
Agent	Le mode par défaut et la principale façon de travailler	« passer à Agent dans Composer » : aucun changement nécessaire
Chat	Pas un mode séparé. La documentation écrit "Agent (Chat)"	« ouvrir Chat pour poser des questions » : utilisez Ask, le mode en lecture seule
Inline Edit	Retiré ; voir plus bas	« sélectionner du code et appuyer sur Cmd+K pour modifier sur place » : sélectionnez du code, appuyez sur Cmd+K ou Cmd+L, et il part vers Agent
Tab	Autocomplétion, nom inchangé	« Supermaven » : le mot n'apparaît pas dans la documentation officielle que nous avons lue
Free	L'offre à $0 pour les nouveaux comptes	« Hobby » : une ancienne offre conservée pour les comptes existants
Règle `.mdc`	Le type de fichier requis pour les règles de projet	« `.cursorrules` » : ancien format, voué à être déprécié

La page d'aide de Cursor indique que Cmd+K "used to open inline edit, which has been replaced by this workflow" (« ouvrait auparavant l'édition en ligne, remplacée par ce flux de travail »). Un message d'un membre de l'équipe Cursor sur le forum officiel donne la date, le 26 octobre 2026, et précise que cela inclut la génération de commandes avec Cmd+K dans le terminal. Le remplacement proposé est Cmd+I et une demande à Agent. Une page d'aide sur le terminal mentionne encore la génération de commandes en langage naturel : la documentation n'est donc pas totalement cohérente sur ce point. Ce guide suit le message de l'équipe.

Les raccourcis de votre premier jour

Le tableau de référence de Cursor ne donne que les touches Mac, et les pages d'aide ajoutent quelques touches Windows et Linux. Quand rien n'est indiqué, nous le disons plutôt que de deviner. Dans ce cas, consultez les réglages de raccourcis dans l'application (Cmd+R puis Cmd+S, ou Ctrl+R puis Ctrl+S).

Action	Mac	Windows / Linux
Ouvrir ou fermer le panneau Agent	Cmd+I, Cmd+L ou Cmd+K	Ctrl+I, Ctrl+L ou Ctrl+K
Envoyer le code sélectionné dans un nouveau chat	Cmd+L ou Cmd+K	Ctrl+L ou Ctrl+K
Ajouter le code sélectionné au chat actuel	Cmd+Shift+L	Non indiqué, vérifiez dans l'application
Parcourir les modes	Shift+Tab	Shift+Tab
Ouvrir le menu des modes	Cmd+.	Ctrl+.
Parcourir les modèles	Cmd+/	Ctrl+/
Accepter une suggestion Tab	Tab	Tab
Accepter Tab mot par mot	Cmd+→	Ctrl+→
Rejeter une suggestion Tab	Escape, ou continuer à taper	Escape, ou continuer à taper
Accepter tous les changements	Cmd+Return	Non indiqué, vérifiez dans l'application
Rejeter tous les changements	Cmd+Shift+Backspace	Non indiqué, vérifiez dans l'application
Cursor Settings	Cmd+Shift+J	Ctrl+Shift+J
Palette de commandes	Cmd+Shift+P	Ctrl+Shift+P

Deux touches dépendent de l'endroit où vous êtes. Cmd+K ouvre le panneau dans l'éditeur, mais une palette de commandes dans l'Agents Window. Cmd+Return a aussi plusieurs sens selon le contexte, comme le montre la référence des raccourcis clavier. Cmd+Shift+Backspace sert aussi à annuler une réponse en cours : appuyez dessus avec précaution.

Première tâche pas à pas : améliorer un petit projet avec Agent

Cet exemple utilise une seule page web : vous n'avez besoin de rien d'autre que Cursor et d'un navigateur. Vous poserez d'abord des questions, puis vous laisserez Agent effectuer les changements.

Étape 1 : créer le projet d'entraînement

Créez un dossier vide nommé cursor-practice, puis choisissez-le comme dossier dans Cursor. Créez un fichier nommé index.html et collez-y ceci :

<!doctype html>
<html>
  <head><meta charset="utf-8"><title>Tip calculator</title></head>
  <body>
    <h1>Tip calculator</h1>
    <label>Bill <input id="bill" type="number"></label>
    <button onclick="calculate()">Calculate 15% tip</button>
    <p id="result"></p>
    <script>
      function calculate() {
        const bill = Number(document.getElementById("bill").value);
        document.getElementById("result").textContent = "Tip: " + (bill * 0.15);
      }
    </script>
  </body>
</html>

Enregistrez le fichier et ouvrez-le dans votre navigateur. Appuyez sur le bouton avec une addition vide et vous obtenez "Tip: 0". C'est le petit problème que vous allez corriger.

Étape 2 : poser des questions avant de changer quoi que ce soit

Appuyez sur Cmd+I (Ctrl+I). Ouvrez le menu des modes et choisissez Ask, ou appuyez sur Shift+Tab jusqu'à ce qu'il s'affiche. Tapez :

Explain what index.html does in plain language.
Then list the problems a user could run into.

Ce que vous devriez voir : une réponse écrite dans le panneau. Votre fichier ne change pas, car Ask est en lecture seule. La réponse mentionnera probablement l'addition vide. La formulation exacte varie d'une exécution à l'autre : ne vous attendez pas à une réponse fixe.

Étape 3 : donner à Agent une tâche précise

Revenez à Agent. Changer de mode ouvre une nouvelle fenêtre de contexte : rédigez donc la demande pour qu'elle se suffise à elle-même.

In @index.html, improve the tip calculator:
1. If the bill is empty, zero or negative, show "Enter a bill above 0".
2. Show the tip with two decimal places.
3. Add a dropdown for 10%, 15% and 20%, with 15% selected by default.
Keep everything in this one file. Do not add libraries.

Ce que vous devriez voir : Agent lit le fichier et commence à le modifier. Le point important quand on débute est que les modifications sont appliquées au fil du travail d'Agent. Vous n'approuvez pas chaque changement à l'avance. Vous examinez le résultat ensuite, dans une vue diff.

Agent peut aussi vouloir exécuter une commande. La gestion de ce cas dépend du mode d'exécution, défini dans Cursor Settings > Agents > Approvals & Execution. Les options sont Auto-review (par défaut), Allowlist et Run Everything. Gardez le réglage par défaut pour l'instant.

Étape 4 : examiner le diff

Cursor affiche les modifications dans une vue diff. La documentation ne nomme pas le bouton exact : cherchez-le autour du fichier modifié et du panneau Agent. Lisez ligne par ligne. Un diff montre les lignes supprimées et ajoutées, ce qui permet de voir exactement ce qui a changé. Pour cette tâche, cherchez :

une vérification de la valeur de l'addition
un menu déroulant avec trois pourcentages
un pourboire arrondi à deux décimales
rien d'étranger à la tâche, comme un nouveau fichier que vous n'avez pas demandé

Rejetez ce que vous ne voulez pas. Pour tout accepter ou tout rejeter d'un coup sur Mac, utilisez Cmd+Return ou Cmd+Shift+Backspace. Sur Windows et Linux, vérifiez dans l'application, comme indiqué plus haut.

Étape 5 : testez vous-même

Rechargez la page dans votre navigateur et essayez ces cas :

Entrée	Résultat attendu
Addition vide	Le message "Enter a bill above 0"
-5	Le même message
100 à 15%	Tip: 15.00, ou similaire
100 à 20%	Tip: 20.00, ou similaire

Si un cas échoue, dites précisément à Agent ce qui s'est passé : « Avec une addition de -5, la page affiche Tip: -0.75. Elle devrait afficher le message. » Cela fonctionne bien mieux que « ça ne marche pas ».

Étape 6 : vous entraîner à annuler

Faites maintenant un changement que vous comptez jeter :

Change the page background to bright green and make all text 40px.

Rechargez le navigateur pour le voir. Remontez ensuite dans la conversation et cliquez sur Restore Checkpoint sur cette demande. Une page d'aide appelle ce bouton Revert. Rechargez à nouveau : le vert devrait avoir disparu. Sinon, restaurez à partir de la demande précédente. Agent crée des checkpoints avant les changements importants : si vous ne voyez pas de bouton pour un changement aussi petit, rejetez-le plutôt dans le diff. Vos messages restent dans la conversation, car une restauration ne rétablit que les fichiers.

Voilà toute la boucle quotidienne : demander, donner une consigne, examiner, tester, annuler si besoin. Si lire des diffs est la partie que vous ne voudrez jamais faire, autant le savoir tôt. C'est peut-être le signe que NxCode, notre propre créateur d'applications, vous conviendra mieux qu'un éditeur.

Quand utiliser Agent, Ask, Plan et Debug

Il existe quatre modes. Passez de l'un à l'autre avec Shift+Tab ou le menu du panneau Agent.

Mode	À utiliser quand	Peut-il modifier des fichiers ?	Exemple de prompt
Agent	Vous voulez construire, refactoriser ou corriger quelque chose. C'est le mode par défaut	Oui	« Ajoute un bouton de réinitialisation et efface le résultat quand on appuie dessus. »
Ask	Vous voulez comprendre du code	Non, lecture seule	« Comment le pourboire est-il calculé ici ? »
Plan	La tâche est grande ou floue et vous voulez vérifier l'approche d'abord	Après votre approbation	« Planifie la séparation de cette page en fichiers HTML, CSS et JS distincts. »
Debug	Un bug nécessite des preuves issues du programme en cours d'exécution	Oui	« Le pourboire est faux après un changement de pourcentage. Trouve la cause. »

Une façon simple de choisir :

Vous ne comprenez pas encore ? Ask.
Vous savez ce que vous voulez et le changement est petit ? Agent.
Cela touche beaucoup de fichiers, ou vous doutez de l'approche ? Plan.
Un bug que la lecture du code n'explique pas ? Debug.

En mode Plan, Agent pose des questions de clarification, étudie votre code et rédige un plan. Rien n'est construit tant que vous ne cliquez pas sur Build. Les plans sont enregistrés par défaut dans votre répertoire personnel, et Save to workspace en déplace un dans votre projet. Cursor peut aussi suggérer Plan quand votre demande semble complexe.

En mode Debug, Agent formule des hypothèses, ajoute des journaux et utilise les informations d'exécution pour trouver la cause.

Examiner et annuler les changements

Liste de contrôle de la revue

Utilisez-la avant de conserver un changement d'Agent :

Lisez tout le diff, pas seulement le résumé.
Chaque fichier modifié a un rapport avec la tâche.
Vous pouvez expliquer chaque changement. Sinon, posez la question en mode Ask.
Rien de ce qui devait rester n'a été supprimé.
Aucun mot de passe, clé ou autre secret n'apparaît dans le code.
Vous avez testé vous-même, y compris avec une mauvaise entrée.

En plus de votre propre revue, Cursor propose Agent Review, lancé avec /agent-review ou depuis l'onglet Source Control.

Comment fonctionnent les checkpoints

Agent crée automatiquement un checkpoint avant les changements importants. Les checkpoints sont stockés localement et sont distincts de Git.

Il existe trois façons de restaurer :

Cliquez sur un checkpoint dans la chronologie du chat pour le prévisualiser, puis restaurez.
Cliquez sur Restore Checkpoint sur une demande antérieure.
Survolez un message et cliquez sur le bouton +.

La restauration rétablit les fichiers mais ne supprime pas les messages. Pour raccourcir aussi la conversation, créez une branche à partir d'un message antérieur.

Les pages officielles se contredisent ici sur un nom. La documentation d'Agent appelle le bouton Restore Checkpoint, alors que la page d'aide de Plan l'appelle Revert, suivi de Confirm. Cherchez l'un ou l'autre libellé.

Utilisez Git pour tout ce que vous voulez conserver

Le conseil de Cursor est de "use Git for permanent version control" (« utiliser Git pour le contrôle de version permanent »). Les checkpoints sont une annulation rapide, et Git est votre historique à long terme. Avant une tâche Agent plus importante, enregistrez un état fonctionnel :

git init
git add .
git commit -m "Working version before Agent task"

Vous n'avez besoin de git init qu'une fois par projet.

Ajouter des règles à votre projet

Les règles sont des instructions permanentes, qui vous évitent de vous répéter. Ajoutez-en une au projet d'entraînement. Il existe trois façons de créer une règle de projet :

Tapez /create-rule dans le chat.
Allez dans Customize > Rules > Add Rule.
Lancez New Cursor Rule depuis la palette de commandes.

Ou créez vous-même le fichier .cursor/rules/practice.mdc :

---
description: Conventions for this practice project
globs:
alwaysApply: true
---

- Keep everything in index.html unless asked otherwise.
- Do not add libraries.
- Use clear variable names and short comments.

Demandez maintenant à Agent un autre petit changement. Il devrait suivre ces règles sans qu'on le lui dise.

Quatre choses à savoir :

L'extension doit être .mdc. Les fichiers en .md sont ignorés par le système de règles dans ce dossier.
AGENTS.md est l'option la plus simple. C'est du Markdown ordinaire, placé à la racine du projet ou dans un sous-dossier. Cursor lit CLAUDE.md de la même manière.
Les règles ne s'appliquent qu'à Agent. Elles n'affectent ni Tab ni Bugbot.
Gardez-les courtes. Cursor suggère moins de 500 lignes par règle.

Les règles sont de quatre types : Always Apply, Apply Intelligently, Apply to Specific Files et Apply Manually (avec une mention @). L'ordre de priorité est Team, puis Project, puis User. .cursorrules est un ancien format qui sera déprécié : ne démarrez pas de nouveau projet avec.

MCP, skills, sous-agents et Cloud Agents en bref

Vous n'avez besoin de rien de tout cela le premier jour. C'est juste pour que vous reconnaissiez les noms.

MCP connecte Agent à des outils et services extérieurs. Installez depuis Customize > MCPs > Add to Cursor, ou configurez .cursor/mcp.json dans un projet ou ~/.cursor/mcp.json globalement. Si les deux définissent le même nom, le projet l'emporte. Notre guide MCP pour Cursor va plus loin.
Skills sont des dossiers contenant un fichier SKILL.md qui apprennent une procédure à Agent. Agent les utilise quand c'est pertinent, ou vous en appelez une avec /. Exemples intégrés : /create-rule, /review et /shell.
Subagents ont leur propre contexte et peuvent s'exécuter en parallèle. Les sous-agents intégrés sont Explore et Browser. Les sous-agents personnalisés vont dans .cursor/agents/.
Cloud Agents s'exécutent sur des machines cloud isolées : ils ne dépendent donc pas du fait que votre ordinateur reste en ligne. Choisissez Cloud dans le menu de la zone de saisie de l'agent. Une personne admin doit d'abord connecter GitHub, GitLab, Bitbucket ou Azure DevOps, et il vous faut un accès en lecture et en écriture au dépôt. Ils ne sont pas disponibles sur Free ni Plus.

La ligne de commande : `agent`

Cursor a aussi une CLI, et la commande est agent. Installez-la avec :

# macOS, Linux, WSL
curl https://cursor.com/install -fsS | bash

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

Vérifiez-la avec agent --version et connectez-vous avec agent login. Lancez ensuite agent dans un dossier de projet pour une session interactive, ou agent -p "your request" pour une seule exécution non interactive. Elle lit les mêmes fichiers .cursor/rules, AGENTS.md et CLAUDE.md que l'éditeur. Si vous débutez, vous pouvez garder cela pour plus tard.

Erreurs courantes

Suivre un ancien tutoriel. Si un guide dit d'ouvrir le mode Composer, d'appuyer sur Cmd+K pour modifier sur place ou de choisir un modèle au premier lancement, il décrit un ancien Cursor.

Croire que rien ne change tant que vous n'acceptez pas. Les modifications d'Agent sont déjà appliquées pendant son travail. Vérifiez le diff avant de continuer, et n'exécutez pas le code sur simple confiance.

Rédiger des demandes vagues. « Corrige ça » donne peu de matière à Agent. Dites ce qui se passe, ce qui devrait se passer et où : « Quand l'addition est vide, la page affiche Tip: 0. Elle devrait afficher un message à la place. »

Commencer trop grand. Ne débutez pas par une application complète. Commencez par de petites tâches, et utilisez le mode Plan pour tout ce qui est plus important.

Traiter les checkpoints comme des sauvegardes. Ils sont locaux et distincts de Git. Faites un commit de tout ce qui compte pour vous.

Enregistrer une règle en .md. Cela semble correct et ne fait rien. Utilisez .mdc, ou AGENTS.md à la racine du projet.

Changer le mode d'exécution le premier jour. Gardez le réglage par défaut jusqu'à ce que vous compreniez ce qu'Agent exécute sur votre ordinateur et quelle permission chaque option accorde.

Choisir un modèle tiers sans vérifier le coût. À partir de Premium, les modèles tiers consomment des crédits prépayés au prix catalogue de l'API dès la première requête. Ils n'utilisent pas votre réserve hebdomadaire.

Accepter du code que vous ne savez pas expliquer. Le mode Ask existe pour cela. Demandez « que fait ce changement, étape par étape ? » avant de le conserver.

Dépannage

Interface et configuration

Ce que vous voyez	Raison probable	Que faire
Aucun mode Composer nulle part	Il n'existe plus en tant que mode	Utilisez Agent avec Cmd+I (Ctrl+I)
Cmd+K ne modifie pas sur place	Inline Edit a été retiré	Sélectionnez du code, appuyez sur Cmd+K, puis décrivez le changement dans Agent
Cmd+K ouvre une palette de commandes	Vous êtes dans l'Agents Window	Utilisez Cmd+Shift+P, puis Open IDE pour revenir à l'éditeur
Une page de connexion Grok ou xAI apparaît	Connexion partagée	C'est normal. Se connecter ne fusionne pas les comptes
Une extension manque	Elle n'est peut-être pas sur Open VSX	Cherchez une alternative dans Open VSX
Une règle est ignorée	Mauvaise extension ou mauvais emplacement	Utilisez `.cursor/rules/name.mdc`, et vérifiez son type
Agent oublie le contexte précédent	Vous avez changé de mode	Chaque changement ouvre une nouvelle fenêtre de contexte : reformulez les points clés
Un raccourci ne fait rien sur Windows	Il peut différer de la touche Mac	Vérifiez les réglages de raccourcis avec Ctrl+R puis Ctrl+S

Modèles, offres et CLI

Ce que vous voyez	Raison probable	Que faire
Claude ou GPT manque	Offre ou région	Free et Plus excluent les modèles tiers. Certains modèles sont aussi masqués dans certaines régions
Les Cloud Agents sont indisponibles	Offre ou configuration du dépôt	Il faut Premium ou plus, un fournisseur Git connecté et l'accès au dépôt
Vous atteignez une limite d'utilisation	Limite de l'offre atteinte	Vérifiez Usage sur grok.com/dashboard. Sur les offres payantes, attendez la réinitialisation hebdomadaire, utilisez des crédits prépayés ou montez en gamme
Vous ne trouvez pas la facturation	La facturation a déménagé	The X Subscription utilise grok.com/dashboard/billing. Les anciennes offres utilisent cursor.com/dashboard/spending
`agent: command not found`	`~/.local/bin` n'est pas dans votre PATH	Ajoutez-le à votre PATH, puis ouvrez un nouveau terminal

Quand utiliser un autre outil

Cursor est un outil pour travailler avec du code. Ces situations peuvent orienter ailleurs :

Vous ne voulez pas du tout écrire ou relire du code. Vous voulez une application fonctionnelle à partir d'une description. C'est à cela que sert NxCode, notre propre produit. Nous le fabriquons, gardez-le à l'esprit en lisant ceci, et consultez notre comparatif avec Cursor et Copilot.
Vous vivez dans le terminal. Essayez d'abord la commande agent de Cursor, ou comparez-la au flux de travail de notre tutoriel Claude Code.
Vous utilisez JetBrains. Vous n'avez peut-être pas besoin de changer d'éditeur, car l'agent de Cursor se connecte à JetBrains via ACP.
Vous comparez encore les outils. Notre classement des outils de code IA présente les options.

Essayer Cursor sur Free ne coûte rien : une petite tâche réelle est donc une façon raisonnable de décider. Si le flux de travail ci-dessus vous a semblé naturel, restez. Si le code lui-même vous a gêné, la première situation vous correspond probablement.

FAQ

Comment commencer à utiliser Cursor pour la première fois ?

Téléchargez Cursor sur cursor.com/download, ouvrez-le, connectez-vous et choisissez un dossier. Appuyez ensuite sur Cmd+I (Ctrl+I sur Windows et Linux) pour ouvrir Agent et demandez-lui d'expliquer le code. Le quickstart de Cursor recommande de commencer par une petite tâche de ce type.

Qu'est devenu le mode Composer dans Cursor ?

Le mode Composer ne figure pas dans la documentation actuelle de Cursor. Composer est désormais le nom du modèle maison de Cursor, actuellement Composer 2.5. Les quatre modes sont Agent, Ask, Plan et Debug. Pour le travail multi-fichiers que les anciens tutoriels faisaient en mode Composer, utilisez Agent.

Qu'est devenu l'édition en ligne Cmd+K dans Cursor ?

Inline Edit a été retiré. Un message d'un membre de l'équipe Cursor sur le forum officiel date ce retrait du 26 octobre 2026. Dans l'éditeur, sélectionnez du code et appuyez sur Cmd+K ou Cmd+L (Ctrl+K ou Ctrl+L sur Windows et Linux) pour envoyer la sélection à Agent, puis décrivez-y le changement.

Cursor est-il gratuit ?

Oui, il existe une offre Free à $0 avec un usage limité d'Agent, Chat et Tab. Cursor ne publie aucun chiffre pour ces limites. La page de tarifs actuelle ne dit pas si une carte bancaire est nécessaire : vérifiez à l'inscription. Les offres payantes commencent à Plus, à $8 par mois hors taxes.

Quels modèles d'IA puis-je utiliser dans Cursor ?

Les modèles propres à Cursor sont Grok 4.7, qu'il présente comme son modèle phare, Grok 4.6, Grok 4.5 et Composer 2.5. Les modèles tiers comme Claude, GPT et Gemini exigent Premium ou plus et sont facturés au prix catalogue de l'API sur les crédits prépayés. Free et Plus ne les incluent pas.

Cursor Agent modifie-t-il mes fichiers avant mon accord ?

Oui. Agent applique les modifications au fil de son travail, et vous les examinez ensuite dans une vue diff, où vous pouvez rejeter ce que vous ne voulez pas. Agent crée aussi des checkpoints avant les changements importants : vous pouvez donc restaurer des états antérieurs des fichiers.

Faut-il savoir coder pour utiliser Cursor ?

Vous pouvez l'essayer sans grande expérience, car le mode Ask explique le code en langage simple, mais il faut quand même lire les diffs et juger le résultat. Si vous préférez décrire une application sans toucher au code, NxCode, notre propre produit, est conçu pour cela.

Où acheter Cursor, et peut-on s'abonner depuis la Chine continentale ?

Cursor indique que les abonnements sont vendus uniquement sur son site officiel ou par achat intégré, et qu'il n'autorise aucun revendeur. L'achat intégré iOS couvre les régions de l'App Store, sauf la Chine continentale. Les pages officielles n'ont pas permis de vérifier si les abonnements web sont restreints en Chine continentale.

Sources

Toutes les pages ont été vérifiées le 1er novembre 2026. Les raccourcis, les offres et les noms peuvent changer : l'application et les pages officielles font foi.