详细介绍
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 能力以实时接口接入自定义应用的场景,例如交互式助手、在线测试台、教学演示与受控沙箱验证。开发者可以在本地通过 <http://localhost:3000> 进行功能验证,或使用 E2B 快速创建隔离的测试环境进行集成与回归测试。
技术特点
项目以轻量 TypeScript 服务为核心,采用消息队列化处理与单连接并发控制策略,保证与 SDK 的流式交互可控且可中断(支持 interrupt)。代码模块化便于替换后端 SDK、扩展自定义工具链或接入现有 CI/CD,适合在研发与生产预演环境中使用。