90% des gens utilisent mal Claude Code: Anthropic Official Best Practices pour une analyse complète.
90% des gens utilisent mal Claude Code: Anthropic Official Best Practices pour une analyse complète.
Claude Code est un outil de programmation Agentique lancé par Anthropic qui peut lire la bibliothèque de code, éditer des fichiers, exécuter des commandes et les intégrer en profondeur à votre outil de développement. Mais selon les documents officiels,90% des gens l'utilisent à tort.Je ne sais pas.
Ce document est basé sur la meilleure pratique officielle anthropique et vous amène à l'utilisation correcte de Claude Code.
Contraintes fondamentales : fenêtre contextuelle
La plupart des pratiques exemplaires reposent sur une contrainte fondamentale :La fenêtre contextuelle de Claude est remplie très rapidement, et la performance diminue avec le remplissage.
La fenêtre contextuelle de Claude contient toute l'histoire de votre conversation, les fichiers que Claude lit et la sortie de chaque commande. Lorsque la fenêtre contextuelle est proche du plein, Claude peut commencer à se souvenir des précommandes ou faire plus d'erreurs.
La fenêtre contextuelle est la ressource la plus importante et nécessite une gestion continue.
Bonne pratique : donner à Claude un moyen de valider le travail
C'est le point le plus important.
Lorsque Claude est en mesure de vérifier son travail — par exemple, en exécutant des tests, des captures d'écran contrastées, une sortie de validation — sa performance augmentera considérablement.
| Politique | Exemple d'erreur | Exemple correct |
|---|---|---|
| Fourniture de normes de certification | "Fonction actuelle pour vérifier une adresse e-mail" | "Ecrivez une fonction ValidateEmail. Exemple pour tester : user@exemple.com retourne true, invalide renvoie false, user@.com retourne false. Essai de fin d'exécution |
| Vérifier les changements à l'AE | "Laissez le tableau de bord mieux." | "Atteindre cette conception. Comparaison des cartes post-achèvement, montrant les écarts et les réparations |
| S'attaquer aux causes profondes | "La construction a échoué" | "Construit pour signaler l'erreur: xx. Corriger et vérifier le succès de la construction, traiter les causes profondes plutôt que de supprimer l'erreur. |
Utiliser correctement
# ❌ 错误：模糊的指令
claude "写个登录功能"
# ✅ 正确：具体的需求 + 验证方式
claude "实现 Google OAuth 登录。先了解现有 auth 流程，写出详细计划，然后实现。完成后运行测试确保通过"
Meilleure pratique II: Explorer, planifier, code final
Permettre à Claude de sauter directement au code peut créer un code pour résoudre le problème. Utilisation Mode de planification Séparer exploration et exécution.
Travaux recommandés
- Explorer (mode plan)Claude lit seulement les fichiers et répond aux questions sans modification
- Mode de planification: Laissez Claude créer des plans de réalisation détaillés
- Mode normalRetourner en mode normal pour faire encoder et vérifier Claude
- Soumettre: Laissez Claude soumettre et créer des PR
# 探索阶段
claude
阅读 /src/auth 目录，了解我们如何处理会话和登录
# 计划阶段
我想添加 Google OAuth。需要改哪些文件？会话流程是什么？创建一个计划
# 实现阶段
implement the OAuth flow from your plan. write tests for the callback handler
Quand n'avez-vous pas besoin d'un plan ?
Lorsque l'éventail des tâches est clair et plus petit (par exemple réparer les erreurs d'orthographe, ajouter des lignes de journal), il suffit que Claude le fasse directement.
Meilleure pratique III: Fournir un contexte spécifique dans le rappel
Claude peut extrapoler l'intention, mais ne peut pas lire les esprits. Référence à des documents spécifiques, référence à des conditions contraignantes, référence à des modèles illustratifs.
| Politique | Exemple d'erreur | Exemple correct |
|---|---|---|
| Limite | Ajouter le test à foo.py | "Foo.py écrit des tests pour couvrir les limites que l'utilisateur a affichées. Ne vous moquez pas" |
| Point vers la source | "Pourquoi est-ce si bizarre avec l'API SituationFactory ?" | "Regardez l'histoire de ExchangeFactory et résumez comment son API a évolué." |
| Référence aux modèles existants | Ajouter un élément Calendrier | Modèle de réalisation des composants existants sur la première page de la référence. HotDogWidget.php est un bon exemple. Créer un nouveau composant de calendrier selon ce mode." |
| Décrire les symptômes | "Recover login bug" | "La session de rapport de l'utilisateur a échoué après timeout. Vérifier le processus auth en src/ auth/, en particulier les rafraîchissements de jeton. Écrire un test échoué pour les problèmes de récurrence et le corriger." |
Utiliser les fichiers @reference
# ❌ 错误：描述文件位置
claude "看看 src/utils 里的那个 helpers.py 文件"
# ✅ 正确：直接 @ 引用
claude "@helpers.py 这个文件有什么可以改进的？"
Meilleure pratique IV : Configurer votre environnement
Écrivez un CLAUDE.md valide
CLUDE.md est un document spécial que Claude lit au début de chaque conversation. Contient des commandes Bash, des styles de code et des règles de workflow.
# CLAUDE.md 示例
## 项目结构
- 前端使用 React + TypeScript
- 后端使用 Node.js + Express
## 代码规范
- 使用 ESLint + Prettier
- 组件使用函数式组件和 hooks
- 避免使用 class 组件
## 常用命令
- `npm run dev` 启动开发服务器
- `npm test` 运行测试
- `npm run build` 构建生产版本
Cours /init La commande peut générer un fichier de démarrage CLAUDE.md basé sur la structure actuelle du projet.
Cinquième pratique : utiliser le PCM pour accroître la capacité
Model Context Protocol (MCP) est une norme ouverte pour connecter les outils d'IA à des sources de données externes. Grâce à MCP, Claude Code peut :
- Lire les documents de conception dans Google Drive
- Mettre à jour les feuilles de travail en Jira
- Dessiner les données de Slack
- Utilisez votre outil personnalisé
# 配置 MCP 服务器后，你可以：
claude "从 Jira 拉取最新的 bug 列表"
claude "更新设计文档"
Meilleure pratique VI : utiliser le travail parallèle sous-agent
Claude Code soutient la tâche de générer plusieurs sous-agents tout en traitant de différentes parties. Agent principal coordonne, assigne des sous-tâches et consolide les résultats.
# 让多个 Agent 同时工作
claude "同时处理这三个任务：1) 优化数据库查询 2) 添加单元测试 3) 更新 API 文档"
Résumé
Claude Code est un environnement de programmation de l'Agence qui modifie votre façon de travailler. Ne pas écrire le code et laisser Claude le revoir, mais décrire ce que vous voulez, Claude va trouver comment le construire.
Souvenez-vous de trois principes fondamentaux :
- Donnez à Claude la méthode d'authentification - Test, capture d'écran, sortie attendue
- Explorer et coder. – Mode d'utilisation du plan
- Contexte spécifique - Plus c'est précis, mieux c'est.
Avec ces meilleures pratiques, vous pouvez utiliser le plus grand pouvoir de Claude Code.
Faites-vous des amis, ajoutez-moi au groupe, et partagez des IA et des technologies de cybersécurité.