90% 的人都在錯誤使用 Claude Code：Anthropic 官方最佳實踐全解析
90% 的人都在錯誤使用 Claude Code：Anthropic 官方最佳實踐全解析
Claude Code 是 Anthropic 推出的 Agentic 編程工具，它能夠閱讀代碼庫、編輯文件、運行命令，並與你的開發工具深度集成。但根據官方文檔，90% 的人都在錯誤使用它。
本文基於 Anthropic 官方最佳實踐，帶你掌握正確使用 Claude Code 的方法。
核心約束：上下文窗口
大多數最佳實踐都基於一個核心約束：Claude 的上下文窗口填充得非常快，性能會隨着填充而下降。
Claude 的上下文窗口包含你的整個對話歷史、每個 Claude 讀取的文件，以及每個命令輸出。當上下文窗口接近滿時，Claude 可能會開始”忘記”之前的指令或犯更多錯誤。
上下文窗口是最重要的資源，需要持續管理。
最佳實踐一：給 Claude 一個驗證工作的方式
這是最重要的一點。
當 Claude 能夠驗證自己的工作時——比如運行測試、對比截圖、驗證輸出——它的表現會顯著提升。
| 策略 | 錯誤示例 | 正確示例 |
|---|---|---|
| 提供驗證標準 | “寫一個驗證郵箱地址的函數” | “寫一個 validateEmail 函數。測試用例：user@example.com 返回 true，invalid 返回 false，user@.com 返回 false。寫完運行測試” |
| 驗證 UI 變化 | “讓儀表盤更好看” | “實現這個設計。完成後截圖對比原圖，列出差異並修復” |
| 解決根本原因 | “構建失敗了” | “構建報這個錯誤：xxx。修復它並驗證構建成功，解決根本原因而不是壓制錯誤” |
正確的使用方式
# ❌ 错误：模糊的指令
claude "写个登录功能"
# ✅ 正确：具体的需求 + 验证方式
claude "实现 Google OAuth 登录。先了解现有 auth 流程，写出详细计划，然后实现。完成后运行测试确保通过"
最佳實踐二：先探索，再計劃，最後編碼
讓 Claude 直接跳到編碼可能會產生解決錯誤問題的代碼。使用 Plan Mode 來分離探索和執行。
推薦工作流
- 探索（Plan Mode）：Claude 只讀文件、回答問題，不做修改
- 計劃（Plan Mode）：讓 Claude 創建詳細的實現計劃
- 實現（Normal Mode）：切換回正常模式，讓 Claude 編碼並驗證
- 提交：讓 Claude 提交併創建 PR
# 探索阶段
claude
阅读 /src/auth 目录，了解我们如何处理会话和登录
# 计划阶段
我想添加 Google OAuth。需要改哪些文件？会话流程是什么？创建一个计划
# 实现阶段
implement the OAuth flow from your plan. write tests for the callback handler
什麼時候不需要計劃？
任務範圍明確且修復較小時（如修復拼寫錯誤、添加日誌行），直接讓 Claude 幹即可。
最佳實踐三：在提示中提供具體上下文
Claude 可以推斷意圖，但無法讀心。參考具體文件、提及約束條件、指向示例模式。
| 策略 | 錯誤示例 | 正確示例 |
|---|---|---|
| 限定範圍 | “給 foo.py 添加測試” | “爲 foo.py 寫測試，覆蓋用戶已登出的邊界情況。不要用 mock” |
| 指向來源 | “爲什麼 ExecutionFactory API 這麼奇怪？” | “查看 ExecutionFactory 的 git 歷史，總結它的 API 是如何演變而來的” |
| 參考現有模式 | “添加一個日曆組件” | “參考首頁現有組件的實現模式。HotDogWidget.php 是個好例子。按照這個模式實現一個新的日曆組件” |
| 描述症狀 | “修復登錄 bug” | “用戶報告會話超時後登錄失敗。檢查 src/auth/ 中的 auth 流程，特別是 token 刷新。寫一個復現問題的失敗測試，然後修復它” |
使用 @ 引用文件
# ❌ 错误：描述文件位置
claude "看看 src/utils 里的那个 helpers.py 文件"
# ✅ 正确：直接 @ 引用
claude "@helpers.py 这个文件有什么可以改进的？"
最佳實踐四：配置你的環境
寫一個有效的 CLAUDE.md
CLAUDE.md 是一個特殊文件，Claude 在每次對話開始時都會讀取它。包含 Bash 命令、代碼風格和工作流規則。
# CLAUDE.md 示例
## 项目结构
- 前端使用 React + TypeScript
- 后端使用 Node.js + Express
## 代码规范
- 使用 ESLint + Prettier
- 组件使用函数式组件和 hooks
- 避免使用 class 组件
## 常用命令
- `npm run dev` 启动开发服务器
- `npm test` 运行测试
- `npm run build` 构建生产版本
運行 /init 命令可以基於當前項目結構生成一個 starter CLAUDE.md 文件。
最佳實踐五：使用 MCP 擴展能力
Model Context Protocol (MCP) 是一個開放標準，用於將 AI 工具連接到外部數據源。通過 MCP，Claude Code 可以：
- 讀取 Google Drive 中的設計文檔
- 更新 Jira 中的工單
- 從 Slack 拉取數據
- 使用你的自定義工具
# 配置 MCP 服务器后，你可以：
claude "从 Jira 拉取最新的 bug 列表"
claude "更新设计文档"
最佳實踐六：使用子 Agent 並行工作
Claude Code 支持生成多個子 Agent 同時處理不同部分的任務。主 Agent 協調工作、分配子任務併合並結果。
# 让多个 Agent 同时工作
claude "同时处理这三个任务：1) 优化数据库查询 2) 添加单元测试 3) 更新 API 文档"
總結
Claude Code 是一個 Agentic 編程環境，它改變了你的工作方式。不要自己寫代碼然後讓 Claude 審查，而是描述你想要什麼，Claude 會弄清楚如何構建它。
記住三個核心原則：
- 給 Claude 驗證方式 — 測試、截圖、預期輸出
- 先探索再編碼 — 使用 Plan Mode
- 提供具體上下文 — 越精確越好
掌握這些最佳實踐，你就能發揮 Claude Code 的最大威力。
交個朋友，加我入羣，交流前沿AI和網絡安全技術