Installation et premier lancement

Installer Claude Code et le configurer correctement prend moins de 10 minutes si vous suivez les bonnes étapes. Ce guide couvre les prérequis système, l'installation via l'installeur natif recommandé (et les alternatives Homebrew, WinGet et npm), l'authentification OAuth et la prise en main de votre premier projet avec les raccourcis essentiels.

Claude Code installation et premier lancement constitue l'étape fondamentale pour intégrer un agent de développement IA directement dans votre terminal. Claude Code fonctionne sur macOS, Linux et Windows (support natif Windows 10 1809+ ou via WSL). La méthode recommandée est l'installeur natif, un binaire autonome qui se met à jour automatiquement et ne nécessite pas Node.js. Node.js 18 ou supérieur n'est requis que si vous choisissez la méthode alternative via npm. De nombreux développeurs utilisent Claude Code quotidiennement dans leur workflow de développement.

Pour une vue d'ensemble de l'outil, consultez la page dédiée à Claude Code qui présente l'écosystème complet de cet agent de coding.

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

Avant d'installer Claude Code, vérifiez que votre environnement remplit quelques conditions. L'installeur natif recommandé est un binaire autonome : il ne nécessite ni Node.js, ni npm. Node.js 18 ou supérieur n'est requis que si vous optez pour la méthode alternative via npm. Git 2.39+ est recommandé pour l'intégration et l'analyse de dépôts, sans être une dépendance d'installation stricte. Sous Windows en mode natif, Git pour Windows est recommandé afin que l'outil Bash fonctionne. Un terminal compatible (bash, zsh ou PowerShell) complète la liste.

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 ou Microsoft Foundry).

L'espace disque requis se compte en quelques dizaines de Mo pour Claude Code et ses dépendances. Le tutoriel d'installation pas à pas détaille chaque prérequis avec des captures d'écran.

À retenir : l'installeur natif recommandé ne nécessite pas Node.js. Node.js 18+ n'est requis que pour la méthode npm, et Git 2.39+ reste recommandé pour l'intégration de dépôts.

Comment installer Claude Code ?

La méthode recommandée est l'installeur 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 PowerShell :

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

Sur Windows CMD :

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

Plusieurs gestionnaires de paquets sont également pris en charge comme alternatives de premier plan. Sur macOS et Linux, Homebrew installe Claude Code (sans mise à jour automatique : utilisez brew upgrade claude-code) :

brew install --cask claude-code

Sur Windows, WinGet installe Claude Code (sans mise à jour automatique : utilisez winget upgrade Anthropic.ClaudeCode) :

winget install Anthropic.ClaudeCode

Sous Linux, les gestionnaires de paquets de votre distribution sont disponibles : apt (Debian/Ubuntu), dnf (Fedora/RHEL) et apk (Alpine).

En alternative secondaire, vous pouvez installer Claude Code via npm. C'est la seule méthode qui requiert Node.js 18 ou supérieur :

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

Voici comment vérifier que l'installation s'est déroulée correctement :

claude --version

Cette commande affiche le numéro de version installé.

Pour mettre à jour Claude Code installé via l'installeur natif, lancez claude update. Avec Homebrew ou WinGet, utilisez le gestionnaire de paquets (brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode). Avec npm, réinstallez le paquet.

Pour les solutions aux problèmes courants d'installation, la page de dépannage Claude Code couvre les erreurs les plus fréquentes. Consultez également le démarrage rapide pour une mise en route en moins de 5 minutes.

À retenir : l'installeur natif (curl -fsSL https://claude.ai/install.sh | bash) est la méthode recommandée et ne nécessite pas Node.js. Homebrew, WinGet et npm restent des alternatives, npm étant la seule à exiger Node.js 18+.

Comment fonctionne l'authentification OAuth de Claude Code ?

Claude Code utilise un flux OAuth pour vous connecter à votre compte Anthropic. Lancez simplement claude dans votre terminal et le processus démarre automatiquement :

claude
# → Ouverture automatique du navigateur pour l'authentification

Le flux OAuth est le protocole d'authentification standard qui permet à Claude Code d'accéder à l'API Anthropic sans stocker votre mot de passe localement. OAuth est un protocole d'autorisation déléguée largement adopté par les services cloud.

Voici comment se déroule le processus en trois étapes :

1. Exécutez claude - le terminal affiche une URL d'authentification
2. Votre navigateur s'ouvre sur la page de connexion Anthropic
3. Après autorisation, un token de session est stocké localement dans ~/.claude.json

Une fois la connexion effectuée, vos identifiants sont stockés localement et réutilisés d'une session à l'autre : vous n'avez pas besoin de vous reconnecter à chaque lancement. Les réglages utilisateur vivent dans ~/.claude/settings.json, tandis que la session et les identifiants OAuth sont stockés dans ~/.claude.json (à la racine de votre répertoire utilisateur, distinct du dossier ~/.claude/). Si nécessaire, ré-authentifiez-vous avec la commande /login dans une session.

Pour les environnements sans navigateur (serveurs distants, conteneurs Docker, CI), utilisez claude setup-token qui génère un token OAuth de longue durée utilisable dans des scripts ou des pipelines :

claude setup-token
# → Génère un token OAuth réutilisable pour les environnements headless

À l'intérieur d'une session interactive, vous pouvez vous (re)connecter avec la commande slash /login.

Vous pouvez en apprendre davantage sur la sécurisation de votre environnement en consultant la page Permissions et sécurité de notre silo.

À retenir : l'authentification OAuth se fait en une étape via le navigateur, et les identifiants sont stockés localement puis réutilisés d'une session à l'autre.

Comment faire analyser votre codebase par Claude Code ?

Une fois authentifié, Claude Code analyse automatiquement votre projet. Naviguez dans le répertoire de votre projet et lancez Claude :

cd ~/mon-projet
claude

Claude Code lit à la demande les fichiers de configuration de votre projet (package.json, tsconfig.json, .gitignore) pour comprendre le contexte technique, plutôt que de construire un index initial.

En pratique, Claude Code ne pré-indexe pas votre codebase : il lit les fichiers à la demande et s'appuie sur ripgrep pour la recherche. Côté matériel, la documentation recommande 4 GB de RAM au minimum. Voici comment poser vos premières questions à l'agent :

claude "Explique l'architecture de ce projet"
claude "Quels sont les principaux composants ?"
claude "Trouve les fichiers liés à l'authentification"

Le système de mémoire CLAUDE.md permet de stocker des instructions persistantes pour votre projet. Créez un fichier CLAUDE.md à la racine de votre dépôt pour donner du contexte permanent à l'agent. Pour une explication approfondie, consultez le guide sur le système de mémoire CLAUDE.md.

Concrètement, les premières interactions avec Claude Code gagnent en qualité quand vous fournissez du contexte explicite. La page Vos premières conversations propose des exemples de prompts structurés pour chaque type de tâche.

Le concept de coding agentique désigne cette capacité de l'IA à naviguer, comprendre et modifier un codebase de manière autonome.

À retenir : lancez claude à la racine de votre projet pour que l'agent analyse automatiquement la structure et les dépendances.

Quels raccourcis clavier accélèrent votre navigation dans Claude Code ?

Claude Code intègre un système de raccourcis clavier qui accélère significativement votre navigation. Mémorisez ces combinaisons essentielles pour travailler efficacement.

Les commandes slash constituent un système de navigation intégré à Claude Code. La commande /help est le point d'entrée pour découvrir toutes les options disponibles. Tapez /compact quand votre conversation devient longue : la commande résume l'historique pour libérer de la place dans la fenêtre de contexte et continuer à travailler.

Pour une liste exhaustive, la page Les commandes slash essentielles détaille chaque commande avec des exemples concrets. Vous trouverez aussi un récapitulatif imprimable dans l'aide-mémoire dédié.

En pratique, la commande /clear démarre une nouvelle conversation avec un contexte vide, ce qui repart d'une fenêtre de contexte entièrement disponible.

La gestion du contexte est un aspect fondamental pour maintenir des conversations productives avec Claude Code sur des projets complexes.

À retenir : les raccourcis /compact et /clear sont les deux commandes les plus utiles pour gérer les sessions longues.

Comment valider que votre installation fonctionne correctement ?

Après l'installation, exécutez cette séquence de vérification complète pour confirmer que tout fonctionne :

# Vérification de l'installation
claude --version

# Test de conversation
claude "dis bonjour"

Si l'authentification a échoué, relancez le flux OAuth en tapant /login dans une session Claude Code (ou utilisez claude auth login). Vous pouvez aussi utiliser la commande /doctor dans une session Claude Code pour diagnostiquer les problèmes de configuration.

La checklist d'installation propose une liste de points de contrôle pour valider chaque composant.

En cas de problème, la FAQ installation répond aux 20 questions les plus posées par les développeurs lors de leur première mise en place. Vous y trouverez des solutions à la quasi-totalité des cas de figure rencontrés.

À retenir : deux commandes suffisent pour valider une installation : claude --version et claude "dis bonjour". Utilisez /doctor dans une session pour un diagnostic complet.

Pourquoi se former à Claude Code avec SFEIR Institute ?

Installer Claude Code est la première étape. Maîtriser le coding agentique demande une approche structurée que SFEIR Institute propose à travers trois formations complémentaires.

La formation Claude Code d'une journée vous permet de passer de l'installation à une utilisation productive. Vous pratiquerez sur des labs concrets couvrant l'ensemble des fonctionnalités : navigation de codebase, génération de code, débogage assisté et automatisation de tâches.

Pour aller plus loin, la formation Développeur Augmenté par l'IA sur 2 jours intègre Claude Code dans un workflow complet de développement assisté par IA, incluant les tests automatisés et la revue de code. Les développeurs qui souhaitent approfondir les patterns avancés (agents multi-fichiers, orchestration de tâches complexes) peuvent suivre la formation Développeur Augmenté par l'IA – Avancé en 1 jour.

Concrètement, les participants aux formations SFEIR rapportent des gains de productivité significatifs dès la première semaine d'utilisation de Claude Code en conditions réelles.

À retenir : SFEIR Institute propose trois niveaux de formation pour maîtriser Claude Code, de l'initiation en 1 jour à l'expertise avancée.

---