今天我们要分享的内容来自 Anthropic 工程师 Thariq —— 他是 Claude Code 及 Claude Agent SDK 的核心开发者。这篇文章是他关于如何为 AI Agent 设计工具的实践经验总结，标题是《构建 Claude Code 的教训：像 Agent 一样思考》。（原文链接：x.com）

在 AI Agent 开发中，一个核心难题是如何设计动作空间—— 给模型多少工具？什么样的工具组合最合适？工具设计得再好，如果模型不喜欢调用它，也是白搭。

Thariq 在这篇文章中分享了五个关键教训：

第一，AskUserQuestion 工具的迭代历程。 从最初的简单参数到结构化输出，再到独立的工具设计，核心原则是让模型“喜欢调用”。

第二，工具需要随模型能力进化。 当 Claude 变得更强时，原本帮助它保持正轨的 TodoWrite 工具反而成了限制，最终被 Task 工具取代。

第三，上下文构建方式的转变。 从直接给模型 RAG 检索结果，到让它自己用 Grep 搜索，再到引入“渐进式披露”理念 —— 让 Agent 通过探索逐步发现所需信息。

第四，工具数量要克制。 Claude Code 仅保留约 20 个工具，每个新增都要经过高门槛审视。

第五，设计工具是艺术而非科学。 核心建议是：经常实验，阅读输出，像 Agent 一样思考。