Étape 1 : obtenir la véritable erreur
claude --version # is the CLI there at all?
claude # start it directly: the real error prints here
claude doctor # install health check
Si cela fonctionne dans le terminal et que seule l’extension ou l’application échoue, le problème vient de l’environnement depuis lequel l’application hôte se lance (PATH, version de Node, variables de proxy) — pas de Claude Code lui-même. Si cela échoue aussi dans le terminal, recherchez le message qu’il affiche.
Causes connues (d’après le suivi des problèmes)
- Reprise d’une session en arrière-plan dans VS Code. L’ouverture d’une session démarrée avec
claude --bgdéclenche exactement cette erreur — signalée sous macOS, Windows et Linux (#77162). Arrêtez d’abord l’agent en arrière-plan ou ouvrez une nouvelle session. - Windows : processus orphelin après un plantage. L’application ne peut pas se relancer, car un ancien processus détient encore un verrou (#42776, #53247). Terminez les processus
clauderestants dans le Gestionnaire des tâches ; la solution fiable signalée dans ce ticket est un redémarrage complet de Windows. - Application de bureau sur Apple Silicon qui échoue à chaque démarrage de session alors que la CLI fonctionne (#59866, doublon d’un problème connu) — mettez l’application à jour ; en attendant, utilisez la CLI dans un terminal.
- Version de Node.js inférieure à 18 ou PATH défectueux après une installation via npm — l’application hôte ne peut pas lancer la CLI.
node -v; passez au programme d’installation natif pour supprimer la dépendance à Node. - `~/.claude/settings.json` invalide. Une virgule superflue dans un bloc de hooks ou d’autorisations provoque l’arrêt immédiat de la CLI. Vérifiez la validité de JSON.
- Incompatibilité de shell sous Windows — un outil PowerShell échoue depuis Git Bash avec un modèle précis (#87980) ; essayez l’autre shell.
Si aucun des cas ci-dessus ne s’applique
- Mettez tout à jour :
claude update, et mettez à jour l’extension VS Code ou l’application de bureau. - Réinstallez avec le programme d’installation natif (
curl -fsSL https://claude.ai/install.sh | bash, ou les commandes PowerShell / CMD sur une seule ligne dans le guide d’installation). - Démarrez VS Code depuis un terminal afin qu’il hérite du même environnement que la CLI qui fonctionne.
- Ouvrez un nouveau ticket avec la sortie de
claude doctor— les signalements de plantage sont rapidement examinés dans l’outil de suivi.
Voir aussi
Si Claude Code démarre, puis échoue avec une erreur API, il s’agit d’un autre problème : voir Erreur API 500, surcharge / 529, Erreur API 400 ou Erreurs OAuth. Pour l’extension en particulier, voir Claude Code dans VS Code.
Vous en avez assez de lutter contre ce problème ?
Exécutez plutôt Claude Code via la passerelle AI Prime Tech : les mêmes modèles Claude sur les propres comptes en amont de la passerelle, deux variables d’environnement à modifier pour basculer, et les nouveaux comptes reçoivent 5 $ de crédit API offert avec le code FIXIT — sans carte bancaire.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyQuestions fréquentes
Que signifie « Le processus Claude Code s’est terminé avec le code 1 » ?
L’extension VS Code ou l’application de bureau a lancé la CLI de Claude Code, qui s’est arrêtée avec une erreur. Exécutez claude dans un terminal pour voir le véritable message d’erreur.
Comment corriger « Claude Code s’est terminé avec le code 1 » sous Windows ?
Terminez les processus claude restants (ou redémarrez Windows si l’application ne se relance pas), vérifiez node -v et PATH, vérifiez la validité de ~/.claude/settings.json et réinstallez avec le programme d’installation natif si nécessaire.
Pourquoi Claude Code fonctionne-t-il dans le terminal, mais pas dans VS Code ?
VS Code a été lancé avec un environnement différent (PATH, Node, variables de proxy). Démarrez VS Code depuis le terminal où claude fonctionne, ou corrigez les variables dans le profil de votre shell.
Utilisez Claude Code sur la passerelle
Les mêmes modèles, deux variables d’environnement, des crédits valant 7.69231× leur valeur nominale — ou une offre illimitée à tarif forfaitaire. Nouveaux comptes : 5 $ de crédit API offert avec le code FIXIT.
Obtenir une clé API Voir les offres illimitéesAI Prime Tech est une passerelle API indépendante et n’est ni affiliée à Anthropic, ni approuvée ou parrainée par Anthropic. « Claude » et « Claude Code » sont des marques commerciales d’Anthropic. Les fonctionnalités de Claude Code décrites ici correspondent à la documentation publique d’Anthropic au moment de la rédaction et évoluent fréquemment ; les prix et les listes de modèles de cette page proviennent des paramètres en temps réel de cette passerelle.