Installer et configurer Claude Code : le guide complet

Claude Code, c’est quoi exactement ?

Claude Code est l’outil CLI officiel d’Anthropic pour le développement assisté par IA. Contrairement à une extension d’éditeur comme Copilot ou Cursor, Claude Code fonctionne directement dans votre terminal. Il lit votre codebase, édite vos fichiers, exécute des commandes et peut enchaîner des actions complexes de façon autonome.

Le terme clé : agentic. Vous décrivez ce que vous voulez accomplir, Claude Code planifie les étapes et les exécute. Ce n’est pas de l’autocomplétion, c’est un agent de développement.

Quelques chiffres pour situer : plus de 65 000 étoiles sur GitHub, des millions de développeurs actifs, et une adoption qui explose depuis début 2026.

Prérequis

Avant de commencer, vérifiez que vous avez :

Node.js 18 ou supérieur - vérifiez avec node --version
npm - inclus avec Node.js, vérifiez avec npm --version
Un compte Anthropic avec une clé API, ou un abonnement Claude Max (qui inclut l’accès à Claude Code)
Un terminal - Terminal natif sur macOS/Linux, Git Bash ou WSL sur Windows
Git - fortement recommandé (Claude Code fonctionne mieux dans un dépôt Git)

Si Node.js n’est pas installé, récupérez-le sur nodejs.org ou via un gestionnaire de versions comme nvm :

# Installer nvm (macOS/Linux)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Installer Node.js 20 LTS
nvm install 20
nvm use 20

Installation

Une seule commande :

npm install -g @anthropic-ai/claude-code

L’option -g installe Claude Code globalement, ce qui le rend accessible depuis n’importe quel répertoire.

Vérifiez que l’installation s’est bien passée :

claude --version

Vous devriez voir le numéro de version s’afficher. Si vous obtenez une erreur “command not found”, assurez-vous que le répertoire global npm est dans votre PATH.

Première session

Naviguez vers un projet existant (idéalement un dépôt Git) et lancez Claude Code :

cd mon-projet
claude

Au premier lancement, Claude Code vous demande de vous authentifier. Deux options :

Clé API Anthropic - si vous avez un compte API avec des crédits
Claude Max - connexion via votre abonnement Anthropic (OAuth)

Suivez les instructions à l’écran. Une fois connecté, vous arrivez sur le prompt interactif de Claude Code.

Premier test

Tapez simplement une question sur votre projet :

> Explique-moi la structure de ce projet

Claude Code va scanner vos fichiers, comprendre l’arborescence et vous donner un résumé clair. C’est le meilleur moyen de vérifier que tout fonctionne.

Commandes essentielles

Claude Code utilise des commandes préfixées par / pour les actions système :

Commande	Description
`/help`	Affiche toutes les commandes disponibles
`/clear`	Efface le contexte de la conversation en cours
`/compact`	Compresse le contexte pour économiser des tokens
`/status`	Affiche l’état de la session (modèle, tokens utilisés)
`/init`	Génère un fichier CLAUDE.md pour votre projet
`/cost`	Montre la consommation de tokens de la session

La commande /compact est particulièrement utile lors de longues sessions. Elle résume la conversation pour libérer de la place dans la fenêtre de contexte sans perdre le fil.

Concepts clés à comprendre

Lecture du codebase

Quand vous posez une question ou demandez une modification, Claude Code peut lire n’importe quel fichier de votre projet. Il ne charge pas tout en mémoire d’un coup : il explore les fichiers pertinents au fur et à mesure, en fonction de votre demande.

C’est pour ça qu’un projet bien structuré avec des noms de fichiers explicites donne de meilleurs résultats.

Système de permissions

Claude Code demande votre autorisation avant d’exécuter certaines actions :

Lecture de fichiers - généralement autorisée par défaut
Écriture de fichiers - demande confirmation
Exécution de commandes - demande confirmation (surtout les commandes potentiellement destructives)

Vous pouvez répondre :

y (yes) - autoriser cette action
n (no) - refuser
a (always) - toujours autoriser ce type d’action pour cette session

Ce système protège votre projet. Claude Code ne supprimera jamais un fichier ou ne lancera jamais un git push --force sans votre accord explicite.

Le fichier CLAUDE.md

C’est le fichier d’instructions que Claude Code lit au démarrage de chaque session. Il contient le contexte de votre projet, vos conventions, les commandes à utiliser. Générez-en un avec /init et personnalisez-le ensuite.

Nous avons un guide dédié aux bonnes pratiques du CLAUDE.md - c’est la prochaine étape recommandée.

Conseils pour bien démarrer

Travaillez toujours dans un dépôt Git. Claude Code utilise Git pour le suivi des modifications. Sans Git, vous perdez la possibilité de revenir en arrière facilement si une modification ne vous convient pas.

# Si votre projet n'est pas encore un dépôt Git
git init
git add -A
git commit -m "initial commit"

Commencez par des questions simples. Avant de demander un refactoring complet, posez des questions sur votre code : “Explique cette fonction”, “Trouve les bugs potentiels dans ce fichier”, “Quels tests manquent ?”. Vous comprendrez vite comment Claude Code raisonne.

Utilisez /init dès le début. Le fichier CLAUDE.md généré est un bon point de départ. Modifiez-le pour ajouter vos conventions spécifiques.

Soyez précis dans vos demandes. “Corrige le bug” est vague. “Le formulaire de connexion ne valide pas les emails, ajoute une validation côté client avec un message d’erreur en français” est exploitable.

Vérifiez les modifications avant de les accepter. Claude Code affiche un diff avant d’écrire dans vos fichiers. Prenez le temps de le lire, surtout au début.

Commitez souvent. Après chaque modification validée, faites un commit. Si Claude Code part dans une mauvaise direction, un simple git checkout . vous ramène à l’état précédent.

Résolution de problèmes courants

”command not found” après installation

Votre PATH ne contient pas le répertoire global npm. Trouvez-le avec :

npm config get prefix

Ajoutez le sous-répertoire bin à votre PATH dans .bashrc ou .zshrc :

export PATH="$(npm config get prefix)/bin:$PATH"

Authentification qui échoue

Vérifiez que votre clé API est valide sur console.anthropic.com. Si vous utilisez Claude Max, assurez-vous que votre abonnement est actif et inclut l’accès à Claude Code.

Claude Code ne comprend pas mon projet

Le problème vient souvent d’un CLAUDE.md absent ou trop vague. Lancez /init, puis enrichissez le fichier généré avec le contexte de votre stack, vos conventions et la structure du projet.

Et maintenant ?

Vous avez Claude Code installé et fonctionnel. La prochaine étape est de configurer votre fichier CLAUDE.md pour tirer le maximum de l’outil. Consultez notre guide sur les bonnes pratiques du CLAUDE.md pour structurer vos instructions de projet.

Quelques idées pour votre prochaine session :

Demandez à Claude Code d’écrire les tests pour un module existant
Faites-lui refactorer un fichier que vous trouvez trop complexe
Utilisez-le pour documenter une partie obscure de votre code
Explorez un projet open source que vous ne connaissez pas en lui posant des questions