Installation et premier lancement - Aide-memoire

Cet aide-mémoire regroupe toutes les commandes et raccourcis pour installer Claude Code, s'authentifier et explorer un codebase en quelques minutes. Gardez cette fiche pratique sous la main pour configurer votre environnement sans friction et lancer vos premières sessions de développement assisté par IA.

Claude Code est un agent de développement en ligne de commande créé par Anthropic qui s'intègre directement dans votre terminal pour analyser, modifier et générer du code. La méthode recommandée est l'installateur natif, un binaire autonome qui se met à jour automatiquement et ne nécessite pas Node.js. Un compte Anthropic actif (ou un accès via un fournisseur cloud supporté) suffit pour démarrer. Cette fiche pratique d'installation et premier lancement constitue un aide-mémoire de référence rapide couvrant les commandes essentielles, de la mise en place à la navigation dans votre projet.

Claude Code fonctionne sur macOS, Linux et Windows. L'installation prend généralement quelques minutes sur une connexion standard.

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

Avant toute installation, vérifiez que votre machine dispose des éléments nécessaires. Avec l'installateur natif (méthode recommandée), aucun runtime particulier n'est requis : le binaire est autonome. Node.js n'est nécessaire que si vous choisissez la méthode npm. Consultez la checklist d'installation complète pour ne rien oublier.

Les fournisseurs cloud supportés sont Amazon Bedrock, Google Vertex AI et Microsoft Foundry. Sur Windows natif, Git pour Windows est recommandé afin que l'outil Bash fonctionne correctement.

Pour résoudre les problèmes courants, le guide de dépannage installation détaille chaque cas d'erreur.

À retenir : l'installateur natif ne requiert aucun runtime particulier. Node.js 18+ n'est nécessaire que pour la méthode npm. Git est recommandé pour l'intégration, et un compte Anthropic actif (ou un accès cloud supporté) est indispensable pour s'authentifier.

Comment installer Claude Code ?

La méthode recommandée est l'installateur natif : un binaire autonome qui se met à jour automatiquement et ne dépend pas de Node.js. Ouvrez votre terminal et exécutez la commande correspondant à votre système :

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

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

Vérifiez ensuite l'installation :

claude --version

Plusieurs alternatives de premier rang existent selon votre gestionnaire de paquets préféré :

L'installateur natif et Homebrew installent un binaire autonome, sans Node.js. La méthode npm reste une alternative secondaire et constitue le seul chemin qui nécessite Node.js 18+ ; elle n'est utile que si vous préférez gérer Claude Code via npm.

# Alternative npm (nécessite Node.js 18+)
npm install -g @anthropic-ai/claude-code

# Mettre à jour Claude Code (installateur natif)
claude update

Pour un guide pas à pas avec captures d'écran, consultez le tutoriel d'installation et premier lancement qui couvre chaque étape en détail.

À retenir : privilégiez l'installateur natif, autonome et auto-mis à jour, sans Node.js. Homebrew, WinGet et les gestionnaires Linux sont des alternatives de premier rang. La méthode npm est secondaire et seule à requérir Node.js 18+.

Comment s'authentifier et configurer le flux OAuth ?

Au premier lancement, Claude Code déclenche un flux d'authentification OAuth dans votre navigateur. Lancez simplement claude dans votre terminal :

# Premier lancement - ouvre le navigateur automatiquement
claude

# Si le navigateur ne s'ouvre pas, copiez l'URL affichée
# et collez-la manuellement dans votre navigateur

Voici comment le processus se déroule concrètement :

1. Exécutez claude dans votre terminal
2. Le navigateur s'ouvre sur la page de connexion Anthropic
3. Connectez-vous avec votre compte Anthropic (email ou Google SSO)
4. Autorisez l'accès pour Claude Code
5. Le terminal confirme l'authentification avec un message de succès
6. Votre token est stocké localement dans ~/.claude/

Vos identifiants sont stockés localement après connexion ; vous n'aurez normalement pas besoin de vous reconnecter.

Pour les environnements CI/CD, utilisez une variable d'environnement plutôt que le flux interactif :

export ANTHROPIC_API_KEY="sk-ant-..."
claude --print "votre prompt"

Le guide des astuces pour vos premières conversations explique comment tirer le meilleur parti de votre session une fois authentifié.

À retenir : le flux OAuth est automatique au premier claude. Vos identifiants sont ensuite stockés localement, et la variable ANTHROPIC_API_KEY permet de contourner l'authentification interactive.

Quelles sont les commandes essentielles pour le premier lancement ?

Voici les commandes les plus fréquentes à connaître dès votre premier lancement. Ce tableau constitue votre fiche pratique d'installation et premier lancement avec les commandes essentielles.

Naviguez d'abord dans le répertoire de votre projet, puis lancez Claude Code :

cd ~/mon-projet
claude
# Claude analyse automatiquement la structure du projet

Claude Code n'indexe pas le codebase au démarrage : il lit les fichiers à la demande, selon vos questions. Le lancement est donc quasi immédiat, quelle que soit la taille du projet.

La référence des commandes slash essentielles approfondit chaque commande disponible dans la session interactive. Vous pouvez aussi consulter l'aide-mémoire des commandes slash pour une vue d'ensemble rapide.

À retenir : claude seul suffit pour démarrer. Ajoutez --print pour du scripting et --verbose pour diagnostiquer un problème.

Comment explorer et comprendre son codebase avec Claude Code ?

Une fois dans une session interactive, Claude Code analyse automatiquement votre codebase. Posez vos questions en langage naturel pour naviguer dans le code.

Concrètement, Claude Code lit les fichiers à la demande. Il n'indexe pas tout le codebase au démarrage : il explore de manière contextuelle selon vos questions.

Les commandes slash internes enrichissent l'exploration. Utilisez /init pour créer un fichier CLAUDE.md qui stocke le contexte de votre projet :

# Dans la session Claude Code interactive
> /init
# Génère un CLAUDE.md avec l'architecture détectée

Le système de mémoire CLAUDE.md vous permet de personnaliser durablement le comportement de Claude Code sur votre projet. Plus votre CLAUDE.md est précis, plus les réponses sont pertinentes.

En pratique, un fichier CLAUDE.md bien renseigné réduit significativement le nombre de tokens consommés par session.

À retenir : posez vos questions en français naturel, et utilisez /init pour créer un fichier CLAUDE.md qui mémorise le contexte de votre projet entre les sessions.

Quels raccourcis clavier maîtriser pour naviguer efficacement ?

Les raccourcis clavier accélèrent votre workflow dans la session interactive Claude Code. Mémorisez ces combinaisons pour gagner en productivité.

Note sur les messages multi-lignes : Shift + Entrée est natif dans iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal et Windows Terminal. Dans VS Code, Cursor, Windsurf, Alacritty ou Zed, exécutez d'abord /terminal-setup pour installer le raccourci. Partout ailleurs, utilisez \ + Entrée ou Ctrl + J, qui fonctionnent sans configuration.

Vous pouvez aussi utiliser des commandes slash directement dans la session pour contrôler le comportement :

Concrètement, la commande /compact résume la conversation pour libérer de l'espace de contexte, ce qui vous permet de continuer une longue session sans perte de cohérence.

L'aide-mémoire des permissions et sécurité détaille comment configurer les autorisations de fichiers. Consultez aussi les astuces des commandes slash essentielles pour des usages avancés.

À retenir : Ctrl + C pour annuler, Ctrl + D pour quitter, /compact pour libérer du contexte : ces trois raccourcis couvrent la majorité des besoins de navigation.

Faut-il configurer des paramètres avancés dès le premier lancement ?

Certains paramètres méritent d'être ajustés dès la première session pour optimiser votre expérience. Configurez au minimum le modèle par défaut et les permissions de fichiers.

En session interactive, utilisez les commandes slash pour ajuster vos paramètres :

# Changer le modèle en session
claude> /model

# Choisir le thème
claude> /theme

Le modèle par défaut dépend de votre formule : Sonnet 4.6 sur Pro et Team Standard, Opus 4.8 sur Max, Team Premium, Enterprise et l'API. Le modèle Claude Sonnet 4.6 offre un ratio performance/coût optimal pour la grande majorité des tâches de développement quotidiennes. Le modèle Opus 4.8 excelle sur les tâches de refactoring complexes et d'architecture.

Si vous souhaitez approfondir la configuration, la référence des commandes pour vos premières conversations couvre les options avancées disponibles en session interactive.

À retenir : configurez le modèle par défaut et les permissions de lecture dès la première session : vous gagnerez du temps sur chaque interaction suivante.

Comment aller plus loin après l'installation ?

Une fois Claude Code installé et configuré, vous pouvez exploiter tout le potentiel de l'outil. Voici les prochaines étapes recommandées pour progresser.

1. Créez votre fichier CLAUDE.md avec /init pour ancrer le contexte projet
2. Explorez les commandes slash avec /help pour découvrir les fonctionnalités avancées
3. Testez le mode multi-fichiers en demandant un refactoring sur 2-3 fichiers
4. Configurez les serveurs MCP pour connecter des outils externes (bases de données, API)
5. Automatisez avec le mode --print dans vos scripts de CI/CD

En pratique, les développeurs formés rapportent un gain de productivité significatif dès la première semaine d'utilisation de Claude Code dans leur workflow quotidien.

Pour maîtriser Claude Code en conditions réelles, la formation Claude Code de SFEIR Institute propose une journée intensive avec des labs pratiques couvrant l'installation, la configuration et les cas d'usage avancés. Si vous souhaitez intégrer Claude Code dans un workflow complet de développement assisté par IA, la formation Développeur Augmenté par l'IA de 2 jours couvre l'ensemble des outils et méthodologies.

Les développeurs expérimentés peuvent directement accéder à la formation Développeur Augmenté par l'IA – Avancé d'une journée pour approfondir les techniques de prompt engineering et d'orchestration multi-agents.

À retenir : l'installation n'est que le début. Investissez 15 minutes dans la configuration de CLAUDE.md et des permissions pour transformer Claude Code en véritable copilote de développement.