Les agents de code Claude ne lisent pas automatiquement la documentation du projet.
Comment les Agents Claude Code Gèrent la Documentation de Projet
Lorsqu'ils travaillent avec le système d'agents de Claude Code, les développeurs doivent être conscients d'une limitation spécifique dans la façon dont les sous-agents accèdent à la documentation du projet. Selon un rapport d'utilisateur de r/ClaudeAI, lorsque Claude Code envoie des agents pour gérer des tâches de codage, ces agents fonctionnent avec un contexte limité.
Détails Clés de la Source
Le problème a été découvert lors d'une session de débogage où un agent a rencontré à plusieurs reprises des pièges documentés. Lorsqu'on lui a demandé pourquoi il avait ignoré les avertissements documentés, l'agent a répondu : "Je n'ai pas lu CLAUDE.md avant d'écrire le callback. J'avais les motifs de la base de code dans mon contexte de prompt de la phase d'exploration, mais lorsque j'ai envoyé l'agent Sonnet pour écrire les routes OAuth, le prompt de l'agent décrivait quoi construire, pas contre quels pièges vérifier."
L'agent a précisé : "Les sous-agents Sonnet ne voient que ce que je mets dans leur prompt. Ils ne lisent pas automatiquement CLAUDE.md, MEMORY.md ou tout contexte de projet, sauf si je leur dis explicitement de le faire."
Implications Pratiques
- Les sous-agents comme Sonnet ne travaillent qu'avec le contexte fourni dans leur prompt spécifique
- Les fichiers de documentation de projet (CLAUDE.md, MEMORY.md) ne sont pas automatiquement chargés
- Les agents écrivent du code à partir de zéro sans consulter les listes de pièges existantes, sauf instruction explicite
- Cela peut conduire les agents à répéter des problèmes documentés qui auraient pu être évités
Ce comportement signifie que les développeurs doivent être explicites sur l'inclusion des références à la documentation lorsqu'ils envoient des agents pour gérer des tâches de codage spécifiques. Les agents conservent les motifs de la base de code de la phase d'exploration mais ne font pas automatiquement référence aux fichiers de documentation spécifiques au projet.
📖 Read the full source: r/ClaudeAI
👀 See Also
Correction de la vitesse de traitement des prompts dans Llama.cpp à l'aide du paramètre --ubatch-size
Un utilisateur a découvert que le réglage de --ubatch-size pour correspondre à la taille du cache L3 du GPU (64 Mo pour la Radeon 9070XT) a considérablement amélioré la vitesse de traitement des invites pour les modèles plus volumineux comme Qwen 27B dans Llama.cpp, rendant l'invocation de code Claude utilisable.
Traitement des exécutions d’agents comme des paquets de révision : un modèle pratique pour Claude Code & Codex
Un développeur partage comment la création d'un dossier structuré par exécution d'agent (recherche, brouillons, évaluations, dossier d'approbation, métriques, mémoire) rend les échecs visibles et accélère les itérations.
Comment le routage de tâches simples vers des modèles moins chers a réduit les coûts de l'IA de 40 %
Un utilisateur d'OpenClaw a réduit sa facture d'IA de 40 % en analysant les journaux d'utilisation et en redirigeant les tâches simples comme les opérations sur fichiers et les questions-réponses vers des modèles moins chers tels que DeepSeek-v3 et Gemini Flash, tout en réservant Claude Sonnet pour les tâches de raisonnement complexes.
Analyse d'un développeur : le routage de modèles réduit les coûts de l'API de 85 % par rapport à l'abonnement Claude Max
Un abonné à Claude Max a suivi sa consommation de tokens et a constaté que seulement 15 % des tâches nécessitaient Opus. En passant au routage via l'API (Sonnet pour les tâches courantes, Opus pour le raisonnement complexe), le coût mensuel est passé de 200 $ à environ 30 $, avec une qualité de sortie identique.