Comment programmer avec Claude Code : le guide pour bien commencer

Par l'équipe NRX3 · Mis à jour le 23 octobre 2026

L'IA évolue très vite. Ce guide a été rédigé au meilleur de nos connaissances en date du 23 octobre 2026 ; il se peut qu'une partie soit dépassée ou ne s'applique plus aujourd'hui.

Claude Code est l'outil de programmation par IA d'Anthropic. Contrairement à un assistant de discussion qui répond puis attend, il lit votre projet, modifie les fichiers, lance des commandes et vérifie son propre travail. Ce guide montre comment l'installer, comment l'utiliser au quotidien et comment garder le contrôle sur ce qu'il fait.

En bref

Il faut un abonnement Claude (Pro, Max, Team ou Enterprise), un compte Claude Console ou un accès par un fournisseur infonuagique.
On l'installe en une commande, puis on tape claude dans le dossier de son projet.
Un fichier CLAUDE.md lui donne les règles de votre projet ; /init en crée un premier jet.
La méthode qui marche : explorer, planifier, coder, puis faire vérifier le résultat par des tests.
Vous restez responsable du code : relisez, testez, et utilisez Git pour pouvoir revenir en arrière.

Qu'est-ce que Claude Code ?

Claude Code est un agent de programmation. Vous décrivez ce que vous voulez en langage courant ; il explore le code, propose une approche, modifie plusieurs fichiers au besoin, lance les tests et corrige ce qui ne passe pas. Il sait aussi utiliser Git : créer une branche, écrire un message de commit, ouvrir une demande de fusion (pull request).

Il fonctionne à plusieurs endroits, qui partagent le même moteur et les mêmes réglages :

le terminal, la version la plus complète ;
VS Code (et Cursor) et les éditeurs JetBrains, avec les modifications affichées dans l'éditeur ;
l'application de bureau Claude, onglet Code, pour macOS et Windows (Linux en bêta) ;
le Web, à claude.ai/code (s'ouvre dans un nouvel onglet), sans rien installer.

Ce qu'il vous faut

Un compte : un abonnement Claude Pro, Max, Team ou Enterprise (recommandé), ou un compte Claude Console (accès API avec crédits prépayés). Les entreprises peuvent aussi passer par Amazon Bedrock, Google Cloud ou Microsoft Foundry, dans le terminal et les éditeurs seulement.
Un projet : un dossier de code, idéalement suivi avec Git.
Un terminal : sous Windows, Git for Windows est recommandé pour que Claude Code puisse utiliser Bash ; sinon, il se sert de PowerShell.

Installer Claude Code

L'installation native est la méthode recommandée ; elle se met à jour toute seule.

macOS, Linux ou WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

Homebrew (brew install --cask claude-code) et WinGet (winget install Anthropic.ClaudeCode) fonctionnent aussi, mais ne se mettent pas à jour seuls. Ouvrez ensuite un nouveau terminal et vérifiez l'installation :

claude --version

Votre première session

Placez-vous dans le dossier de votre projet et lancez Claude Code. À la première utilisation, il vous demande de vous connecter dans votre navigateur.

cd chemin/vers/mon-projet
claude

Commencez par des questions, sans rien modifier. Claude Code lit lui-même les fichiers dont il a besoin :

que fait ce projet ?
quelles technologies utilise-t-il ?
explique-moi l'organisation des dossiers

Puis demandez une petite modification. Il vous montre le changement et, selon le mode choisi, vous demande votre accord avant de l'appliquer :

ajoute une validation des champs au formulaire d'inscription

Les commandes à connaître

Commande	À quoi elle sert
`claude`	Démarrer une session interactive
`claude "tâche"`	Démarrer avec une première demande
`claude -p "question"`	Poser une question sans session interactive (scripts, intégration continue)
`claude -c`	Reprendre la dernière conversation du dossier
`claude -r`	Choisir une conversation précédente à reprendre
`/help`	Afficher les commandes disponibles (dans une session)
`/clear`	Repartir d'une conversation vide
`Échap`	Arrêter Claude en cours d'action, pour le réorienter

Donnez-lui les règles de votre projet : CLAUDE.md

CLAUDE.md est un fichier texte, placé à la racine du projet, que Claude Code lit au début de chaque session. C'est là que vous écrivez ce qu'il ne peut pas deviner en lisant le code : les commandes pour compiler et tester, les conventions de l'équipe, les décisions d'architecture, les pièges connus.

La commande /init analyse votre projet et en écrit un premier jet ; complétez-le ensuite. Gardez-le court : un fichier trop long dilue les consignes importantes. Pour chaque ligne, demandez-vous si son absence causerait une erreur. Si ce n'est pas le cas, retirez-la.

# Commandes
- Compiler : npm run build
- Tester un seul fichier : npm test -- chemin/du/test

# Conventions
- Modules ES (import/export), pas de require
- Toujours lancer la vérification des types après une série de modifications

Vos préférences personnelles, valables pour tous vos projets, vont dans ~/.claude/CLAUDE.md. Si votre dépôt a déjà un fichier AGENTS.md pour d'autres outils, Claude Code le lit seulement en l'absence de CLAUDE.md ; si vous avez les deux, ajoutez la ligne @AGENTS.md dans votre CLAUDE.md.

Gardez le contrôle : les modes de permission

Le mode de permission décide de ce que Claude Code peut faire sans vous demander. On passe d'un mode à l'autre avec Maj+Tab, parmi les modes offerts ; le mode actif s'affiche sous la zone de saisie.

Mode	Ce qu'il fait sans demander	Pour quoi
Manuel	Seulement lire	Approuver chaque action vous-même
Acceptation des modifications	Lire, modifier les fichiers et les commandes de fichiers courantes dans le projet	Itérer sur du code que vous relisez
Plan	Lire et explorer, sans modifier le code	Comprendre et planifier avant de toucher à quoi que ce soit
Auto	Presque tout, avec un contrôle de sécurité automatique qui bloque les actions risquées	Les longues tâches, avec moins d'interruptions

Dans les versions récentes, Claude Code démarre en mode Auto dans le terminal et dans VS Code. Pour approuver vous-même chaque action, passez en mode Manuel avec Maj+Tab.

D'autres modes existent pour les scripts et les environnements isolés. Contournez les permissions seulement dans un conteneur ou une machine virtuelle jetable, sans accès Internet, jamais sur votre poste ou un serveur de production.

La méthode qui donne de bons résultats

Explorer. En mode Plan, demandez-lui de lire la partie du code concernée et de vous l'expliquer.
Planifier. Demandez un plan détaillé : fichiers touchés, étapes, risques. Corrigez le plan avant de passer à la suite.
Coder. Approuvez le plan et laissez-le travailler, en lui demandant de se vérifier en cours de route.
Valider et livrer. Relisez le résultat, puis demandez-lui un commit avec un message clair et, au besoin, une demande de fusion.

Pour une petite correction évidente, sautez le plan : si vous pouvez décrire le changement en une phrase, demandez-le directement.

Donnez-lui un moyen de vérifier son travail

C'est le conseil le plus utile. Sans vérification, Claude Code s'arrête quand le travail « a l'air fini ». Avec des tests, une compilation ou une capture d'écran à comparer, il travaille, vérifie, corrige et recommence jusqu'à ce que ça passe.

écris une fonction validerCourriel. Cas de test : nom@exemple.com est valide,
nom@.com ne l'est pas. Lance les tests après l'avoir écrite et corrige les échecs.

Soyez précis

Nommez les fichiers, le scénario et ce que « réglé » veut dire. « Corrige le bogue de connexion » donne moins bien que « après l'expiration de la session, la connexion échoue ; regarde le renouvellement du jeton dans src/auth, écris un test qui reproduit le problème, puis corrige-le ». Vous pouvez désigner un fichier avec @, coller une capture d'écran ou un message d'erreur.

Gérez le contexte

Tout ce qui se passe dans une session, messages, fichiers lus, résultats de commandes, occupe la « fenêtre de contexte » de l'IA. Quand elle se remplit, la qualité baisse. Quelques réflexes :

/clear entre deux tâches sans rapport ;
après deux corrections ratées sur le même problème, repartez avec /clear et une demande plus précise ;
/compact pour résumer une longue session en gardant l'essentiel ;
Échap deux fois (avec la zone de saisie vide), ou /rewind, pour revenir à un point précédent de la conversation, du code, ou des deux.

Ces retours en arrière ne remplacent pas Git : committez souvent.

Aller plus loin

MCP : un standard ouvert pour brancher Claude Code sur d'autres outils (gestion de tâches, bases de données, documents).
Compétences (skills) : des fichiers SKILL.md qui décrivent un savoir-faire ou une procédure réutilisable, appelée par exemple avec /nom-de-la-competence.
Crochets (hooks) : des commandes lancées automatiquement à des moments précis, par exemple formater chaque fichier modifié. Contrairement à CLAUDE.md, ils s'appliquent à coup sûr.
Sous-agents : des assistants spécialisés qui travaillent dans leur propre contexte, par exemple pour une revue de sécurité.
Mode non interactif : claude -p dans un script ou une intégration continue.

Comment on l'utilise chez NRX3

On développe avec Claude Code tous les jours, mais l'outil ne livre jamais seul. Chaque projet a ses règles écrites, chaque modification passe par des tests automatisés, et une personne relit, comprend et approuve le code avant qu'il arrive chez le client. L'IA accélère le travail ; la responsabilité, elle, reste humaine.

La documentation officielle d'Anthropic, en anglais, va beaucoup plus loin : c'est la référence à consulter, et elle change souvent. Les liens sont ci-dessous.