http://www.heyuan110.com/zh/tags/agent-sdk/Recent content in Agent SDK on Bruce AI 工程笔记HugozhFri, 17 Apr 2026 10:00:00 +0800http://www.heyuan110.com/zh/posts/ai/2026-04-17-claude-agent-sdk-guide/Fri, 17 Apr 2026 10:00:00 +0800http://www.heyuan110.com/zh/posts/ai/2026-04-17-claude-agent-sdk-guide/<p><img src="http://www.heyuan110.com/posts/ai/2026-04-17-claude-agent-sdk-guide/cover.webp" alt="Claude Agent SDK practical guide: build production AI agents with Python" loading="lazy" decoding="async" fetchpriority="low" width="1200" height="630" /> </p> <p>一个能读写文件、执行终端命令、搜索代码库的 AI Agent，用 Python 写需要几行代码？</p> <p>如果你用 LangChain，大概 80 行——定义 tool schema、实现 tool executor、写 agent loop、处理异常。如果你用 CrewAI，大概 50 行——还得理解它的 Agent/Task/Crew 三层抽象。</p> <p>用 Claude Agent SDK？<strong>3 行</strong>。</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"><span class="line"><span class="cl"><span class="kn">from</span> <span class="nn">claude_agent_sdk</span> <span class="kn">import</span> <span class="n">query</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="k">async</span> <span class="k">for</span> <span class="n">message</span> <span class="ow">in</span> <span class="n">query</span><span class="p">(</span><span class="n">prompt</span><span class="o">=</span><span class="s2">&#34;Find and fix the bug in auth.py&#34;</span><span class="p">):</span> </span></span><span class="line"><span class="cl"> <span class="nb">print</span><span class="p">(</span><span class="n">message</span><span class="p">)</span> </span></span></code></pre></div><p>这不是玩具代码。这 3 行背后，Claude 会自动读取文件、分析 bug、编辑修复——不需要你写任何 tool execution loop。</p> <p>但 90% 的教程到这里就结束了。真正把 Agent 推向生产，你还需要搞懂 3 件事：多轮对话的 <code>ClaudeSDKClient</code>、权限管控的三层防御、以及 MCP 自定义工具。这篇文章把这些全覆盖。</p> <h2 id="agent-sdk-到底解决了什么问题">Agent SDK 到底解决了什么问题<a href="#agent-sdk-%e5%88%b0%e5%ba%95%e8%a7%a3%e5%86%b3%e4%ba%86%e4%bb%80%e4%b9%88%e9%97%ae%e9%a2%98" class="anchor" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"> <path d="M15 7h3a5 5 0 0 1 5 5 5 5 0 0 1-5 5h-3m-6 0H6a5 5 0 0 1-5-5 5 5 0 0 1 5-5h3"></path> <line x1="8" y1="12" x2="16" y2="12"></line> </svg></a></h2> <p>如果你用过 <a href="https://docs.anthropic.com/en/api/client-sdks">Anthropic Client SDK</a> 构建 Agent，一定写过这样的循环：</p>