你不知道的 AI Coding：非技术人的上手、场景与实战

你不知道的 AI Coding：非技术人的上手、场景与实战 你不知道的 AI Coding：非技术人的上手、场景与实战 Modified April 27 避免方法也一句话： 根因没说清楚之前先别动代码 。让它先答"问题出在哪个文件的哪一行，为什么会这样"，答含糊继续查，答清楚再改。一上来说"我试试改 X 看行不行"的，直接喊停让它先答根因。 Max 进阶：alias、模型、长会话 刚上手不必看，等用熟了或者你感觉Pro完全不够你用的时候，再来翻这个都行。 我自己 Max 订阅怎么用 alias ，我在 .zshrc 里加了一行，按 c 就直接启动一个不再问我权限的 Claude Code，同时把自动压缩点提前到 400k，等到上下文塞满才压效果会差，提前一点反而更舒服，你可以把这一段 copy 给你的 claude code 让他帮你来优化。 Code block Plain Text Copy alias c='CLAUDE CODE AUTO COMPACT WINDOW=400000 claude dangerously skip permissions' dangerously skip permissions 不建议刚上手的人用，它字面意思就是"危险跳过所有权限确认"，意味着 Claude Code 不会再问你任何事。我自己用是因为我能看懂它每一步在做什么，加上确实嫌反复确认烦。如果你还没到这个程度，老老实实用 Auto 模式就好。 模型用 opusplan ，我现在这套用法是输入 /model opusplan 这个隐藏命令就开启。划交给 Opus，执行交给 Sonnet，整体省钱也省时间。想更快可以再跑 /fast，刚好补回上面省下来的 token。 关键配置 ，如果你当前版本支持，用 opusplan 时去 /.claude/settings.json 里把 showClearContextOnPlanAccept 设成 true，不然会在 Sonnet 这一段碰到严重的缓存未命中，速度会明显慢下来。这个设置一开，整体就好多了。 长会话怎么办 Claude Code 的工作台是固定大小，跑久了早期内容会被挤出去。 任务做完就 /clear ，一个会话只做一件事，做完清掉再开下一件，两件不相干的事在同一个上下文里来回切，它会越做越乱。 长任务结束前让它写交接笔记 ，直接对它说："把当前进度写成一份 HANDOFF.md，包括做了什么、试过什么没成功、下一步该做什么。" 第二天打开新会话，把这个文件给它，就能接着干，不依赖任何压缩算法。 Waza：把好习惯沉淀成肌肉记忆 AI 可以让明确敲代码的活做得很快，但事情本身要做成什么样子其实需要你自己来定。我最近折腾了一套叫 Waza 的 Skill，一共8 个技能对应一个好工程师该有的 8 个习惯。 /think 是动手前先想一下技术方案，AI 写代码很快，但方向错了越快越远，先质疑问题本身、把方案上都思考好后，再让它跑。 /design 是给帮你设计一个产品化的页面，拒绝那种蓝紫渐变 + 一堆 emoji 的 AI 模板感。 /hunt 是排查问题的，原则只有一条：根因没说清楚之前先别动代码，避免改了试试的死循环。 /check 是收工前的最后检查，diff 审一遍，能自动修的修掉，它拿不准的归拢起来再问你。 剩下四个偏日常：/read 把任意网页或 PDF 转成干净的 Markdown 进工作流，/write 让你的表达更清晰，/learn 是一套从收资料到出文章的研究流程，/health 给你的 CLAUDE.md 和各种规则做个体检，你感觉Claude不好用的时候运行一下试试。 其中我最建议产品、业务、运营先试的是 /design，截图丢给它带上 /design，它不会立刻动手，会先反问你给谁用、想要什么气质、最不喜欢哪种风格、有没有想让用户记住的微交互，回答完再动手，效果通常比直接说"帮我改一下样式"稳定。 你也可以自己写一个 Skill Skill 本质就是一个文件夹，放在 .claude/skills/ 目录下，里面有个 SKILL.md 写清楚什么时候用、要做什么。Claude Code 启动时只读 frontmatter，也就是描述触发条件的约 100 个字，真正调用时才加载完整内容，所以你装几十个 Skill 启动也不会变慢。 第一种是工作流型 ：把每次都要做的固定步骤打包。比如整理周会纪要： Code block Markdown Copy name: 整理周会 description: 开完会有原始记录需要整理时调用 输出格式 本周达成 ：[负责人] 完成了什么 下周计划 ：[负责人] 做什么，截止时间 待讨论 ：卡在哪里，需要谁来决定 行动项 ：[谁] [做什么] [什么时候] 规则 不润色，保持原始措辞 信息缺失就标注"待确认"，不要猜 第二种是检查清单型 ：上线前、发版前、提交前过一遍，避免漏项，比如需求上线检查： Code block Markdown Copy name: 需求上线检查 description: 需求发布前跑一遍，确认没有遗漏 上线前必须全部通过 [ ] PRD 里的验收标准逐条确认 [ ] 设计稿和实现对齐，间距、文案、交互没漏 [ ] 异常状态（空态、报错、超时）都有处理 [ ] 数据埋点按规范打好 [ ] 测试环境验证通过 输出 每项 Pass / Fail，有 Fail 必须修完再发布。 第三种是领域专家型 ：把判断框架沉淀进去，碰到这类问题按固定路径走，不让它每次自由发挥，比如线上问题排查，以及你们平时的业务最佳实践的 SOP。 Code block Markdown Copy name: 线上问题排查 description: 收到线上告警或用户反馈异常时调用 收集信息 报错截图或错误日志的完整内容 影响范围：哪些用户、哪个页面、什么时间开始 最近的变更：代码发布、配置修改、数据变更 判断矩阵 | 现象| 优先检查 | | 页面白屏 | JS 报错 → 最近发布记录 | | 接口超时 | 服务监控 → 数据库慢查询 | | 数据异常 | 最近数据变更 → 上下游依赖 | 输出格式 根因 / 影响范围 / 修复步骤 / 验证方式 写好之后，把它放到 .claude/skills/ 文件夹下，碰到对应场景说一句"用整理周会"或"用线上排查"就行，这里你也可以让 Claude 帮你写，此外两个写 Skill 的小坑要避一下。 description 写触发条件，不写功能介绍 ，"开完会有原始记录需要整理时调用"比"把会议录音整理成结构化周报"准确率高得多。 一个 Skill 只做一件事 ，别把审查、发布、调试塞在一起，拆开用起来才更准。 Kami：让 AI 帮你排版出专业文档 写完内容只是第一步，排版成能发出去的东西往往更耗时间。Kami也是我最近做的 AI 排版设计工具，你把内容丢给它，说一句"帮我排成一页纸"或"做个作品集"，它会生成一份可下载的 PDF。 它有 8 套模板：一页纸、作品集、幻灯片、Resume、长文档、信件、研报、Changelog。风格统一，暖底色、墨蓝色点缀、衬线字体为主。中文用苍耳今楷，英文用 Charter，不需要自己调字体。 Waza /hunt /check Kami 避免方法也一句话： 根因没说清楚之前先别动代码 。让它先答"问题出在哪个文件的哪一行，为什么会这样"，答含糊继续查，答清楚再改。一上来说"我试试改 X 看行不行"的，直接喊停让它先答根因。 Max 进阶：alias、模型、长会话 刚上手不必看，等用熟了或者你感觉Pro完全不够你用的时候，再来翻这个都行。 我自己 Max 订阅怎么用 alias ，我在 .zshrc 里加了一行，按 c 就直接启动一个不再问我权限的 Claude Code，同时把自动压缩点提前到 400k，等到上下文塞满才压效果会差，提前一点反而更舒服，你可以把这一段 copy 给你的 claude code 让他帮你来优化。 dangerously skip permissions 不建议刚上手的人用，它字面意思就是"危险跳过所有权限确认"，意味着 Claude Code 不会再问你任何事。我自己用是因为我能看懂它每一步在做什么，加上确实嫌反复确认烦。如果你还没到这个程度，老老实实用 Auto 模式就好。 模型用 opusplan ，我现在这套用法是输入 /model opusplan 这个隐藏命令就开启。划交给 Opus，执行交给 Sonnet，整体省钱也省时间。想更快可以再跑 /fast，刚好补回上面省下来的 token。 关键配置 ，如果你当前版本支持，用 opusplan 时去 /.claude/settings.json 里把 showClearContextOnPlanAccept 设成 true，不然会在 Sonnet 这一段碰到严重的缓存未命中，速度会明显慢下来。这个设置一开，整体就好多了。 长会话怎么办 Claude Code 的工作台是固定大小，跑久了早期内容会被挤出去。 任务做完就 /clear ，一个会话只做一件事，做完清掉再开下一件，两件不相干的事在同一个上下文里来回切，它会越做越乱。 长任务结束前让它写交接笔记 ，直接对它说："把当前进度写成一份 HANDOFF.md，包括做了什么、试过什么没成功、下一步该做什么。" 第二天打开新会话，把这个文件给它，就能接着干，不依赖任何压缩算法。 Waza：把好习惯沉淀成肌肉记忆 AI 可以让明确敲代码的活做得很快，但事情本身要做成什么样子其实需要你自己来定。我最近折腾了一套叫 Waza 的 Skill，一共8 个技能对应一个好工程师该有的 8 个习惯。 Waza /think 是动手前先想一下技术方案，AI 写代码很快，但方向错了越快越远，先质疑问题本身、把方案上都思考好后，再让它跑。 /design 是给帮你设计一个产品化的页面，拒绝那种蓝紫渐变 + 一堆 emoji 的 AI 模板感。 /hunt 是排查问题的，原则只有一条：根因没说清楚之前先别动代码，避免改了试试的死循环。 /hunt /check 是收工前的最后检查，diff 审一遍，能自动修的修掉，它拿不准的归拢起来再问你。 /check 剩下四个偏日常：/read 把任意网页或 PDF 转成干净的 Markdown 进工作流，/write 让你的表达更清晰，/learn 是一套从收资料到出文章的研究流程，/health 给你的 CLAUDE.md 和各种规则做个体检，你感觉Claude不好用的时候运行一下试试。 其中我最建议产品、业务、运营先试的是 /design，截图丢给它带上 /design，它不会立刻动手，会先反问你给谁用、想要什么气质、最不喜欢哪种风格、有没有想让用户记住的微交互，回答完再动手，效果通常比直接说"帮我改一下样式"稳定。 你也可以自己写一个 Skill Skill 本质就是一个文件夹，放在 .claude/skills/ 目录下，里面有个 SKILL.md 写清楚什么时候用、要做什么。Claude Code 启动时只读 frontmatter，也就是描述触发条件的约 100 个字，真正调用时才加载完整内容，所以你装几十个 Skill 启动也不会变慢。 第一种是工作流型 ：把每次都要做的固定步骤打包。比如整理周会纪要： 第二种是检查清单型 ：上线前、发版前、提交前过一遍，避免漏项，比如需求上线检查： 第三种是领域专家型 ：把判断框架沉淀进去，碰到这类问题按固定路径走，不让它每次自由发挥，比如线上问题排查，以及你们平时的业务最佳实践的 SOP。 写好之后，把它放到 .claude/skills/ 文件夹下，碰到对应场景说一句"用整理周会"或"用线上排查"就行，这里你也可以让 Claude 帮你写，此外两个写 Skill 的小坑要避一下。 description 写触发条件，不写功能介绍 ，"开完会有原始记录需要整理时调用"比"把会议录音整理成结构化周报"准确率高得多。 一个 Skill 只做一件事 ，别把审查、发布、调试塞在一起，拆开用起来才更准。 Kami：让 AI 帮你排版出专业文档 写完内容只是第一步，排版成能发出去的东西往往更耗时间。Kami也是我最近做的 AI 排版设计工具，你把内容丢给它，说一句"帮我排成一页纸"或"做个作品集"，它会生成一份可下载的 PDF。 Kami 它有 8 套模板：一页纸、作品集、幻灯片、Resume、长文档、信件、研报、Changelog。风格统一，暖底色、墨蓝色点缀、衬线字体为主。中文用苍耳今楷，英文用 Charter，不需要自己调字体。 最实用的几个场景：会议纪要排成简报、项目进展排成一页纸给老板。以前这些活得开 Word 或 Figma 折腾半天，现在把内容丢进去，先出一版能看的稿子，再微调。 Claude Design：不写代码也能出原型 2026 年 4 月推出的 Claude Design是另一条路：你上传截图或文档，它直接给你个能交互的原型、幻灯片或落地页，对想快速做原型的非技术同学挺好用。 Claude Design 还不想碰代码的话，用它先出个能展示的想法准没错。产品经理可以用它画原型开评审，过了直接把原型扔给 Claude Code 变代码。早期原型不用等完整设计和研发排期，当天就能拿出来讨论。 用熟之后的几个小习惯 截图比文字快 ，要描述一个界面问题或者想参考某个设计风格，直接丢图比写一段话准多了，布局、颜色、层级都带进来了，让它少猜。 任务拆小一件件来 ，一句话能讲清楚的任务它几乎不会出错。一上来给一大坨需求，它中间任意一步走偏后面就全偏了，一件做完验收一件再开下一件。 对话跑偏了就重启 ，在已经跑偏的对话里来回纠正它越纠越乱，清掉上下文重说一遍需求往往更快。第二天接着干，先翻一眼上次的 Recap（/clear 后会自动生成的会话摘要）想起来干到哪了。 Memory 跨项目记住你的偏好 ，CLAUDE.md 是项目级的每个项目都得单独写一份，Memory 是用户级的跨所有项目和会话都生效。直接对它说"记住我喜欢先看方案再执行"、"记住回我中文"，它会写进 /.claude/memory/，以后任何项目打开都记得。常交代的背景信息都可以沉淀进去，省得每次重复说。 双击 ESC 改上一条 ，说错了或者它跑偏了，按两下 ESC 就能回到上一条消息修改，不用重开会话。 几个安全考虑点需要注意的 让它先解释再动手 ，在 CLAUDE.md 里加一条："每次执行 Bash 命令或修改文件前，先用一句话解释要做什么。" 它就会在每步操作前先告诉你它打算干嘛，看不懂代码没关系，看得懂"我要删掉这个文件"就够了。 看不懂的命令先问 ，它要跑一条你没见过的命令别直接放行，先问它"这条命令具体做了什么、有什么风险"，看懂了再点确认，要复制任何你不懂的命令去执行，里面可能夹带下载、上传或泄露信息的操作。 生产环境不要拿来练手 ，本地和测试环境随便折腾，但涉及生产数据库、线上配置的操作一定先在测试环境验证。一条写错的 SQL 或一次误删，回滚成本远高于你预期。 密钥别直接粘到对话里 ，要配置 API Key、数据库密码这类东西，让它放到环境变量或者 .env 文件里，不要直接把明文贴到聊天窗口。 还有一条容易被忽略但很要紧：能跑不代表安全，AI 生成的代码可能有漏洞，涉及登录、支付和个人信息的功能，能用 Clerk 或 Stripe 这种现成服务就别让它从零写。 加深了解 1. 你不知道的 Claude Code：架构、治理与工程实践 你不知道的 Claude Code：架构、治理与工程实践 2. 你不知道的 Agent：原理、架构与工程实践 你不知道的 Agent：原理、架构与工程实践 3. 你不知道的大模型训练：原理、路径与新实践 你不知道的大模型训练：原理、路径与新实践 4. Claude Code Best Practices Anthropic 官方 Claude Code Best Practices Anthropic 官方 5. vibe coding Andrej Karpathy 原始推文 vibe coding Andrej Karpathy 原始推文 6. Claude Skills are awesome, maybe a bigger deal than MCP Simon Willison Claude Skills are awesome, maybe a bigger deal than MCP Simon Willison 7. Malleable software in the age of LLMs Geoffrey Litt Malleable software in the age of LLMs Geoffrey Litt 8. Claude Code Skills 完全指南 Datawhale Easy Vibe Claude Code Skills 完全指南 Datawhale Easy Vibe 9. Claude Code Starter Pack: Tools, Tutorials & Resources AI Edge Claude Code Starter Pack: Tools, Tutorials & Resources AI Edge 10. When the Vibes Are Off: The Security Risks of AI Generated Code Lawfare When the Vibes Are Off: The Security Risks of AI Generated Code Lawfare 🔗 原文链接： https://x.com/HiTw93/status/2048230... https://x.com/HiTw93/status/2048230... 太长可不读 上个月在公司里给产品和业务的小伙伴分享了下如何上手 AI Coding，加上最近又发了条推特，聊到不少同学因为订阅门槛没机会用上一线 AI Coding 工具，方法和习惯不花钱就能先学，索性把上手这部分整理出来。然后为了让内容给大伙更好理解，文章中绘制了不少简单插画，这样看起来应该更会直接。 不少人用 Claude Code 其实是卡在使用命令行的第一步，看到只有字母的终端会觉得是给程序员用的，自己肯定搞不定。其实门槛没想象的高，会用豆包这类对话框 AI 的人花点时间也能上手，剩下的就是慢慢习惯把执行权交给它。 等你用顺手后，你会发现它像个什么活都接的能干助手，跑后台数据、写解决你问题的小工具、把乱七八糟的文档拼成简报、做原型、整理销售报表都能干。之前会不会写代码不是关键，等你有意识把项目背景写进 CLAUDE.md、把需求写得足够精确、会去想着沉淀几个 Skill 把重复动作打包，那你其实就称得上入门了，这篇文章主要是想着带非技术同学可以上手使用我最爱的 Claude Code。 第一道坎是命令行 不写代码的同学习惯了豆包这类对话框 AI，第一次装 Claude Code 都会有点不适应。以前是个来回搬运的过程，你描述需求、它生成代码、你复制粘贴到别处去试，现在变成Claude Code 直接在终端运行，搬运这一步省掉了。 如果你没用过终端，推荐我做的 Kaku，它是专门为 AI Coding 做的终端，装好就能用，不用折腾配色和字体。深色浅色跟着系统走，分屏按 Cmd + D，文件管理器按 Cmd + Shift + Y 直接显示出来。对刚上手的人最友好的是内置了 AI 辅助：命令跑报错了会自动给修复建议，记不住命令在前面加个 写中文也能生成。 Kaku 安装 Claude Code 也只需一条命令，详见官方文档，然后进项目文件夹输入 claude 就能开始 Coding 了。 官方文档 curl fsSL https://claude.ai/install.sh| bash curl fsSL https://claude.ai/install.sh| bash 非常建议补点技术知识 不写代码的同学想真把 Claude Code 用好，光会描述需求还不够，懂一点基础概念，后面排错会轻松很多。 知道常用框架是干嘛的 ，知道 React、Vue、Next.js 大概在解决什么问题，看 Claude Code 写出来的东西就不会一头雾水。 常用软件的基础 ，终端命令、Git、VS Code、Chrome 开发者工具，跑出错的时候你能跟着它一起定位，而不是只能干等。 编程的几个核心思想 ，函数是干什么的、变量和状态是什么、为什么要拆成多个文件，懂了这些需求才写得精确。 学会读代码和读报错 ，比自己会写代码更早派上用场。它改完一段你能扫一眼大概在干嘛，比让它从头解释一遍快得多。报错也别一看就慌，整段复制丢回去问"这是什么意思、要怎么改"，十次有九次能告诉你具体哪一行出问题。 不用学到能自己写代码的程度，知道这些东西长什么样就够了。花一两个晚上把 freeCodeCamp 或者 MDN 的入门篇过一遍，或者去 B 站挑一套入门课粗看一遍， 计算机科学速成课、哈佛 CS50都不错，后面跟 Claude Code 协作的效率会很不一样。 计算机科学速成课 哈佛 CS50 我挺推荐这三本对工程师最有用的入门易读书： 《启示录》看产品判断、《Linux/Unix 设计思想》看工程哲学、《左耳听风》看一个我怀念的左耳朵耗子攒下来的程序员专家视野，读完跟 AI 聊技术细节会少懵很多。 《启示录》 《Linux/Unix 设计思想》 《左耳听风》 准备工作：账号与订阅 账号 ：在 claude.ai用 Gmail 注册，流程最标准，注册前尽量用美国 iP 稳定的网络环境，别频繁切换出口，不然新账号容易触发风控，同时新账号不要直接包 Max，也容易被封号。 claude.ai 最简单的方式是走美区 App Store 内购，Android 走 Google Play 也行，进 Claude App 选 Pro 用余额订阅就行，注意走 App Store 有税费，100档会显示成125，多 25 买一个安心，不过很建议先 Pro 起步，配额不够再升 Max。订阅状态跟账号走，iOS 订完之后在 Android 或网页登录都正常用。 账号没了所有事都得重来，甚至还有可能持续被封，订前几件事注意一下。网络环境用稳定低延迟的别天天换，账号一号一人别合租也别和别人共用，付款方式选靠谱的实体卡，虚拟卡尤其是币圈渠道充值的容易秒封。邮箱用老 Gmail 别用新注册的 Outlook，出口尽量保持干净别让其他乱七八糟的 App 流量都从同一个口子出去。 Claude Code 适合什么样的活 我自己用过的 AI Coding 工具不少，Cursor、Windsurf 都试过一圈，Codex 平时也会用，主力还是 Claude Code。 它最不一样的地方是模型能力本身就很不错，加上Claude Code自己的代码实现也把 Harness 这一套玩到了极致，使用时候它先扫一遍 和目录结构摸清楚上下文，然后跨文件改代码、跑命令、看报错、再改，自己全部完成。再加上它本来就活在终端里，git、测试、脚本这些你日常用的工具它都能直接调起来，不用来回复制粘贴。 Claude Code 实际更像个通用 Agent，叫 Code 只是因为最初定位偏写代码。Anthropic 自己分享过他们内部不少非工程团队比如销售、风控、财务都在拿它干活，处理 CRM 数据和客户邮件。如果你实在不想碰终端，可以用官方出的桌面应用 Cowork ，能直接读写你的下载和文档目录，把收据截图拼成报销表这种活，你说一句话它也能给你干好。 还有一点我感觉很重要：写代码这件事上，模型快不快不重要， 准不准才重要 。它 10 分钟跑完然后你花 20 分钟 debug，远不如它 20 分钟跑完直接能验收来的舒服。 要让它准，前提是你给到的活本身就 目标清楚、结果好验收 ，两个都满足的最适合交给它，好比你把活交给了一个非常直男但是技术非常厉害的程序员。 具体就这几类活：做原型和内部小工具，把需求和展示逻辑说清楚，第二天就能跑起来一版；处理 CSV、做销售报表，分组和计算逻辑写明白几分钟出结果；几十页合同提炼条款、对比版本差异这种文档活它最擅长；最后是给一堆链接或 PDF 让它从特定视角提炼信息，说清格式就行。 做一个只给你一个人用的软件 最阻碍新人写代码的第一步是不知道自己要做个啥。《纽约时报》专栏作家 Kevin Roose 提过一个概念叫 software for one ：你不需要做给一百万人用的 App，可以做只给你一个人用的软件。 他给自己做过整理链接的 Stash，给孩子准备便当的 LunchBox Buddy。对你来说，可能是把语音批注转成会议纪要的工具，或者是每天提醒你三件事的小仪表盘。这种东西反而是产品和业务的同学最容易做成，毕竟只有你最懂自己每天的麻烦在哪。 一天到三个月的节奏 别一上来就想做个“像 Notion 那样的产品”，可以按下面这个节奏来，每一段都有摸得到的产出： 第 1 天先试水，让它改一个你手头现成的 Excel 或 Markdown 文档；第 1 周尝鲜，做一个单页个人主页或日报大盘 15 分钟就能跑起来；第 1 个月提效，挑一件每周重复做两三次的事变成一条命令或一个页面；第 3 个月进阶，选一个"software for one"的想法做一个只给自己用的小工具。 用 OpenCLI 把网页操作变成命令 很多运营日常是在浏览器里点点点：查后台、发消息、导报表。这些活其实能绕开界面，直接调背后的接口来做。 OpenCLI 是我朋友卡比做的，它内置了小红书、知乎、Twitter/X、Bilibili 等几十个站点的 CLI 适配器，再加上一组通用的浏览器操作原语像点击、输入、抓取、截图。把网页动作变成一条命令，Claude Code 一句话就能调起来。 OpenCLI 小红书调研 ，让 Claude Code 调 opencli xiaohongshu 抓数据，再做分类和热词提炼，原本浏览器里点半天的事一句话搞定。 舆情汇总 ，把 Twitter/X、Reddit、HackerNews 几个适配器组合起来，同一关键词在多个平台的讨论自动拼成一份日报。 没适配的网站 ，用浏览器原语命令描述一遍流程，比如开页面、输关键词、抓表格，Claude Code 自己拼出来。 Claude Code 还有个 Routines 功能，能把一段工作流存到云端，按定时、Webhook 或 GitHub 事件自动触发。我自己还没怎么深用，概念上像「周一早上自动跑一遍周报流程」这种事它能接管，感兴趣可以看官方文档。 官方文档 CLAUDE.md：先把项目背景写清楚 很多人装好之后直接开问，结果每次都要重复交代背景，用一会就觉得很烦。原因几乎都一样：没建 CLAUDE.md。 它放在项目根目录，Claude Code 每次启动都会先读它，相当于你给新来的同事写的项目交接文档，区别是它每次都会从头认真读一遍而且严格执行。 写得好不好，三件事最关键。写得短一点，150 行以内为佳，写太长会挤压后续对话的空间。语气直接，用命令式，别写"我们团队比较喜欢"这种软话，"所有注释用中文"比"团队偏好中文注释"有效太多。每条都能判断，"代码质量要高"没用，"函数超过 50 行必须拆分"才能落地。 四条最值钱的规则，直接拿去用：先问清楚再动手、简单优先、只动该动的、做完要验证。展开就是：别让它猜你的意图，目标说清再写；能两行解决的不写两百行，拒绝过度设计；不要顺手重构没让它改的代码；跑通构建和测试才算完，没通过别说完成。 最后这段"压缩时保留"看着不起眼，长会话能不能稳就靠它。Claude Code 的上下文用到一定程度会自动压缩，决策的理由通常是第一个被丢的。比如你之前说过"这里要用 POST 不用 GET，因为数据量大"，压缩之后可能只剩"用 POST"三个字，理由没了。下次再问相关问题，它可能给你一个完全不同的方案，前后矛盾。把这一段写进去，长会话就不会前后打架。 上面这些不一定要自己从头写。装好 Claude Code 之后，直接说"读一下我这个项目，帮我生成一份 CLAUDE.md"，它会扫一遍代码、技术栈、目录结构，给你一份草稿，你只要改一改人名和团队偏好。装依赖、配 alias、改 /.claude/settings.json 这些事也一样，告诉它要什么效果让它自己去试，比你查文档快得多。配置类的活能交就交，省下来的精力放到真正要判断的事情上。 需求描述越精确，它越少分叉跑偏 模糊版