Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Cette page couvre les problèmes de performance, de stabilité et de recherche une fois que Claude Code est en cours d’exécution. Pour d’autres problèmes, commencez par la page qui correspond à votre situation :
SymptômeAller à
command not found, l’installation échoue, problèmes de PATH, EACCES, erreurs TLSDépanner l’installation et la connexion
Boucles de connexion, erreurs OAuth, 403 Forbidden, « organisation désactivée », identifiants Bedrock/Vertex/FoundryDépanner l’installation et la connexion
Les paramètres ne s’appliquent pas, les hooks ne se déclenchent pas, les serveurs MCP ne se chargent pasDéboguer votre configuration
API Error: 5xx, 529 Overloaded, 429, erreurs de validation de requêteRéférence des erreurs
model not found ou you may not have access to itRéférence des erreurs
L’extension VS Code ne se connecte pas ou ne détecte pas ClaudeIntégration VS Code
Le plugin JetBrains ou l’IDE n’est pas détectéIntégration JetBrains
Utilisation élevée du CPU ou de la mémoire, réponses lentes, blocages, la recherche ne trouve pas les fichiersPerformance et stabilité ci-dessous
Si vous n’êtes pas sûr de ce qui s’applique, exécutez /doctor dans Claude Code pour une vérification automatisée de votre installation, vos paramètres, vos serveurs MCP et votre utilisation du contexte. Si claude ne démarre pas du tout, exécutez claude doctor depuis votre shell à la place.

​
Performance et stabilité

Ces sections couvrent les problèmes liés à l’utilisation des ressources, la réactivité et le comportement de recherche.

​
Utilisation élevée du CPU ou de la mémoire

Claude Code est conçu pour fonctionner avec la plupart des environnements de développement, mais peut consommer des ressources importantes lors du traitement de grandes bases de code. Si vous rencontrez des problèmes de performance :
  1. Utilisez /compact régulièrement pour réduire la taille du contexte
  2. Fermez et redémarrez Claude Code entre les tâches majeures
  3. Envisagez d’ajouter les grands répertoires de construction à votre fichier .gitignore
Si l’utilisation de la mémoire reste élevée après ces étapes, exécutez /heapdump pour écrire un snapshot de tas JavaScript et une ventilation de la mémoire sur ~/Desktop. Sur Linux sans dossier Desktop, les fichiers sont écrits dans votre répertoire personnel. La ventilation affiche la taille de l’ensemble résident, le tas JS, les tampons de tableau et la mémoire native non comptabilisée, ce qui aide à identifier si la croissance est dans les objets JavaScript ou dans le code natif. Pour inspecter les rétenteurs, ouvrez le fichier .heapsnapshot dans Chrome DevTools sous Memory → Load. Joignez les deux fichiers lors de la signalisation d’un problème de mémoire sur GitHub.

​
L’auto-compaction s’arrête avec une erreur de thrashing

Si vous voyez Autocompact is thrashing: the context refilled to the limit..., la compaction automatique a réussi mais un fichier ou une sortie d’outil a immédiatement rempli la fenêtre de contexte plusieurs fois de suite. Claude Code arrête les tentatives pour éviter de gaspiller les appels API sur une boucle qui ne progresse pas. Pour récupérer :
  1. Demandez à Claude de lire le fichier surdimensionné en petits morceaux, comme une plage de lignes spécifique ou une fonction, au lieu du fichier entier
  2. Exécutez /compact avec un focus qui supprime la sortie volumineuse, par exemple /compact keep only the plan and the diff
  3. Déplacez le travail sur fichier volumineux vers un sous-agent pour qu’il s’exécute dans une fenêtre de contexte séparée
  4. Exécutez /clear si la conversation antérieure n’est plus nécessaire

​
Les commandes se figent ou se gèlent

Si Claude Code semble ne pas répondre :
  1. Appuyez sur Ctrl+C pour tenter d’annuler l’opération actuelle
  2. Si ne répond pas, vous devrez peut-être fermer le terminal et redémarrer
Le redémarrage ne perd pas votre conversation. Exécutez claude --resume dans le même répertoire pour reprendre la session.

​
Problèmes de recherche et de découverte

Si l’outil Search, les mentions @file, les agents personnalisés ou les compétences personnalisées ne trouvent pas les fichiers, le binaire ripgrep fourni peut ne pas s’exécuter sur votre système. Installez le paquet ripgrep de votre plateforme et dites à Claude Code de l’utiliser à la place : 
brew install ripgrep
Ensuite, définissez USE_BUILTIN_RIPGREP=0 dans votre environnement.

​
Résultats de recherche lents ou incomplets sur WSL

Les pénalités de performance de lecture de disque lors du travail sur les systèmes de fichiers sur WSL peuvent entraîner moins de correspondances que prévu lors de l’utilisation de Claude Code sur WSL. La recherche fonctionne toujours, mais retourne moins de résultats que sur un système de fichiers natif.
/doctor affichera Search comme OK dans ce cas.
Solutions :
  1. Soumettre des recherches plus spécifiques : réduisez le nombre de fichiers recherchés en spécifiant des répertoires ou des types de fichiers : « Search for JWT validation logic in the auth-service package » ou « Find use of md5 hash in JS files ».
  2. Déplacer le projet vers le système de fichiers Linux : si possible, assurez-vous que votre projet est situé sur le système de fichiers Linux (/home/) plutôt que sur le système de fichiers Windows (/mnt/c/).
  3. Utiliser Windows natif à la place : envisagez d’exécuter Claude Code nativement sur Windows au lieu de via WSL, pour une meilleure performance du système de fichiers.

​
Obtenir plus d’aide

Si vous rencontrez des problèmes non couverts ici :
  1. Exécutez /doctor pour vérifier la santé de l’installation, la validité des paramètres, la configuration MCP et l’utilisation du contexte en une seule passe
  2. Utilisez la commande /feedback dans Claude Code pour signaler les problèmes directement à Anthropic
  3. Vérifiez le référentiel GitHub pour les problèmes connus
  4. Demandez directement à Claude ses capacités et fonctionnalités. Claude a un accès intégré à sa documentation.