Votre premier prompt — Claude Code 101

Claude Code est installé ; place à la première session. Cette leçon suit le quickstart officiel : poser des questions sur un projet, demander une première modification, utiliser git en langage courant, puis les commandes et les raccourcis qui servent tous les jours. Prenez un vrai projet, même petit : les réponses n’ont d’intérêt que sur du code que vous connaissez.

Ouvrir une session

cd /chemin/vers/votre/projet
claude

Claude Code ouvre une session interactive dans le terminal. Le dossier depuis lequel vous le lancez compte : c’est lui qui définit le projet que Claude voit, et c’est à lui que la session est rattachée quand vous voudrez la reprendre.

Commencer par des questions

Votre première demande n’a pas besoin de modifier quoi que ce soit. Demandez à Claude de vous présenter le projet :

what does this project do?

Claude analyse les fichiers et vous en fait un résumé. Vous n’avez rien à lui fournir : il lit lui-même les fichiers dont il a besoin. Les prompts peuvent être en français ; la documentation officielle donne ses exemples en anglais, que nous reprenons tels quels. Continuez avec des questions plus précises :

quelles technologies ce projet utilise-t-il ?
où se trouve le point d'entrée principal ?
explique-moi l'organisation des dossiers

Vous pouvez aussi l’interroger sur Claude Code lui-même : « que peut faire Claude Code ? », « comment créer une skill ? ». Pour répondre, il consulte la documentation à jour de Claude Code, si bien que sa réponse ne se limite pas à la version installée chez vous.

Une première modification

Essayez une petite tâche :

add a hello world function to the main file

Claude trouve le bon fichier et vous montre la modification. S’il vous demande la permission avant de l’appliquer, choisissez Yes. Ce comportement dépend du mode de permission de la session. Depuis la version 2.1.283 de Claude Code, une session en terminal ou dans VS Code démarre en mode Auto : un second modèle, le classifieur, examine les actions risquées avant leur exécution au lieu de vous interroger à chaque fois. En mode Manual, Claude vous demande avant la plupart des modifications de fichiers et des commandes. Maj+Tab fait passer d’un mode à l’autre à tout moment ; nous y reviendrons dans la leçon sur le flux de travail.

Git en langage courant

Claude Code rend les opérations git conversationnelles :

quels fichiers ai-je modifiés ?
commit my changes with a descriptive message
crée une branche feature/quickstart
montre-moi les 5 derniers commits
aide-moi à résoudre les conflits de fusion

Bugs, fonctionnalités et tâches courantes

Décrivez ce que vous voulez, comme à un collègue :

add input validation to the user registration form
there's a bug where users can submit empty forms - fix it
write unit tests for the calculator functions
review my changes and suggest improvements

Trois conseils du quickstart changent beaucoup la qualité du résultat :

Soyez précis. Plutôt que « corrige le bug », écrivez « corrige le bug de connexion : après de mauvais identifiants, l’utilisateur voit un écran blanc ».
Découpez les tâches complexes en étapes numérotées : créer la table, puis l’API, puis la page.
Laissez Claude explorer d’abord (« analyse le schéma de la base de données ») avant de lui demander une modification.

N’attendez pas non plus le prompt parfait. C’est une conversation : commencez par ce que vous voulez, puis corrigez (« ce n’est pas tout à fait ça, le problème vient de la gestion de session »).

Les commandes à connaître

Depuis votre terminal :

Commande	Effet
`claude`	Ouvrir une session interactive
`claude "tâche"`	Ouvrir une session avec une première demande
`claude -p "question"`	Poser une question ponctuelle, afficher la réponse et quitter
`claude -c`	Reprendre la conversation la plus récente du dossier
`claude -r`	Choisir une conversation précédente à reprendre

Dans une session :

Commande	Effet
`/help`	Lister les commandes disponibles
`/clear`	Repartir d’une conversation vierge (l’ancienne reste enregistrée et peut être reprise)
`/exit` ou Ctrl+D deux fois	Quitter Claude Code

Les gestes du quotidien

Quelques raccourcis de la page Interactive mode vous serviront dès le premier jour :

Échap arrête Claude au milieu d’une action, en gardant le travail déjà fait, pour le réorienter ;
Échap deux fois, sur une invite vide, ouvre le menu de retour en arrière ;
Entrée pendant que Claude travaille met votre message en file d’attente au lieu de l’interrompre ;
@ suivi d’un chemin ajoute un fichier ou un dossier à votre demande (@src/utils/auth.js) ;
! en début de ligne lance une commande shell directement (! npm test), et sa sortie est ajoutée à la conversation ;
Ctrl+V colle une image (une capture d’écran, une maquette) dans votre demande ; Alt+V sous Windows et WSL ;
Maj+Tab change de mode de permission ;
? sur une invite vide affiche l’aide des raccourcis.

D'après la leçon « Your first prompt » (Claude Academy, Claude Code 101) et la page Interactive mode (documentation Claude Code).

À vous de jouer

Votre première session. Dans un projet que vous connaissez, posez trois questions sur le code, puis demandez une petite modification et relisez-la avant de l’accepter. Testez au passage trois gestes : @ pour citer un fichier, ! pour lancer une commande, et Échap pour interrompre puis réorienter Claude.

Sources officielles : Your first prompt (Claude Academy) · Quickstart · Interactive mode · Common workflows

Points clés à retenir

Lancez claude depuis le dossier du projet ; commencez par des questions, Claude lit lui-même les fichiers utiles
Le mode de permission décide si Claude vous demande avant d’agir ; Maj+Tab en change
Git, bugs, tests, revues : tout se demande en langage courant, et mieux vaut un prompt précis
claude -c reprend la dernière conversation, /clear repart de zéro, Échap interrompt sans perdre le travail fait