Installer Claude Code sur macOS, Linux ou Windows

L’installation dépend du système et de la méthode de distribution retenue. L’article donne les étapes natives pour macOS, Linux et Windows, les alternatives Homebrew et WinGet, puis les commandes de diagnostic et les contrôles de sécurité.

La méthode recommandée par Anthropic est désormais l’installation native. Elle ne demande pas Node.js. Après l’installation, lancez claude dans un projet, connectez votre compte puis vérifiez l’environnement avec claude doctor.

Prérequis

• Un système pris en charge : macOS, Linux ou Windows.
• Une connexion internet pour l’authentification et les requêtes.
• Un compte Claude compatible ou un accès fourni par votre organisation.
• Sur Windows natif, Git for Windows est recommandé ; WSL 2 reste adapté aux projets Linux et au mode bac à sable.

macOS, Linux ou WSL : installation native

Exécutez uniquement le programme fourni depuis le domaine officiel d’Anthropic :

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

# Vérification
claude --version
claude doctor

Windows natif

Dans PowerShell :

irm https://claude.ai/install.ps1 | iex
claude --version
claude doctor

Dans l’invite de commandes Windows :

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

Ne mélangez pas les syntaxes : irm appartient à PowerShell, tandis que la commande avec && est prévue pour l’invite de commandes.

Autres méthodes officielles

Homebrew et WinGet conviennent si vous gérez déjà vos logiciels avec ces outils :

# macOS avec Homebrew
brew install --cask claude-code

# Windows avec WinGet
winget install Anthropic.ClaudeCode

Ces installations se mettent à jour avec leur gestionnaire : brew upgrade claude-code ou winget upgrade Anthropic.ClaudeCode. L’installation native gère ses mises à jour en arrière-plan.

Première connexion et premier test

cd chemin/vers/votre-projet
claude

Suivez l’écran de connexion. Ne collez pas une clé privée dans un fichier du projet. Les organisations qui utilisent la Console, Amazon Bedrock, Google Vertex AI ou Microsoft Foundry doivent suivre la méthode d’authentification prévue par leur administrateur.

Commencez par une demande sans modification, par exemple : « Lis le projet et indique les commandes de test sans changer de fichier ». Vérifiez ensuite chaque proposition avant de l’autoriser.

Donner les règles du projet

Un fichier CLAUDE.md placé à la racine peut préciser l’architecture, les commandes et les limites. Gardez-le court et vérifiable :

# CLAUDE.md

## Vérifications
- npm test
- npm run lint

## Limites
- Ne jamais lire les fichiers .env
- Ne pas modifier la production
- Demander une validation avant tout envoi externe

Dépannage

• Commande introuvable : fermez puis rouvrez le terminal, puis lancez claude doctor.
• Ancienne installation npm : lancez claude migrate-installer depuis l’installation existante pour passer à l’installation locale proposée par Anthropic.
• Windows ne trouve pas Bash : installez Git for Windows ou utilisez WSL, puis relancez le diagnostic.
• Connexion refusée : vérifiez que le compte, le pays et la méthode d’authentification sont autorisés par votre organisation.

Contrôles avant de travailler sur un vrai dépôt

1. Travaillez dans un dépôt Git et vérifiez l’état des fichiers.
2. Confirmez que les secrets et les fichiers .env sont ignorés.
3. Lancez d’abord une lecture seule, puis relisez chaque différence.
4. Exécutez les tests avant de valider une modification.
5. Gardez les actions externes et la production sous validation humaine.

Source officielle

Les commandes et prérequis de cette page ont été vérifiés dans la documentation d’installation Claude Code d’Anthropic. Consultez-la avant installation, car les méthodes prises en charge évoluent.

Prochaines étapes

• Les commandes essentielles
• Configurer MCP
• Formation complète Claude Code