Claude Code 最佳实践：我用 AI 编程三个月，总结了 5 条关键发现

Claude Code 这工具我用三个月了。期间用它重建了自己的咨询品牌网站、写了三个 Mac 应用原型，还在真实项目中趟过了各种坑。

有意思的是，这三个月最反直觉的发现不是 Claude Code 能做什么，而是谁用它、怎么用它，比工具本身重要得多。

LinkedIn 和 YouTube 上铺天盖地的「AI 编程神器」教程，大多在讲技巧和快捷键。但真正用过的人都知道：技巧只是表层，底层工作流才是壁垒。

这篇文章，我从三个真实项目中提炼出 5 条核心发现。

—

一、先把 Git 和 CLAUDE.md 搞定

很多人一上来就让 Claude 写代码，结果每次新会话都要重新解释项目背景，效率极低。

正确的打开方式是：在第一天就建立基础设施。

首先是 Git。不管项目大小，始终用 Git 管理代码。让 Claude 自动处理提交，每次提交保持详细描述。每次新会话开始，先让它读取最近的 commit 历史——这样 Claude 就能无缝衔接上下文，不用你重复解释。

然后是 CLAUDE.md。这个文件是 Claude Code 的「项目宪法」，值得认真投入。Anthropic 官方建议每个 CLAUDE.md 保持在 200 行以内，太长会消耗上下文窗口并降低 Claude 的遵循度。

CLAUDE.md 应该包含：项目概述与目标用户、技术栈与版本、关键构建/测试/部署命令、项目结构说明、编码规范、重要规则（如「永不提交 secrets」「必须配置 CORS」等）。

这一点至关重要：一个好的 CLAUDE.md 能让 Claude Code 从「每次都要重新训练」变成「开箱即用」。

—

二、大项目用 BMAD，小任务用 Plan Mode

不是所有项目都需要同样的投入。

小任务用 Plan Mode。Claude Code 的 Plan Mode 能分析代码库、规划改动范围，适合小的功能迭代和 bug 修复。输入简单指令，Claude 就能理解上下文并执行。

但问题是：AI 不会主动问困难的问题。

我用一个真实案例说明：我想写一个 mac-folder-sync 菜单栏应用（用于同步本地文件夹到 NAS）。用了 Plan Mode，初始构建很快完成。但测试时发现了 Claude 没有主动标记的问题——安全漏洞、文件不存在时的行为、sync 中断后的恢复逻辑……这些问题，Claude Code 在 Plan Mode 下不会主动追问。

大项目用 BMAD。BMAD 是一个 AI SDLC 框架，在动手写代码之前，先做产品规格、用户流程和设计验证。我在 Propel Kanban 项目中试用了这个方法论——结果 1 小时产出了数十个用户流程（注：数据来源为单一博客案例，建议谨慎参考）。BMAD 会持续质疑你的假设，发现规格中的矛盾，甚至能识别安全风险。

划重点：项目越大、用户越多、外部集成越复杂，就越需要 BMAD 的结构化投入。小修小改用 Plan Mode，但要主动追问 AI 不会主动提的问题。

—

三、Opus 和 Sonnet 各司其职

模型选择是另一个被低估的杠杆。

我的配置是：
– Opus：处理架构设计、安全审查、复杂代码重构等重活
– Sonnet：用于日常规划、迭代打磨、代码审查等轻量任务

Opus 的推理能力更强，适合需要深度思考的场景；Sonnet 速度快、成本低，适合快速迭代。

最关键的是：不要让 Sonnet 去做 Opus 的工作。当你在 Sonnet 会话中感觉 Claude 开始「绕圈子」或「不够深入」时，说明这个任务需要切换到 Opus。

—

四、Skills 比 MCP Server 更透明

Anthropic 有一个生态体系：Skills 和 MCP Servers。两者都能扩展 Claude Code 的能力，但有一个关键区别：透明度。

MCP Servers 是黑盒。你不知道它让 Claude 做了什么、怎么做的、是否有安全风险。

Skills 是白盒。以内置的 Security Review Skill 为例，我能直接阅读它的源码，审查它告诉 Claude 做什么，必要时修改或删除。我对 AI 在我的项目里做什么，有完全的掌控权。

这也意味着：找到能填补你专业缺口的 Skills，比接更多 MCP Server 更有价值。比如，一个缺乏前端设计经验的开发者，可以用官方 Web Design Skill 把 UI 质量提升一个档次。

工具不是目的，效率才是。

—

五、最核心的认知：工具不如人重要

这是我在整个过程中最深刻的体会。

Claude Code 能快速完成一个网站的初始框架（注：来自单一案例，数据待验证）。这很惊艳。但 SEO 优化、安全加固、PageSpeed 调优，这些需要人工驱动——因为这些领域的知识，来自多年经验积累，不是工具能凭空生成的。

BMAD 能帮你发现用户流程，但理解用户痛点的本质，还是靠人。Plan Mode 能快速构建，但问出「这里有没有安全漏洞」的，永远是你。

AI 不会取代你，会用 AI 的人会。 这句话已经快被说烂了，但真正用过 Claude Code 后，才体会到它的真实含义：不是你比 AI 强多少，而是你的领域知识能让你正确使用 AI。

复杂的事情简单化，简单的事情标准化，标准的事情自动化。Claude Code 帮你做最后一层，而前三层，永远是你的工作。

—

写在最后

Claude Code 最佳实践的核心就这么几条：

1. 基础设施优先：Git + CLAUDE.md，第一天搞定
2. 方法论匹配：BMAD 对大项目，Plan Mode 对小任务
3. 模型各司其职：Opus 做重活，Sonnet 做轻活
4. Skills > MCP：优先选择透明可控的扩展
5. 领域知识是核心：工具放大你的能力，但不替代你的判断

最后一句话：不要追逐工具的最新潮流，把时间花在理解你要解决的问题上。

如果这篇文章对你有帮助，欢迎留言讨论。