Installation et premier lancement - Démarrage rapide

Installez Claude Code et lancez votre première analyse de codebase en moins de 5 minutes. Ce guide de démarrage rapide couvre l'installeur natif recommandé, les alternatives Homebrew, WinGet et npm, l'authentification OAuth et la prise en main immédiate de l'outil, étape par étape, sans détour.

L'installation de Claude Code est la première étape pour démarrer avec cet assistant de développement en ligne de commande créé par Anthropic. La méthode recommandée par Anthropic est l'installeur natif, un binaire autonome qui se met à jour automatiquement et ne nécessite pas Node.js. Claude Code s'installe en une seule commande et comprend les principaux langages et frameworks de développement.

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

Avant de lancer l'installation, vérifiez que votre poste dispose des éléments suivants :

• 4 Go+ de RAM et un processeur x64 ou ARM64
• Un terminal : Terminal.app (macOS), Windows Terminal ou tout émulateur Linux
• Git (optionnel, recommandé ; sur Windows natif, Git for Windows est conseillé pour que l'outil Bash fonctionne)
• Node.js 18+ uniquement si vous choisissez la méthode d'installation via npm (ce n'est pas un prérequis de Claude Code en général)
• Un compte : 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)

L'installeur natif n'exige aucun runtime préinstallé. Node.js 18+ n'est requis que si vous optez pour l'installation via npm. Pour un guide détaillé de chaque composant, consultez le tutoriel complet d'installation et premier lancement qui couvre aussi les configurations avancées.

À retenir : l'installeur natif ne nécessite aucun runtime ; Node.js 18+ n'est requis que pour la méthode npm, et Git reste optionnel mais recommandé.

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.

Sur macOS, Linux ou WSL, ouvrez votre terminal et exécutez :

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

L'installeur natif télécharge le binaire et se charge ensuite de ses propres mises à jour. Vous pouvez forcer une mise à jour à tout moment avec claude update.

Vérifiez que l'installation a fonctionné :

claude --version

Vous devez obtenir un numéro de version confirmant l'installation.

Alternatives via un gestionnaire de paquets

Plusieurs gestionnaires de paquets installent Claude Code comme alternatives de premier plan.

Avec Homebrew (macOS et Linux) :

brew install --cask claude-code

Homebrew ne gère pas l'auto-mise à jour : utilisez brew upgrade claude-code pour passer à la dernière version.

Avec WinGet (Windows) :

winget install Anthropic.ClaudeCode

WinGet ne gère pas non plus l'auto-mise à jour : utilisez winget upgrade Anthropic.ClaudeCode.

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

Installation via npm (alternative)

L'installation via npm est une alternative secondaire. C'est la seule méthode qui nécessite Node.js 18+ ; ce prérequis ne concerne donc que ce chemin d'installation, pas Claude Code en général.

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

Avec cette méthode, mettez Claude Code à jour en réinstallant le paquet.

Pour les cas spécifiques comme les proxys d'entreprise, la FAQ d'installation et premier lancement répond aux problèmes les plus fréquents. Vous y trouverez aussi les solutions pour les environnements contraints.

À retenir : l'installeur natif (curl ... install.sh ou irm ... install.ps1) est la méthode recommandée et sans Node.js ; npm reste une alternative qui, seule, exige Node.js 18+.

Comment résoudre l'authentification et le flux OAuth au premier lancement ?

L'authentification OAuth est le mécanisme qui relie Claude Code à votre compte Anthropic. Lancez Claude Code pour la première fois :

claude

Un lien s'affiche dans le terminal. Ouvrez ce lien dans votre navigateur. Vous êtes redirigé vers la page de connexion Anthropic où vous autorisez Claude Code à accéder à votre compte.

le token OAuth est stocké localement dans ~/.claude/ et se renouvelle automatiquement. Concrètement, vous ne devez vous authentifier qu'une seule fois par machine. Pour changer de compte au sein d'une session, tapez la commande /login.

Si le navigateur ne s'ouvre pas automatiquement, copiez l'URL manuellement. Pour les environnements sans interface graphique (serveurs, conteneurs Docker), utilisez une clé API :

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

En cas de problème d'authentification, le guide des permissions et sécurité détaille les modes d'autorisation disponibles et les bonnes pratiques pour sécuriser votre configuration.

À retenir : le flux OAuth se fait une seule fois. Claude Code stocke et renouvelle le token automatiquement.

Comment comprendre son codebase avec Claude Code en 5 minutes ?

Comprendre son codebase avec Claude en 5 minutes est possible dès le premier lancement. Naviguez vers la racine de votre projet et lancez Claude Code :

cd /chemin/vers/votre-projet
claude

Claude Code n'analyse pas le projet à l'avance : il explore les fichiers pertinents à la demande (lecture de fichiers, recherche via ripgrep) au fil de vos questions. Posez-lui directement vos questions en langage naturel.

Voici comment exploiter les commandes les plus utiles au démarrage :

> Explique l'architecture de ce projet
> Quels sont les points d'entrée principaux ?
> Résume le contenu du fichier src/index.ts
> Trouve tous les appels API dans ce projet

En pratique, Claude Code ne pré-indexe pas votre projet. À chaque question, il explore les fichiers pertinents à la demande (lecture de fichiers, recherche via ripgrep) pour comprendre l'architecture, sans configuration préalable.

Pour aller plus loin dans l'exploration, les commandes slash essentielles vous permettent d'interagir plus efficacement avec l'outil. Vous pouvez aussi consulter les exemples de premières conversations pour découvrir des cas d'usage concrets.

Le temps de réponse dépend de la taille du projet et du nombre d'allers-retours nécessaires : comptez généralement quelques secondes.

À retenir : lancez claude à la racine de votre projet et posez vos questions, aucune configuration n'est nécessaire.

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

Les raccourcis clavier de Claude Code permettent de naviguer sans quitter le terminal. Voici les combinaisons et commandes les plus utiles à mémoriser dès le premier jour :

Testez immédiatement la commande /help pour afficher la liste complète des options disponibles :

> /help

Les commandes slash constituent le cœur de l'interaction avancée avec Claude Code. Essayez /init pour générer un fichier CLAUDE.md qui servira de mémoire persistante à votre assistant. Pour maîtriser l'ensemble des raccourcis, le guide des commandes slash avec exemples propose des scénarios pas à pas.

Concrètement, la commande /init génère un fichier CLAUDE.md qui personnalise le comportement de Claude Code pour votre projet. Le tutoriel sur le système de mémoire CLAUDE.md explique comment exploiter cette fonctionnalité pour que Claude retienne vos préférences et conventions d'équipe.

À retenir : /help, Tab et Ctrl+C sont les trois raccourcis à connaître dès la première session.

Comment vérifier que tout fonctionne correctement ?

Après l'installation, exécutez cette séquence de vérification complète :

claude --version # Vérifier l'installation
claude "Dis bonjour" # Tester la connexion API
claude "Quel OS ?" # Valider l'exécution de commandes

Si les trois commandes retournent un résultat, votre installation est opérationnelle. Le temps total de vérification ne dépasse pas 30 secondes.

Checklist rapide :

1. claude --version affiche un numéro de version → installation OK
2. claude "Dis bonjour" retourne une réponse → authentification OK
3. claude dans un dépôt Git → analyse de codebase OK

En cas d'erreur, les causes les plus fréquentes sont : un proxy non configuré, un token expiré, ou, si vous avez choisi la méthode npm, une version de Node.js inférieure à 18. L'aide-mémoire d'installation rassemble toutes les commandes de diagnostic sur une seule page.

SFEIR Institute propose une formation dédiée Claude Code d'une journée qui vous permet de maîtriser l'outil à travers des labs pratiques, de l'installation jusqu'aux workflows avancés. Pour ceux qui souhaitent intégrer Claude Code dans une approche plus large, la formation Développeur Augmenté par l'IA sur 2 jours couvre l'ensemble des outils d'assistance au développement.

À retenir : trois commandes suffisent pour valider une installation complète de Claude Code.

Quelles sont les prochaines étapes après l'installation ?

Votre environnement Claude Code est prêt. Voici comment approfondir votre maîtrise de l'outil :

• Explorez vos premières conversations avec Claude Code pour apprendre à formuler des requêtes efficaces
• Configurez le système de mémoire CLAUDE.md pour personnaliser Claude Code sur votre projet
• Découvrez le MCP (Model Context Protocol) pour connecter Claude Code à des outils externes comme des bases de données ou des API
• Maîtrisez les commandes slash essentielles pour accélérer chaque interaction

En pratique, les développeurs qui configurent CLAUDE.md dès le premier jour gagnent en productivité. La formation Développeur Augmenté par l'IA – Avancé d'une journée vous apprend à exploiter les patterns avancés comme les agents autonomes et l'intégration CI/CD.

À retenir : configurez CLAUDE.md et explorez les commandes slash pour tirer le meilleur parti de Claude Code dès vos premiers jours.