[JS/TS] Claude Agent SDK 的 WebSocket 封装：在沙箱中实时控制 Claude 智能体

文章摘要：一个将 Claude Agent SDK 封装为 WebSocket 服务的开源项目，方便开发者在沙箱或本地环境与 Claude 进行实时交互。

项目资源

• 项目地址：github.com/dzhang/claude-agent-server
• 相关讨论：x.com/dzhng/status/1991154972558581889?s=20
• 作者：dzhng

详细介绍

Claude Agent SDK WebSocket Server 是一个开源项目，它将 Anthropic 的 Claude Agent 原生 SDK 封装成了一个提供 WebSocket 接口的服务。这个项目的目的很明确：方便开发者，无论是想在本地机器上，还是在更安全的 E2B 沙箱环境中，都能以一种实时、双向通信的方式来驱动 Claude 智能体。

项目本身采用 monorepo 结构进行组织，这意味着它把服务器、客户端库以及 E2B 打包脚本都放在了一个仓库里进行统一管理。你可以通过配套的 @dzhng/claude-agent 客户端库，轻松地与远端的沙箱服务建立安全连接，并收发消息。

主要特性

• WebSocket 实时交互：项目将 SDK 原生的查询响应流，转换成了 WebSocket 消息进行转发。这种方式非常适合需要即时反馈的交互式应用场景。
• E2B 沙箱模板：它贴心地提供了 bun run build:e2b 打包流程。利用这个脚本，你可以轻松地把整个应用打包，并在一个隔离的沙箱环境中运行和测试你的 Claude 智能体，这大大提升了安全性。
• 客户端库与示例：项目包含了一个独立的 @dzhng/claude-agent 客户端库以及使用示例。这能帮助你快速接入并进行功能测试，省去了从头编写通信逻辑的麻烦。
• 支持本地部署：项目提供了 .env 配置文件、Docker 镜像以及本地启动脚本和测试工具。这意味着你可以很方便地在自己的私有环境中进行部署和使用。

使用场景

这个项目非常适合那些需要将 Claude 的智能体能力，以实时 API 的形式接入到自己定制化应用中的场景。例如：

• 构建一个交互式的 AI 助手前端。
• 创建一个在线的 AI 能力测试台或演示平台。
• 用于教学演示，让学生实时看到智能体的思考过程。
• 在受控的沙箱环境中验证智能体的行为和安全性。

开发者可以先在本地通过访问 http://localhost:3000 来验证核心功能。如果需要进行更彻底的集成测试或回归测试，也可以利用 E2B 快速创建一个干净、隔离的测试环境。

技术特点

项目的核心是一个轻量级的 TypeScript 服务。它在内部采用了消息队列化处理与单连接并发控制策略，确保了与底层 Claude Agent SDK 的流式交互既是可控的，也是可中断的（支持 interrupt 操作）。整个代码结构模块化程度很高，这使得替换后端 SDK、扩展自定义工具链，或者将服务接入现有的 CI/CD 流程都变得相对简单。因此，它既适合在研发阶段进行原型验证，也适合在生产环境的预演阶段使用。

希望这个关于 Claude Agent 与 WebSocket 结合的开源项目能给你带来启发。如果你对构建类似的实时 AI 应用感兴趣，欢迎到 云栈社区 交流更多想法。