Tutoriel d’utilisation de Claude Code : installation et prise en main sur Windows/macOS en un seul article

Ce tutoriel d’utilisation de Claude est entièrement consacré à Claude Code : de l’installation et de la vérification à l’association de la clé API, puis au dépannage des erreurs courantes. Suivez les étapes : en 10 minutes, vous pouvez lancer Claude Code dans le terminal et l’utiliser pour générer du code, corriger des erreurs et faire une collaboration de développement simple.

I. Préparation avant l’installation : attention à la version de Node.js

Claude Code dépend de l’environnement Node.js ; il est recommandé d’installer Node.js 18 ou une version supérieure, puis d’ouvrir une nouvelle fenêtre de terminal. Les utilisateurs Windows peuvent simplement suivre l’installateur en cliquant sur « Suivant » jusqu’au bout ; sur macOS, vous pouvez utiliser l’installateur officiel ou un gestionnaire de paquets. Une fois l’installation terminée, saisissez node -v dans le terminal pour vérifier que le numéro de version est correct.

II. Installer Claude Code : installation globale via npm et miroir en Chine

Exécutez dans le terminal la commande d’installation globale : npm install -g @anthropic-ai/claude-code ; c’est la méthode d’installation de Claude Code la plus courante. Si, sur votre réseau, l’accès au registre npm officiel est lent, vous pouvez utiliser un miroir : npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com. Une fois l’installation terminée, rouvrez le terminal et saisissez claude --version pour vérifier que Claude Code est disponible.

III. Premier lancement et association de la clé API : rendre Claude Code réellement utilisable

Claude Code nécessite l’autorisation via la clé API d’Anthropic ; lors du premier lancement de claude, il vous guidera généralement pour configurer la clé. Une méthode plus fiable consiste à définir d’abord, dans le système, la variable d’environnement ANTHROPIC_API_KEY, puis à démarrer Claude Code, afin d’éviter de devoir la ressaisir à chaque fois. Ensuite, ouvrez un terminal dans le répertoire du projet et décrivez la tâche en langage naturel, par exemple demander à Claude Code d’analyser une erreur, de générer un correctif et de vous indiquer comment le vérifier.

IV. Problèmes courants de Claude Code : blocage, erreurs et interruptions — que faire ?

Si Claude Code échoue dans ses requêtes ou s’interrompt fréquemment, vérifiez en priorité la stabilité du réseau et si un throttling/une limitation de débit côté serveur a été déclenché ; passer sur un réseau plus stable améliore souvent nettement la situation. En cas d’erreur d’installation, cela provient le plus souvent d’une version de Node.js trop ancienne ou de permissions insuffisantes pour l’installation globale ; mettre à niveau Node.js et réinstaller avec des droits administrateur/sudo résout généralement le problème. Si claude --version ne renvoie rien, vérifiez que le chemin npm global est bien ajouté au PATH et relancez Claude Code dans un nouveau terminal.