Claude Agent SDK 快速上手：从命令行调用到搭建 Claude Code 网页版

借助 Anthropic 开源的 Claude Agent SDK（Python 版），你可以轻松将 Claude Code 的智能代理能力嵌入到自己的应用中。本文将带你从零开始，快速上手并创建一个网页版聊天界面。

项目地址：
https://github.com/anthropics/claude-agent-sdk-python

安装 SDK

首先，通过 pip 安装 claude-agent-sdk：

pip install claude-agent-sdk

运行快速测试

下载官方提供的 quick_start.py 示例脚本，链接如下：

https://github.com/anthropics/claude-agent-sdk-python/blob/main/examples/quick_start.py

配置好 Anthroipc 相关的环境变量（如 ANTHROPIC_API_KEY），然后运行该脚本。运行效果如下：

Image

成功跑通这个脚本，意味着你的 Claude Code 环境和 Agent SDK 均已正确配置，并且验证了在命令行中以非交互模式调用 Claude Code 的能力。

构建 Web 版 Claude Code

接下来，我们将基于 SDK 快速搭建一个 Web 版 Claude Code，以检验其集成能力。

Image

最终实现的网页版效果如图所示，用户可直接在浏览器中与 Claude Code 对话：

Image

这里仅演示了 claude-agent-sdk 的基础对话功能。在实际生产环境中，你还需要妥善管理多轮对话的会话 ID，并对聊天记录进行持久化存储；否则一旦程序重启，所有历史记录将会丢失。

多轮会话与工具调用

除了基本的聊天功能，SDK 还支持调用外部工具，这一能力和 OpenClaw 的设计理念有着异曲同工之妙：

Image

通过以上步骤，你已经掌握了 Claude Agent SDK 的基本用法。现在就可以将它集成到自己的项目中，构建更强大的 AI 代理应用。