Claude Code ‘Process Exited with Code 1’ : Toutes les Solutions 2026

Vous lancez Claude Code, vous voyez un message du genre claude: process exited with code 1, et vous n’avez aucune idée de ce qui cloche. C’est l’une des erreurs les plus cherchées par les utilisateurs de Claude Code en 2026, et pour cause : ce code de sortie est un fourre-tout. Il veut juste dire « quelque chose s’est mal passé », sans préciser quoi.

Bonne nouvelle : dans 95% des cas, la cause fait partie d’une courte liste. Je vais vous montrer comment diagnostiquer vite, puis parcourir les 7 causes les plus fréquentes avec leur solution. À la fin, vous aurez aussi la procédure de réinstallation propre qui règle la majorité des cas rebelles.

Diagnostic rapide : lire le message complet

Avant de toucher à quoi que ce soit, lisez le message d’erreur entier. Le code 1 est générique, mais Claude Code affiche presque toujours une ligne juste avant qui donne un indice précieux. C’est elle qu’il faut capturer.

Pour voir les logs complets avec le stack trace, relancez Claude Code en mode verbeux :

• claude --debug : active le mode debug, vous verrez les étapes internes
• claude doctor : vérifie l’installation, les dépendances, la clé API et la connexion
• DEBUG=* claude (Mac/Linux) ou set DEBUG=* && claude (Windows cmd) : logs très détaillés

Notez la ligne juste au-dessus du process exited with code 1. C’est votre point d’entrée. Voici les motifs les plus fréquents à repérer :

• ENOENT : un fichier ou binaire est manquant (souvent Node.js)
• EACCES : problème de permissions
• ECONNREFUSED ou ETIMEDOUT : réseau, proxy ou firewall
• 401 ou invalid API key : authentification
• MODULE_NOT_FOUND : dépendance manquante, installation cassée
• SyntaxError dans un hook : un script personnalisé plante

Selon ce que vous voyez, sautez directement à la section correspondante ci-dessous.

Cause 1 : mauvaise version de Node.js

Claude Code a besoin de Node.js 18 ou plus récent. En 2026, Node 20 LTS ou 22 LTS sont recommandés. Si vous tournez encore sur Node 16, le CLI refuse de démarrer et sort en code 1 avec un message souvent cryptique.

Vérifiez votre version :

• node -v : doit afficher v18.x.x ou plus
• npm -v : doit afficher 9.x.x ou plus

Si la version est trop ancienne, mettez à jour :

• Windows / Mac / Linux avec nvm : nvm install 20 && nvm use 20
• Windows sans nvm : téléchargez le MSI officiel sur nodejs.org (version 20 LTS)
• Mac avec Homebrew : brew install node@20
• Linux Debian/Ubuntu : curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - puis sudo apt install -y nodejs

Piège classique sous Windows : deux installations de Node qui se marchent dessus (une via installer, une via nvm-windows). Lancez where node (cmd) ou Get-Command node -All (PowerShell) pour voir si plusieurs chemins apparaissent. Nettoyez si besoin.

Après mise à jour, relancez claude --version. Si l’erreur persiste, il faut réinstaller le CLI (voir section finale).

Cause 2 : problème de permissions npm

Si l’erreur apparaît dès l’installation avec un message type EACCES ou permission denied, c’est que npm ne peut pas écrire dans le dossier d’installation global. Très fréquent sous Linux et Mac quand on a installé Node via le package officiel plutôt qu’avec nvm.

La mauvaise solution (qui circule trop) : sudo npm install -g. Ça marche sur le moment, mais ça crée des fichiers root dans votre home et prépare des erreurs futures. Ne faites pas ça.

La bonne solution : reconfigurer npm pour qu’il installe les globals dans votre dossier utilisateur.

• Créez un dossier dédié : mkdir -p ~/.npm-global
• Configurez npm : npm config set prefix ~/.npm-global
• Ajoutez-le au PATH. Dans votre ~/.zshrc ou ~/.bashrc : export PATH=~/.npm-global/bin:$PATH
• Rechargez : source ~/.zshrc (ou rouvrez un terminal)
• Réinstallez Claude Code : npm install -g @anthropic-ai/claude-code

Sur Mac, une alternative propre : passez par Homebrew pour installer Node (brew install node), qui configure les permissions correctement dès le départ.

Cause 3 : authentification ou clé API invalide

Si Claude Code sort en code 1 juste après votre premier lancement avec un message qui parle de 401, unauthorized, invalid API key ou authentication required, c’est simple : vous n’êtes pas (ou plus) connecté.

Cas 1 : vous utilisez le mode abonnement (Claude Pro ou Max).

• Lancez claude /login et suivez le flux d’authentification dans le navigateur
• Vérifiez que votre abonnement est actif : claude.ai/settings
• Si le paiement a échoué récemment, Claude Code bloque l’accès. Mettez la carte à jour.

Cas 2 : vous utilisez le mode API (pay-as-you-go).

• Vérifiez que la variable ANTHROPIC_API_KEY est exportée : echo $ANTHROPIC_API_KEY (Mac/Linux) ou echo %ANTHROPIC_API_KEY% (Windows)
• Assurez-vous qu’elle commence par sk-ant- et qu’elle n’a pas été tronquée par un copier-coller
• Testez-la avec curl pour isoler le souci : si curl échoue aussi, la clé est invalide ou révoquée
• Dans la console Anthropic, vérifiez que votre clé n’a pas été désactivée et que vous avez du crédit

Astuce : évitez de stocker la clé directement dans .zshrc partagé. Utilisez un gestionnaire comme direnv ou 1Password CLI pour l’injecter seulement dans vos projets.

Cause 4 : proxy, firewall ou réseau

Si vous êtes sur un réseau d’entreprise, dans un pays avec restrictions ou derrière un VPN capricieux, Claude Code peut planter parce qu’il n’arrive pas à joindre les API d’Anthropic. Les symptômes typiques : ECONNREFUSED, ETIMEDOUT, ENOTFOUND ou des timeouts silencieux qui finissent en code 1.

Vérifications à faire dans l’ordre :

• Testez l’accès à l’API : curl https://api.anthropic.com. Si c’est bloqué, c’est réseau.
• Si vous êtes derrière un proxy d’entreprise, configurez npm et Claude Code : npm config set proxy http://user:pass@proxy.mycorp.com:8080 et npm config set https-proxy http://user:pass@proxy.mycorp.com:8080
• Définissez les variables d’environnement HTTP_PROXY, HTTPS_PROXY et NO_PROXY dans votre shell
• Désactivez temporairement VPN ou antivirus pour isoler la cause
• Si vous êtes dans un pays où Anthropic n’est pas officiellement disponible, Claude Code refusera de fonctionner (Chine, Russie, etc.). Un VPN peut contourner, mais c’est une zone grise côté CGU.

Sur Windows derrière un firewall d’entreprise, le souci est souvent un certificat SSL racine manquant. Si vous voyez UNABLE_TO_VERIFY_LEAF_SIGNATURE, demandez à votre IT le certificat racine interne et ajoutez-le à Node avec NODE_EXTRA_CA_CERTS=/chemin/vers/cert.pem.

Cause 5 : erreurs spécifiques à Windows

Windows concentre les cas les plus pénibles. Voici les trois plus fréquents en 2026.

PowerShell bloque l’exécution des scripts. Message type : cannot be loaded because running scripts is disabled on this system. Solution :

• Lancez PowerShell en administrateur
• Exécutez : Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
• Confirmez avec Y, puis relancez Claude Code

Le PATH ne contient pas le dossier npm global. Après installation, claude n’est pas reconnu. Ajoutez à votre PATH utilisateur :

• %APPDATA%\npm (installation classique)
• Ou le dossier retourné par npm config get prefix suivi de \node_modules\.bin
• Fermez et rouvrez votre terminal pour recharger le PATH

Les antivirus bloquent l’exécution. Windows Defender, McAfee ou certains outils entreprise mettent en quarantaine les binaires Node récents. Vérifiez dans votre centre de sécurité qu’il n’y a pas eu de blocage récent, et ajoutez une exception sur le dossier d’installation de Claude Code.

Astuce bonus : si vous codez sérieusement sous Windows, installez WSL2 (Ubuntu) et utilisez Claude Code à l’intérieur. L’expérience est nettement plus fluide, la plupart des erreurs Windows disparaissent.

Cause 6 : hooks ou scripts qui plantent

Si vous avez configuré des hooks Claude Code (pre-commit, post-bash, etc.) ou si vous utilisez des skills personnalisées, un script qui plante va faire sortir Claude Code en code 1. C’est une des causes les plus sournoises parce que l’erreur vient de votre code, pas du CLI.

Pour isoler :

• Désactivez temporairement vos hooks en renommant le fichier .claude/hooks.json en .claude/hooks.json.bak
• Relancez Claude Code. Si ça marche, le problème vient d’un hook
• Réactivez les hooks un par un pour identifier celui qui plante
• Testez le script du hook incriminé directement dans votre terminal pour voir l’erreur exacte

Même logique pour les skills custom dans .claude/skills/ : si un SKILL.md référence un script cassé, Claude Code peut échouer au chargement. Commencez minimal, ajoutez les skills une par une.

Enfin, vérifiez votre CLAUDE.md. Un fichier trop gros (plusieurs milliers de lignes) ou avec des commandes dangereuses dedans peut faire sortir Claude Code sans message clair. Gardez-le sous 200-300 lignes, concentré sur le contexte réellement utile.

Cause 7 : binaire corrompu ou cache pourri

Parfois, l’installation elle-même est cassée. Soit une coupure réseau pendant l’install, soit un cache npm qui a gardé une version instable, soit une mise à jour interrompue. Les symptômes : MODULE_NOT_FOUND, Cannot find module, ou tout simplement un process exited with code 1 sans aucun autre message.

Procédure de nettoyage de cache npm :

• npm cache clean --force
• npm cache verify
• Réinstallez Claude Code : npm install -g @anthropic-ai/claude-code

Si ça ne suffit pas, passez à la réinstallation complète ci-dessous. C’est la solution qui règle 80% des cas quand les six précédents ne suffisent pas.

La réinstallation propre qui règle 80% des cas

Quand rien ne marche, faites table rase. Cette procédure nettoie tout et repart de zéro. Comptez 5 minutes.

Étape 1 : désinstaller proprement

• npm uninstall -g @anthropic-ai/claude-code
• Supprimez le dossier de config : rm -rf ~/.claude (Mac/Linux) ou rmdir /s %USERPROFILE%\.claude (Windows)
• Supprimez le cache de session si besoin : rm -rf ~/.config/claude (Linux/Mac)

Étape 2 : nettoyer npm

• npm cache clean --force
• Vérifiez votre PATH : npm config get prefix doit retourner un chemin raisonnable (pas /usr/local si vous êtes sur Mac moderne)

Étape 3 : mettre Node à jour si besoin

• node -v doit être en 18+ (idéalement 20 LTS ou 22 LTS)
• Si non, mettez à jour avec nvm ou l’installer officiel

Étape 4 : réinstaller Claude Code

• npm install -g @anthropic-ai/claude-code
• Vérifiez : claude --version doit afficher la version sans erreur
• Lancez claude doctor pour valider que tout est en ordre
• Authentifiez-vous : claude /login (ou configurez ANTHROPIC_API_KEY)

Étape 5 : tester dans un dossier vide

• Créez un dossier test : mkdir ~/test-claude && cd ~/test-claude
• Lancez claude et posez une question simple (« bonjour, tu m’entends ? »)
• Si ça répond, le CLI est sauvé. Retournez dans votre projet réel et regardez si un hook ou CLAUDE.md cause toujours le souci

Après cette procédure, 80% des erreurs rebelles disparaissent. Pour les 20% restants, c’est souvent un cas spécifique entreprise (proxy exotique, certificats) qu’il faut creuser avec l’IT.

Questions fréquentes

Claude Code affiche « process exited with code 1 » dès le démarrage, sans autre message. Que faire ?

Relancez-le avec claude --debug pour avoir le stack trace complet. Si c’est silencieux même en debug, lancez claude doctor, il identifie 80% des problèmes d’installation. En dernier recours, faites la réinstallation propre décrite plus haut.

L’erreur n’arrive que sur un projet précis, pas les autres. Pourquoi ?

Très probablement un hook, un skill custom ou un CLAUDE.md problématique dans ce projet. Désactivez-les temporairement en renommant .claude/hooks.json et CLAUDE.md, puis relancez. Si ça marche, vous avez trouvé la cause.

Après mise à jour, Claude Code ne démarre plus. Est-ce que je peux revenir en arrière ?

Oui : npm install -g @anthropic-ai/claude-code@x.y.z avec la version précédente (cherchez sur npm ou dans votre historique). Mais avant, vérifiez que ce n’est pas un simple cache pourri avec npm cache clean --force puis réinstallation.

Claude Code fonctionne en terminal classique mais plante dans mon IDE (VS Code, Cursor). Pourquoi ?

Votre IDE utilise probablement un autre PATH ou une autre version de Node. Dans VS Code, ouvrez le terminal intégré et lancez which claude et node -v. Comparez avec votre terminal système. Si ça diffère, ajustez les paramètres du terminal intégré.

L’erreur ne dit rien. Comment forcer plus de détails ?

Trois niveaux de verbosité : claude --debug, puis DEBUG=* claude (logs Node complets), puis strace -f claude sur Linux (appels système). Le deuxième suffit dans 95% des cas.

Claude Code marche en cmd Windows mais pas en WSL, ou l’inverse. Normal ?

Oui, ce sont deux environnements distincts. Chacun a son propre Node, son propre npm et ses propres variables d’environnement. Installez Claude Code séparément dans les deux si vous voulez qu’il marche dans les deux shells.

Mon antivirus a mis en quarantaine des fichiers de Claude Code. Dangereux ?

Non, c’est un faux positif fréquent sur Windows Defender et certains antivirus d’entreprise. Ajoutez une exception sur %APPDATA%\npm\node_modules\@anthropic-ai\claude-code\ et restaurez les fichiers depuis la quarantaine. Si le doute persiste, le binaire officiel est signé par Anthropic, vous pouvez vérifier la signature.

Aller plus loin avec Claude Code

Maintenant que Claude Code redémarre, voici les ressources pour le maîtriser sereinement :

• Guide complet Claude Code : toutes les fonctionnalités (CLAUDE.md, Plan Mode, MCP, hooks, subagents).
• Installer Claude Code proprement : la procédure officielle Windows, Mac, Linux.
• Claude Code prix 2026 : tous les plans et comment choisir le bon.
• Claude Code vs Cursor : comparatif complet pour bien choisir son outil.