Accueil › Claude Code › Installation
Vue d’ensembleInstallationréférence de la CLITarifs et limitesAgent SDKCompétences et pluginsGitHubWeb, bureau et IDEModèlesErreursOpen source ?TutorielPour les étudiantsAutomatisation de l’assurance qualitéComparaison avec CursorComparaison avec Codex et OpenCodeSous-agentsHooksMCPÉcosystèmeVS CodeOpenRouterLimites de débitGuide en chinois
Dernière mise à jour : 11 octobre 2026

Comment installer Claude Code

Il existe trois méthodes prises en charge pour installer Claude Code sur une machine. Choisissez-en une ; elles fournissent toutes la même commande claude .

TLDR

  • npm : npm install -g @anthropic-ai/claude-code (nécessite Node.js 18 ou version ultérieure).
  • Programme d’installation natif : une commande curl (macOS/Linux) ou une ligne PowerShell (Windows) — Node n’est pas nécessaire.
  • Vérifiez avec claude --version, puis définissez ANTHROPIC_BASE_URL et ANTHROPIC_API_KEY pour utiliser cette passerelle.

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 version erreurs → Node.js 18 ou version ultérieure est requis ; node -v pour 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_key

Créer un compte avec le code CLAUDECODE

Questions 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ées

AI 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.

Autres guides Claude Code

Claude Code : le guide completDocumentation de la CLI Claude Code : commandes et optionsLes tarifs et limites de Claude Code expliquésLe SDK Claude Code, désormais Claude Agent SDKCompétences et plugins Claude CodeClaude Code dans GitHub : l’App, l’Action et @claudeClaude Code dispose-t-il d’une interface web ? Le web, le bureau et l’IDE expliquésQuel modèle Claude Code utilise et comment en changerLes erreurs de Claude Code et comment les résoudreClaude Code est-il open source ?Tutoriel Claude Code : votre première vraie sessionClaude pour les étudiants : Claude Code, l’API et ce que le statut étudiant vous apporte réellementComment utiliser Claude Code pour automatiser l’assurance qualitéClaude Code ou Cursor : lequel choisir, quand — et comment utiliser les deuxClaude Code vs Codex vs OpenCode : comparaison des agents de terminalSous-agents de Claude Code : fonctionnement, définition et équipes d’agentsHooks de Claude Code : un contrôle déterministe des actions de l’agentMCP dans Claude Code : connexion de serveurs, portées, MCP distant et exemples concretsL’écosystème Claude Code : routeurs, frameworks, plugins et listes qui les recensentClaude Code dans VS Code : l’extension, l’utilisation via le terminal et les erreursComment utiliser OpenRouter dans Claude Code (et quand s’en passer)Erreur de limite de débit de Claude : ce que signifie « API error: rate limit reached » et comment la résoudreComment utiliser Claude Code : de l’installation à l’utilisation quotidienne