90% der Menschen missbrauchen Claude Code: Anthropic Official Best Practices für eine vollständige Analyse.
90% der Menschen missbrauchen Claude Code: Anthropic Official Best Practices für eine vollständige Analyse.
Claude Code ist ein Agentic-Programmiertool, das von Anthropic ins Leben gerufen wurde und die Codebibliothek lesen, Dateien bearbeiten, Befehle ausführen und sie eingehend in Ihr Entwicklungstool integrieren kann. Aber nach offiziellen Dokumenten,90% der Menschen verwenden es falsch.Ich weiß es nicht.
Dieses Papier basiert auf der offiziellen anthropischen Best Practice und bringt Sie zur korrekten Verwendung von Claude Code.
Kernbeschränkungen: Kontextfenster
Die meisten Best Practices basieren auf einer Kernbedingung:Claudes Kontextfenster wird sehr schnell gefüllt und die Leistung nimmt mit dem Füllen ab.
Das Kontextfenster von Claude enthält den gesamten Verlauf Ihrer Konversation, die Dateien, die Claude liest, und die Ausgabe jedes Befehls. Wenn das Kontextfenster fast voll ist, kann Claude anfangen, sich an Vorbefehle zu "erinnern" oder mehr Fehler zu machen.
Das Kontextfenster ist die wichtigste Ressource und erfordert ein kontinuierliches Management.
Best Practice eins: Geben Sie Claude eine Möglichkeit, die Arbeit zu validieren
Das ist der wichtigste Punkt.
Wenn Claude in der Lage ist, ihre Arbeit zu verifizieren - zum Beispiel Tests, Kontrast-Screenshots, Validierungsergebnisse - wird ihre Leistung deutlich steigen.
| Politik | Fehlerbeispiel | Richtiges Beispiel |
|---|---|---|
| Bereitstellung von Zertifizierungsnormen | "Aktuelle Funktion zur Überprüfung einer E-Mail-Adresse" | "Schreiben Sie eine ValidateEmail-Funktion." Beispiel zum Testen: user@example.com gibt true, invalid returns false, user@.com return false zurück. Endlaufprüfung |
| UI-Änderungen überprüfen | "Lassen Sie das Dashboard besser aussehen." | "Dieses Design erreichen." Vergleich von Post-Completion-Karten, Darstellung von Diskrepanzen und Reparatur |
| Bekämpfung der Ursachen | "Bau gescheitert" | "Build, um den Fehler zu melden: xx." Beheben Sie es und überprüfen Sie den Bauerfolg, beheben Sie die Ursachen, anstatt den Fehler zu unterdrücken. |
Richtig verwenden
# ❌ 错误：模糊的指令
claude "写个登录功能"
# ✅ 正确：具体的需求 + 验证方式
claude "实现 Google OAuth 登录。先了解现有 auth 流程，写出详细计划，然后实现。完成后运行测试确保通过"
Best Practice II: Explore, Plan, endgültiger Code
Lassen Sie Claude direkt zum Code springen und erstellen Sie möglicherweise einen Code, um das Problem zu lösen. Verwendung Planmodus Um Exploration und Ausführung zu trennen.
Empfohlener Workflow
- Entdecken (Planmodus)Claude liest nur Dateien und beantwortet Fragen ohne Änderungen
- Planmodus: Lassen Sie Claude detaillierte Realisierungspläne erstellen
- NormalzustandUmschalten in den normalen Modus, um Claude zu codieren und zu verifizieren
- Einreichung: Lassen Sie Claude einreichen und PR erstellen
# 探索阶段
claude
阅读 /src/auth 目录，了解我们如何处理会话和登录
# 计划阶段
我想添加 Google OAuth。需要改哪些文件？会话流程是什么？创建一个计划
# 实现阶段
implement the OAuth flow from your plan. write tests for the callback handler
Wann brauchen Sie keinen Plan?
Wenn der Aufgabenbereich klar und kleiner ist (z. B. Reparatur von Rechtschreibfehlern, Hinzufügen von Protokollzeilen), reicht es für Claude aus, dies direkt zu tun.
Best Practice III: Geben Sie in der Erinnerung einen spezifischen Kontext an
Claude kann Absichten extrapolieren, aber Gedanken nicht lesen. Verweis auf spezifische Dokumente, Verweis auf verbindliche Bedingungen, Verweis auf illustrative Modelle.
| Politik | Fehlerbeispiel | Richtiges Beispiel |
|---|---|---|
| Begrenzung | Test zu foo.py hinzufügen | "Foo.py schreibt Tests, um die Grenzen abzudecken, die der Benutzer gepostet hat." Verspotten Sie nicht |
| Punkt zur Quelle | "Warum ist es so seltsam an der SituationFactory API?" | "Schauen Sie sich die Geschichte von ExchangeFactory an und fassen Sie zusammen, wie sich seine API entwickelt hat." |
| Verweis auf bestehende Modelle | Hinzufügen einer Kalenderkomponente | "Modell der Realisierung bestehender Komponenten auf der ersten Seite der Referenz." HotDogWidget.php ist ein gutes Beispiel. Erstellen Sie eine neue Kalenderkomponente gemäß diesem Modus. |
| Symptome beschreiben | "Login Bug wiederherstellen" | "User Report Session Login nach Timeout fehlgeschlagen." Prüft den Auth-Prozess in src / auth /, insbesondere Token-Aktualisierungen. Schreiben Sie einen fehlgeschlagenen Test für Rezidivprobleme und beheben Sie ihn. |
Verwenden Sie @Referenzdateien
# ❌ 错误：描述文件位置
claude "看看 src/utils 里的那个 helpers.py 文件"
# ✅ 正确：直接 @ 引用
claude "@helpers.py 这个文件有什么可以改进的？"
Best Practice IV: Konfigurieren Sie Ihre Umgebung
Schreiben Sie eine gültige CLAUDE.md
CLUDE.md ist ein spezielles Dokument, das Claude zu Beginn jedes Gesprächs liest. Enthält Bash-Befehle, Codestile und Workflow-Regeln.
# CLAUDE.md 示例
## 项目结构
- 前端使用 React + TypeScript
- 后端使用 Node.js + Express
## 代码规范
- 使用 ESLint + Prettier
- 组件使用函数式组件和 hooks
- 避免使用 class 组件
## 常用命令
- `npm run dev` 启动开发服务器
- `npm test` 运行测试
- `npm run build` 构建生产版本
Lauf /init Befehl kann eine Starter-CLAUDE.md-Datei basierend auf der aktuellen Projektstruktur erzeugen.
Best Practice 5: Nutzung von MCP zur Kapazitätserweiterung
Model Context Protocol (MCP) ist ein offener Standard für die Verbindung von KI-Tools mit externen Datenquellen. Durch MCP kann Claude Code:
- Lesen Sie Designdokumente in Google Drive
- Aktualisieren von Arbeitsblättern in Jira
- Zeichne Daten von Slack
- Verwenden Sie Ihr eigenes Tool
# 配置 MCP 服务器后，你可以：
claude "从 Jira 拉取最新的 bug 列表"
claude "更新设计文档"
Best Practice VI: Verwenden Sie SubAgent Parallel Work
Claude Code unterstützt die Aufgabe, mehrere Subagenten zu generieren, während er sich mit verschiedenen Teilen beschäftigt. Main Agent koordiniert, ordnet Unteraufgaben zu und konsolidiert Ergebnisse.
# 让多个 Agent 同时工作
claude "同时处理这三个任务：1) 优化数据库查询 2) 添加单元测试 3) 更新 API 文档"
Zusammenfassung
Claude Code ist eine Agentur-Programmierumgebung, die Ihre Arbeitsweise verändert. Schreiben Sie den Code nicht und lassen Sie ihn von Claude überprüfen, aber beschreiben Sie, was Sie wollen, Claude wird herausfinden, wie Sie ihn erstellen.
Denken Sie an drei Kernprinzipien:
- Geben Sie Claude die Authentifizierungsmethode - Test, Screenshot, erwartete Ausgabe
- Erkunden und encodieren. Verwenden Sie den Planmodus
- Spezifischer Kontext - Je genauer, desto besser.
Mit diesen Best Practices können Sie die größte Macht von Claude Code nutzen.
Finde Freunde, füge mich der Gruppe hinzu und teile A.I. und Cyber-Sicherheitstechnologie.