Comment utiliser Claude Code : planifier, bien prompter et garder le contrôle

On découvre souvent Claude dans un chat : on colle du code, on recopie la réponse en espérant qu'elle convienne. Claude Code fonctionne autrement. Il s'exécute dans votre projet, lit et modifie lui-même les fichiers, lance vos tests et commite le résultat, en demandant la permission au fil de l'eau. Bien plus utile qu'un chatbot pour du vrai développement, il est aussi bien plus facile à mal utiliser. Ce guide explique comment utiliser Claude Code : installation, première session, planification avant toute écriture, prompts exploitables, configuration qui le garde sur les rails et limites à connaître avant de lui confier votre code.

Ce qu'est Claude Code (et ce qu'il n'est pas)

Claude Code est l'outil de programmation agentique d'Anthropic. « Agentique » signifie qu'il ne se contente pas de suggérer du code : il travaille en boucle, choisit l'étape suivante, utilise des outils et vérifie le résultat jusqu'à la fin de la tâche. Concrètement, il peut fouiller votre dépôt, lire et modifier des fichiers partout dans le projet, lancer des commandes shell (tests, linter), utiliser git et se connecter à des outils externes. Le principe de cette boucle est expliqué dans notre guide des agents IA.

Il fonctionne à plusieurs endroits, sur le même moteur, et vos réglages de projet vous suivent :

• Le terminal : la version complète en ligne de commande, sur laquelle porte ce guide.
• Les IDE VS Code et JetBrains : des extensions avec diffs en ligne et partage de votre sélection en cours.
• L'application de bureau : l'onglet Code de l'application Claude, avec revue visuelle des diffs et plusieurs sessions côte à côte.
• Le web et le mobile : sur claude.ai/code, pour des tâches longues sur des dépôts absents de votre machine.

Ce qu'il n'est pas : une autocomplétion qui finit la ligne en cours, ni une dispense de savoir ce que votre code doit faire. C'est plutôt un collègue rapide et infatigable tout juste arrivé : il lit tout très vite, mais ne connaît que le dépôt et ce que vous lui dites. Pour des réponses, des explications ou un avis sur un extrait, le chat classique de notre guide comment utiliser Claude est plus simple.

Comment installer Claude Code et lancer une session

Il faut un abonnement Claude payant (Pro, Max, Ultra, Team ou Enterprise), un compte Claude Console avec des crédits API, ou un accès via un fournisseur cloud compatible comme Amazon Bedrock. L'offre gratuite ne l'inclut pas.

L'installateur recommandé tient en une commande. Sous macOS, Linux ou WSL : curl -fsSL https://claude.ai/install.sh | bash. Sous Windows PowerShell : irm https://claude.ai/install.ps1 | iex. Homebrew (brew install --cask claude-code) et WinGet (winget install Anthropic.ClaudeCode) fonctionnent aussi, mais sans mise à jour automatique, contrairement à l'installateur natif. Sous Windows natif, ajoutez Git for Windows pour que Claude Code dispose d'un shell Bash.

Ensuite :

1. Dans un nouveau terminal, lancez claude --version pour vérifier l'installation. Commande introuvable ? Le dossier d'installation n'est pas encore dans votre PATH.
2. Placez-vous dans un dossier de projet avec cd et tapez claude.
3. Connectez-vous à la demande. Le navigateur s'ouvre ; les identifiants sont enregistrés une fois pour toutes.
4. Tapez /help pour voir les commandes disponibles. / seul liste commandes et skills au fil de la saisie.

Le terminal vous rebute ? Installez l'extension VS Code ou ouvrez l'onglet Code de l'application de bureau. Tout ce qui suit s'y applique, avec des boutons à la place de certains raccourcis.

Première session : explorer, puis faire une petite modification

Ne commencez pas par « développe-moi une fonctionnalité ». Laissez d'abord Claude Code lire le projet et vous résumer ce qu'il a trouvé : vous verrez comment il raisonne et repérerez les malentendus avant qu'ils ne deviennent des modifications. Des questions simples marchent : « que fait ce projet ? », « où est le point d'entrée principal ? » ou « explique la structure des dossiers ». Face à un code inconnu, demandez une vraie visite guidée :

Faites ensuite une petite modification sans risque : coquille dans le README, test manquant, message d'erreur plus clair. Observez-le. Claude Code montre chaque modification en diff et, selon le mode de permission, demande avant de l'appliquer ou l'applique et vous prévient. Sélectionnez Yes si elle vous semble juste ; sinon, dites ce qui ne va pas.

Git aussi s'utilise en conversation : « quels fichiers ai-je modifiés ? », « crée une branche nommée fix/login-timeout » ou « commite mes modifications avec un message descriptif ». Travaillez sur une branche dès le départ : chaque essai se jette facilement.

Planifier d'abord, coder ensuite

Au-delà d'une petite correction, l'habitude la plus utile est de séparer réflexion et écriture. Le mode Plan laisse Claude Code lire et explorer, sans toucher à votre code source avant que vous ayez approuvé un plan écrit. Appuyez sur Shift+Tab pour y basculer (la ligne d'état affiche « plan mode on ») ou commencez un prompt isolé par /plan.

Un bon prompt de planification décrit le résultat, les contraintes et comment vérifier que ça marche :

Le plan prêt, Claude Code propose de l'approuver et continuer, de l'approuver en relisant chaque modification, ou de continuer à planifier. Lisez-le vraiment : c'est le moment le moins coûteux pour repérer une hypothèse fausse, comme modifier un fichier généré ou oublier un appelant ailleurs. Ctrl+G ouvre le plan dans votre éditeur pour le modifier avant de l'approuver.

Comment écrire des prompts sur lesquels Claude Code peut agir

Claude Code lit votre dépôt, pas vos pensées, et il ne voit pas votre écran. Le conseil officiel : lui dire ce qu'il ne peut pas trouver seul. Nommez le fichier, décrivez le symptôme, dites à quoi ressemble « corrigé ». « Corrige le bug » l'envoie fouiller ; « corrige le bug de connexion où les utilisateurs voient un écran vide après un mauvais mot de passe » le met directement au travail.

Quelques façons de lui fournir du contexte :

• Référencez des fichiers avec @ : @ suivi d'un chemin, comme @src/auth/session.ts, inclut ce fichier dans votre message.
• Collez la vraie erreur : la stack trace complète ou la sortie du test en échec bat toute paraphrase.
• Collez des captures d'écran : utile pour un bug de mise en page ou une maquette à reproduire.
• Découpez les gros chantiers en étapes numérotées : la table, puis l'endpoint, puis la page qui l'utilise.

Pour les bugs, cette structure fonctionne bien :

Cette dernière ligne compte : pressé de faire passer un test, tout modèle de code peut être tenté de modifier le test ou d'intercepter l'erreur pour la cacher. Le dire d'emblée l'évite. Nos prompts IA pour le code proposent d'autres modèles pour revues, refactorisations et documentation, et le générateur de prompts Claude change une demande vague en prompt structuré de ce type.

CLAUDE.md, permissions et retour arrière : garder le contrôle

CLAUDE.md est un simple fichier Markdown à la racine du projet, que Claude Code lit au début de chaque session. /init en rédige un brouillon à partir de votre code ; à vous, surtout, de supprimer des lignes. Gardez-le court (la documentation conseille moins de 200 lignes) et limitez-le à ce que Claude ne peut pas déduire seul : commandes exactes de build et de test, conventions adoptées par l'équipe, étape de déploiement qui n'existe que dans la tête de quelqu'un, dossiers à ne jamais toucher. Si le dépôt a déjà un AGENTS.md pour d'autres agents, Claude Code peut le lire à la place. Rédiger ces instructions, c'est presque écrire un prompt système ; notre générateur de prompts système vous aide à les structurer.

Les modes de permission déterminent ce qui s'exécute sans demander. Shift+Tab les fait défiler :

• Manual (manuel) : Claude lit librement mais demande avant de modifier un fichier ou de lancer une commande.
• Accept edits (accepter les modifications) : modifications et commandes de fichiers courantes dans le dossier du projet passent ; les autres commandes demandent toujours.
• Plan : exploration et plan écrit, sans modification du code source.
• Auto, là où il est disponible : tout s'exécute, un modèle classificateur distinct vérifiant d'abord les actions risquées.

Sur deux points, la documentation est claire. D'abord, CLAUDE.md est indicatif : Claude peut juger qu'une ligne ne s'applique pas. Ce qui doit se produire à chaque fois relève d'une règle de refus (bloquer la lecture des fichiers .env, par exemple) ou d'un hook, un script que Claude Code exécute à des moments fixes, comme avant chaque modification ou quand Claude tente de terminer. Ensuite, n'utilisez jamais le mode qui contourne toute permission hors d'un conteneur ou d'une machine virtuelle jetable.

S'il fait fausse route, Esc l'arrête en pleine action pour le réorienter. Deux fois Esc sur un prompt vide, ou /rewind, ramène le code, la conversation ou les deux à un point antérieur. Ces points de contrôle ne couvrent que les fichiers modifiés par les outils d'édition de Claude, pas par des commandes shell : continuez donc à commiter dans git.

Longues sessions, coûts et automatisation

Chaque message renvoie toute la conversation : les longues sessions pèsent donc davantage sur le quota de votre abonnement ou votre budget API. La plupart des modèles Claude actuels ont une fenêtre de contexte d'un million de tokens, et Claude Code compacte seul l'ancien historique : la saturation est rare. Le vrai problème : payer pour un historique inutile, et en être distrait. Les bonnes habitudes :

• /clear entre deux tâches sans rapport : cela ne coûte rien. /clear [NOM] nomme aussi la session quittée pour y revenir.
• /compact avec un objectif : /compact garde les changements d'API et les commandes de test résume le reste.
• /usage et /context : voyez où part votre consommation et ce qui remplit la fenêtre.
• Reprenez au lieu de réexpliquer : claude -c poursuit la dernière session du dossier ; /rename puis claude --resume [NOM] reprend un travail nommé des jours plus tard.

Les bases acquises, Claude Code va bien au-delà du chat. claude -p "[TÂCHE]" exécute un seul prompt puis s'arrête : on peut lui envoyer des logs via un pipe ou l'appeler depuis des scripts et la CI, avec des intégrations prêtes pour GitHub Actions et GitLab. Les serveurs MCP le relient à des gestionnaires de tickets, des bases de données ou des fichiers de design. Les skills empaquettent des procédures répétables, comme une checklist de release, que Claude ne charge qu'au besoin, et les sous-agents gèrent des tâches annexes en parallèle sans encombrer la conversation principale.

Ce que Claude Code ne sait pas faire

• Connaître ce qui n'est écrit nulle part : règles métier, raison d'être d'un code étrange, processus de déploiement que personne n'a documenté. Hors du dépôt, de CLAUDE.md et de votre prompt, Claude devinera.
• Garantir un code correct : il peut écrire du code plausible qui passe des tests faibles tout en gérant mal cas limites, sécurité ou performances. Relisez les diffs comme la pull request d'un collègue, surtout pour l'authentification, les paiements ou la suppression de données.
• Vous faire comprendre votre propre système : tout lui faire écrire sans rien relire, c'est du vibe coding, acceptable pour un prototype, risqué pour ce que vous devrez maintenir.
• Résister seul aux instructions malveillantes : pages web, issues, dépendances ou fichiers qu'il lit peuvent contenir du texte conçu pour le manipuler. Demandes de permission, règles de refus et sandbox (/sandbox) existent en partie pour cela ; voir notre article sur l'injection de prompt.
• Être gratuit : abonnement payant ou crédits API obligatoires, et les sessions intensives épuisent vite les quotas. Vérifiez les tarifs actuels avant d'en faire un outil d'équipe.
• Rester stable longtemps : fonctionnalités, commandes et réglages par défaut changent souvent. Si une commande de ce guide diffère, la documentation officielle et /help font foi.

Bien utilisé, Claude Code vous décharge des tâches lentes du développement : s'orienter dans un code inconnu, écrire les tests que vous auriez sautés, traquer un bug à travers six fichiers. La méthode gagnante ne varie pas : explorez d'abord, planifiez avant de modifier, donnez-lui une vérification à lancer, gardez un CLAUDE.md court et exact, et relisez ce qu'il vous rend. Vous restez l'ingénieur ; il se charge de la frappe.

Références

• Anthropic — Aperçu de Claude Code (documentation officielle)
• Anthropic — Bonnes pratiques pour Claude Code
• Wikipedia — Claude (modèle de langage)