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: (22) The requested URL returned error: 403`	Le script d’installation a retourné 403
`curl: (23)` ou `curl: (56) Failure writing output to destination`	Vérifiez la connectivité ou utilisez un programme d’installation alternatif
`Killed` pendant l’installation sur Linux, ou `Installation was killed before it could finish (exit code 137)`	Libérez de la mémoire ou ajoutez de l’espace d’échange
`Raw mode is not supported` pendant l’installation	Réexécutez le programme d’installation
`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
`Cask 'claude-code' is unavailable: No Cask with this name exists`	Mettez à jour Homebrew
`'bash' is not recognized as the name of a cmdlet`	Utilisez la commande du programme d’installation Windows
`A parameter cannot be found that matches parameter name 'fsSL'`	Utilisez la commande du programme d’installation Windows
`Claude Code on Windows requires either Git for Windows (for bash) or PowerShell`	Installez un shell
`Claude Code does not support 32-bit Windows`	Ouvrez Windows PowerShell, pas l’entrée x86
`The process cannot access the file ... because it is being used by another process`	Videz le dossier des téléchargements et réessayez
`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	Ajoutez le répertoire d’installation à votre PATH, puis ouvrez un nouveau terminal
`dyld: Symbol not found`, `dyld: cannot load`, ou `Abort trap` sur macOS	Incompatibilité binaire
`claude update` se bloque après `Checking for updates`, ou `claude doctor` se bloque sans sortie	Déplacez le répertoire à un chemin de configuration shell
`Invoke-Expression` ou `iex` erreurs d’analyse citant des balises HTML ou CSS, ou `ParserError` avec `ParseException`	Le script d’installation retourne du HTML
`running scripts is disabled on this system` ou `PSSecurityException`	Autorisez les shims npm à s’exécuter
`Error: claude native binary not installed`	Complétez l’installation npm
`npm error code ENOTEMPTY` pendant la mise à jour ou la réinstallation	Supprimez le répertoire de package restant
Sur Windows, la commande d’installation imprime le texte du script et rien ne s’installe	Exécutez la commande d’installation complète
`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
`Unable to connect to Anthropic services` pendant la configuration	Consultez Unable to connect to Anthropic services dans la Référence des erreurs
`Could not load the default credentials` ou `Could not load credentials from any providers`	Identifiants Amazon Bedrock, Google Cloud’s Agent Platform ou Microsoft Foundry
`ChainedTokenCredential authentication failed` ou `CredentialUnavailableError`	Identifiants Amazon Bedrock, Google Cloud’s Agent Platform ou Microsoft 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. Sur Linux, installez l’application avec apt en suivant les instructions d’installation Linux.

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 :

macOS/Linux
Windows PowerShell

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

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

PowerShell crée un alias curl vers Invoke-WebRequest, qui rejette les drapeaux -sI, donc appelez curl.exe explicitement.

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 :

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.

L’extension VS Code ne place pas claude à cet emplacement. Elle regroupe une copie privée de la CLI à l’intérieur du répertoire d’extension pour son propre panneau de chat et ne l’ajoute pas à PATH. Si vous avez uniquement installé l’extension, ~/.local/bin/claude n’existera pas. Exécutez l’installation autonome pour utiliser claude à partir d’un terminal, puis continuez ci-dessous.

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.Pour les autres shells tels que fish ou Nushell, ajoutez ~/.local/bin à votre PATH en utilisant la syntaxe de configuration propre à votre shell, puis redémarrez 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

Une installation native affiche un lien symbolique dans ~/.local/share/claude/versions/. Un script ou un lien symbolique que vous avez créé vous-même à ce chemin est un lanceur personnalisé, que la mise à jour automatique laisse en place.Si l’une ou l’autre commande ls affiche No such file or directory, ce n’est pas une erreur. Cela signifie que rien n’est installé à cet emplacement, alors passez à la vérification suivante.

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 :

macOS/Linux
Windows PowerShell

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 :

macOS/Linux
Windows PowerShell

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

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 des erreurs d’analyse pointant dans 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 demande a été routée, vous pouvez à la place voir un 403 sans corps HTML :

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

Tout cela signifie 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 dit « App unavailable in region », Claude Code n’est pas disponible dans votre pays. Consultez les pays pris en charge. Un 403 nu sans corps a souvent la même cause, mais il 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 le 403, parcourez Vérifiez la connectivité réseau avant d’essayer les programmes d’installation alternatifs ci-dessous, car ceux-ci atteignent les mêmes hôtes. 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
Puis 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.
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, et l’erreur associée curl: (23) Failure writing output to destination, signifie 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. 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. 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
- 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
Puis 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.

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 cask 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 que vous attendez, 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 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 :

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 :
- macOS/Linux
- Windows PowerShell
curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
Le programme d’installation PowerShell télécharge via .NET, qui valide TLS par rapport au magasin de certificats Windows. Demandez à votre équipe informatique d’ajouter le certificat CA du proxy au magasin Windows s’il n’y est pas déjà, puis exécutez le programme d’installation :
irm https://claude.ai/install.ps1 | iex
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 :
- macOS/Linux
- Windows PowerShell
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
$env:NODE_EXTRA_CA_CERTS = 'C:\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 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 depuis 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éessaye avec la vérification de révocation au meilleur effort automatiquement, donc le drapeau n’est nécessaire que sur la commande que vous exécutez vous-même. La vérification au meilleur effort tolère un serveur de révocation inaccessible mais rejette toujours un certificat connu pour être révoqué, correspondant à 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 depuis 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érifiez la connectivité réseau.

Mauvaise commande d’installation sur Windows

Si vous voyez 'irm' is not recognized, The token '&&' is not valid, 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 avez exécuté seulement 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
&& 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
A parameter cannot be found that matches parameter name 'fsSL' : vous avez exécuté le programme d’installation macOS/Linux curl -fsSL ... | bash dans Windows PowerShell, où curl est un alias pour Invoke-WebRequest et rejette les drapeaux -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é 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. Dirigez-le vers 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 que vous utilisez, 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 stratégie d’exécution de PowerShell bloque les scripts de lanceur .ps1 que npm crée pour ses commandes. La stratégie s’applique aux fichiers de script, donc elle n’affecte pas le programme d’installation PowerShell irm https://claude.ai/install.ps1 | iex, qui exécute le texte téléchargé directement. Solutions :

Autorisez les scripts créés localement pour votre utilisateur, puis réessayez :
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Appelez le lanceur .cmd à la place : npm.cmd et claude.cmd font le même travail, et la stratégie ne les couvre pas.
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` pendant 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 que le 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 interrompue sur les serveurs Linux à faible mémoire

Un message Killed pendant l’installation signifie généralement que le tueur OOM (out-of-memory) Linux a terminé l’étape claude install car le système a manqué de mémoire libre. Cela 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 :

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
Donnez à Docker plus de mémoire si vous utilisez Docker Desktop. Construisez les conteneurs partagent la mémoire allouée à la machine virtuelle Docker Desktop, donc ouvrez Paramètres > Ressources dans Docker Desktop, augmentez la limite de mémoire, et réexécutez la construction.

`Raw mode is not supported` pendant 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 pendant claude install. La boîte de dialogue a besoin d’un terminal sur stdin. Lorsque le programme d’installation exécute claude install depuis un tuyau, comme curl -fsSL https://claude.ai/install.sh | bash le fait, 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 pendant 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, comme lorsqu’elle définit forceRemoteSettingsRefresh, la boîte de dialogue apparaît toujours pendant ces commandes, et une exécution d’installation depuis 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 :

macOS/Linux
Windows PowerShell

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 fige

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 se figer les deux commandes et laissait la section Diagnostics système de /status vide. claude doctor s’est figé sans sortie ; claude update s’est figé 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’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 fige 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 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 pour Windows (pour bash) ou PowerShell

Git pour 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 pour Windows à la place, 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. L’installation 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 que 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 :

Les emplacements d’installation par défaut C:\Program Files\Git et C:\Program Files (x86)\Git.
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é depuis C:\dev\env\myproject. Cela empêche Claude Code d’exécuter un exécutable qu’un projet a placé là. Si votre Git est 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 le fichier existe mais que Claude Code ne l’utilise toujours pas, vérifiez d’abord le nom du fichier. Claude Code accepte uniquement un fichier nommé bash.exe, sh.exe, bash, ou sh ; avec tout autre nom, tel que le lanceur git-bash.exe de Git pour 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 secours et avertissement. Avant v2.1.219, Claude Code utilisait n’importe quel fichier existant comme shell sans vérifier son nom, et s’est fermé 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 stratégie de protection des points de terminaison.

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
Sur Alpine, ripgrep est dans le référentiel communautaire. Si apk signale que le paquet est manquant, 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 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. 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, 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 native ; suivez le problème #50384 pour le statut, et incluez votre modèle de processeur depuis 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 pendant 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 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

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 :

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 télécharge le binaire natif en tant que dépendance optionnelle par plateforme, comme @anthropic-ai/claude-code-darwin-arm64. npm exécute ensuite le script postinstall du paquet, 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 l’étape 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 espace réservé de script 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. 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é, 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 paquet de plateforme. Exécutez node node_modules/@anthropic-ai/claude-code/install.cjs comme le message le suggère, ou réinstallez sans le drapeau. 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 paquet téléchargé et le lance, au coût d’un processus Node supplémentaire à chaque démarrage. Si le wrapper affiche Could not find native binary package à la place, le paquet de plateforme n’a jamais été téléchargé, donc corrigez d’abord la cause des dépendances optionnelles ci-dessus.
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. Sur FreeBSD, le programme d’installation signale la plateforme comme non supportée. 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 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.

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

Lorsque vous exécutez npm install -g @anthropic-ai/claude-code sur une installation existante, npm peut échouer en déplaçant l’ancien répertoire de paquets de côté :

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 paquets global avec npm root -g ; si le répertoire que la ligne npm error path nomme n’est pas sous le répertoire que npm root -g affiche, par exemple parce que vous avez changé de versions de Node avec nvm, supprimez les répertoires que l’erreur nomme à la place :

macOS/Linux
Windows PowerShell

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

Puis supprimez tous les répertoires temporaires restants. Si zsh affiche no matches found, il n’y en avait aucun à supprimer :

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

Puis 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). Ces sections traitent des échecs de connexion, des erreurs OAuth et des problèmes de jeton. 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.

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 :

macOS/Linux
Windows PowerShell

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

Vérifiez l'accès au Keychain

Exécutez claude doctor pour vérifier l’accès au Keychain. Lorsque le Keychain rejette les écritures, le rapport liste un avertissement qui commence par macOS Keychain is not writable, suivi d’une correction suggérée. Lorsque le rapport ne liste aucun avertissement Keychain, le Keychain est accessible en écriture et vous pouvez passer à la dernière étape.

Déverrouillez le Keychain

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

Entrez votre mot de passe Keychain lorsque la commande vous le demande, puis exécutez claude doctor à nouveau. Lorsque le déverrouillage a fonctionné, le rapport ne liste plus l’avertissement Keychain.

Resynchronisez le mot de passe Keychain si le déverrouillage n'aide pas

Ouvrez Keychain Access, sélectionnez le Keychain login, et choisissez Édition > Changer le mot de passe pour le Keychain « login » pour le resynchroniser avec votre mot de passe de compte. Puis exécutez claude doctor à nouveau. Passez à l’étape suivante une fois que le rapport ne liste plus l’avertissement Keychain.

Déconnectez-vous et reconnectez-vous

Une fois que le Keychain est à nouveau accessible en écriture, Claude Code déplace les identifiants dans le Keychain la prochaine fois qu’il écrit un identifiant. Pour le forcer maintenant, exécutez /logout puis /login. La déconnexion supprime tous les identifiants enregistrés, y compris le contenu du fichier en texte brut, les connexions du serveur MCP enregistrées et les valeurs sensibles du plugin, alors attendez-vous à ré-autoriser les serveurs MCP et à re-saisir les secrets du plugin par la suite. La reconnexion enregistre votre connexion dans le Keychain.

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 :

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

​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

​Cask Homebrew indisponible ou obsolète

​Erreurs de connexion TLS ou SSL

​Failed to fetch version from downloads.claude.ai

​Mauvaise commande d’installation sur Windows

​running scripts is disabled on this system

​The process cannot access the file pendant l’installation Windows

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

​L’installation se fige dans Docker

​Raw mode is not supported pendant l’installation

​claude update ou claude doctor se fige

​Claude Desktop remplace la commande claude sur Windows

​Claude Code sur Windows nécessite Git pour Windows (pour bash) ou PowerShell

​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

​Erreur npm ENOTEMPTY pendant la mise à jour ou la réinstallation

​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, SSH ou conteneurs

​Non connecté ou jeton expiré

​Les identifiants Bedrock, Agent Platform 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`

Cask Homebrew indisponible ou obsolète

Erreurs de connexion TLS ou SSL

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

Mauvaise commande d’installation sur Windows

`running scripts is disabled on this system`

`The process cannot access the file` pendant l’installation Windows

Installation interrompue sur les serveurs Linux à faible mémoire

L’installation se fige dans Docker

`Raw mode is not supported` pendant l’installation

`claude update` ou `claude doctor` se fige

Claude Desktop remplace la commande `claude` sur Windows

Claude Code sur Windows nécessite Git pour Windows (pour bash) ou PowerShell

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

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

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, SSH ou conteneurs

Non connecté ou jeton expiré

Les identifiants Bedrock, Agent Platform ou Foundry ne se chargent pas

Toujours bloqué