Claude Code 入门：Agent SDK 与规划模式实战技巧

Claude Code 的能力远不止命令行工具那么简单。在 Anthropic 官方讲师 Lydia 的入门分享中，她重点介绍了 Agent SDK 的用途，以及在规划阶段如何借助 Ask User Question 工具与模型高效协作。这两个点对想真正用好 Claude Code 的开发者很有价值。

Agent SDK：脱离 CLI 也能调用 Claude Code 运行时

很多人接触 Claude Code，都是从命令行工具（CLI）开始的。但 Lydia 指出，如果你不想依赖官方的 CLI 或任何现成工具，仍然可以通过 Agent SDK 直接调用 Claude Code 的运行时（Runtime）。

所谓 Runtime，指的是模型执行的底层环境。通过 Agent SDK，你依然能够发起查询、调用工具，完成在 Claude Code 中习以为常的各种操作——区别只是你可以用编程的方式，围绕这个运行时自行封装工具链。

接入方式也很直接，只需要一个 API Key 即可。换句话说，Agent SDK 把 Claude Code 的核心能力开放给了开发者，让它可以嵌入到自己的应用和自动化流程中，而不必被固定的交互界面所限制。

值得一提的是，Anthropic 内部的 CoWork 产品正是基于 Agent SDK 构建的。也就是说，官方自己的协作工具都跑在同一套 SDK 之上，这从侧面印证了它的成熟度与可靠性。对于希望把 Claude 的 Agent 能力集成进自研系统的团队来说，这是一个重要信号。

从更广泛的背景来看，Agent SDK 属于「模型即运行时」架构的一种实现。传统 LLM API 通常是无状态的单次请求-响应模式，而 Agent SDK 在此之上封装了工具调用循环（Tool Use Loop）、上下文持久化和多步推理的协调逻辑。开发者通过 SDK 拿到的不仅是一次文本生成，而是一个可以自主决策「下一步调用哪个工具、是否需要继续推理」的完整执行环境。这与 OpenAI 的 Assistants API、Google 的 Agent Builder 等产品在定位上是同类竞品，共同指向一个趋势：将 Agent 编排能力从应用层下沉到平台层，让开发者专注于业务逻辑而非底层的 ReAct 循环实现。

规划模式中的 Ask User Question 工具

Lydia 在演示中特别推荐了一个她个人最喜欢的用法：在**规划模式（Plan Mode）**下，主动要求 Claude 使用 Ask User Question 工具。

她以一个「问题追踪系统」的需求为例——希望实现每个 issue 支持多个负责人、优先级等字段。在描述需求时，她会在 prompt 中明确写上：

使用 ask user question 工具来彻底地访谈我，思考那些我可能还没想到的边界情况。

这个工具本质上是一次结构化的回调，会在界面上弹出一组问题，逐项向用户确认设计细节。无论是在图形界面还是 CLI 中，都能看到这种交互形式。它让人和模型之间形成一来一回的对话，共同打磨方案。

为什么要「刻意」调用这个工具

Lydia 坦言，有时候 Claude 会自发地弹出这些问题，但并不总是如此。所以她倾向于在提示词中显式要求模型使用该工具，确保每次规划都能进入这种深度交互状态。

在演示过程中，模型确实提出了许多她自己一开始没想到的考量点，比如 UI 元素的摆放位置、负责人的识别方式等。她形容这是「它替我想到了很多我还没想到的东西」——这正是规划模式的价值所在。

她也提到一个操作上的小细节：如果中途按下 Esc，会直接退出整个问答流程，相当于拒绝回答全部问题，需要留意。

规划模式（Plan Mode）是 Claude Code 的一种特殊运行状态，在此模式下模型被要求先输出结构化的执行计划，而不是直接生成并运行代码。这一设计借鉴了软件工程中「先设计后实现」的思路，也与提示工程领域的「思维链（Chain-of-Thought）」研究结果一致——让模型在输出最终答案前先做显式推理，能显著降低遗漏关键约束条件的概率。Ask User Question 工具在规划模式中充当了「需求评审」的角色：它将模型在内部推理时识别到的模糊点或潜在边界条件，以结构化问卷的形式外化给用户，从而把隐性假设转化为明确的设计决策，避免后续开发阶段因需求理解偏差而返工。

实用要点与思考

Lydia 强调，即便你不显式指定工具，只要在 prompt 里要求 Claude「彻底询问边界情况」，它往往也会自然地展开追问。但她仍然选择刻意调用 Ask User Question 工具，目的是不浪费与模型之间的来回交互周期，让每一轮对话都更有效率。

这背后其实反映了一种更成熟的使用心态：与其让 AI 直接给出一个可能遗漏关键点的方案，不如先通过结构化访谈把需求和边界条件厘清，再进入实际开发。规划越充分，后续返工的成本就越低。

对于初学者而言，这段分享传递了两个核心认知：一是 Claude Code 不只是 CLI，Agent SDK 提供了更灵活的编程式接入；二是善用规划模式和 Ask User Question 这类工具，能把人机协作从「下指令」升级为「共同设计」。