Node.js pour Claude Code : quelle version utiliser et comment s’en passer
La méthode npm nécessite Node.js 18 ou version ultérieure — node -v pour vérifier ; nvm (nvm install --lts) pour corriger. Une version trop ancienne de Node est la raison la plus courante pour laquelle une nouvelle installation ne démarre pas. Si Node ne fait pas partie de votre chaîne d’outils, passez-vous-en : le programme d’installation natif ci-dessous fournit un binaire autonome qui se met à jour automatiquement.
Option 1 — npm (tout système d’exploitation avec Node.js 18 ou version ultérieure)
npm install -g @anthropic-ai/claude-code
claude --version
Si npm install -g échoue avec EACCES sur macOS ou Linux, n’utilisez pas sudo — corrigez plutôt le préfixe npm : npm config set prefix ~/.npm-global et ajoutez ~/.npm-global/bin à votre PATH. Sous Windows, lancez l’installation depuis un terminal normal (sans droits d’administrateur).
Option 2 — programme d’installation natif pour Mac, Linux et Windows (sans Node.js)
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Windows CMD (the one-liner people search for)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Installer Claude Code sur Linux et Ubuntu
Sur Ubuntu, Debian, Fedora ou toute autre distribution : le programme d’installation natif (curl -fsSL https://claude.ai/install.sh | bash) place un binaire à mise à jour automatique dans votre répertoire personnel, sans nécessiter de droits root ni Node.js. Si vous préférez npm, installez d’abord Node 18 ou version ultérieure via NodeSource ou nvm — la version de Node fournie par apt sur Ubuntu est généralement trop ancienne — puis npm install -g @anthropic-ai/claude-code. Sur un serveur accessible uniquement par terminal ou dans un conteneur, le binaire natif est le meilleur choix ; ajoutez les deux variables de la passerelle à ~/.bashrc et il fonctionne via SSH exactement comme en local.
La version native se met à jour automatiquement et évite les conflits de versions de Node. C’est le meilleur choix sur les machines où Node ne fait pas déjà partie de votre chaîne d’outils.
Option 3 — application de bureau ou extension d’IDE
L’application de bureau Claude inclut Claude Code, et les extensions VS Code et JetBrains installent la CLI pour vous à la première utilisation. Consultez le guide du Web, de l’application de bureau et des IDE pour connaître les possibilités et les limites de chaque interface.
Remarques pour Windows
Claude Code fonctionne nativement sur Windows 10/11 (PowerShell ou Git Bash) et dans WSL. WSL offre une expérience plus fluide pour les projets qui supposent l’utilisation d’un shell Unix. Si claude est introuvable après une installation npm sous Windows, ouvrez un nouveau terminal pour que PATH soit relu, ou vérifiez npm config get prefix et ajoutez son dossier bin .
Exécuter Claude Code sans connexion : s’authentifier avec une clé API
Exécutez claude et choisissez /login pour vous connecter avec un abonnement Claude Pro/Max — ou ignorez complètement la connexion. Lorsque ANTHROPIC_API_KEY (ou ANTHROPIC_AUTH_TOKEN) est défini, Claude Code n’affiche jamais l’écran de connexion et s’exécute localement en utilisant le point de terminaison indiqué par ANTHROPIC_BASE_URL, ce qui lui permet aussi de fonctionner sur les machines qui ne peuvent pas ouvrir de navigateur. Pour cette passerelle, utilisez l’authentification par clé :
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key # or ANTHROPIC_AUTH_TOKEN
claude
Placez ces deux lignes dans ~/.zshrc, ~/.bashrc ou dans votre profil PowerShell afin que chaque nouveau terminal en dispose. Dans Claude Code, /status indique le point de terminaison et la clé actifs.
Comment mettre à jour et désinstaller Claude Code
claude update # native / self-update
npm update -g @anthropic-ai/claude-code # npm install
npm uninstall -g @anthropic-ai/claude-code
Si l’installation a réussi mais que Claude Code ne démarre pas
command not found→ PATH : ouvrez un nouveau shell ou ajoutez le répertoire global des exécutables npm.Node versionerreurs → Node.js 18 ou version ultérieure est requis ;node -vpour vérifier, ou passez au programme d’installation natif.- Blocage au premier lancement → proxy d’entreprise ; définissez HTTPS_PROXY, ou l’URL de base de la passerelle si votre réseau bloque api.anthropic.com.
401/ clé non valide → la clé doit être une clé de passerelle lorsque ANTHROPIC_BASE_URL pointe ici ; une clé de la console Anthropic sera rejetée.
Essayez gratuitement pour commencer
Les nouveaux comptes reçoivent 5 $ de crédit API offert avec le code CLAUDECODE — de quoi passer une soirée à utiliser Claude Code avec Sonnet — puis des crédits valant 7.69231× leur valeur nominale.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyQuestions fréquentes
Ai-je besoin de Node.js pour installer Claude Code ?
Uniquement pour l’installation via npm. Le programme d’installation natif (curl sur macOS/Linux, PowerShell sur Windows) et l’application de bureau ne nécessitent pas Node.
Claude Code fonctionne-t-il sur Windows ?
Oui, nativement dans PowerShell ou Git Bash, ainsi que dans WSL. WSL est recommandé pour les projets structurés pour Unix.
Puis-je installer Claude Code sans abonnement Claude ?
Oui. L’installation est gratuite ; authentifiez-vous avec une clé API plutôt qu’avec /login. Une clé de passerelle de ce site peut être utilisée directement à la place.
Utilisez Claude Code sur la passerelle
Les mêmes modèles, deux variables d’environnement, des crédits valant 7.69231× leur valeur nominale — ou une offre illimitée à tarif forfaitaire. Nouveaux comptes : 5 $ de crédit API offert avec le code CLAUDECODE.
Obtenir une clé API Voir les offres illimitéesAI Prime Tech est une passerelle API indépendante et n’est ni affiliée à Anthropic, ni approuvée ou parrainée par Anthropic. « Claude » et « Claude Code » sont des marques commerciales d’Anthropic. Les fonctionnalités de Claude Code décrites ici correspondent à la documentation publique d’Anthropic au moment de la rédaction et évoluent fréquemment ; les prix et les listes de modèles de cette page proviennent des paramètres en temps réel de cette passerelle.