Installer Claude Code sur Mac et Windows en 3 étapes (2026)

Avant de commencer la configuration de Claude Code

Vérifiez d'abord ces cinq points. La plupart des installations ratées viennent de l'un d'eux :

Votre travail dans le terminal et vos conversations Claude partagent une même allocation, alors parcourez les limites d'utilisation de Claude Code avant les longues sessions.

Est-ce sûr d'installer Claude Code ?

Oui, tant que la commande vient d'Anthropic. Les installateurs officiels ne téléchargent que depuis claude.ai et downloads.claude.ai, le programme Mac est signé par Anthropic et notarié par Apple, le programme Windows est signé par Anthropic, et tout s'installe dans votre propre dossier utilisateur sans droits administrateur.

Deux habitudes le garantissent : ne collez que des lignes d'installation qui commencent par https://claude.ai/install, jamais une variante trouvée dans la description d'une vidéo, et lancez Claude Code dans un dossier prévu pour lui, car il peut lire tout ce que contient le dossier où vous l'ouvrez.

Quelle méthode d'installation choisir ?

La voie sans terminal : l'application de bureau Claude Code

L'application de bureau est l'application Claude habituelle, avec un onglet Code qui fait tourner Claude Code sur les fichiers de votre ordinateur. Le guide de démarrage de l'application de bureau d'Anthropic propose le téléchargement pour chaque système.

1. Téléchargez l'application pour votre système. La version Mac est un seul téléchargement pour Intel et Apple silicon, Windows sur ARM a son propre installateur, et la version Linux est une bêta qui s'installe avec apt sur Ubuntu et Debian.
2. Installez-la et connectez-vous. Ouvrez Claude depuis Applications ou le menu Démarrer et connectez-vous avec le compte qui a votre forfait payant.
3. Ouvrez l'onglet Code en haut de la fenêtre. S'il vous propose de passer à un forfait supérieur, c'est que ce compte est sur le forfait gratuit.
4. Choisissez un dossier. Sous la zone de saisie, réglez le sélecteur d'environnement sur la première entrée sous Local, puis utilisez le contrôle de dossier juste à côté pour ouvrir un dossier de test vide.
5. Demandez quelque chose. Tapez une demande et appuyez sur Entrée. En mode Manual, Claude montre chaque modification et attend que vous l'acceptiez ou la refusiez.

L'application tient sa propre copie de Claude Code. Mettez-la à jour avec Claude > Check for Updates… sur Mac ou Help > Check for Updates… sur Windows. Si vous lisez l'hébreu, ai school propose aussi un installateur gratuit en un clic pour Mac et Windows, qui installe l'application de bureau pour vous.

Installer Claude Code sur Mac ou Linux

Étape 1 : ouvrir le Terminal

Appuyez sur Cmd + Espace, tapez Terminal et appuyez sur Entrée. Une fenêtre avec un curseur qui clignote apparaît : c'est là que vous tapez les commandes.

Étape 2 : coller l'installateur officiel

Copiez cette ligne, collez-la avec Cmd + V et appuyez sur Entrée :

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

Elle télécharge l'installateur d'Anthropic depuis claude.ai et le lance. Rien ne semble se passer pendant un moment, alors laissez la fenêtre tranquille jusqu'à voir Claude Code successfully installed!

Le terminal en haut de ce guide est une vraie exécution, du début à la fin, sur un Mac que nous avons préparé pour l'occasion. La note de configuration jaune qu'on y voit est l'accroc le plus courant : si elle apparaît, lancez la ligne qu'elle donne, ou utilisez la correction du PATH plus bas.

Étape 3 : vérifier que Claude Code est installé

Fermez la fenêtre et ouvrez une nouvelle fenêtre de Terminal, car seule une nouvelle fenêtre prend en compte le nouveau programme. Puis lancez :

$ claude --version
$ 

Un numéro de version suivi de (Claude Code) signifie que vous êtes prêt :

Si vous voyez plutôt zsh: command not found: claude, passez directement à la correction du PATH plus bas.

Installer Claude Code sur Windows

Claude Code tourne nativement sur Windows 10 et 11, donc vous n'avez pas besoin de WSL (le sous-système Windows pour Linux) et vous n'avez jamais à lancer quoi que ce soit en tant qu'administrateur.

Étape 1 : ouvrir PowerShell, pas l'Invite de commandes

Appuyez sur Win + X et choisissez Windows PowerShell ou Terminal. Chaque ligne doit commencer par PS C:\. Si elle commence par C:\ sans le PS, vous êtes dans l'Invite de commandes (CMD), qui demande une autre commande.

Étape 2 : coller l'installateur officiel

Collez ceci avec Ctrl + V ou un clic droit, et appuyez sur Entrée :

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

irm télécharge l'installateur et iex le lance. C'est terminé quand vous voyez Claude Code successfully installed! Si vous êtes plutôt dans l'Invite de commandes, utilisez cette ligne :

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

Étape 3 : vérifier que ça a marché

Fermez PowerShell, ouvrez une nouvelle fenêtre et lancez claude --version. Un numéro de version signifie que vous êtes prêt ; 'claude' is not recognized signifie qu'il vous faut la correction du PATH pour Windows.

Faut-il Git pour Claude Code ?

Pas pour démarrer. Git for Windows, un téléchargement gratuit sur git-scm.com, donne à Claude Code un shell Bash (Git Bash) pour lancer des commandes ; sans lui, Claude Code utilise PowerShell, ce qui couvre la plupart des tâches de débutant. Vous n'avez jamais à apprendre Git, et un Mac n'a besoin de rien de plus. Si vous l'installez plus tard, cliquez sur Next à chaque écran et gardez l'option recommandée sur l'écran Adjusting your PATH environment.

Installer Claude Code dans VS Code ou JetBrains

Si vous travaillez déjà dans Visual Studio Code, l'extension d'Anthropic place Claude Code dans un panneau latéral :

1. Vérifiez votre version. L'extension demande VS Code 1.94 ou plus récent.
2. Installez l'extension. Appuyez sur Cmd + Maj + X sur Mac ou Ctrl + Maj + X sur Windows, cherchez Claude Code et cliquez sur Install sur l'extension d'Anthropic.
3. Ouvrez le panneau. Cliquez sur l'icône Spark en haut à droite d'un fichier ouvert, ou sur ✻ Claude Code dans la barre d'état en bas à droite.
4. Connectez-vous. Cliquez sur Sign in et terminez la connexion dans votre navigateur.

L'extension embarque sa propre copie de Claude Code pour son panneau. Pour taper claude dans le terminal intégré de VS Code, il vous faut quand même l'installation Mac ou Windows ci-dessus.

Les IDE JetBrains comme IntelliJ IDEA, PyCharm et WebStorm fonctionnent autrement : leur plugin Claude Code lance la commande claude dans le terminal de l'IDE, alors faites d'abord l'installation dans le terminal, puis ajoutez le plugin depuis la JetBrains Marketplace et redémarrez l'IDE.

Démarrer Claude Code et se connecter pour la première fois

Créez un dossier de test et lancez Claude Code à l'intérieur. Sur Mac :

$ mkdir -p ~/claude-projects/first-test
$ cd ~/claude-projects/first-test
$ claude
$ 

Sur Windows, dans PowerShell :

PS> mkdir -Force "$HOME\claude-projects\first-test"
PS> cd "$HOME\claude-projects\first-test"
PS> claude
PS> 

Voici ce qui se passe ensuite :

1. Configuration et navigateur. Claude Code vous demande de choisir un thème de couleurs avec les flèches, puis une méthode de connexion, et ouvre votre navigateur.
2. Connexion. Utilisez le compte qui a votre forfait payant. Si le navigateur ne s'ouvre pas, appuyez sur c pour copier le lien de connexion et collez-le vous-même dans le navigateur.
3. Confirmation. Quand le terminal affiche Login successful, appuyez sur Entrée.
4. Confiance dans le dossier. Claude Code vous demande si vous faites confiance à ce dossier ; vous venez de le créer, donc acceptez.
5. Au travail. La zone de saisie de Claude Code apparaît, avec la version, le modèle et le dossier affichés au-dessus. Tapez /help pour voir les commandes.

Voici les deux écrans auxquels vous répondez, capturés lors d'un vrai premier lancement. D'abord, la méthode de connexion : choisissez l'option 1 pour utiliser votre forfait Pro ou Max.

Ensuite, la vérification du dossier. Placez-vous sur « Yes, I trust this folder » avec les flèches et appuyez sur Entrée :

Lancer une première tâche sans risque

Commencez par une question qui ne change rien :

Quels fichiers y a-t-il dans ce dossier, et pour quels types de tâches pourrais-tu m'aider ici ? Ne crée et ne modifie rien pour l'instant.

Puis une toute petite modification visible :

Crée un fichier appelé hello.html : une page simple avec un titre qui dit « Ma première page Claude Code » et un court paragraphe qui explique ce que tu viens de faire. Ensuite, dis-moi comment l'ouvrir.

Les versions actuelles démarrent les sessions de terminal en mode auto, où un contrôle de sécurité en arrière-plan vérifie chaque action au lieu de vous demander. Pendant votre apprentissage, appuyez sur Maj+Tab (Shift+Tab) jusqu'à ce que la ligne sous la zone de saisie affiche manual mode on : Claude Code vous demandera alors l'autorisation avant chaque fichier qu'il crée et chaque commande qu'il lance.

Lisez chaque demande et choisissez Yes si elle correspond à ce que vous avez demandé. Quand il a fini, double-cliquez sur hello.html dans le Finder ou l'Explorateur de fichiers pour l'ouvrir dans votre navigateur.

Nous avons lancé les deux prompts dans un dossier neuf pour ce guide. En mode manuel, Claude Code a montré tout le fichier avant de le créer :

Neuf secondes plus tard, c'était fait, et il a aussi répondu à la seconde moitié du prompt, avec trois façons d'ouvrir le fichier :

first-test/hello.html

Mettre à jour ou désinstaller Claude Code

• Les installations natives se mettent à jour toutes seules en arrière-plan, et la nouvelle version s'applique au prochain démarrage de Claude Code.
• claude update installe la dernière version tout de suite.
• claude doctor lance un bilan de santé en lecture seule sans démarrer de session ; dans une session, /doctor lance un examen plus complet qui peut aussi corriger des problèmes.
• Les installations Homebrew et WinGet ne se mettent pas à jour toutes seules. Utilisez les commandes de mise à jour du tableau des méthodes.

Pour désinstaller une installation native sur Mac, lancez :

$ rm -f ~/.local/bin/claude
$ rm -rf ~/.local/share/claude
$ 

Sur Windows, dans PowerShell :

PS> Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
PS> Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
PS> 

Les installations Homebrew et WinGet se suppriment avec brew uninstall --cask claude-code ou winget uninstall Anthropic.ClaudeCode. Vos réglages et l'historique de vos sessions restent dans le dossier .claude et le fichier .claude.json de votre dossier personnel ; ne les supprimez que si vous voulez repartir de zéro.

Dépannage : les erreurs que l'on rencontre vraiment

Trouvez le message que vous voyez et appliquez la solution. Tous ces cas viennent de la page de dépannage de l'installation d'Anthropic, qui liste aussi des cas plus rares. Les messages de Claude Code s'affichent en anglais ; sur un Windows en français, ceux du système lui-même peuvent apparaître en français.

Erreur command not found ou not recognized avec Claude Code

Le programme s'est bien installé, mais votre terminal ne sait pas où le chercher. Une fenêtre déjà ouverte garde son ancienne liste de dossiers de programmes (le PATH), alors ouvrez-en d'abord une nouvelle. Si cela ne suffit pas, ajoutez le dossier vous-même.

Sur Mac, qui utilise le shell Zsh par défaut, lancez ces deux lignes. La première enregistre le réglage pour chaque nouvelle fenêtre, et la seconde l'applique à la fenêtre où vous êtes :

$ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
$ source ~/.zshrc
$ 

Sur Windows, lancez ces deux lignes dans PowerShell, puis fermez et rouvrez PowerShell :

PS> $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
PS> [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
PS> 

Pourquoi l'installation de Claude Code semble bloquée

L'installateur n'affiche rien pendant le téléchargement, donc quelques minutes de silence sont normales sur une connexion lente. Si cela dure beaucoup plus longtemps, appuyez sur Ctrl + C et vérifiez que votre réseau atteint le serveur de téléchargement d'Anthropic :

$ curl -sI https://downloads.claude.ai/claude-code-releases/latest
$ 

Dans PowerShell, tapez curl.exe au lieu de curl. Une première ligne avec 200 signifie que le serveur est joignable, alors relancez l'installateur ; un 403, un délai dépassé ou aucune sortie signifie qu'un pare-feu, un proxy ou un blocage régional fait obstacle. Peu de mémoire disponible ? Quittez les applications lourdes avant de réessayer, car Anthropic indique que l'installation demande environ 512 Mo libres.

Si claude --version fonctionne mais que quelque chose d'autre se comporte mal, lancez claude doctor et lisez ses avertissements : chacun est accompagné d'une solution suggérée.

Que faire ensuite

Consacrez votre première heure à de petites tâches sans risque, pour apprendre les commandes avant de confier à Claude Code quoi que ce soit d'important. Le tutoriel Claude Code pour débutants vous guide dans un premier projet complet, et le guide sur le fichier CLAUDE.md montre comment enregistrer vos préférences pour ne plus avoir à les répéter. Gardez l'aide-mémoire Claude Code ouvert dans un onglet pour les commandes et les raccourcis, et si vous voulez tout le parcours au même endroit, la formation Claude Code commence par l'installation et se termine par des projets utiles à votre activité.