Claude Code CLI : installation et premier lancement

Vous allez installer Claude Code CLI sur votre système, finaliser le premier lancement, puis vérifier que la commande fonctionne avant d’aller vers un workflow complet. L’objectif est simple : obtenir une base fiable et reproductible, sans rentrer encore dans les scénarios avancés de prompting ou d’automatisation.

Ce que vous allez apprendre

• Installer Claude Code CLI sur Linux, macOS ou Windows
• Comprendre les écrans normaux du premier lancement
• Finaliser l’authentification sans rester bloqué
• Vérifier l’état de la CLI avec des commandes de diagnostic

Pourquoi soigner l’installation avant le premier workflow

Ce guide s’adresse aux personnes qui démarrent avec Claude Code CLI et qui veulent une base propre avant d’aller vers des workflows plus complets.

Il répond à une question simple : “comment installer, se connecter et vérifier que tout fonctionne ?”.

L’objectif n’est pas encore de détailler le fonctionnement des sessions, du prompting avancé, ni des mécanismes de gouvernance. Ces sujets sont traités dans le guide suivant.

Prérequis

• Un terminal local (Bash, Zsh, PowerShell ou équivalent)
• Un compte ou un accès compatible Claude Code : Pro, Max, Team, Enterprise, Console, ou un fournisseur API pris en charge
• Un accès Internet

Étape 1 : installer Claude Code CLI

Linux

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

macOS

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

Alternative officielle avec Homebrew :

brew install --cask claude-code

Pour installer la version la plus récente publiée :

brew install --cask claude-code@latest

Windows PowerShell

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

Alternative officielle avec WinGet :

winget install Anthropic.ClaudeCode

Pré-requis Windows natif : installez Git for Windows avant Claude Code. Ce pré-requis ne s’applique pas si vous utilisez WSL.

Windows CMD

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

Alternative officielle avec WinGet (à lancer depuis PowerShell) :

winget install Anthropic.ClaudeCode

Pré-requis Windows natif : installez Git for Windows avant Claude Code. Ce pré-requis ne s’applique pas si vous utilisez WSL.

Étape 2 : vérifier l’installation

1. Ouvrez un nouveau terminal (pour recharger le PATH)

2. Vérifiez la version

   claude --version

3. Lancez le diagnostic de base

   claude doctor

Si la commande est introuvable

Fermez complètement le terminal, rouvrez-en un nouveau, puis relancez claude --version. Si le problème persiste, relancez l’installation et vérifiez les messages de fin d’installation.

Étape 3 : passer le premier lancement

Au premier claude, vous rencontrerez généralement une séquence de configuration visuelle, puis d’authentification, avant d’arriver sur une session prête à l’emploi.

Écran 1 : configuration visuelle

Vous arrivez sur un écran de démarrage qui vous propose un thème d’affichage.

• Utilisez les flèches pour choisir
• Appuyez sur Entrée pour valider
• Vous pourrez modifier ce choix plus tard

Écran 2 : authentification du compte

La CLI affiche ensuite une URL de connexion (OAuth) et peut demander un code de validation.

Procédure recommandée :

1. Copiez l’URL affichée dans le terminal
2. Ouvrez-la dans votre navigateur
3. Connectez-vous à votre compte Claude
4. Si un code est demandé, revenez au terminal
5. Collez le code puis validez avec Entrée

Écran 3 : session prête

Quand l’écran de type « Welcome back » apparaît, la CLI est opérationnelle.

• La ligne > vous permet de saisir vos requêtes
• Le dossier courant indique le contexte de travail
• Vous pouvez lancer une première commande simple pour vérifier le flux

Si le navigateur ne s'ouvre pas

Copiez simplement l’URL affichée dans le terminal, ouvrez-la manuellement, puis revenez coller le code de validation si la CLI le demande.

Étape 4 : Petite découverte de la CLI

Une fois la CLI opérationnelle, prenez 2 minutes pour faire trois réglages utiles.

1. Ouvrez l’aide rapide

   Dans la session CLI, tapez ? pour afficher les raccourcis disponibles.

2. Changez le thème

   Dans la session CLI, tapez :

   /theme

   Choisissez un thème lisible pour vous, puis validez.

3. Passez l’interface en français

   Ouvrez la configuration :

   /config

   Puis sélectionnez la langue d’interface en français si l’option est disponible dans votre version.

À ce stade, ne cherchez pas à tout configurer. L’objectif est simplement de repérer où se trouvent les réglages que vous utiliserez ensuite.

Suite recommandée : passez d’abord au guide Claude Code CLI : créer le projet fil rouge lab-claude pour poser un terrain de pratique unique, puis continuez avec Claude Code CLI : prise en main, commandes et configuration.

Erreurs fréquentes

Symptôme	Cause probable	Correction
claude: command not found	PATH non rechargé	Rouvrir le terminal, puis retester
La connexion boucle	Session navigateur incomplète	Reprendre l’URL de connexion affichée et finaliser le login
claude doctor remonte des avertissements	Dépendance locale manquante	Corriger d’abord les avertissements bloquants, puis relancer

Glissez pour voir

À retenir

• Une installation réussie se valide toujours avec claude --version puis claude doctor
• Le premier lancement avec thème + connexion + écran final est un comportement normal
• Tant que la CLI n’est pas stable, n’enchaînez pas sur des workflows complexes

Prochaines étapes

Vue d'ensemble Claude Code Revenir au positionnement global : moteur, surfaces et 8 leviers

Créer le projet fil rouge lab-claude Préparer un dépôt unique et testable pour toute la série

Prise en main CLI Maîtriser commandes slash, raccourcis, @-mentions et settings.json

×

📖 Voir la documentation →