Trois pièges classiques font échouer une première installation de Claude Code, et la documentation d'Anthropic les décrit tous : une offre gratuite qui ne donne pas accès à l'outil, une commande collée dans la mauvaise fenêtre, et une fenêtre qu'on n'a pas rouverte après l'installation. Cette page vous évite les trois, puis vous donne la solution des autres erreurs courantes.
Il y a deux chemins. Je les donne tous les deux, pour Windows et pour Mac, mais si vous ne codez pas, prenez le premier.
Avant de commencer : ce qu'il vous faut
| Élément | Ce que demande Anthropic |
|---|---|
| Système | macOS 13 ou plus récent ; Windows 10 version 1809 ou plus récent (Windows 11 compris) ; Ubuntu 20.04, Debian 10 ou Alpine 3.19 et plus récents |
| Ordinateur | 4 Go de mémoire au moins, processeur x64 ou ARM64 |
| Connexion | Internet obligatoire, depuis un pays où Anthropic est disponible |
| Compte | Un abonnement Pro, Max, Ultra, Team ou Enterprise, ou un compte Console payé à l'usage. L'offre gratuite ne donne pas accès à Claude Code. |
Pour choisir l'abonnement, voir les prix de Claude Code. Pro suffit pour installer et découvrir.
Chemin 1 : l'application de bureau (recommandé si vous ne codez pas)
C'est la méthode que j'enseigne dans ma formation offerte. L'application de bureau Claude contient Claude Code : pas de terminal, pas de Node.js, rien d'autre à installer. Vous avez des boutons, une fenêtre, et en mode Manual, Claude vous montre chaque modification avant de l'appliquer.
Sur Windows
- Téléchargez l'application Claude pour Windows depuis le site d'Anthropic (claude.com/download). Il existe une version pour les processeurs x64 (la plupart des PC) et une version ARM64.
- Lancez le fichier téléchargé et installez l'application comme n'importe quel logiciel.
- Ouvrez Claude depuis le menu Démarrer et connectez-vous avec votre compte.
- Cliquez sur l'onglet Code, en haut de la barre latérale. Si seules des icônes s'affichent, survolez-les pour voir leur nom.
Sur Mac
- Téléchargez l'application Claude pour macOS. C'est une version universelle : elle fonctionne sur les Mac Intel comme sur les Mac Apple Silicon (M1 et suivants).
- Ouvrez le fichier téléchargé et installez l'application (si la fenêtre qui s'ouvre vous le propose, faites glisser l'icône Claude sur le dossier Applications).
- Lancez Claude depuis le dossier Applications et connectez-vous.
- Cliquez sur l'onglet Code.
Ce qui peut se passer en cliquant sur « Code »
- On vous propose de passer à une offre payante : votre compte est sur l'offre gratuite. Prenez un abonnement, puis revenez.
- On vous demande de vous connecter en ligne : terminez la connexion dans le navigateur, puis redémarrez l'application.
- Une erreur 403 s'affiche : déconnectez-vous puis reconnectez-vous depuis le menu de l'application, c'est la solution la plus courante selon la documentation d'Anthropic. Sinon, vérifiez que votre abonnement payant est actif ; si Claude Code fonctionne dans le terminal mais pas dans l'application, quittez complètement l'application (pas seulement la fenêtre), puis rouvrez-la et reconnectez-vous.
Votre première session
Créez un dossier vide sur votre Bureau (par exemple mon-premier-site). Dans l'onglet Code, sous la zone de saisie, choisissez l'environnement Local, puis Open folder… et sélectionnez ce dossier. Réglez le mode de permission sur Manual pour commencer : Claude vous montrera chaque modification et attendra votre accord. Puis écrivez ce que vous voulez construire, en français. La suite, avec un premier message tout prêt, est dans le guide Claude Code pour débutants.
Sur Linux, l'application de bureau existe en bêta pour Ubuntu et Debian, à installer avec apt.
Chemin 2 : la ligne de commande (le terminal)
C'est la version la plus complète de Claude Code, celle que la documentation appelle « la CLI ». Elle fait peur, mais l'installation tient en une ligne à copier-coller. Un réflexe de sécurité : une commande collée dans un terminal s'exécute avec vos droits, alors ne copiez une commande d'installation que depuis cette page ou depuis la documentation officielle d'Anthropic (code.claude.com), jamais depuis une vidéo ou un commentaire.
Installer Claude Code sur Windows
Étape facultative : Git for Windows. Il donne à Claude Code l'outil Bash pour lancer ses commandes. Sans lui, Claude Code utilise PowerShell à la place, ce qui fonctionne. Si vous l'installez (git-scm.com), cliquez sur « Next » à chaque écran sans rien changer. Vous n'aurez pas à apprendre Git vous-même.
1. Ouvrez PowerShell. Appuyez sur Win + X et choisissez Windows PowerShell ou Terminal. Pas besoin de l'ouvrir en administrateur.
Vérifiez que vous êtes au bon endroit : dans PowerShell, chaque ligne commence par PS C:\Users\VotreNom>. Sans le PS, vous êtes dans l'invite de commandes (CMD), qui n'accepte pas les mêmes commandes.
2. Collez la commande d'installation (clic droit ou Ctrl + V), puis Entrée :
irm https://claude.ai/install.ps1 | iex
Si vous êtes dans l'invite de commandes (CMD) et non dans PowerShell, la commande est celle-ci :
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
La commande n'affiche aucune progression pendant le téléchargement : laissez la fenêtre ouverte et patientez jusqu'au message de fin d'installation.
3. Fermez la fenêtre et ouvrez-en une nouvelle. C'est l'étape que tout le monde oublie : Windows ne prend en compte le nouveau programme que dans les fenêtres ouvertes après l'installation.
4. Vérifiez et lancez :
claude --version
claude
La première commande affiche un numéro de version. La seconde démarre Claude Code et ouvre votre navigateur pour vous connecter avec votre compte Claude.
Autre méthode, si vous utilisez déjà le gestionnaire de paquets de Windows : winget install Anthropic.ClaudeCode. Attention, par défaut, cette installation ne se met pas à jour toute seule.
Installer Claude Code sur Mac
1. Ouvrez le Terminal. Appuyez sur Cmd + Espace, tapez Terminal, puis Entrée. Une fenêtre avec un curseur qui clignote apparaît.
2. Collez la commande d'installation (Cmd + V), puis Entrée :
curl -fsSL https://claude.ai/install.sh | bash
Là encore, aucune progression ne s'affiche : patientez jusqu'au message de fin.
3. Ouvrez une nouvelle fenêtre de Terminal, puis lancez :
claude --version
claude
Si vous utilisez Homebrew, l'alternative est brew install --cask claude-code, qui suit la version dite stable, en général une semaine en retard sur la plus récente. Comme WinGet, Homebrew ne met pas Claude Code à jour tout seul par défaut.
Lancer Claude Code dans un projet
Claude Code travaille dans le dossier depuis lequel vous le lancez. Placez-vous d'abord dans le dossier de votre projet : tapez cd suivi d'une espace, faites glisser le dossier depuis votre Bureau jusque dans la fenêtre (son chemin s'écrit tout seul), appuyez sur Entrée, puis lancez Claude Code :
cd chemin/vers/mon-premier-site
claude
Quelques réflexes dans le terminal : on ne clique pas, on se déplace avec les flèches ; Échap interrompt Claude pendant qu'il travaille ; /help affiche les commandes ; exit quitte Claude Code.
Les erreurs d'installation les plus fréquentes
| Ce que vous voyez | Ce que ça veut dire | La solution |
|---|---|---|
'irm' n'est pas reconnu… | Vous êtes dans l'invite de commandes (CMD), pas dans PowerShell | Ouvrez PowerShell (Win + X), ou utilisez la commande CMD donnée plus haut |
The token '&&' is not a valid statement separator | L'inverse : vous avez collé la commande CMD dans PowerShell | Utilisez la commande irm … |
'claude' n'est pas reconnu ou command not found: claude | La fenêtre a été ouverte avant l'installation, ou le dossier du programme n'est pas encore connu du système | Ouvrez une nouvelle fenêtre ; si le problème persiste, lancez les lignes données juste après ce tableau |
| Erreur SSL/TLS, « Could not create SSL/TLS secure channel » | Fréquent sur les Windows 10 anciens | Lancez d'abord [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12, puis la commande d'installation |
| « Claude Code does not support 32-bit Windows » sur un PC récent | Vous avez ouvert « Windows PowerShell (x86) » | Ouvrez l'entrée du menu Démarrer sans « (x86) » |
| « The process cannot access the file… » | Une installation précédente tourne encore, ou l'antivirus analyse le fichier téléchargé | Fermez les autres fenêtres PowerShell, attendez la fin de l'analyse, supprimez le dossier de téléchargement avec Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads", puis relancez la commande d'installation |
| Du code HTML ou « App unavailable in region » | Claude Code n'est pas disponible dans votre pays, ou la page a mal répondu | Vérifiez la liste des pays pris en charge, sinon relancez la commande |
| Erreur « dyld » sur Mac | Votre macOS est plus ancien que la version 13 | Mettez à jour macOS (menu Pomme, puis Mise à jour de logiciels) |
Si claude reste introuvable
Le dossier où l'installation a rangé Claude Code n'est pas encore dans le « chemin » de votre ordinateur, la liste des dossiers où il cherche les programmes. Sur Mac, l'installation affiche la ligne à lancer à la fin, sous « Setup notes » ; sinon, collez ces deux lignes dans le Terminal :
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Sur Windows, collez ces deux lignes dans PowerShell :
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Dans les deux cas, fermez la fenêtre, ouvrez-en une nouvelle et tapez à nouveau claude --version.
En cas de doute, claude doctor affiche un diagnostic de l'installation et des réglages, sans rien modifier.
Le piège qui coûte de l'argent : la clé d'API qui passe avant l'abonnement
Si vous avez un jour créé une clé d'API chez Anthropic et qu'elle est enregistrée sur votre ordinateur dans la variable ANTHROPIC_API_KEY, Claude Code peut l'utiliser à la place de votre abonnement : chaque requête est alors facturée à l'usage, en plus de ce que vous payez déjà. Anthropic le signale dans son centre d'aide. Au premier lancement, si Claude Code vous demande s'il doit utiliser une clé trouvée sur la machine, répondez non si vous voulez rester sur votre abonnement. Pour vérifier à tout moment quel compte est utilisé, tapez /status dans Claude Code.
Après l'installation : les trois premières choses à faire
- Vérifier la mémoire. La mémoire automatique, qui permet à Claude de se souvenir de votre projet d'une session à l'autre, est active par défaut : vous n'avez rien à régler. Pour voir ce qu'il a retenu, ou la couper, tapez
/memorydans Claude Code. - Créer le fichier d'instructions du projet. Une fois que votre projet contient ses premiers fichiers, tapez
/initdans la zone de saisie : Claude Code analyse le projet et rédige un premier fichierCLAUDE.md, qu'il relira au début de chaque session. Sur un dossier encore vide, il n'aurait rien à analyser : faites-le après la première version. Ajoutez-y ensuite ce qu'il doit toujours savoir. - Brancher vos outils plus tard. Les connexions à votre agenda, votre outil de paiement ou votre base de données passent par les MCP ; inutile de vous en occuper le premier jour.
Pour la suite, le tutoriel complet est sur la page Claude Code pour débutants. Si vous bloquez malgré tout, trente minutes en visio, écran partagé, suffisent en général à régler une installation : c'est la visio de déblocage.
