Dépanner l'installation et la connexion

Corrigez les erreurs de commande introuvable, PATH, permission, réseau et authentification lors de l'installation ou de la connexion à Claude Code.

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 :

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

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

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

Vous avez atteint le serveur si la première ligne affiche un statut 200. Vous voyez HTTP/2 200 sur macOS et Linux, et HTTP/1.1 200 OK depuis le curl.exe inclus avec Windows. D'autres résultats pointent vers la cause :

• 403 : généralement un proxy ou un filtre réseau bloquant l'hôte, ou Claude Code n'est pas disponible dans votre région
• 5xx : généralement un problème de service temporaire ; attendez quelques minutes et réessayez

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 :

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 :

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

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

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

claude --version

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

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

claude --version

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

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é :

which -a claude

ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

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

where.exe claude

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

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)"

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

Voici 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 sous forme d'erreurs d'analyse pointant vers la page retournée, avec iex essayant d'exécuter du HTML et du CSS en tant que PowerShell :

iex : At line:1 char:2310
+ ... igin="anonymous"/><script type="text/javascript">!function(o,c){var n ...
Missing argument in parameter list.
...

La formulation varie selon la version de PowerShell et la langue du système : vous pouvez voir Missing expression after unary operator '--' ou une ParserError avec ParseException à la place. Les balises HTML ou le CSS dans le texte entre guillemets identifient cet échec. Si vous téléchargez avec -OutFile install.ps1 à la place, le fichier enregistré est la même page web, donc cela n'aide pas non plus.

Selon la façon dont la requête a été routée, vous pouvez à la place voir une erreur 403 sans corps HTML :

curl: (22) The requested URL returned error: 403

Tous ces cas signifient que l'URL d'installation a retourné une page HTML ou un statut d'erreur au lieu du script d'installation. Si la page HTML indique « App unavailable in region », Claude Code n'est pas disponible dans votre pays. Consultez les pays pris en charge.

Une erreur 403 nue sans corps a souvent la même cause, mais elle peut aussi provenir d'un proxy d'entreprise ou d'un pare-feu bloquant le téléchargement. Si vous êtes dans un pays pris en charge et voyez toujours l'erreur 403, consultez Vérifier la connectivité réseau avant d'essayer les programmes d'installation alternatifs ci-dessous, car ceux-ci accèdent aux mêmes hôtes.

Sinon, cela peut se produire en raison de problèmes réseau, de routage régional ou d'une interruption temporaire du service.

Solutions :

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

   Ensuite, exécutez claude --version pour confirmer : la commande affiche un numéro de version tel que 2.1.211 (Claude Code). Si le shell signale que claude n'est pas trouvé, ouvrez une nouvelle fenêtre de terminal et réessayez : la session à partir de laquelle vous avez installé conserve son ancien PATH.

2. 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. Le message d'erreur exact varie selon la plateforme :

Cela signifie que le répertoire d'installation ne se trouve pas dans le chemin de recherche de votre shell. Consultez Vérifier 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, et l'erreur associée curl: (23) Failure writing output to destination, signifient que Bash n'a pas reçu le script complet. Le code de sortie 56 indique que le téléchargement lui-même a été interrompu, et le code de sortie 23 indique que curl n'a pas pu écrire ce qu'il a reçu dans le tuyau, généralement parce que Bash s'est fermé prématurément.

Testez que vous pouvez atteindre downloads.claude.ai avec la vérification dans Vérifier la connectivité réseau. Si vous avez atteint le serveur, l'échec d'origine était probablement intermittent ; réessayez la commande d'installation. Vous pouvez également essayer une méthode d'installation alternative.

Cask Homebrew indisponible ou obsolète

Homebrew signale Error: Cask 'claude-code' is unavailable: No Cask with this name exists lorsque votre copie locale de l'index des casks Homebrew est antérieure à la publication du cask. Actualisez l'index et réessayez :

brew update
brew install --cask claude-code

Si Homebrew installe une version de Claude Code plus ancienne que celle attendue, le même index obsolète en est généralement la cause. Le cask claude-code suit le canal stable et est généralement environ une semaine en retard sur la dernière version ; pour la version la plus récente, exécutez brew install --cask claude-code@latest à la place. Consultez Configurer le canal de version pour connaître la différence entre les deux casks.

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 :

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

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

3. 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, faites en sorte que le téléchargement d'installation fasse confiance à l'autorité de certification de votre proxy d'entreprise :

   macOS/Linux Windows PowerShell

   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 requêtes API fassent confiance au même bundle :

   macOS/Linux Windows PowerShell

   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 en est la cause.

4. Sur Windows, contournez les vérifications de révocation bloquées. Les erreurs CRYPT_E_NO_REVOCATION_CHECK (0x80092012) et CRYPT_E_REVOCATION_OFFLINE (0x80092013) 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. Si la commande défaillante est le curl qui télécharge install.cmd, réexécutez-la à partir d'une invite de commande avec --ssl-revoke-best-effort ajouté :

   curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
   

   Lorsque les téléchargements du script lui-même rencontrent les mêmes erreurs, il les réessaie automatiquement avec la vérification de révocation au mieux, donc l'indicateur n'est nécessaire que sur la commande que vous exécutez vous-même. La vérification au mieux tolère un serveur de révocation inaccessible mais rejette toujours un certificat connu pour être révoqué, ce qui correspond à la façon dont les navigateurs gèrent la révocation. Vous pouvez également éviter entièrement la vérification de révocation de curl en exécutant le programme d'installation PowerShell à partir de PowerShell, qui télécharge via .NET et ne échoue pas lorsque le serveur de révocation est inaccessible :

   irm https://claude.ai/install.ps1 | iex
   

   Vous pouvez également installer 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. Consultez Vérifier la connectivité réseau.

Mauvaise commande d'installation sur Windows

Si vous voyez 'irm' is not recognized, The token '&&' is not a valid statement separator, A parameter cannot be found that matches parameter name 'fsSL', 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. Si la commande affiche le texte du script au lieu d'installer quoi que ce soit, vous n'avez exécuté qu'une partie de celle-ci.

• 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
  

• && n'est pas un séparateur d'instruction 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
  

• A parameter cannot be found that matches parameter name 'fsSL' : vous avez exécuté le programme d'installation curl -fsSL ... | bash macOS/Linux dans Windows PowerShell, où curl est un alias pour Invoke-WebRequest et rejette les indicateurs -fsSL. Utilisez le programme d'installation PowerShell à la place :

  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
  

• La commande affiche le texte du script au lieu d'installer : vous avez exécuté la moitié du téléchargement de la commande sans la partie qui l'exécute. irm https://claude.ai/install.ps1 seul affiche le script téléchargé au terminal. Transmettez-le à iex pour l'exécuter :

  irm https://claude.ai/install.ps1 | iex
  

  Dans CMD, curl -fsSL https://claude.ai/install.cmd sans -o affiche le script batch au lieu de l'enregistrer. Exécutez la commande complète :

  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  

Quel que soit le programme d'installation utilisé, confirmez qu'il a fonctionné : ouvrez un nouveau terminal et exécutez claude --version, qui affiche un numéro de version tel que 2.1.211 (Claude Code).

`running scripts is disabled on this system`

L'installation ou l'exécution de Claude Code via npm sur Windows peut échouer avec une SecurityError :

npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
...
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException

La même erreur nomme claude.ps1 lorsque vous exécutez claude après une installation npm. La politique d'exécution de PowerShell bloque les scripts .ps1 lanceurs que npm crée pour ses commandes. La politique s'applique aux fichiers de script, elle n'affecte donc pas le programme d'installation PowerShell irm https://claude.ai/install.ps1 | iex, qui exécute le texte téléchargé directement.

Solutions :

1. Autorisez les scripts créés localement pour votre utilisateur, puis réessayez :

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

2. Appelez le lanceur .cmd à la place : npm.cmd et claude.cmd font le même travail, et la politique ne les couvre pas.
3. Utilisez le programme d'installation PowerShell à la place de npm. Il installe un binaire plutôt qu'un script .ps1.

`The process cannot access the file` lors de l'installation Windows

Si le programme d'installation PowerShell échoue avec Failed to download binary: The process cannot access the file ... because it is being used by another process, le programme d'installation n'a pas pu écrire dans %USERPROFILE%\.claude\downloads. Cela signifie généralement qu'une tentative d'installation précédente est toujours en cours d'exécution, ou qu'un logiciel antivirus analyse un binaire partiellement téléchargé dans ce dossier.

Fermez toutes les autres fenêtres PowerShell exécutant le programme d'installation et attendez que les analyses antivirus libèrent le fichier. Ensuite, supprimez le dossier des téléchargements et exécutez le programme d'installation à nouveau :

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

Installation arrêtée sur les serveurs Linux à faible mémoire

Un message Killed lors de l'installation signifie généralement que le tueur de mémoire insuffisante (OOM) Linux a terminé l'étape claude install parce que le système a manqué de mémoire libre. C'est courant sur les petits VPS et instances cloud. Le script d'installation signale la cause et se termine avec le code 137. Dans cet exemple, le numéro de ligne et l'ID de processus varient selon la version et l'exécution :

Setting up Claude Code...
bash: line 183: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

L'installation nécessite environ 512 Mo de mémoire libre, et l'exécution de Claude Code en nécessite davantage. Consultez les exigences système.

Solutions :

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

   Ensuite, réessayez l'installation :

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

2. Fermez d'autres processus pour libérer de la mémoire avant l'installation.

3. Utilisez une instance plus grande si possible. Claude Code nécessite au moins 4 Go de RAM.

L'installation se bloque 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 :

1. Définissez un répertoire de travail avant d'exécuter le programme d'installation. Lorsqu'il est exécuté à partir de /, 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
   

2. Donnez à Docker plus de mémoire si vous utilisez Docker Desktop. Les conteneurs de construction partagent la mémoire allouée à la machine virtuelle Docker Desktop, donc ouvrez Settings > Resources dans Docker Desktop, augmentez la limite de mémoire et réexécutez la construction.

`Raw mode is not supported` lors de l'installation

Lorsque les paramètres gérés par le serveur de votre organisation incluent des modifications qui nécessitent une approbation de sécurité, les versions de Claude Code antérieures à 2.1.246 essaient d'afficher la boîte de dialogue d'approbation lors de claude install. La boîte de dialogue a besoin d'un terminal sur stdin. Lorsque le programme d'installation exécute claude install à partir d'un tuyau, comme le fait curl -fsSL https://claude.ai/install.sh | bash, stdin est le tuyau plutôt qu'un terminal, donc l'installation échoue avec une erreur contenant Raw mode is not supported.

Claude Code v2.1.246 et versions ultérieures n'affichent pas la boîte de dialogue lors de claude install ou claude update. La commande s'exécute avec les paramètres que vous avez approuvés en dernier, et Claude Code affiche la boîte de dialogue dans votre prochaine session interactive. Si la configuration de démarrage de votre organisation attend la récupération des paramètres, par exemple lorsqu'elle définit forceRemoteSettingsRefresh, la boîte de dialogue apparaît toujours lors de ces commandes, et une exécution d'installation à partir d'un tuyau échoue toujours.

Dans toute autre configuration, réexécuter le programme d'installation dépasse cette erreur, car le script exécute la commande install de la dernière version même lorsque vous demandez d'installer une version plus ancienne. Réexécutez la commande pour votre plateforme :

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

irm https://claude.ai/install.ps1 | iex

claude --version affiche la version que la réexécution a installée.

`claude update` ou `claude doctor` se bloque

claude update et claude doctor analysent vos fichiers de configuration shell pour un alias claude obsolète : ~/.zshrc, ~/.bashrc, et ~/.config/fish/config.fish, plus sur macOS le premier de ~/.bash_profile, ~/.bash_login, ou ~/.profile qui existe. Si vous définissez ZDOTDIR, le fichier Zsh est $ZDOTDIR/.zshrc à la place. Lorsque l'un de ces chemins est un répertoire, Claude Code le saute et les deux commandes se terminent normalement. Avant v2.1.214, un répertoire à l'un de ces chemins faisait bloquer les deux commandes et laissait la section Diagnostics système de /status vide. claude doctor s'est bloqué sans sortie ; claude update s'est bloqué juste après l'affichage de Checking for updates.

Si vous rencontrez le blocage sur une version antérieure, trouvez le répertoire. Dans la sortie de cette commande, une ligne commençant par d marque ce chemin comme un répertoire. Une ligne No such file or directory signifie que rien n'existe à ce chemin et n'en est pas la cause :

ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

Déplacez le répertoire de côté, ou mettez à jour vers v2.1.214 ou ultérieur. Puisque claude update se bloque sur les versions affectées, mettez à jour en réexécutant le script d'installation à la place.

Claude Desktop remplace la commande `claude` sur Windows

Si vous avez installé une version plus ancienne 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 soit Git for Windows (pour bash) soit PowerShell

Git for Windows est optionnel. Claude Code utilise l'outil PowerShell en l'absence de Git Bash, donc cette erreur signifie qu'aucun shell n'a été trouvé.

Si PowerShell manque de votre PATH, son emplacement par défaut est C:\Windows\System32\WindowsPowerShell\v1.0\. Ajoutez ce répertoire à votre PATH, ou installez PowerShell 7, qui fournit pwsh.

Pour installer Git for Windows à la place, téléchargez-le depuis git-scm.com/downloads/win. Lors de la configuration, sélectionnez « Add to PATH ». Redémarrez votre terminal après l'installation. L'installation l'active, ce qui active l'outil Bash, utile lorsque vous travaillez avec des scripts et des outils basés sur Bash.

Si Git est déjà installé mais Claude Code ne peut pas le trouver, comparez son emplacement par rapport aux endroits où Claude Code cherche. Lorsque CLAUDE_CODE_GIT_BASH_PATH n'est pas défini, Claude Code cherche bash.exe dans cet ordre :

1. Les emplacements d'installation par défaut C:\Program Files\Git et C:\Program Files (x86)\Git.
2. Le git sur votre PATH, en utilisant le bin\bash.exe de cette installation Git.

À l'étape 2, Claude Code saute un git qui se trouve dans le dossier à partir duquel vous avez lancé Claude Code, ou en dessous dans un chemin qui contient node_modules ou un dossier d'environnement virtuel tel que .venv ou env, par exemple C:\dev\env\myproject\Git lorsque vous avez lancé à partir de C:\dev\env\myproject. Cela empêche Claude Code d'exécuter un exécutable qu'un projet y a placé. Si votre Git se trouve dans un emplacement comme celui-ci, pointez CLAUDE_CODE_GIT_BASH_PATH vers lui.

Pour pointer Claude Code vers une installation Git spécifique, trouvez-la en exécutant where.exe git dans PowerShell, puis définissez le chemin bin\bash.exe de cette installation en tant que CLAUDE_CODE_GIT_BASH_PATH dans votre fichier settings.json :

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

Si CLAUDE_CODE_GIT_BASH_PATH est défini sur le chemin correct et que le fichier existe mais Claude Code ne l'utilise toujours pas, vérifiez d'abord le nom du fichier. Claude Code n'accepte qu'un fichier nommé bash.exe, sh.exe, bash, ou sh ; avec tout autre nom, tel que le lanceur git-bash.exe de Git for Windows, il ignore la variable et détecte automatiquement Git Bash comme s'il n'était pas défini, en enregistrant un avertissement visible avec --debug. Un chemin qui n'existe pas obtient le même repli et avertissement. Avant v2.1.219, Claude Code utilisait n'importe quel fichier existant comme shell sans vérifier son nom, et se terminait au démarrage avec Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path lorsque le chemin n'existait pas.

Si le nom du fichier est correct, un logiciel de sécurité des points de terminaison tel que AppLocker, les stratégies de restriction logicielle de la stratégie de groupe, ou les agents EDR peuvent interférer. Demandez à votre équipe informatique de mettre en liste blanche claude.exe et les processus qu'il génère, y compris cmd.exe et bash.exe, dans votre politique de protection des points de terminaison.

Claude Code ne prend pas en charge 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 des bibliothèques partagées manquantes comme libstdc++.so.6 ou libgcc_s.so.1 après l'installation, le programme d'installation peut avoir 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 packages de compilation croisée musl installés, ce qui amène le programme d'installation à mal détecter le système comme musl.

Solutions :

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

2. 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*.

3. Si vous êtes réellement sur musl, tel que Alpine Linux, installez les packages requis :

   apk add libgcc libstdc++ ripgrep
   

   Sur Alpine, ripgrep se trouve dans le référentiel communautaire. Si apk signale que le package manque, consultez Configuration Alpine Linux.

`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 prend pas en charge. 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 AVX manquant. Si votre architecture est correcte mais que vous voyez toujours Illegal instruction, votre CPU 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, et les machines virtuelles où l'hyperviseur ne transmet pas AVX à l'invité.

Sur un VPS ou une VM, exécutez grep -m1 -ow avx /proc/cpuinfo ; un résultat vide signifie qu'AVX n'est pas disponible pour l'invité.

Il n'y a pas de solution de contournement binaire natif ; suivez le problème #50384 pour l'état, et incluez votre modèle de CPU à partir de grep -m1 "model name" /proc/cpuinfo 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: Symbol not found, dyld: cannot load, ou Abort trap: 6 lors de l'installation, le binaire est incompatible avec votre version ou matériel macOS.

Une erreur Symbol not found qui référence libicucore signifie que votre version macOS est plus ancienne que celle que le binaire prend en charge :

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

Le chargeur peut à la place rejeter les commandes de chargement du binaire, ce qui signifie également que votre version macOS est trop ancienne :

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

Solutions :

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

2. 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 versions macOS plus anciennes ne prennent pas en charge. 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 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 à partir de 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")" "$@"
}

Ensuite, 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 du système d'exploitation ou de la plateforme. Si npm signale une incompatibilité de plateforme lors de 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 packages 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 échouer 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éfixez explicitement votre chemin Node Linux :

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

Erreurs de permission lors de 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érifier les permissions du répertoire.

Si vous avez précédemment installé avec npm et rencontrez des erreurs de permission spécifiques à npm, basculez vers le programme d'installation natif :

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

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

Le package npm @anthropic-ai/claude-code télécharge le binaire natif en tant que dépendance optionnelle par plateforme, tel que @anthropic-ai/claude-code-darwin-arm64. npm exécute ensuite le script postinstall du package, qui copie ce binaire en place en tant que commande claude ; jusqu'à ce qu'il s'exécute, claude est un script d'espace réservé. Si l'étape de téléchargement ou de postinstall est ignorée, l'espace réservé reste en place, et l'exécution de claude sur macOS et Linux affiche :

Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).

Run the postinstall manually (adjust path for local vs global install):
  node node_modules/@anthropic-ai/claude-code/install.cjs

Or reinstall without --ignore-scripts / --omit=optional.

Sur Windows, bin/claude.exe est ce même script d'espace réservé shell plutôt qu'un vrai exécutable, donc PowerShell et CMD signalent qu'ils ne peuvent pas exécuter le fichier au lieu d'afficher ce message.

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. Ensuite, réinstallez. Le binaire natif est livré uniquement en tant que dépendance optionnelle, il n'y a donc pas de secours JavaScript s'il est ignoré, et l'exécution de install.cjs à nouveau ne peut pas placer un binaire qui n'a jamais été téléchargé.
• Les scripts d'installation sont désactivés. --ignore-scripts et certaines configurations pnpm ignorent l'étape postinstall mais téléchargent toujours le package de plateforme. Exécutez node node_modules/@anthropic-ai/claude-code/install.cjs comme le suggère le message, ou réinstallez sans l'indicateur. Si postinstall ne peut pas s'exécuter du tout dans votre environnement, node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs trouve le package téléchargé et le lance, au prix d'un processus Node supplémentaire à chaque démarrage. Si l'enveloppe affiche Could not find native binary package à la place, le package de plateforme n'a jamais été téléchargé, donc corrigez d'abord la cause des dépendances optionnelles ci-dessus.
• Plateforme non prise en charge. 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. Sur FreeBSD, le programme d'installation signale la plateforme comme non prise en charge. Avant v2.1.205, il traitait FreeBSD comme Linux et téléchargeait un binaire qui ne pouvait pas s'exécuter.
• Le miroir npm d'entreprise manque les packages de plateforme. Assurez-vous que votre registre met en miroir les huit packages @anthropic-ai/claude-code-* de plateforme en plus du package méta.

Erreur npm `ENOTEMPTY` lors de la mise à jour ou de la réinstallation

Lorsque vous exécutez npm install -g @anthropic-ai/claude-code sur une installation existante, npm peut échouer lors du déplacement de l'ancien répertoire de package :

npm error code ENOTEMPTY
npm error syscall rename
npm error path /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/claude-code
npm error dest /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/.claude-code-tVWAnUUt
npm error errno -39
npm error ENOTEMPTY: directory not empty, rename '...'

La ligne npm error path nomme le répertoire que npm n'a pas pu déplacer. Supprimez ce répertoire et tous les répertoires .claude-code-* restants à côté, que les exécutions interrompues antérieures peuvent laisser derrière. Les commandes ci-dessous trouvent votre répertoire de package global avec npm root -g ; si le répertoire que la ligne npm error path nomme ne se trouve pas sous le répertoire que npm root -g affiche, par exemple parce que vous avez basculé les versions de Node avec nvm, supprimez les répertoires que l'erreur nomme à la place :

rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*

Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"

Ensuite, réinstallez :

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

Confirmez avec claude --version, qui affiche un numéro de version tel que 2.1.211 (Claude Code).

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 :

1. Exécutez /logout pour vous déconnecter complètement
2. Fermez Claude Code
3. 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

Remove-Item Env: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, SSH ou conteneurs

Lorsque Claude Code s'exécute dans WSL2, sur une machine distante via SSH ou à l'intérieur d'un conteneur, le navigateur s'ouvre généralement sur un hôte différent et sa redirection ne peut pas atteindre le serveur de rappel local de Claude Code. Après vous être connecté, le navigateur affiche un code de connexion au lieu de rediriger automatiquement. Collez ce code dans le terminal à l'invite Paste code here if prompted pour terminer la connexion.

Si le navigateur ne s'ouvre pas du tout depuis WSL2, 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

Sinon, appuyez sur c à l'invite de connexion interactive pour copier l'URL OAuth, ou copiez l'URL que claude auth login affiche, et ouvrez-la dans un navigateur sur votre machine locale.

Si coller le code dans l'invite interactive ne fait rien, le raccourci de collage de votre terminal n'atteint probablement pas le champ de saisie. Essayez le raccourci de collage alternatif de votre terminal, souvent clic droit ou Maj+Insérer dans Windows Terminal, ou utilisez claude auth login à la place, qui lit le code collé à partir de l'entrée standard :

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.

Les sessions parallèles sur une machine partagent une connexion enregistrée et coordonnent son renouvellement afin qu'un seul processus actualise le jeton à la fois. Avant la v2.1.211, le réveil de la machine du sommeil pouvait faire que deux sessions se renouvellent avec le même jeton, ce qui révoquait la connexion enregistrée et invitait chaque session ouverte à se connecter à nouveau à la fois.

Sur macOS, Claude Code enregistre les identifiants dans le Keychain de connexion. Lorsque le Keychain rejette l'écriture, par exemple lorsqu'il est verrouillé dans une session SSH ou que son mot de passe est désynchronisé avec votre mot de passe de compte, Claude Code enregistre votre connexion dans le fichier en texte brut ~/.claude/.credentials.json à la place. Une connexion Console qui crée une clé API échoue jusqu'à ce que le Keychain soit à nouveau accessible en écriture.

Pour rendre le Keychain à nouveau accessible en écriture et déplacer votre connexion dans le Keychain chiffré :

security unlock-keychain ~/Library/Keychains/login.keychain-db

Les identifiants Bedrock, Agent Platform 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 Amazon Bedrock, Could not load the default credentials sur Google Cloud's Agent Platform, ou ChainedTokenCredential authentication failed sur Microsoft Foundry, votre CLI du fournisseur cloud n'est probablement pas authentifiée dans le shell actuel.

Pour Amazon Bedrock, confirmez que vos identifiants AWS sont valides :

aws sts get-caller-identity

Pour Google Cloud's Agent Platform, 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 Cloud's Agent Platform, ou Microsoft Foundry pour la configuration complète du fournisseur.

Toujours bloqué

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

1. 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
2. Si claude --version fonctionne mais quelque chose d'autre ne va pas, exécutez claude doctor pour un rapport de diagnostic automatisé
3. Si vous pouvez démarrer une session, utilisez /feedback dans Claude Code pour signaler le problème
4. Si le problème concerne votre compte plutôt que l'installation, comme une boucle de connexion, un abonnement qui n'est pas reconnu, ou une organisation désactivée, contactez le support Anthropic : connectez-vous à claude.ai (Utilisateurs Console : platform.claude.com), cliquez sur vos initiales en bas à gauche, et sélectionnez Obtenir de l'aide. Consultez Comment obtenir du support pour le flux complet.