Dépanner l'installation et la connexion

Si l’installation échoue ou que vous ne pouvez pas vous connecter, trouvez votre erreur ci-dessous. Pour les problèmes d’exécution après que Claude Code fonctionne, consultez Dépannage. Pour les problèmes de configuration tels que les paramètres qui ne s’appliquent pas ou les hooks qui ne se déclenchent pas, consultez Déboguer votre configuration.

Trouvez votre erreur

Faites correspondre le message d’erreur ou le symptôme que vous voyez à une solution :

Ce que vous voyez	Solution
`command not found: claude` ou `'claude' is not recognized`	Corrigez votre PATH
`syntax error near unexpected token '<'`	Le script d’installation retourne du HTML
`curl: (56) Failure writing output to destination`	Vérifiez la connectivité ou utilisez un programme d’installation alternatif
`Killed` pendant l’installation sur Linux	Ajoutez de l’espace d’échange pour les serveurs à faible mémoire
`TLS connect error` ou `SSL/TLS secure channel`	Mettez à jour les certificats CA
`Failed to fetch version` ou impossible d’atteindre le serveur de téléchargement	Vérifiez les paramètres réseau et proxy
`irm is not recognized` ou `&& is not valid`	Utilisez la bonne commande pour votre shell
`'bash' is not recognized as the name of a cmdlet`	Utilisez la commande du programme d’installation Windows
`Claude Code on Windows requires git-bash`	Installez ou configurez Git Bash
`Claude Code does not support 32-bit Windows`	Ouvrez Windows PowerShell, pas l’entrée x86
`Error loading shared library`	Mauvaise variante binaire pour votre système
`Illegal instruction`	Incompatibilité d’architecture ou d’ensemble d’instructions CPU
`cannot execute binary file: Exec format error` dans WSL	Régression binaire native WSL1
Le programme d’installation PowerShell se termine mais `claude` n’est pas trouvé ou affiche une ancienne version	Redémarrez votre terminal et vérifiez PATH
`dyld: cannot load`, `dyld: Symbol not found`, ou `Abort trap` sur macOS	Incompatibilité binaire
`Invoke-Expression: Missing argument in parameter list`	Le script d’installation retourne du HTML
`App unavailable in region`	Claude Code n’est pas disponible dans votre pays. Consultez les pays pris en charge.
`unable to get local issuer certificate`	Configurez les certificats CA d’entreprise
`OAuth error` ou `403 Forbidden`	Corrigez l’authentification
`Could not load the default credentials` ou `Could not load credentials from any providers`	Identifiants Bedrock, Vertex ou Foundry
`ChainedTokenCredential authentication failed` ou `CredentialUnavailableError`	Identifiants Bedrock, Vertex ou Foundry
`API Error: 500`, `529 Overloaded`, `429`, ou autres erreurs 4xx et 5xx non listées ci-dessus	Consultez la Référence des erreurs

Si votre problème n’est pas listé, travaillez à travers les vérifications de diagnostic ci-dessous pour affiner la cause.

Si vous préférez ignorer complètement le terminal, l’application Claude Code Desktop vous permet d’installer et d’utiliser Claude Code via une interface graphique. Téléchargez-la pour macOS ou Windows et commencez à coder sans aucune configuration en ligne de commande.

Exécutez les vérifications de diagnostic

Vérifiez la connectivité réseau

Le programme d’installation télécharge depuis downloads.claude.ai. Vérifiez que vous pouvez l’atteindre :

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Une ligne HTTP/2 200 signifie que vous avez atteint le serveur. Si vous ne voyez aucune sortie, Could not resolve host, ou un délai d’expiration de connexion, votre réseau bloque la connexion. Les causes courantes incluent :

Les pare-feu d’entreprise ou les proxies bloquant downloads.claude.ai
Les restrictions réseau régionales : essayez un VPN ou un réseau alternatif
Les problèmes TLS/SSL : mettez à jour les certificats CA de votre système, ou vérifiez si HTTPS_PROXY est configuré

Si vous êtes derrière un proxy d’entreprise, définissez HTTPS_PROXY et HTTP_PROXY à l’adresse de votre proxy avant d’installer. Demandez à votre équipe informatique l’URL du proxy si vous ne la connaissez pas, ou vérifiez les paramètres proxy de votre navigateur. Cet exemple définit les deux variables de proxy, puis exécute le programme d’installation via votre proxy :

macOS/Linux
Windows PowerShell

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

Vérifiez votre PATH

Si l’installation a réussi mais que vous obtenez une erreur command not found ou not recognized lors de l’exécution de claude, le répertoire d’installation n’est pas dans votre PATH. Votre shell recherche les programmes dans les répertoires listés dans PATH, et le programme d’installation place claude à ~/.local/bin/claude sur macOS/Linux ou %USERPROFILE%\.local\bin\claude.exe sur Windows. Vérifiez si le répertoire d’installation est dans votre PATH en listant vos entrées PATH et en filtrant pour local/bin :

macOS/Linux
Windows PowerShell
Windows CMD

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

Si cela affiche /Users/you/.local/bin ou /home/you/.local/bin, le répertoire est dans votre PATH et vous pouvez passer à Vérifiez les installations en conflit. S’il n’y a pas de sortie, ajoutez-le à votre configuration shell.Pour Zsh, la valeur par défaut sur macOS :

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Pour Bash, la valeur par défaut sur la plupart des distributions Linux :

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Alternativement, fermez et rouvrez votre terminal.Vérifiez que la correction a fonctionné :

claude --version

$env:PATH -split ';' | Select-String '\.local\\bin'

S’il n’y a pas de sortie, ajoutez le répertoire d’installation à votre PATH utilisateur :

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Redémarrez votre terminal pour que la modification prenne effet.Vérifiez que la correction a fonctionné :

claude --version

echo %PATH% | findstr /i "local\bin"

S’il n’y a pas de sortie, ouvrez Paramètres système, allez à Variables d’environnement, et ajoutez %USERPROFILE%\.local\bin à votre variable PATH utilisateur. Redémarrez votre terminal.Vérifiez que la correction a fonctionné :

claude --version

Vérifiez les installations en conflit

Plusieurs installations de Claude Code peuvent causer des incompatibilités de version ou un comportement inattendu. Vérifiez ce qui est installé :

macOS/Linux
Windows PowerShell

Listez tous les binaires claude trouvés dans votre PATH :

which -a claude

Si cela n’affiche rien, aucun claude n’est encore sur votre PATH. Retournez à Vérifiez votre PATH.Vérifiez les trois emplacements d’où un binaire claude peut provenir. ~/.local/bin/claude est le programme d’installation natif, ~/.claude/local/ est une installation npm locale héritée créée par les anciennes versions de Claude Code, et la liste npm globale affiche une installation -g :

ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

npm -g ls @anthropic-ai/claude-code 2>/dev/null

Listez tous les binaires claude trouvés dans votre PATH :

where.exe claude

Vérifiez si le programme d’installation natif a placé un binaire :

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

Si vous trouvez plusieurs installations, conservez-en une seule. L’installation native à ~/.local/bin/claude sur macOS/Linux ou %USERPROFILE%\.local\bin\claude.exe sur Windows est recommandée. Supprimez les extras : Désinstallez une installation npm globale :

npm uninstall -g @anthropic-ai/claude-code

Supprimez l’installation npm locale héritée :

rm -rf ~/.claude/local

Sur Windows, utilisez PowerShell :

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"

Supprimez une installation Homebrew sur macOS. Si vous avez installé le cask claude-code@latest, remplacez ce nom :

brew uninstall --cask claude-code

Supprimez une installation WinGet sur Windows :

winget uninstall Anthropic.ClaudeCode

Vérifiez les permissions des répertoires

Le programme d’installation a besoin d’accès en écriture à ~/.local/bin/ et ~/.claude/ sur macOS et Linux. Sur Windows, l’emplacement d’installation est sous %USERPROFILE%, qui est accessible en écriture par votre utilisateur par défaut, donc cette section s’applique rarement là. Vérifiez si les répertoires sont accessibles en écriture :

test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"

Si l’un des répertoires n’est pas accessible en écriture, créez le répertoire d’installation et définissez votre utilisateur comme propriétaire :

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

Vérifiez que le binaire fonctionne

Si claude --version affiche une version mais que claude plante ou se fige au démarrage, exécutez ces vérifications pour affiner la cause. Si claude --version dit commande introuvable, allez d’abord à Vérifiez votre PATH ; les commandes ci-dessous supposent que claude est sur votre PATH. Confirmez que le binaire existe et est exécutable :

ls -la "$(command -v claude)"

Sur Windows, utilisez PowerShell :

Get-Command claude | Select-Object Source

Sur Linux, vérifiez les bibliothèques partagées manquantes. Si ldd affiche des bibliothèques manquantes, vous devrez peut-être installer des paquets système. Sur Alpine Linux et autres distributions basées sur musl, consultez Configuration Alpine Linux.

ldd "$(command -v claude)" | grep "not found"

Confirmez que le binaire peut s’exécuter :

claude --version

Problèmes d’installation courants

Ce sont les problèmes d’installation les plus fréquemment rencontrés et leurs solutions.

Le script d’installation retourne du HTML au lieu d’un script shell

Lors de l’exécution de la commande d’installation, vous pouvez voir l’une de ces erreurs :

bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'

Sur PowerShell, le même problème apparaît comme :

Invoke-Expression: Missing argument in parameter list.

Cela signifie que l’URL d’installation a retourné une page HTML au lieu du script d’installation. Si la page HTML dit « App unavailable in region », Claude Code n’est pas disponible dans votre pays. Consultez les pays pris en charge. Sinon, cela peut se produire en raison de problèmes réseau, de routage régional ou d’une interruption de service temporaire. Solutions :

Utilisez une méthode d’installation alternative : Sur macOS, installez via Homebrew :
```
brew install --cask claude-code
```
Sur Windows, installez via WinGet :
```
winget install Anthropic.ClaudeCode
```
Réessayez après quelques minutes : le problème est souvent temporaire. Attendez et réessayez la commande d’origine.

`command not found: claude` après l’installation

L’installation s’est terminée mais claude ne fonctionne pas. L’erreur exacte varie selon la plateforme :

Plateforme	Message d’erreur
macOS	`zsh: command not found: claude`
Linux	`bash: claude: command not found`
Windows CMD	`'claude' is not recognized as an internal or external command`
PowerShell	`claude : The term 'claude' is not recognized as the name of a cmdlet`

Cela signifie que le répertoire d’installation n’est pas dans le chemin de recherche de votre shell. Consultez Vérifiez votre PATH pour la correction sur chaque plateforme.

`curl: (56) Failure writing output to destination`

La commande curl ... | bash télécharge le script et le transmet à Bash pour exécution. Cette erreur signifie que la connexion s’est interrompue avant que le script ne soit complètement téléchargé. Les causes courantes incluent les interruptions réseau, le téléchargement bloqué en cours de flux, ou les limites de ressources système. Solutions :

Vérifiez la stabilité du réseau : les binaires Claude Code sont hébergés sur downloads.claude.ai. Testez que vous pouvez l’atteindre :
```
curl -sI https://downloads.claude.ai/claude-code-releases/latest
```
Une ligne HTTP/2 200 signifie que vous avez atteint le serveur et l’échec d’origine était probablement intermittent ; réessayez la commande d’installation. Si vous voyez Could not resolve host ou un délai d’expiration de connexion, votre réseau bloque le téléchargement.
Essayez une méthode d’installation alternative : Sur macOS :
```
brew install --cask claude-code
```
Sur Windows :
```
winget install Anthropic.ClaudeCode
```

Erreurs de connexion TLS ou SSL

Les erreurs comme curl: (35) TLS connect error, schannel: next InitializeSecurityContext failed, ou le Could not establish trust relationship for the SSL/TLS secure channel de PowerShell indiquent des échecs de négociation TLS. Solutions :

Mettez à jour vos certificats CA système : Sur Ubuntu/Debian :
```
sudo apt-get update && sudo apt-get install ca-certificates
```
Sur macOS, le curl système utilise le magasin de confiance Keychain ; la mise à jour de macOS lui-même met à jour les certificats racine.

Sur Windows, activez TLS 1.2 dans PowerShell avant d’exécuter le programme d’installation :

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

Vérifiez l’interférence du proxy ou du pare-feu : les proxies d’entreprise qui effectuent une inspection TLS peuvent causer ces erreurs, y compris unable to get local issuer certificate et SELF_SIGNED_CERT_IN_CHAIN. Pour l’étape d’installation, pointez curl vers votre bundle CA d’entreprise avec --cacert :
```
curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
```
Pour Claude Code lui-même une fois installé, définissez NODE_EXTRA_CA_CERTS pour que les demandes API fassent confiance au même bundle :
```
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
```
Demandez à votre équipe informatique le fichier de certificat si vous ne l’avez pas. Vous pouvez également essayer sur une connexion directe pour confirmer que le proxy est la cause.
Sur Windows, contournez les vérifications de révocation de certificat si vous voyez CRYPT_E_NO_REVOCATION_CHECK (0x80092012) ou CRYPT_E_REVOCATION_OFFLINE (0x80092013). Ceux-ci signifient que curl a atteint le serveur mais votre réseau bloque la recherche de révocation de certificat, ce qui est courant derrière les pare-feu d’entreprise. Ajoutez --ssl-revoke-best-effort à la commande d’installation :
```
curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```
Alternativement, installez avec winget install Anthropic.ClaudeCode, qui évite curl entièrement.

`Failed to fetch version from downloads.claude.ai`

Le programme d’installation n’a pas pu atteindre le serveur de téléchargement. Cela signifie généralement que downloads.claude.ai est bloqué sur votre réseau. Solutions :

Testez la connectivité directement :

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Si derrière un proxy, définissez HTTPS_PROXY pour que le programme d’installation puisse le router. Consultez configuration du proxy pour plus de détails.
```
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash
```
Si sur un réseau restreint, essayez un réseau différent ou un VPN, ou utilisez une méthode d’installation alternative : Sur macOS :
```
brew install --cask claude-code
```
Sur Windows :
```
winget install Anthropic.ClaudeCode
```

Mauvaise commande d’installation sur Windows

Si vous voyez 'irm' is not recognized, The token '&&' is not valid, ou 'bash' is not recognized as the name of a cmdlet, vous avez copié la commande d’installation pour un shell ou un système d’exploitation différent.

irm non reconnu : vous êtes dans CMD, pas PowerShell. Vous avez deux options : Ouvrez PowerShell en recherchant « PowerShell » dans le menu Démarrer, puis exécutez la commande d’installation d’origine :
```
irm https://claude.ai/install.ps1 | iex
```
Ou restez dans CMD et utilisez le programme d’installation CMD à la place :
```
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```
&& non valide : vous êtes dans PowerShell mais avez exécuté la commande du programme d’installation CMD. Utilisez le programme d’installation PowerShell :
```
irm https://claude.ai/install.ps1 | iex
```
bash non reconnu : vous avez exécuté le programme d’installation macOS/Linux sur Windows. Utilisez le programme d’installation PowerShell à la place :
```
irm https://claude.ai/install.ps1 | iex
```

Installation interrompue sur les serveurs Linux à faible mémoire

Si vous voyez Killed pendant l’installation sur un VPS ou une instance cloud :

Setting up Claude Code...
Installing Claude Code native build latest...
bash: line 142: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}

Le tueur OOM Linux a terminé le processus car le système a manqué de mémoire. Claude Code nécessite au moins 4 Go de RAM disponible. Solutions :

Ajoutez de l’espace d’échange si votre serveur a une RAM limitée. L’échange utilise l’espace disque comme mémoire de débordement, permettant à l’installation de se terminer même avec une RAM physique faible. Créez un fichier d’échange de 2 Go et activez-le :
```
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
```
Puis réessayez l’installation :
```
curl -fsSL https://claude.ai/install.sh | bash
```
Fermez les autres processus pour libérer de la mémoire avant d’installer.
Utilisez une instance plus grande si possible. Claude Code nécessite au moins 4 Go de RAM.

L’installation se fige dans Docker

Lors de l’installation de Claude Code dans un conteneur Docker, l’installation en tant que root dans / peut causer des blocages. Solutions :

Définissez un répertoire de travail avant d’exécuter le programme d’installation. Lorsqu’il est exécuté depuis /, le programme d’installation analyse l’ensemble du système de fichiers, ce qui provoque une utilisation excessive de la mémoire. La définition de WORKDIR limite l’analyse à un petit répertoire :
```
WORKDIR /tmp
RUN curl -fsSL https://claude.ai/install.sh | bash
```
Augmentez les limites de mémoire Docker si vous utilisez Docker Desktop :
```
docker build --memory=4g .
```

Claude Desktop remplace la commande `claude` sur Windows

Si vous avez installé une version antérieure de Claude Desktop, elle peut enregistrer un Claude.exe dans le répertoire WindowsApps qui prend la priorité PATH sur Claude Code CLI. L’exécution de claude ouvre l’application Desktop au lieu de la CLI. Mettez à jour Claude Desktop vers la dernière version pour corriger ce problème.

Claude Code sur Windows nécessite Git Bash

Claude Code sur Windows natif a besoin de Git pour Windows, qui fournit Git Bash pour exécuter les commandes shell. Si Git n’est pas installé, téléchargez-le depuis git-scm.com/downloads/win. Pendant la configuration, sélectionnez « Add to PATH ». Redémarrez votre terminal après l’installation. Si Git est déjà installé mais que Claude Code ne peut pas le trouver, définissez le chemin dans votre fichier settings.json :

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Si votre Git est installé ailleurs, trouvez le chemin en exécutant where.exe git dans PowerShell et utilisez le chemin bin\bash.exe de ce répertoire.

Claude Code ne supporte pas Windows 32 bits

Windows inclut deux entrées PowerShell dans le menu Démarrer : Windows PowerShell et Windows PowerShell (x86). L’entrée x86 s’exécute en tant que processus 32 bits et déclenche cette erreur même sur une machine 64 bits. Pour vérifier quel cas vous êtes, exécutez ceci dans la même fenêtre qui a produit l’erreur :

[Environment]::Is64BitOperatingSystem

Si cela affiche True, votre système d’exploitation est correct. Fermez la fenêtre, ouvrez Windows PowerShell sans le suffixe x86, et réexécutez la commande d’installation. Si cela affiche False, vous êtes sur une édition 32 bits de Windows. Claude Code nécessite un système d’exploitation 64 bits. Consultez les exigences système.

Incompatibilité binaire musl ou glibc Linux

Si vous voyez des erreurs concernant les bibliothèques partagées manquantes comme libstdc++.so.6 ou libgcc_s.so.1 après l’installation, le programme d’installation a peut-être téléchargé la mauvaise variante binaire pour votre système.

Error loading shared library libstdc++.so.6: No such file or directory

Cela peut se produire sur les systèmes basés sur glibc qui ont des paquets de compilation croisée musl installés, ce qui amène le programme d’installation à mal détecter le système comme musl. Solutions :

Vérifiez quelle libc votre système utilise :
```
ldd --version 2>&1 | head -1
```
La sortie mentionnant GNU libc ou GLIBC signifie glibc. La sortie mentionnant musl signifie musl.
Si vous êtes sur glibc mais avez obtenu le binaire musl, supprimez l’installation et réinstallez. Vous pouvez également télécharger manuellement le binaire correct en utilisant le manifeste à https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json. Déposez un problème GitHub avec la sortie de ldd --version et ls /lib/libc.musl*.
Si vous êtes réellement sur musl, comme Alpine Linux, installez les paquets requis :
```
apk add libgcc libstdc++ ripgrep
```

`Illegal instruction`

Si l’exécution de claude ou du programme d’installation affiche Illegal instruction, le binaire natif utilise des instructions CPU que votre processeur ne supporte pas. Il y a deux causes distinctes. Incompatibilité d’architecture. Le programme d’installation a téléchargé le mauvais binaire, par exemple x86 sur un serveur ARM. Vérifiez avec uname -m sur macOS ou Linux, ou $env:PROCESSOR_ARCHITECTURE dans PowerShell. Si le résultat ne correspond pas au binaire que vous avez reçu, déposez un problème GitHub avec la sortie. Ensemble d’instructions manquant sur les anciens processeurs. Si votre architecture est correcte mais que vous voyez toujours Illegal instruction, votre processeur manque probablement d’AVX ou d’une autre instruction que le binaire nécessite. Cela affecte environ les processeurs Intel et AMD antérieurs à 2013. Il n’y a actuellement pas de solution de contournement binaire native ; suivez le problème #50384 pour le statut, et incluez votre modèle de processeur depuis cat /proc/cpuinfo | grep "model name" | head -1 sur Linux ou sysctl -n machdep.cpu.brand_string sur macOS lors du signalement. Les méthodes d’installation alternatives téléchargent le même binaire natif et ne résoudront aucune des deux causes.

`dyld: cannot load` sur macOS

Si vous voyez dyld: cannot load, dyld: Symbol not found, ou Abort trap: 6 pendant l’installation, le binaire est incompatible avec votre version ou matériel macOS.

dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
Abort trap: 6

Une erreur Symbol not found qui référence libicucore indique également que votre version macOS est plus ancienne que celle que le binaire supporte :

dyld: Symbol not found: _ubrk_clone
  Referenced from: claude-darwin-x64 (which was built for Mac OS X 13.0)
  Expected in: /usr/lib/libicucore.A.dylib

Solutions :

Vérifiez votre version macOS : Claude Code nécessite macOS 13.0 ou ultérieur. Ouvrez le menu Apple et sélectionnez À propos de ce Mac pour vérifier votre version.
Mettez à jour macOS si vous êtes sur une version plus ancienne. Le binaire utilise des commandes de chargement et des bibliothèques système que les anciennes versions de macOS ne supportent pas. Les méthodes d’installation alternatives comme Homebrew téléchargent le même binaire et ne résoudront pas cette erreur.

`Exec format error` sur WSL1

Si l’exécution de claude dans WSL affiche cannot execute binary file: Exec format error, vous êtes sur WSL1 et vous rencontrez une régression binaire native connue suivie dans le problème #38788. Les en-têtes de programme du binaire ont changé d’une manière que le chargeur WSL1 ne peut pas gérer. La correction la plus propre est de convertir votre distribution en WSL2 depuis PowerShell :

wsl --set-version <DistroName> 2

Si vous devez rester sur WSL1, invoquez le binaire via l’éditeur de liens dynamique. Ajoutez cette fonction à ~/.bashrc dans WSL, en remplaçant le chemin si votre répertoire personnel diffère :

claude() {
  /lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
}

Puis exécutez source ~/.bashrc et réessayez claude.

Erreurs d’installation npm dans WSL

Ces problèmes s’appliquent si vous avez installé Claude Code avec npm install -g dans WSL. Si vous avez utilisé le programme d’installation natif, ignorez cette section. Problèmes de détection d’OS ou de plateforme. Si npm signale une incompatibilité de plateforme pendant l’installation, WSL utilise probablement le npm Windows. Exécutez d’abord npm config set os linux, puis installez avec npm install -g @anthropic-ai/claude-code --force. N’utilisez pas sudo. exec: node: not found lors de l’exécution de claude. Votre environnement WSL utilise probablement l’installation Windows de Node.js. Confirmez avec which npm et which node : les chemins commençant par /mnt/c/ sont des binaires Windows, tandis que les chemins Linux commencent par /usr/. Pour corriger cela, installez Node via le gestionnaire de paquets de votre distribution Linux ou via nvm. Conflits de version nvm. Si vous avez nvm installé à la fois dans WSL et Windows, basculer les versions de Node dans WSL peut casser car WSL importe le PATH Windows par défaut et le nvm Windows prend la priorité. La cause la plus courante est que nvm n’est pas chargé dans votre shell. Ajoutez le chargeur nvm à ~/.bashrc ou ~/.zshrc :

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

Ou chargez-le dans votre session actuelle :

source ~/.nvm/nvm.sh

Si nvm est chargé mais que les chemins Windows prennent toujours la priorité, prépendez explicitement votre chemin Node Linux :

export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

Évitez de désactiver l’importation du PATH Windows via appendWindowsPath = false car cela casse la capacité à appeler les exécutables Windows depuis WSL. De même, évitez de désinstaller Node.js de Windows si vous l’utilisez pour le développement Windows.

Erreurs de permission pendant l’installation

Si le programme d’installation natif échoue avec des erreurs de permission, le répertoire cible peut ne pas être accessible en écriture. Consultez Vérifiez les permissions des répertoires. Si vous avez précédemment installé avec npm et rencontrez des erreurs de permission spécifiques à npm, passez au programme d’installation natif :

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

Binaire natif non trouvé après l’installation npm

Le paquet npm @anthropic-ai/claude-code récupère le binaire natif via une dépendance optionnelle par plateforme comme @anthropic-ai/claude-code-darwin-arm64. Si l’exécution de claude après l’installation affiche Could not find native binary package "@anthropic-ai/claude-code-<platform>", vérifiez les causes suivantes :

Les dépendances optionnelles sont désactivées. Supprimez --omit=optional de votre commande d’installation npm, --no-optional de pnpm, ou --ignore-optional de yarn, et vérifiez que .npmrc ne définit pas optional=false. Puis réinstallez. Le binaire natif est livré uniquement en tant que dépendance optionnelle, donc il n’y a pas de secours JavaScript s’il est ignoré.
Plateforme non supportée. Les binaires précompilés sont publiés pour darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64, et win32-arm64. Claude Code ne livre pas de binaire pour d’autres plateformes ; consultez les exigences système.
Le miroir npm d’entreprise manque les paquets de plateforme. Assurez-vous que votre registre reflète les huit paquets @anthropic-ai/claude-code-* de plateforme en plus du paquet méta.

L’installation avec --ignore-scripts ne déclenche pas cette erreur. L’étape postinstall qui lie le binaire en place est ignorée, donc Claude Code revient à un wrapper qui localise et génère le binaire de plateforme à chaque lancement. Cela fonctionne mais démarre plus lentement ; réinstallez avec les scripts activés pour l’exécution directe.

Connexion et authentification

Ces sections traitent des échecs de connexion, des erreurs OAuth et des problèmes de jeton.

Réinitialisez votre connexion

Lorsque la connexion échoue et que la cause n’est pas évidente, une ré-authentification propre résout la plupart des cas :

Exécutez /logout pour vous déconnecter complètement
Fermez Claude Code
Redémarrez avec claude et complétez le processus d’authentification à nouveau

Si le navigateur ne s’ouvre pas automatiquement pendant la connexion, appuyez sur c pour copier l’URL OAuth dans votre presse-papiers, puis collez-la dans un navigateur manuellement. Cela fonctionne également lorsque l’URL s’enroule sur plusieurs lignes dans un terminal étroit ou SSH et ne peut pas être cliquée directement.

Erreur OAuth : Code invalide

Si vous voyez OAuth error: Invalid code. Please make sure the full code was copied, le code de connexion a expiré ou a été tronqué lors du copier-coller. Solutions :

Appuyez sur Entrée pour réessayer et complétez la connexion rapidement après l’ouverture du navigateur
Tapez c pour copier l’URL complète si le navigateur ne s’ouvre pas automatiquement
Si vous utilisez une session distante/SSH, le navigateur peut s’ouvrir sur la mauvaise machine. Copiez l’URL affichée dans le terminal et ouvrez-la dans votre navigateur local à la place.

403 Forbidden après la connexion

Si vous voyez API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}} après la connexion :

Utilisateurs Claude Pro/Max : vérifiez que votre abonnement est actif sur claude.ai/settings
Utilisateurs Anthropic Console : confirmez que votre compte a le rôle « Claude Code » ou « Developer ». Les administrateurs l’attribuent dans la console Anthropic sous Paramètres → Membres.
Derrière un proxy : les proxies d’entreprise peuvent interférer avec les demandes API. Consultez configuration réseau pour la configuration du proxy.

Cette organisation a été désactivée avec un abonnement actif

Si vous voyez API Error: 400 ... "This organization has been disabled" malgré un abonnement Claude actif, une variable d’environnement ANTHROPIC_API_KEY remplace vos identifiants OAuth d’abonnement. Cela se produit couramment lorsqu’une ancienne clé API d’un employeur ou d’un projet précédent est toujours définie dans votre profil shell. Lorsque ANTHROPIC_API_KEY est présente et que vous l’avez approuvée, Claude Code utilise cette clé au lieu des identifiants OAuth de votre abonnement. En mode non interactif avec le drapeau -p, la clé est toujours utilisée lorsqu’elle est présente. Consultez précédence d’authentification pour l’ordre de résolution complet. Pour utiliser votre abonnement à la place, défiez la variable d’environnement et supprimez-la de votre profil shell :

unset ANTHROPIC_API_KEY
claude

Vérifiez ~/.zshrc, ~/.bashrc, ou ~/.profile pour les lignes export ANTHROPIC_API_KEY=... et supprimez-les pour rendre le changement permanent. Sur Windows, vérifiez votre profil PowerShell à $PROFILE et vos variables d’environnement utilisateur pour ANTHROPIC_API_KEY. Exécutez /status dans Claude Code pour confirmer quelle méthode d’authentification est active.

La connexion OAuth échoue dans WSL2

La connexion basée sur le navigateur dans WSL2 peut échouer de deux façons : WSL ne peut pas ouvrir votre navigateur Windows, ou le terminal n’acceptera pas le code d’autorisation collé. Si le navigateur ne s’ouvre pas, définissez la variable d’environnement BROWSER sur le chemin de votre navigateur Windows :

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Ou appuyez sur c à l’invite de connexion pour copier l’URL OAuth et la coller dans votre navigateur Windows vous-même. Si le navigateur s’ouvre mais que coller le code dans le terminal ne fait rien, le raccourci de collage de votre terminal n’atteint probablement pas l’invite. Essayez le raccourci de collage alternatif de votre terminal, souvent clic droit ou Maj+Insérer dans Windows Terminal, ou exécutez la connexion en dehors de l’interface utilisateur interactive :

claude auth login

Ce secours s’applique également sur Windows natif ou tout terminal où coller le code dans l’invite interactive échoue.

Non connecté ou jeton expiré

Si Claude Code vous demande de vous connecter à nouveau après une session, votre jeton OAuth a peut-être expiré. Exécutez /login pour vous ré-authentifier. Si cela se produit fréquemment, vérifiez que votre horloge système est exacte, car la validation du jeton dépend des horodatages corrects. Sur macOS, la connexion peut également échouer lorsque le Keychain est verrouillé ou que son mot de passe est désynchronisé avec votre mot de passe de compte, ce qui empêche Claude Code de sauvegarder les identifiants. Exécutez claude doctor pour vérifier l’accès au Keychain. Pour déverrouiller le Keychain manuellement, exécutez security unlock-keychain ~/Library/Keychains/login.keychain-db. Si le déverrouillage n’aide pas, ouvrez Keychain Access, sélectionnez le Keychain login, et choisissez Édition > Changer le mot de passe du Keychain « login » pour le resynchroniser avec votre mot de passe de compte.

Les identifiants Bedrock, Vertex ou Foundry ne se chargent pas

Si vous avez configuré Claude Code pour utiliser un fournisseur cloud et voyez Could not load credentials from any providers sur Bedrock, Could not load the default credentials sur Vertex, ou ChainedTokenCredential authentication failed sur Foundry, votre CLI du fournisseur cloud n’est probablement pas authentifiée dans le shell actuel. Pour Bedrock, confirmez que vos identifiants AWS sont valides :

aws sts get-caller-identity

Pour Vertex AI, confirmez que ANTHROPIC_VERTEX_PROJECT_ID et CLOUD_ML_REGION sont définis dans votre shell, puis définissez les identifiants par défaut de l’application :

gcloud auth application-default login

Pour Microsoft Foundry, confirmez que ANTHROPIC_FOUNDRY_API_KEY est défini, ou connectez-vous avec l’interface de ligne de commande Azure pour que la chaîne d’identifiants par défaut puisse trouver votre compte :

az login

Si les identifiants fonctionnent dans votre terminal mais pas dans l’extension VS Code ou JetBrains, le processus IDE n’a probablement pas hérité de votre environnement shell. Définissez les variables d’environnement du fournisseur dans les paramètres de l’IDE lui-même, ou lancez l’IDE depuis un terminal où elles sont déjà exportées. Consultez Amazon Bedrock, Google Vertex AI, ou Microsoft Foundry pour la configuration complète du fournisseur.

Toujours bloqué

Si aucune des solutions ci-dessus ne résout votre problème :

Vérifiez le référentiel GitHub pour les problèmes connus, ou ouvrez-en un nouveau avec votre système d’exploitation, la commande d’installation que vous avez exécutée, et la sortie d’erreur complète
Si claude --version fonctionne mais quelque chose d’autre ne va pas, exécutez claude doctor pour un rapport de diagnostic automatisé
Si vous pouvez démarrer une session, utilisez /feedback dans Claude Code pour signaler le problème

Agents

Outils et plugins

Automatisation

Dépannage

Dépanner l'installation et la connexion

Trouvez votre erreur

Exécutez les vérifications de diagnostic

Vérifiez la connectivité réseau

Vérifiez votre PATH

Vérifiez les installations en conflit

Vérifiez les permissions des répertoires

Vérifiez que le binaire fonctionne

Problèmes d’installation courants

Le script d’installation retourne du HTML au lieu d’un script shell

`command not found: claude` après l’installation

`curl: (56) Failure writing output to destination`

Erreurs de connexion TLS ou SSL

`Failed to fetch version from downloads.claude.ai`

Mauvaise commande d’installation sur Windows

Installation interrompue sur les serveurs Linux à faible mémoire

L’installation se fige dans Docker

Claude Desktop remplace la commande `claude` sur Windows

Claude Code sur Windows nécessite Git Bash

Claude Code ne supporte pas Windows 32 bits

Incompatibilité binaire musl ou glibc Linux

`Illegal instruction`

`dyld: cannot load` sur macOS

`Exec format error` sur WSL1

Erreurs d’installation npm dans WSL

Erreurs de permission pendant l’installation

Binaire natif non trouvé après l’installation npm

Connexion et authentification

Réinitialisez votre connexion

Erreur OAuth : Code invalide

403 Forbidden après la connexion

Cette organisation a été désactivée avec un abonnement actif

La connexion OAuth échoue dans WSL2

Non connecté ou jeton expiré

Les identifiants Bedrock, Vertex ou Foundry ne se chargent pas

Toujours bloqué

Agents

Outils et plugins

Automatisation

Dépannage

Documentation Index

​Trouvez votre erreur

​Exécutez les vérifications de diagnostic

​Vérifiez la connectivité réseau

​Vérifiez votre PATH

​Vérifiez les installations en conflit

​Vérifiez les permissions des répertoires

​Vérifiez que le binaire fonctionne

​Problèmes d’installation courants

​Le script d’installation retourne du HTML au lieu d’un script shell

​command not found: claude après l’installation

​curl: (56) Failure writing output to destination

​Erreurs de connexion TLS ou SSL

​Failed to fetch version from downloads.claude.ai

​Mauvaise commande d’installation sur Windows

​Installation interrompue sur les serveurs Linux à faible mémoire

​L’installation se fige dans Docker

​Claude Desktop remplace la commande claude sur Windows

​Claude Code sur Windows nécessite Git Bash

​Claude Code ne supporte pas Windows 32 bits

​Incompatibilité binaire musl ou glibc Linux

​Illegal instruction

​dyld: cannot load sur macOS

​Exec format error sur WSL1

​Erreurs d’installation npm dans WSL

​Erreurs de permission pendant l’installation

​Binaire natif non trouvé après l’installation npm

​Connexion et authentification

​Réinitialisez votre connexion

​Erreur OAuth : Code invalide

​403 Forbidden après la connexion

​Cette organisation a été désactivée avec un abonnement actif

​La connexion OAuth échoue dans WSL2

​Non connecté ou jeton expiré

​Les identifiants Bedrock, Vertex ou Foundry ne se chargent pas

​Toujours bloqué

Trouvez votre erreur

Exécutez les vérifications de diagnostic

Vérifiez la connectivité réseau

Vérifiez votre PATH

Vérifiez les installations en conflit

Vérifiez les permissions des répertoires

Vérifiez que le binaire fonctionne

Problèmes d’installation courants

Le script d’installation retourne du HTML au lieu d’un script shell

`command not found: claude` après l’installation

`curl: (56) Failure writing output to destination`

Erreurs de connexion TLS ou SSL

`Failed to fetch version from downloads.claude.ai`

Mauvaise commande d’installation sur Windows

Installation interrompue sur les serveurs Linux à faible mémoire

L’installation se fige dans Docker

Claude Desktop remplace la commande `claude` sur Windows

Claude Code sur Windows nécessite Git Bash

Claude Code ne supporte pas Windows 32 bits

Incompatibilité binaire musl ou glibc Linux

`Illegal instruction`

`dyld: cannot load` sur macOS

`Exec format error` sur WSL1

Erreurs d’installation npm dans WSL

Erreurs de permission pendant l’installation

Binaire natif non trouvé après l’installation npm

Connexion et authentification

Réinitialisez votre connexion

Erreur OAuth : Code invalide

403 Forbidden après la connexion

Cette organisation a été désactivée avec un abonnement actif

La connexion OAuth échoue dans WSL2

Non connecté ou jeton expiré

Les identifiants Bedrock, Vertex ou Foundry ne se chargent pas

Toujours bloqué