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. De nombreux développeurs utilisent Claude Code au quotidien pour accélérer leur workflow de développement.

L'outil s'installe en moins de 2 minutes et fonctionne sur macOS, Linux et Windows (nativement ou 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. La méthode recommandée par Anthropic, l'installateur natif, est un binaire autonome qui ne nécessite pas Node.js. Node.js 18 ou supérieur n'est requis que si vous choisissez la méthode alternative d'installation via npm. Git est recommandé pour les fonctionnalités liées au versioning ; sur Windows natif, l'installation de Git for Windows est conseillée afin que l'outil Bash fonctionne correctement.

Côté compte, Claude Code requiert un abonnement Claude Pro, Max, Team ou Enterprise, un compte Claude Console, ou un fournisseur cloud pris en charge (Amazon Bedrock, Google Vertex AI, Microsoft Foundry).

Exécutez ces commandes pour vérifier votre environnement :

git --version
uname -a

Si vous prévoyez d'utiliser la méthode npm, vérifiez en complément que Node.js 18 ou supérieur est installé. Vous trouverez des détails complémentaires dans le guide de démarrage rapide de l'installation.

node --version

À retenir : l'installateur natif recommandé ne nécessite pas Node.js ; Node.js 18+ n'est requis que pour la méthode d'installation alternative via npm. Git est recommandé pour les fonctionnalités de versioning (Git for Windows sur Windows natif).

Comment installer Claude Code ? (Étape 1)

La méthode recommandée par Anthropic est l'installateur natif : un binaire autonome qui se met à jour automatiquement et ne nécessite pas Node.js. Ouvrez votre terminal et lancez la commande correspondant à votre système.

Sur macOS, Linux ou WSL :

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

Sur Windows depuis PowerShell :

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

Sur Windows depuis l'invite de commandes (CMD) :

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

Alternatives de premier choix : Homebrew, WinGet et gestionnaires de paquets Linux

Si vous gérez déjà vos outils via un gestionnaire de paquets, ces méthodes sont d'excellentes alternatives.

Homebrew (macOS et Linux) :

brew install --cask claude-code

WinGet (Windows) :

winget install Anthropic.ClaudeCode

Sur Linux, Claude Code est également distribué via les gestionnaires de paquets système : apt (Debian/Ubuntu), dnf (Fedora/RHEL) et apk (Alpine).

ℹ️ Contrairement à l'installateur natif, Homebrew et WinGet ne se mettent pas à jour automatiquement. Mettez Claude Code à jour avec brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode.

Alternative secondaire : installation via npm

L'installation via npm reste disponible comme alternative. C'est la seule méthode qui requiert Node.js 18 ou supérieur.

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

⚠️ Si vous installez via npm et que 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.

Pour mettre à jour Claude Code après une installation native, exécutez claude update ; pour une installation npm, réinstallez le paquet. Consultez la FAQ d'installation pour les cas d'utilisation avancés comme l'installation derrière un proxy d'entreprise.

À retenir : l'installateur natif est la méthode recommandée et ne nécessite pas Node.js ; Homebrew, WinGet et les gestionnaires de paquets Linux sont des alternatives de premier choix ; npm reste une alternative secondaire, et c'est la seule méthode qui exige Node.js 18+.

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) : l'écran d'accueil de Claude Code s'affiche. Vous pouvez y saisir directement vos instructions en langage naturel.

Au premier lancement, Claude Code analyse la structure du répertoire courant. L'outil détecte automatiquement le langage principal, le framework utilisé et les fichiers de configuration présents. Vous pouvez lancer Claude Code dans n'importe quel répertoire, y compris un répertoire vide, 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.

À retenir : lancez 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. Au premier lancement, Claude Code vous invite à vous connecter ; suivez les instructions affichées pour compléter l'authentification dans votre navigateur.

claude

✅ 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.

L'authentification de Claude Code repose sur une connexion via le navigateur. Une fois la connexion validée, les identifiants sont stockés localement dans le répertoire ~/.claude/ et réutilisés automatiquement lors des lancements suivants.

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 : la connexion via le navigateur est la méthode d'authentification par défaut ; vos identifiants sont stockés localement après la première connexion et réutilisés automatiquement, sans avoir à vous reconnecter à chaque session.

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.

Explique-moi la structure de ce projet
Quelles sont les dépendances principales ?
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 initiale ne prend généralement que quelques secondes.

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

Que fait la fonction handleAuth dans src/auth.ts ?
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 texte analysables en une seule conversation (le rendement réel sur du code source varie). 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.

/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, ces raccourcis font gagner un temps notable à chaque session 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.

/help # Affiche toutes les commandes disponibles
/clear # Repart d'une conversation vierge
/compact # Résume la conversation pour libérer du contexte
/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 une grande partie du contexte disponible.

À retenir : Tab pour accepter, Ctrl+C pour annuler, /compact pour libérer du contexte. Ces trois raccourcis couvrent la majorité 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).

Crée un commit avec les changements actuels
Génère une PR avec un résumé des modifications
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 significativement le temps de revue de code.

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 (méthode npm uniquement)

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

Cette erreur ne concerne que l'installation via npm, qui exige Node.js 18+. Si vous rencontrez ce blocage, vous pouvez aussi basculer vers l'installateur natif, qui ne dépend pas de Node.js.

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 connexions HTTPS

Claude Code communique avec l'API Anthropic via des appels HTTPS standard. Vérifiez que votre pare-feu autorise les connexions HTTPS sortantes vers api.anthropic.com sur le port 443.

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 : la plupart des problèmes liés à npm se résolvent en mettant à jour Node.js et en corrigeant les permissions ; pour éviter ces écueils, privilégiez l'installateur natif qui ne dépend pas de Node.js.

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.