简介
让 AI 写代码容易,让 AI 写的代码安全地跑起来很难。生成的代码可能要装依赖、要起服务、要访问网络,一旦放进你的生产机器,就是一把随时可能误伤的刀。
CodeSandbox SDK 把这层隔离做成了 API:调一次接口拿到一个独立 VM,里面有文件系统、可以执行命令、可以起服务并通过 URL 预览;用完销毁。对 AI 编程产品来说,这基本就是「执行层」的标准答案之一。
核心能力
- 沙箱生命周期管理:创建、暂停、恢复、销毁,可长驻也可短任务
- 执行与文件操作:读写文件、跑终端命令、装 npm/pip 依赖
- 实时预览:沙箱内的服务自动获得可访问的预览链接
- 模板与快照:把「已装好依赖的项目」存成模板,冷启动从几十秒压到几秒
- 与 Agent 集成:LLM 负责生成,SDK 负责在隔离环境验证生成结果
适合谁用
- 做 AI 编程 / 低代码生成产品的团队:需要「生成—运行—预览」闭环
- 做自动化数据分析 Agent:让模型写 Python,在沙箱里跑出图表
- 需要在 CI 之外跑不可信代码的场景:作业批改、代码评测、插件运行
使用建议
- 先做模板预热:把运行环境和依赖固化进模板,别每次现装
- 设空闲回收策略:沙箱是按时长计费的,忘记销毁是最常见的浪费
- 限制出网:AI 生成的代码不该默认能访问内网与任意外网地址
- 执行超时与资源上限必须配:死循环和内存炸弹是必然会遇到的