我做过一个不严谨的统计：在我们团队几个开发交流群里，每周出现频率最高的求助，前三名全是 Claude Code 的报错问题。而且每次都是同样的几个错误。……这些报错不复杂，但每次出现，都能让刚上手的人卡半天——因为报错信息本身说的是英文，而且通常不会直接告诉你根本原因在哪。我自己也在这些坑里趟过。这篇文章是我的踩坑记录，按"我遇到这个报错时需要知道什么"来组织，不是 API 文档的翻译版。

装完 Claude Code 不代表你就能"AI 编程"了，就像买了健身卡不代表你能练出腹肌。Claude Code 不是用来替你写代码的，而是用来加速你已经知道怎么做的事情。如果你连基本的 Web 开发概念都不懂，AI 生成再多代码你也看不懂为什么能跑、为什么会报错。装完这套流程，你应该能做到：30 秒生成一个标准的 API 接口5 分钟完成重复性的 CRUD 代码遇到不熟悉的库时，让 Clau

Claude Code 不是"更聪明的 Copilot"，而是"需要你主动驾驭的协作伙伴"。你给它的上下文越精确、约束越清晰、任务拆得越细，它就越能帮你省时间。那些"隐藏功能"，本质上都是在教你怎么更好地跟 AI 说话。

当一个对话快到上下文上限时，在开新对话之前，让 Claude Code 做一个摘要：请用200字以内总结我们这个对话里确定的所有技术决策和已完成的实现细节，我会把这段摘要带到下一个对话继续。然后把它生成的摘要贴到新对话的开头。这个习惯养成之后，上下文丢失的问题基本消失了。

计时过一次。同样是让 Claude Code 重构一个 300 行的工具函数，用鼠标点菜单的方式，我花了 11 分钟。熟悉快捷键之后，同样的操作，4 分 20 秒。不是 AI 变聪明了，是我和 AI 之间的"摩擦"变少了。

新 Session。打开，把 API 路由文件也参考已加载的 API 路由文件，更新 User 相关的 TypeScript 类型定义，加上timezone字段，类型为。这一步通常很快，Claude 只需要加一行类型，但必须做——否则前端用这个类型的地方会报 TypeScript 错误。

我做过一个不严谨的统计：在我们团队几个开发交流群里，每周出现频率最高的求助，前三名全是 Claude Code 的报错问题。而且每次都是同样的几个错误。……这些报错不复杂，但每次出现，都能让刚上手的人卡半天——因为报错信息本身说的是英文，而且通常不会直接告诉你根本原因在哪。我自己也在这些坑里趟过。这篇文章是我的踩坑记录，按"我遇到这个报错时需要知道什么"来组织，不是 API 文档的翻译版。

Claude Code 的上限，取决于你给它的反馈质量，而不是你的 Prompt 有多精妙。Terminal 闭环、CLAUDE.md 上下文、窗口分工——这三件事做到位，你就不是在用一个聊天工具，你是在驱动一个真的能感知项目状态的执行引擎。你现在的 CLAUDE.md 里写了什么？或者你根本没用过这个文件——如果是后者，你觉得阻碍你写它的原因是什么？懒，还是不知道该写什么？

装完 Claude Code 不代表你就能"AI 编程"了，就像买了健身卡不代表你能练出腹肌。Claude Code 不是用来替你写代码的，而是用来加速你已经知道怎么做的事情。如果你连基本的 Web 开发概念都不懂，AI 生成再多代码你也看不懂为什么能跑、为什么会报错。装完这套流程，你应该能做到：30 秒生成一个标准的 API 接口5 分钟完成重复性的 CRUD 代码遇到不熟悉的库时，让 Clau

Claude Code 的上限，取决于你给它的反馈质量，而不是你的 Prompt 有多精妙。Terminal 闭环、CLAUDE.md 上下文、窗口分工——这三件事做到位，你就不是在用一个聊天工具，你是在驱动一个真的能感知项目状态的执行引擎。你现在的 CLAUDE.md 里写了什么？或者你根本没用过这个文件——如果是后者，你觉得阻碍你写它的原因是什么？懒，还是不知道该写什么？