Installer Claude Code sur Windows, macOS et Linux
Une commande pour installer Claude Code, deux variables d’environnement pour le brancher sur une clé OneProvider, et vous êtes au travail en cinq minutes. Sans Node.js, sans connexion à un compte claude.ai, avec les vraies commandes pour chaque système.
Avant d’installer Claude Code : prérequis et méthode
Claude Code est un assistant de programmation qui s’utilise dans le terminal, dans votre dossier de projet : il lit le code, modifie les fichiers et lance des commandes. Le télécharger ne coûte rien. Ce qui se paye, c’est l’usage des modèles, soit par un abonnement Claude, soit par une clé API facturée aux tokens, comme dans ce guide.
Le minimum requis : macOS 13 ou plus récent, Windows 10 (version 1809 ou plus), Ubuntu 20.04, Debian 10 ou Alpine 3.19, avec 4 Go de mémoire vive et un processeur x64 ou ARM64.
| Méthode | Systèmes | Mises à jour | À retenir |
|---|---|---|---|
| Installeur natif (conseillé) | macOS, Linux, WSL, Windows | Automatiques | Aucun Node.js requis |
| Homebrew | macOS | À la main | brew upgrade claude-code |
| WinGet | Windows | À la main | winget upgrade |
| apt, dnf, apk | Debian, Ubuntu, Fedora, Alpine | Via le système | Dépôts signés |
| npm | Tous | À la main | Node.js 22 ou plus |
Installer Claude Code sur Mac, Linux et Windows
Ouvrir un terminal
Sur Mac, Cmd + Espace puis « Terminal ». Sur Windows, le menu Démarrer puis « PowerShell ». Sur Linux, Ctrl + Alt + T. Aucun droit administrateur n’est nécessaire.
macOS et Linux : une seule ligne
Le script officiel télécharge le binaire adapté à votre machine et le place dans le dossier .local/bin de votre compte. Sur Mac, Homebrew fait aussi l’affaire.
curl -fsSL https://claude.ai/install.sh | bash # ou, avec Homebrew brew install --cask claude-codeWindows : PowerShell ou WinGet
Lancez la commande dans PowerShell. Git pour Windows reste facultatif : sans lui, Claude Code exécute ses commandes avec PowerShell ; avec lui, il utilise Git Bash.
irm https://claude.ai/install.ps1 | iex # ou, avec WinGet winget install Anthropic.ClaudeCodeWindows : invite de commandes (CMD)
Si vous préférez CMD, l’installeur existe aussi en script .cmd. Cette variante change seulement la commande de départ, le résultat est identique.
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdOption WSL 2 pour un environnement Linux
Pour des projets qui tournent sous Linux dans Windows, ouvrez votre distribution WSL 2 et lancez-y la commande Linux ci-dessus. Installez et utilisez alors claude depuis ce terminal, pas depuis PowerShell.
Vérifier l’installation
La première commande affiche un numéro de version, la seconde un diagnostic en lecture seule de l’installation et de vos réglages.
claude --version claude doctor
Brancher Claude Code sur une clé API OneProvider
Avec une clé OneProvider, Claude Code n’a pas besoin d’un abonnement ni d’une connexion à claude.ai : il envoie ses requêtes à notre point d’accès compatible Anthropic et vous ne payez que les tokens consommés. Il suffit de changer l’adresse de base et de fournir la clé.
Créer la clé dans l’espace client
Ouvrez le bot Telegram @oneprovider_robot ou le site app.oneprovider.dev, rechargez le solde (à partir de 20 $) et créez une clé API. Vous pouvez en créer jusqu’à 3, chacune avec un nom et une limite de dépense.
Déclarer l’adresse et la clé : macOS et Linux
À taper dans le terminal où vous lancerez Claude Code. Ces valeurs ne durent que pour cette session.
export ANTHROPIC_BASE_URL=https://api.oneprovider.dev export ANTHROPIC_AUTH_TOKEN=sk-...Déclarer l’adresse et la clé : Windows PowerShell
Même principe avec la syntaxe PowerShell, valable pour la fenêtre en cours.
$env:ANTHROPIC_BASE_URL = "https://api.oneprovider.dev" $env:ANTHROPIC_AUTH_TOKEN = "sk-..."Tester sans ouvrir l’interface
Cette requête rapide confirme que la clé, l’adresse et le solde sont corrects.
claude -p "dis bonjour en une phrase"Enregistrer les réglages pour toutes les sessions
Placez le fichier dans ~/.claude/settings.json (sous Windows : %USERPROFILE%\.claude\settings.json). Si le fichier existe déjà, ajoutez seulement le bloc env au lieu de l’écraser.
{ "env": { "ANTHROPIC_BASE_URL": "https://api.oneprovider.dev", "ANTHROPIC_AUTH_TOKEN": "sk-...", "ANTHROPIC_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5" }, "model": "claude-sonnet-5-5" }Lancer Claude Code dans votre projet
Placez-vous dans le dossier du projet et tapez claude. Si un écran de connexion ou un avertissement « Auth conflict » apparaît (ancienne session claude.ai), tapez /logout : vos variables restent en place.
cd mon-projet claude
Gardez la clé pour vous. Ne publiez jamais une clé dans un dépôt Git ou une capture d’écran. En cas de fuite, révoquez-la dans l’espace client et créez-en une nouvelle.
Claude Code est-il payant ? Coût par modèle
Le logiciel est gratuit, l’usage ne l’est pas. Chez OneProvider, il n’y a ni abonnement ni prélèvement automatique : vous rechargez un solde en dollars, à partir de 20 $, et chaque requête en consomme selon les tarifs ci-dessous, exprimés par million de tokens.
- Claude Sonnet 5.5: Entrée / 1M de jetons $2.00, Sortie / 1M de jetons $10.00, Contexte 1M
- Claude Opus 5.5: Entrée / 1M de jetons $4.00, Sortie / 1M de jetons $20.00, Contexte 1M
- Claude Haiku 5.5: Entrée / 1M de jetons $0.10, Sortie / 1M de jetons $0.50, Contexte 1M
Prix du catalogue par million de tokens : Sonnet pour le quotidien, Opus pour les tâches difficiles, Haiku pour les petites opérations.
Pour recharger depuis la France, une carte bancaire de n’importe quel pays, Apple Pay et Google Pay sont proposés sur la page de paiement, avec la conversion affichée avant validation. Le paiement en cryptomonnaie (USDT, TON, BTC) passe par @CryptoBot ou @xRocket dans Telegram. Nous ne conservons pas vos données de carte.
Côté confidentialité, notre politique prévoit de ne pas écrire le contenu de vos requêtes sur disque ni dans les journaux ; l’infrastructure est hébergée à Francfort, dans l’Union européenne.
Erreurs d’installation et de connexion les plus fréquentes
| Symptôme | Cause probable | Que faire |
|---|---|---|
| claude : commande introuvable | Dossier .local/bin absent du PATH | Ajouter le dossier au PATH (ci-dessous) |
| « claude » non reconnu sous Windows | Terminal ouvert avant l’installation | Fermer puis rouvrir PowerShell |
| Écran de connexion, Auth conflict | Ancienne session claude.ai | Taper /logout dans Claude Code |
| Erreur 401 | Clé erronée, révoquée ou tronquée | Recopier la clé, en créer une nouvelle |
| Erreur 429 ou JSON illisible | settings.json corrompu | Contrôler le fichier (ci-dessous) |
| Réponse coupée en plein milieu | VPN ou proxy qui interrompt le flux | Désactiver le VPN et réessayer |
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# valider settings.json (macOS, Linux)
jq . ~/.claude/settings.jsonGet-Content $env:USERPROFILE\.claude\settings.json | ConvertFrom-JsonMettre à jour ou désinstaller Claude Code
L’installeur natif se met à jour tout seul en arrière-plan. Pour forcer la mise à jour, lancez claude update. Les installations par Homebrew, WinGet ou un gestionnaire de paquets Linux se mettent à jour avec leur propre commande.
claude update
# Homebrew / WinGet
brew upgrade claude-code
winget upgrade Anthropic.ClaudeCodePour désinstaller une installation native sur macOS ou Linux, supprimez le lanceur et les versions téléchargées. Vos réglages et l’historique des sessions restent dans le dossier .claude, que vous pouvez conserver ou effacer à part.
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeQuestions fréquentes
Comment installer Claude Code sur Windows ?
Ouvrez PowerShell et lancez irm https://claude.ai/install.ps1 | iex, ou installez-le avec WinGet : winget install Anthropic.ClaudeCode. Aucun droit administrateur n’est requis. Vérifiez ensuite avec claude --version dans un nouveau terminal.
Faut-il installer Node.js pour Claude Code ?
Non, pas avec l’installeur natif, Homebrew ou WinGet. Seule l’installation par npm demande Node.js 22 ou plus. Les tutoriels qui parlent de Node.js 18 sont dépassés.
Comment télécharger Claude Code sur Mac ?
Dans le Terminal, tapez curl -fsSL https://claude.ai/install.sh | bash, ou brew install --cask claude-code si vous utilisez Homebrew. L’installation en ligne de commande ne passe par aucun fichier .dmg : une seule ligne suffit.
Claude Code est-il gratuit ?
Le logiciel se télécharge gratuitement, mais l’usage des modèles est payant. Le forfait gratuit de claude.ai n’inclut pas Claude Code. Avec une clé OneProvider, vous payez uniquement les tokens consommés, sans abonnement.
Peut-on utiliser Claude Code sans abonnement Claude Pro ?
Oui. Définissez ANTHROPIC_BASE_URL sur https://api.oneprovider.dev et ANTHROPIC_AUTH_TOKEN sur votre clé : aucune connexion à un compte claude.ai n’est nécessaire. Si un écran de connexion apparaît, tapez /logout.
Pourquoi la commande claude est-elle introuvable après l’installation ?
Le dossier ~/.local/bin n’est probablement pas dans votre PATH, ou le terminal était déjà ouvert pendant l’installation. Ajoutez le dossier à votre fichier ~/.zshrc, ou fermez et rouvrez le terminal sous Windows.
Comment mettre à jour ou désinstaller Claude Code ?
Lancez claude update pour mettre à jour une installation native. Pour désinstaller, supprimez ~/.local/bin/claude et ~/.local/share/claude, ou utilisez brew uninstall --cask claude-code ou winget uninstall Anthropic.ClaudeCode.
Comment payer depuis la France ?
Par carte bancaire de n’importe quel pays, Apple Pay ou Google Pay sur la page de paiement, ou en cryptomonnaie via Telegram. Le solde est en dollars, avec un minimum de 20 $ et la conversion affichée avant validation.
Claude, ChatGPT, GPT, Cursor et les autres noms de produits sont des marques de leurs propriétaires, utilisées uniquement pour décrire la compatibilité. Nous ne donnons pas de conseils juridiques : le respect des règles locales reste à la charge de l’utilisateur.