花了一整天研读Anthropic最新发布的Claude Code最佳实践文档,结合个人实战经验,整理出这份终极指南。
+ 基础心法
任务描述永远放在最前面,重要指令置顶。这听起来简单,却是大多数人忽略的细节。
给Claude一个自我验证的方式,比如测试用例、截图或预期输出。这是提升效果最立竿见影的一招。
推荐的提示词结构:角色 + 任务 + 上下文。简洁有力,屡试不爽。
工作流程遵循“先探索,再规划,后执行”。可以先用其他大模型做调研,进入Plan Mode规划,最后切回正常模式写代码。
假设Claude对你的项目一无所知,把它需要的信息全部告诉它。用@符号链接文件、数据和图片,提供丰富的上下文。
运行/init可以为当前项目生成一个CLAUDE.md模板文件。
+ 项目与技能管理
用项目级指令定义长期行为,避免重复提示。编辑Memory标签精确控制Claude应该记住或忽略什么。
把重复性工作流转化为Skills。一个取巧的方法:贴一个优秀输出,让Claude把它变成可复用的Skill。甚至可以上传截图让Claude复刻,这是创建高质量Skill的捷径。
定期清理memory、文件和指令,防止项目漂移。不相关的工作流要分开项目,避免上下文污染。
推荐两个Skills资源库:skillsmp.com收录了8万多个Skills,mcpservers.org/claude-skills提供即插即用的Skills。
+ 冷门但实用的技巧
用其他大模型规划项目、生成高级提示词,再交给Claude Code执行。这个策略还能节省Plan Mode的token消耗。
在.claude/agents/目录下定义专门的子代理,让Claude把特定任务委派出去。
让Claude根据你预设的成功标准给自己的答案打分。
运行/plugin浏览插件市场,无需配置即可扩展能力。
大型项目可以让Claude先采访你。用一个简短提示开始,让Claude通过AskUserQuestion工具向你提问。
发现Claude跑偏时立刻纠正,按ESC中断操作。/clear开启干净会话,双击ESC或/rewind打开检查点菜单。
可以运行多个并行会话:Claude Desktop管理多个本地会话,每个会话有独立的工作树;Claude Web在Anthropic的云端隔离虚拟机中运行。
+ 调试与错误处理
只重跑出错的步骤,不要重新生成所有内容。让Claude故意复现错误来理解问题本质。回滚到上一个正常的提示词,逐步重新应用修改。
CLAUDE.md太长会适得其反,重要规则被淹没。解决方案:无情地精简,如果Claude本来就能做对的事,删掉那条指令。
常见错误:一个任务没完成就问不相关的问题,再回到第一个任务。上下文被无关信息污染。解决方案:不相关任务之间用/clear。
连续纠正两次还是错的话,/clear后写一个更好的初始提示词,把学到的教训融入进去。
上下文窗口填满后,Claude可能开始遗忘早期指令。参考官方文档减少token消耗:code.claude.com/docs/en/costs#reduce-token-usage
+ 进阶资源
把Notion数据库连接到Claude,存储常用提示词。
使用claude --dangerously-skip-permissions跳过所有权限检查,适合修复lint错误或生成样板代码这类安全的自动化工作流。
Hooks适合那些必须每次都执行、零例外的操作。
推荐资源:Anthropic官方学习资源anthropic.com/learn,Claude Code最佳实践文档code.claude.com/docs/en/best-practices,GitHub上的superpowers仓库github.com/obra/superpowers。
最后一条忠告:慢即是快。尤其是构建严肃的工作流时,规划、规划、再规划,然后才是执行。
x.com/aiedge_/status/2014740607248564332