CLAUDE.md：90%人用错了

张开发
• 2026/4/20 2:13:20 • 15 分钟阅读

最新文章

推荐文章

相关文章

分享文章

CLAUDE.md：90%人用错了
CLAUDE.md90%人用错了我用这个文件让AI记住我项目的所有秘密。先讲个故事上周团队新来一个实习生。我让他帮改个功能3小时没搞定。后来我自己上10分钟改完了。差距在哪不是我比他强是我知道这个项目的所有破事。哪个文件是干什么的、哪些代码碰不得、接口在哪、全局变量叫什么——我全清楚。AI也一样。CLAUDE.md 是什么简单说给AI看的项目说明书。你创一个文件叫CLAUDE.md扔项目根目录。每次启动Claude Code它自动就读。就这对但90%人写不对。常见错误1. 当 README 写❌# 这个项目叫XXX使用React Node 安装npminstall这不是给AI看的是给人看的。2. 写得太简略❌项目技术栈Next.jsAI需要知道的是哪个目录是干嘛的哪些接口能动、哪些不能动编码规范是什么怎么跑测试3. 一次写完不更新项目变了CLAUDE.md没变。久了就不准了。正确写法基础版# 项目概述 这是一个给朋友做的思维导图工具... # 技术栈 - Next.js 14App Router - Tailwind CSS - AI接口OpenAI # 目录结构 /src/app 页面路由 /src/components 组件 /src/lib 工具函数 # 重要文件 - src/app/page.tsx 首页禁止乱改 - src/lib/ai.ts AI调用逻辑 # 规范 - 组件用 .tsx .module.css - 不用的代码直接删别注释进阶版再加这些# 编码规范 - 组件名用 PascalCase - CSS用 BEM 或模块化 - API错误要捕获 # 常见问题 - 导出功能有时失灵可能是API超时 - 用户登录态存localStorage # 测试 - 测试文件放 __tests__ - 跑测试npm test核心心法把AI当新人教。你招一个新人你会告诉他这里是哪干嘛的什么能碰什么不能出了问题找谁CLAUDE.md就写这些。我的习惯每次接新需求我会先更新CLAUDE.md加需求背景——这次要做啥标新文件——要新增/改哪些列风险——哪块可能坑久而久之AI比我更懂这个项目你CLAUDE.md怎么写的评论区聊聊。

更多文章