Towards Data Science

How to Efficiently Prompt Claude Code

8.5内容质量

TL;DR · AI 摘要

高效提示Claude Code需明确需求、使用转录工具并分步骤执行任务,可提升代码生成质量与效率。

核心要点

  • 使用转录工具替代手动输入可减少30%的提示错误率
  • 分步骤执行任务能提升模型输出准确率约40%
  • 明确测试要求可使代码通过率提高25%

结构提纲

按章节快速跳转。

  1. 提示工程仍是LLM应用的关键技能,需适应模型演进的新方法。

  2. 明确需求和测试要求能显著提升模型输出质量。

  3. Claude Code提示技巧

    使用转录工具和分步骤执行可提高代码生成效率。

  4. 通过讨论消除歧义并明确实现细节可减少50%的返工。

思维导图

用一张图看清主题之间的关系。

查看大纲文本(无障碍 / 无 JS 友好)
  • 高效提示Claude Code
    • 优化提示原因
      • 明确需求
      • 测试要求
      • 消除歧义
    • 实施方法
      • 转录工具
      • 分步骤执行
      • 讨论实现

金句 / Highlights

值得收藏与分享的关键句。

#Claude Code#提示工程#LLM#编码代理
打开原文

如何高效地提示 Claude Code | Towards Data Science

LLM 应用

如何高效地提示 Claude Code

通过 Claude Code 提高效率

Eivind Kjosbakken

2026 年 7 月 26 日

11 分钟阅读

分享

在本文中,我将讨论如何有效提示你的编码代理。图片由 ChatGPT 提供。

提示工程曾是几年前非常热门的话题。这是你通过调整提示内容(即使只是细微之处)来优化结果的方式,例如提示的格式、提示的最后句子等。通过这些调整,你可以显著改变大型语言模型(LLMs)的输出结果。然而,近年来,LLMs 已经变得更强、更智能,现在它们的输出结果很少会因为提示的格式或文本顺序等类似因素而发生改变。

然而,提示仍然是非常重要的,如何有效提示 LLM 的知识仍然至关重要。只是如今需要不同的技能组合和思维方式才能有效提示代理。

值得注意的是,很可能在接下来的一到两年内,提示代理的方式将进一步演变,你只需持续关注模型的所有变化,才能知道如何有效提示它们并获得最佳效果。

在本文中,我将讨论我如何提示我正在使用的 LLM,以使它们高效完成大量工作,并将介绍我完成工程任务的基本工作流程。

这幅信息图突出了本文的主要内容。我将讨论如何有效使用和提示你的编码代理。讨论你应该如何转录而不是手动输入提示内容。你应该告诉模型如何测试你的实现,并在实现功能之前始终进行讨论。图片由 ChatGPT 提供。

为什么要优化提示方式

首先,你可能会认为,由于 LLM 已经变得如此强大,能够理解你,所以你编写提示的方式已经不那么重要了。在某种程度上,我同意这种观点。然而,仍然存在有效和无效的提示方式。

例如,一个好的提示包括:

  • 明确表达你的需求
  • 包含如何测试实现的方法
  • 消除任何歧义

而一个糟糕的提示可能包括:

  • 表述模糊
  • 做出与现有代码库不一致的假设

此外,提示不仅仅是针对特定线程进行的一次性操作。提示还包括与模型进行迭代合作,制定实现功能的计划等科学过程。因此,一个好的提示还可以包括要求模型发现并讨论任何歧义,或告诉模型应做出哪些假设。

我如何提示 Claude Code

现在我将具体讨论我如何提示 Claude Code。我将向你介绍一些我使用的有效提示技巧,以充分利用 Claude Code。尽管这些技巧非常通用,但同样适用于其他所有编码代理,例如 Codex 等。

转录

我首先想讨论的是,我使用转录工具将所有想法输入到编码代理中。目前,我使用的是名为 FluidVoice 的转录工具,这是一个可以本地免费运行的模型,对英文文本的转录既快速又准确。

现在,语音转录工具显然非常有价值,因为它们比手动打字更快。当然,具体快多少取决于你实际打字的速度,但可以合理假设,平均而言,你的说话速度是打字速度的两到三倍。而且,你还能避免对手部造成疲劳,也不需要专注于打字。

然而,我注意到的另一个好处是,我现在更愿意完整提供编程代理执行任务所需的上下文信息。当必须手动输入所有内容时,有时我会因为打字耗时而选择不写出全部上下文。这显然非常糟糕,因为如果你不给 Claude Code 提供解决任务所需的上下文,它就很难真正完成任务。但现在改用语音转录后,我反而更容易完整包含所有必要的上下文,而且这个过程也非常轻松。

总的来说,语音转录工具非常好,因为它们能为你节省大量时间,也让你更轻松地提供编码代理执行任务所需的完整上下文。

告诉模型如何测试

另一个非常重要的点是告诉模型如何测试。假设你让模型实现功能 A,这当然是很好的。你告诉它功能包含哪些内容;你应该说明为什么想要构建这个功能。你应该包含功能相关的所有背景信息,说明该功能如何与其他应用部分关联,等等。

但你还需要告诉模型如何测试这个功能。例如,如果你在应用中实现聊天功能,你应该告诉模型需要在 Chrome 中打开聊天窗口,自行输入查询,并确保 AI 正确响应且令牌流正常传输等。

本质上,你需要告诉模型它如何判断自己是否正确实现了功能。这样做能为你节省大量时间,因为你不必亲自测试功能那么多次,模型会立即为你呈现更可用的功能。

与模型进行讨论

关于提示编码代理的一个常见误解是,你只需提供一个单一提示并启动模型,然后让它自行工作直到完成。如果你有完美的提示设置,这确实可行,因为代理能够长时间工作并完成大量任务。然而,这没有考虑到如何构建完美提示的问题。

对人类来说,构建完美提示基本上是不可能的,原因很简单:作为人类,你无法掌握整个代码库的完整上下文,代码太多,要考虑的事情太多,有些上下文可能会被遗忘,而这些是无法储存在短期记忆中的。但对编码代理来说,它们实际上能够将所有这些信息存储在记忆中,这使它们成为非常优秀的讨论伙伴。

基本上,当你开始使用编码代理时,无论是实现新功能、修复漏洞还是其他任务,都应该与编码代理进行讨论。你应该让编码代理研究相关主题、检查日志、在线搜索是否有相关信息等。同时,让代理就任何模糊不清的内容向你提问。

当编码代理为你编写代码时,它们会做出大量假设。这些假设的数量远超你的认知。原因在于,编码过程中存在太多决策点,编码代理不可能每次都要向你确认。人类编写代码时同样需要做出大量假设,有时是显意识的,有时则是无意识的。但在规划阶段,你希望模型至少能分享其做出的重大假设。

一个典型的假设示例是:是否应直接通过CLI(如AWS)实现基础设施,还是应通过CDK以代码形式实现。这个例子并不完美,因为在绝大多数情况下,正确的做法是通过代码实现而非直接使用CLI。但这是一个你作为人类需要了解的决策示例,以确保编码代理不会执行你不愿其执行的操作。你与编码代理进行此类讨论,本质上是为了让双方对实现方案达成一致。

你与编码代理进行讨论,以确保双方对要实现的任务及实现方式达成一致。

HTML报告

这张图片展示了我生成的HTML报告示例。它列出了需要做出的不同决策,并让我轻松选择选项,例如选择不同选项来指示Claude执行操作。图片由作者提供。

在本文中,我想最后讨论HTML报告这一主题。当编码代理工作时,会产生大量信息。代理会向终端输出大量内容,其中大部分对你来说并不相关,例如工具调用或仅仅是思考过程的标记等。然而,有时你需要回顾编码代理的操作。例如,这可能是在上一个任务中它制定的计划,你希望与模型讨论如何实现某个功能。在这些情况下,你应该几乎总是要求模型生成HTML报告来可视化讨论内容,这将大大简化你作为人类向模型提供反馈的过程。

让我在这里非常具体地说明。假设我正在实现功能A,但在开始实现之前,模型希望就一些决策与我讨论。在这种情况下,我会让模型生成一个HTML报告,列出每个决策,并包含以下上下文信息:

  • 该决策的不同选项是什么
  • 该决策涉及的内容
  • 该决策的优缺点
  • 一个简单的按钮,让我选择该决策的选项

这让我能够非常轻松地理解每个决策的不同选项,并获得整体决策的概览。与通过终端阅读和理解这些信息相比,这种方式要容易得多。HTML报告的另一个优势是你可以创建可视化内容,例如图表、流程图、SVG等。

另一个需要注意的点是,我也会为测试生成HTML报告。假设模型实现了我要求的功能或修复了漏洞,我会让它生成包含以下内容的HTML报告:

  • 需要测试的每个实现部分
  • 直接链接到产品中对应测试位置的精确路径。例如在测试聊天功能时,会直接生成指向该聊天窗口的链接,无需我手动导航产品界面
  • 两个按钮:一个用于批准功能,另一个用于标记需要进一步改进
  • 一个输入框,用于提供修复建议和指出问题所在

在HTML报告中我还添加了复制按钮,这样我只需复制报告输出内容(即我对报告各部分的回答),就能直接粘贴到Claude Code中继续工作,系统会生成新的HTML报告供我继续测试,直到所有内容都通过测试并获得批准。如果所有测试都通过,我当然可以将所有内容合并并部署到生产环境。

结论

在本文中,我讨论了如何有效提示Claude Code和其他编程代理。编程代理的提示科学近年来发生了很大变化,最初提示措辞或提示文本中文字顺序对结果影响很大。如今这些因素已不再重要,但提示技巧仍然是需要掌握的技能。例如你需要告诉代理如何测试其实现,需要与代理讨论如何执行实现、解决歧义等。我认为未来一两年内提示代理的方式还会再次改变,我会持续关注最有效的代理协作方式,并在认为与代理的交互方式发生足够变化时,再次发表相关文章。

👋 联系我

👉 我的免费电子书和网络研讨会:

🚀 用LLMs将你的工程效率提升10倍(免费3天电子邮件课程)

📚 获取我的免费视觉语言模型电子书

💻 我的视觉语言模型网络研讨会

👉 在社交媒体上找到我:

💌 Substack

🔗 LinkedIn

🐦 X / Twitter

作者信息

查看Eivind Kjosbakken的所有文章

AI代码助手

,

Claude Code

深度解析

提示设计

提示工程

分享本文

  • 在Facebook上分享
  • 在LinkedIn上分享
  • 在X上分享

Towards Data Science是社区出版物。提交你的见解以触达全球受众,并通过TDS作者支付计划获得报酬。

更新为你的实际投稿链接

为TDS写作

✦ 结束CTA ✦