来自Claude 官方的这个《Claude Code: Best practices for Agentic coding》文章开篇就是王炸。
Claude秉承了一贯的特色,从来不玩那些虚的!
明明白白告知Claude Code这个AI命令行工具使用了最基本最low-level最无主见的最原始模型能力。
然后就是直入主题:AI编程最有效的提示和技巧。
虽然是讲Claude Code,但是对于所有AI编程的思考和思想都是一致的,摘录其中部分我认为比较有用比较普适的内容。
CLAUDE.md 是 Claude 在开始对话时自动提取到上下文中的特殊文件,这个类似于Cursor Rule。
类似于昨天讲的Cursor Rules 原理和最佳实践
CLAUDE.md 文件没有必需的格式。官方建议保持它们简洁易读。例如:
#Bashcommands
-npmrunbuild:Buildtheproject
-npmruntypecheck:Runthetypechecker
#Codestyle
-UseESmodules(import/export)syntax,notCommonJS(require)
-Destructureimportswhenpossible(eg.import{foo}from'bar')
#Workflow
-Besuretotypecheckwhenyou’redonemakingaseriesofcodechanges
-Preferrunningsingletests,andnotthewholetestsuite,forperformance上面就是一个 Claude.md 文件的模板, 用来帮助 Claude 更好地理解项目环境、代码风格和工作习惯, 从而在对话中提供更准确、更有上下文感知的建议。
当然它并不是固定的,可以根据项目实际情况进行修改和拓展。
具体应该填哪些内容呢?Claude官方给出了如下的方向。
官方最推荐的做法是:把 CLAUDE.md 放在代码仓库根目录, 并提交到 Git。这样Claude 每次运行时都能自动加载你设定的上下文, 同时团队成员也能共享这份配置。
接下来是一个Claude Code 与 GitHub 的深度整合,主要通过 gh CLI 实现。
可以对 Claude 说:“请为这个更改创建一个 PR,并写一个合适的提交信息。”
Claude 会读取 diff,生成 commit message,推送代码,并通过 gh 创建 PR。
GH CLI详细的安装操作请点击这里:gh安装和使用
下面是重头戏,Claude的AI编程工作流。
1. 通览项目
让 Claude 读取相关文件、图像或 URL,提供通用指针(“读取处理日志记录的文件”)或特定文件名(“读取 logging.py”),但明确告诉它暂时不要编写任何代码。
换句话说:你可以让Claude 先了解问题背景, 比如让它读取代码、图片或网页; 可以用模糊描述, 也可以直接给文件名。
但重点是:你要明确告诉 Claude“现在不要写代码”, 先让它只做阅读和理解。
这是 Claude Code 推荐的第一步, 用来建立上下文、避免它过早进入编码阶段。 尤其在处理复杂问题时, 这种做法能提高 Claude 的准确性和效率。
2. 深度思考
这个文章官方主要针对Claude Code来讲的,而且很绕。
其实说白了,就是让你在正式入编写前代码前,来制定和评估各种方案,分析利弊, 最后给出一份详细的执行计划。并且在这一步就开始建立git版本控制检查点。
3. 方案制定
让Claude 在代码中实现其解决方案。这也是要求它在实现解决方案的各个部分时 显式验证其解决方案的合理性的好地方。
4. 测试驱动开发
通过单元、集成或端到端测试,测试驱动开发 (TDD) 通过代理编码变得更加强大。
很不巧,本人正好也写过这种文章:
营销号都在教你写贪吃蛇2048,我却要和你聊一聊真正的编程实践,在Cursor中践行TDD
这是 Anthropic 官方非常推荐的一种工作方式, 适用于可以通过测试轻松验证 的更改 (如单元测试、集成测试、端到端测试) 。它的流程如下:
1.让 Claude 根据预期输入/输出编写测试 ,明确告诉 Claude:你正在进行测试驱动开发 (TDD), 这样 Claude 就不会提前写出“假实现”或“模拟代码”, 即使功能还不存在也不会乱写。
2.运行测试并确认失败,告诉 Claude 运行测试, 并确认它们失败,明确指示它:此阶段不要写任何实现代码,样可以确保测试是有效的, 且尚未被实现代码“误通过”。
3.编写实现代码, 直到测试通过 告诉 Claude:现在写实现代码, 但不要修改测试。
4.Claude 会开始迭代开发:写代码 >运行测试-修复错误>再次测试。
一般需要几轮迭代, 直到所有测试通过。
如果你对测试逻辑满意, 可以让 Claude把测试代码提交到版本库。
Claude 在有明确目标 (如测试用例) 时表现最佳。通过测试驱动开发, 你能让 Claude更稳定地输出正确代码。这个流程尤其适合那些“改动小但要确保正确性”的任务, 比如修 bug、加小功能、重构等。
优化工作流程
最后,官方给出了使用 Claude Code 时,通过明确指令、合理利用图像、文件和 URL、及时纠正方向以及使用清单和暂存区等方式。
具体来说,越具体的指令越能帮助 Claude 精准理解任务;提供截图、文件路径或链接能增强上下文理解
通过这些方法,用户不仅能更高效地完成任务,还能更好地引导 Claude 成为真正的协作伙伴。
| 欢迎光临 链载Ai (https://www.lianzai.com/) | Powered by Discuz! X3.5 |