Installer Claude Code

Le problème : tu veux installer Claude Code mais tu ne sais pas par où commencer. Voici le chemin le plus court de zéro à un terminal IA fonctionnel.

Comment installer Claude Code : démarrage rapide

Anthropic livre désormais des installateurs natifs comme méthode recommandée. Pas de Node.js nécessaire :

Windows PowerShell (Recommandé) :

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

macOS / Linux :

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

Homebrew (macOS/Linux) :

brew install --cask claude-code

Lance claude --version pour confirmer. Le succès ressemble à : un numéro de version s'affiche sans erreur.

Étape par étape : installer Claude Code sur n'importe quelle plateforme

Avant d'installer Claude Code, vérifie que tu as :

1. Un accès terminal (Invite de commandes, PowerShell ou Bash)
2. Une clé API Anthropic depuis console.anthropic.com
3. Node.js 18+ (uniquement si tu prévois d'installer via npm)

Installer Claude Code sur Windows

Windows supporte quelques chemins d'installation. Choisis celui qui correspond à ton workflow :

Option 1 : Natif Windows (Recommandé)

# PowerShell (Lancer en tant qu'Administrateur)
irm https://claude.ai/install.ps1 | iex
claude --version

Option 2 : Git Bash

Installe Git pour Windows, puis :

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

Option 3 : WSL (Ubuntu)

# Installer WSL si nécessaire (PowerShell en tant qu'Administrateur)
wsl --install -d Ubuntu
 
# Dans le terminal Ubuntu
curl -fsSL https://claude.ai/install.sh | bash
claude --version

Utilisateurs Windows : l'installateur natif n'a plus besoin de Node.js. Sur WSL, lance Claude Code depuis ton terminal Linux.

Installer Claude Code sur macOS

Option 1 : Homebrew (Recommandé)

brew install --cask claude-code
claude --version

Option 2 : Installateur natif

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

Option 3 : npm (si tu préfères Node.js)

npm install -g @anthropic-ai/claude-code
 
# Si tu vois "command not found", corrige le PATH :
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
claude --version

Installer Claude Code sur Linux

Option 1 : Installateur natif (Recommandé)

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

Option 2 : Homebrew

brew install --cask claude-code
claude --version

Option 3 : npm (nécessite Node.js 18+)

# Créer un répertoire npm utilisateur (évite les prérequis sudo)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
 
# Installer Claude Code
npm install -g @anthropic-ai/claude-code
claude --version

Configurer ta clé API

Une fois l'installation réussie, configure l'authentification :

claude
# Colle ta clé API quand c'est demandé

Obtiens ta clé API : ouvre console.anthropic.com, crée un compte, va dans API Keys, et génère une nouvelle clé commençant par sk-.

Vérifier ton installation

Teste ton setup Claude Code :

claude --version    # Affiche le numéro de version
claude doctor       # Lance les diagnostics

Test de fonctionnalité rapide :

mkdir test-project && cd test-project
echo "console.log('Hello!');" > test.js
claude

Dans le prompt Claude : "Read test.js and explain it"

Succès : Claude lit le fichier et explique le JavaScript.

Erreurs courantes lors de l'installation de Claude Code

Erreur : "Command Not Found"

Cause : la configuration du PATH manque après l'installation

Correction :

which claude    # Vérifie si installé
npm list -g @anthropic-ai/claude-code
 
# Ajouter au PATH manuellement
echo 'export PATH="$PATH:/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin"' >> ~/.bashrc
source ~/.bashrc

Erreur : "EBADPLATFORM"

Cause : npm install a tourné sur une config de plateforme non supportée

Correction : utilise l'installateur natif au lieu de npm :

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

Erreur : "EACCES Permission Denied"

Cause : npm veut sudo (pas une bonne habitude)

Correction : configure un répertoire npm au niveau utilisateur (voir la section Linux ci-dessus). Ça fonctionne sur toutes les plateformes.

Réinitialisation nucléaire (corrige 95% des problèmes)

Quand rien d'autre ne fonctionne, réinitialise tout :

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude ~/.npm/_cacache
npm cache clean --force
npm install -g @anthropic-ai/claude-code
claude --version

Quoi faire après avoir installé Claude Code

Une fois que claude --version répond correctement :

1. Construis ton premier projet : Guide Premier Projet
2. Apprends l'interface : Qu'est-ce que Claude Code
3. Configure les paramètres : Bases de la configuration
4. Règle les problèmes courants : Guide de dépannage
5. Vois des exemples concrets : Exemples & Templates

Astuce pro : lance claude doctor quand quelque chose semble cassé. Il détecte automatiquement la plupart des problèmes de config et suggère des corrections.