Installation et premier lancement - Tutoriel

Ce tutoriel vous guide pas à pas pour installer Claude Code sur votre machine, configurer l'authentification OAuth et lancer votre première analyse de codebase. En 30 minutes, vous passerez d'un terminal vierge à un assistant IA opérationnel capable de naviguer dans vos projets.

Claude Code est l'interface en ligne de commande (CLI) développée par Anthropic qui permet aux développeurs d'interagir avec le modèle Claude directement depuis leur terminal. plus de 500 000 développeurs utilisent Claude Code au quotidien pour accélérer leur workflow de développement.

L'outil s'installe via npm en moins de 2 minutes et fonctionne sur macOS, Linux et Windows via WSL2. Ce guide d'installation et premier lancement couvre chaque étape, des prérequis système jusqu'à la maîtrise des raccourcis clavier, pour que vous soyez productif dès la première session.

Quels sont les prérequis système pour installer Claude Code ?

Avant de lancer l'installation, vérifiez que votre environnement remplit les conditions minimales. Claude Code nécessite Node.js en version 18 ou supérieure et Git installé sur votre système. En pratique, 90 % des erreurs d'installation proviennent d'une version de Node.js obsolète.

Exécutez ces trois commandes pour valider votre environnement :

node --version
npm --version
git --version

Si Node.js n'est pas installé, utilisez nvm (Node Version Manager) pour l'installer proprement. Nvm est un gestionnaire de versions qui permet de basculer entre différentes versions de Node.js en une commande. Vous trouverez des détails complémentaires dans le guide de démarrage rapide de l'installation.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 22

⚠️ Si vous voyez nvm: command not found, relancez votre terminal ou exécutez source ~/.zshrc (macOS) / source ~/.bashrc (Linux).

Node.js 22 LTS offre des performances 15 % supérieures à Node.js 18 pour les opérations CLI intensives. Privilégiez cette version pour une expérience optimale avec Claude Code.

À retenir : Node.js 18+, npm 9+ et Git 2.30+ sont les trois prérequis indispensables avant toute installation de Claude Code.

Comment installer Claude Code via npm ? (Étape 1)

Ouvrez votre terminal et lancez l'installation globale avec npm. Une seule commande suffit :

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

✅ Vérification (~30 secondes) : exécutez claude --version pour confirmer l'installation. Vous devez obtenir un numéro de version, par exemple claude-code v1.0.32.

⚠️ Si vous voyez EACCES: permission denied, ne lancez pas sudo npm install. Corrigez plutôt les permissions npm avec mkdir ~/.npm-global && npm config set prefix '~/.npm-global', puis ajoutez export PATH=~/.npm-global/bin:$PATH à votre fichier ~/.bashrc ou ~/.zshrc.

Le paquet pèse environ 45 MB une fois installé. Pour les environnements qui nécessitent une installation locale au projet, vous pouvez aussi utiliser npx sans installation globale. Concrètement, la commande npx @anthropic-ai/claude-code télécharge et exécute Claude Code en une seule étape. Consultez la FAQ d'installation pour les cas d'utilisation avancés comme l'installation derrière un proxy d'entreprise.

À retenir : l'installation globale via npm install -g est la méthode recommandée pour 95 % des développeurs.

Comment lancer Claude Code pour la première fois ? (Étape 2)

Naviguez dans un répertoire de projet existant, puis lancez Claude Code :

cd ~/votre-projet
claude

✅ Vérification (~10 secondes) : un écran d'accueil interactif s'affiche avec le prompt claude> prêt à recevoir vos instructions.

Au premier lancement, Claude Code analyse la structure du répertoire courant en moins de 3 secondes pour un projet de 10 000 fichiers. L'outil détecte automatiquement le langage principal, le framework utilisé et les fichiers de configuration présents. Vous pouvez aussi lancer Claude Code sans projet pour poser des questions générales.

Si vous souhaitez approfondir les différentes façons de démarrer une conversation, le guide des premières conversations avec Claude Code propose des exemples concrets adaptés à chaque situation.

⚠️ Si vous voyez Error: Could not find project root, vérifiez que vous êtes dans un répertoire contenant au minimum un fichier (même vide). Claude Code a besoin d'un contexte de travail.

À retenir : lancez toujours Claude Code depuis la racine de votre projet pour qu'il ait accès à l'ensemble de votre codebase.

Comment s'authentifier avec le flux OAuth ? (Étape 3)

Exécutez claude dans votre terminal. Lors du premier lancement, l'outil vous propose automatiquement l'authentification :

claude
# → "Would you like to authenticate? (Y/n)"
# → Appuyez sur Y, puis Entrée

✅ Vérification (~1 minute) : une page de connexion s'ouvre dans votre navigateur par défaut. Connectez-vous avec votre compte Anthropic, puis revenez au terminal.

Claude Code utilise le protocole OAuth 2.0 avec PKCE (Proof Key for Code Exchange) pour sécuriser l'échange de tokens. PKCE est une extension OAuth qui protège contre l'interception du code d'autorisation. Aucun token n'est stocké en clair sur votre disque : les identifiants sont chiffrés dans le trousseau système (Keychain sur macOS, libsecret sur Linux).

Pour les environnements serveur sans navigateur, définissez une clé API en variable d'environnement :

export ANTHROPIC_API_KEY="sk-ant-api03-votre-cle-ici"
claude

le flux OAuth est recommandé pour les postes développeurs car il offre un renouvellement automatique et une révocation centralisée. La clé API reste utile pour les pipelines CI/CD et les environnements headless. Pour comprendre comment Claude Code gère les permissions après l'authentification, consultez le guide des permissions et de la sécurité.

⚠️ Si le navigateur ne s'ouvre pas automatiquement, copiez l'URL affichée dans le terminal et collez-la manuellement dans votre navigateur.

À retenir : OAuth avec PKCE est la méthode d'authentification par défaut ; elle ne stocke aucun secret en clair et se renouvelle automatiquement tous les 30 jours.

Comment analyser et comprendre votre codebase avec Claude Code ?

Une fois authentifié, vous pouvez demander à Claude Code d'explorer votre projet. Voici comment obtenir une vue d'ensemble en quelques secondes. Tapez directement vos questions en langage naturel dans le prompt.

claude> Explique-moi la structure de ce projet
claude> Quelles sont les dépendances principales ?
claude> Montre-moi les points d'entrée de l'application

Claude Code parcourt l'arborescence, lit les fichiers de configuration (package.json, tsconfig.json, Dockerfile, etc.) et produit un résumé structuré. En pratique, l'analyse d'un projet de 50 000 lignes de code prend entre 5 et 15 secondes selon la complexité.

Vous pouvez aussi poser des questions ciblées sur des fichiers spécifiques :

claude> Que fait la fonction handleAuth dans src/auth.ts ?
claude> Y a-t-il des vulnérabilités dans ce fichier ?

La capacité de contexte de Claude Code atteint 200 000 tokens, soit environ 150 000 mots de code source analysables en une seule conversation. Pour maîtriser la gestion du contexte et éviter les dépassements, explorez les techniques décrites dans le guide de gestion du contexte.

Le fichier CLAUDE.md à la racine de votre projet permet de fournir des instructions persistantes à Claude Code. CLAUDE.md est un fichier de mémoire que Claude Code lit automatiquement à chaque lancement. Créez-le pour indiquer les conventions de votre équipe. Le tutoriel dédié au système de mémoire CLAUDE.md vous montre comment structurer ce fichier pour des résultats optimaux.

claude> /init
# → Claude Code génère un fichier CLAUDE.md adapté à votre projet

À retenir : Claude Code comprend votre codebase en langage naturel - posez vos questions directement, sans syntaxe spéciale.

Quels sont les raccourcis clavier et commandes de navigation essentiels ?

La productivité avec Claude Code passe par la maîtrise des raccourcis. Mémorisez ces combinaisons pour gagner du temps à chaque session. En pratique, les développeurs qui utilisent les raccourcis clavier réduisent leur temps d'interaction de 40 % par rapport à la saisie manuelle complète.

Les commandes slash constituent le système de navigation principal. Une commande slash est un raccourci textuel commençant par / qui déclenche une action prédéfinie. Découvrez l'ensemble des commandes slash dans le guide des commandes essentielles et le tutoriel avancé des commandes slash.

claude> /help          # Affiche toutes les commandes disponibles
claude> /clear         # Repart d'une conversation vierge
claude> /compact       # Résume la conversation pour libérer du contexte
claude> /config        # Ouvre les paramètres de configuration

La commande /compact est particulièrement utile pour les longues sessions. Elle compresse l'historique de conversation en conservant les informations clés, libérant ainsi jusqu'à 60 % du contexte disponible.

À retenir : Tab pour accepter, Ctrl+C pour annuler, /compact pour libérer du contexte - ces trois raccourcis couvrent 80 % des interactions quotidiennes.

Comment intégrer Claude Code dans votre workflow Git ?

Claude Code s'intègre nativement avec Git pour automatiser les tâches répétitives. Utilisez-le pour générer des messages de commit, créer des pull requests et résoudre des conflits. l'intégration Git supporte tous les fournisseurs (GitHub, GitLab, Bitbucket).

claude> Crée un commit avec les changements actuels
claude> Génère une PR avec un résumé des modifications
claude> Aide-moi à résoudre le conflit dans src/index.ts

Concrètement, Claude Code analyse le diff Git, comprend le contexte sémantique des changements et produit des messages de commit conformes aux conventions de votre projet (Conventional Commits, Gitmoji, etc.). l'utilisation de Claude Code pour la génération de commits réduit le temps de revue de code de 25 %.

Pour exploiter toutes les fonctionnalités Git de Claude Code, consultez le guide complet d'intégration Git avec exemples pratiques. Vous y trouverez des workflows pour le rebase interactif, le cherry-pick assisté et la résolution automatique de conflits.

Si vous souhaitez aller plus loin dans la maîtrise de Claude Code, SFEIR Institute propose la formation Claude Code sur une journée. Vous y pratiquerez l'installation, la configuration avancée et les cas d'usage réels en entreprise à travers des labs encadrés par des formateurs certifiés.

À retenir : Claude Code génère des commits, des PR et résout les conflits Git directement depuis le terminal, sans changer d'outil.

Quelles erreurs courantes éviter lors de l'installation ?

Voici les 5 problèmes les plus fréquents rencontrés par les développeurs lors de leur première installation, avec leurs solutions. SFEIR Institute a compilé ces retours à partir de centaines de sessions de formation.

1. Version de Node.js incompatible

# Erreur : "engine" requirements not met
nvm install 22 && nvm use 22

L'erreur survient dans 35 % des cas sur les machines avec Node.js 16 préinstallé.

2. Permissions npm globales

# Erreur : EACCES permission denied
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

3. Proxy d'entreprise bloquant OAuth

# Solution : utiliser une clé API
export ANTHROPIC_API_KEY="sk-ant-api03-..."
export HTTPS_PROXY="http://proxy.entreprise.com:8080"

4. WSL2 sans navigateur configuré

# Solution : définir le navigateur par défaut
export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"

5. Pare-feu bloquant les WebSockets

Claude Code utilise des connexions WebSocket sur le port 443. WebSocket est un protocole de communication bidirectionnelle persistante entre le client et le serveur. Vérifiez que votre pare-feu autorise les connexions sortantes sur ce port.

Pour d'autres cas de figure, la FAQ complète de l'installation couvre plus de 20 scénarios de dépannage avec des solutions testées.

À retenir : 90 % des problèmes d'installation se résolvent en mettant à jour Node.js et en corrigeant les permissions npm.

Comment aller plus loin après l'installation ?

Vous avez installé Claude Code, configuré l'authentification et exploré votre premier projet. Passez maintenant à la vitesse supérieure avec ces ressources et pratiques avancées.

Prochaines étapes recommandées :

1. Configurez le fichier CLAUDE.md pour personnaliser le comportement de Claude Code sur chaque projet
2. Explorez les commandes slash avancées (/compact, /config, /cost)
3. Intégrez Claude Code dans votre pipeline CI/CD pour l'analyse automatique de PR
4. Testez le mode multi-fichiers pour les refactorisations à grande échelle
5. Activez les hooks personnalisés pour automatiser les vérifications pré-commit

Pour approfondir chacun de ces sujets, consultez la page d'installation et premier lancement qui centralise l'ensemble des guides disponibles.

La formation Développeur Augmenté par l'IA proposée par SFEIR Institute sur 2 jours couvre l'utilisation avancée de Claude Code combinée à d'autres outils d'IA. Vous y apprendrez à orchestrer plusieurs assistants IA dans un workflow professionnel complet avec des exercices pratiques sur des projets réels. Pour ceux qui maîtrisent déjà les bases, la formation Développeur Augmenté par l'IA – Avancé sur une journée aborde les stratégies d'optimisation de prompts, la gestion fine du contexte et l'intégration dans les architectures d'entreprise.

À retenir : l'installation n'est que le début - configurez CLAUDE.md, maîtrisez les commandes slash et intégrez Claude Code dans votre pipeline CI/CD pour en tirer le maximum.