CodeSandbox 是一个面向个人开发者、团队与教育场景的云开发平台,通过在云端创建隔离的沙箱(sandbox)与微虚拟机(microVM),让你可以随时随地打开浏览器就开始编码、运行和调试项目,无需本地复杂环境配置,同时还能安全地运行不受信任代码、并行运行多个环境、快速快照与恢复。平台提供 API 接口,方便将沙箱能力集成到自己的产品、教学平台或自动化流程中。

产品详细介绍

1. 核心定位

CodeSandbox 是“即时云开发环境”(Instant Cloud Development Environments)平台,核心目标是:

  • 让开发环境像网页一样即开即用
  • 通过隔离沙箱安全运行任意代码
  • 支持大规模并发的云端开发与测试
  • 为 AI 代理、教学平台、团队协作等场景提供可控、可编排的运行环境

2. 关键特性与能力

1)隔离沙箱环境(Sandbox)

  • 每个沙箱都是独立的开发环境,可运行任意类型代码
  • 环境之间完全隔离,互不影响
  • 适合运行不受信任代码、学生作业、在线示例、实验性功能等

2)基于 microVM 的高性能基础设施

  • 使用微虚拟机(microVM)技术,支持在约 2 秒内启动完整 VM
  • 支持快速克隆与快照恢复,便于复制环境、回滚状态
  • 能够处理数百万级并发 VM,适合大规模平台与企业场景

3)快照与会话恢复

  • 支持对沙箱进行快照(snapshot),保存当前代码与运行状态
  • 长时间不活动后可自动休眠(hibernate),再次访问时快速恢复
  • 开发进度不会因中断或切换设备而丢失

4)自动休眠与资源控制

  • 可配置空闲时间后自动休眠,节省资源成本
  • 对不同项目、用户或代理设置不同的资源与休眠策略
  • 适合企业或平台方统一管理计算资源

5)面向 AI 代理与自动化的环境

  • 为 AI 代理提供独立沙箱,用于解析用户指令、运行代码、生成结果
  • 可并行运行多个代理,互不干扰
  • 通过“fork(分叉)”机制复制沙箱,支持对不同代理策略进行 A/B 测试

6)多用户与教学场景支持

  • 为每位开发者或学生创建独立沙箱
  • 可同时运行大量开发环境,适合课堂教学、在线课程、编程训练营
  • 教师或平台可统一管理、监控与回收环境

7)安全执行与代码评估

  • 在沙箱中运行不受信任代码,避免影响本地系统
  • 可在沙箱中执行代码解释、评估(evals)与安全测试
  • 适合在线代码运行器、题库评测、插件/脚本验证等场景

8)测试与持续集成场景

  • 在沙箱中运行自动化测试、集成测试
  • 测试完成后自动休眠,保留环境以便快速再次启动
  • 适合构建轻量 CI 环境或与现有 CI/CD 流程集成

3. 典型应用场景

  • 在线开发与原型验证:快速搭建前后端示例、Demo、PoC
  • 教学与培训:为每个学生提供独立环境,统一课程模板
  • SaaS/平台集成:在自家产品中嵌入“在线运行代码”或“在线实验环境”
  • AI 代理运行环境:为智能体提供安全、可控的代码执行沙箱
  • 安全测试与代码审查:在隔离环境中运行第三方脚本、插件或用户提交代码

简单使用教程

1. 快速上手:创建与管理沙箱

1)注册与登录

  • 访问 CodeSandbox 官网,使用邮箱或第三方账号注册
  • 登录后进入控制台或项目列表页面

2)创建新沙箱

  • 在控制台点击“Create”或“New Sandbox”
  • 选择技术栈或模板(如 React、Node.js、Vue、纯 JavaScript 等)
  • 系统会在云端自动创建并启动一个新的沙箱环境

3)编写与运行代码

  • 在浏览器中直接编辑代码文件
  • 右侧或下方可查看实时预览或终端输出
  • 保存操作会自动同步到云端,无需手动部署

4)快照与恢复

  • 在沙箱页面中选择“Snapshot”或类似功能创建快照
  • 需要回滚时,从快照列表中选择对应版本进行恢复
  • 可将快照链接分享给团队成员或学生

5)休眠与唤醒

  • 当沙箱长时间无操作时,会自动休眠
  • 再次访问该沙箱链接或在控制台点击进入,即可快速唤醒并恢复状态

2. 使用 API 创建与控制沙箱(概念级流程)

1)获取 API 访问凭证

  • 在个人或组织设置中创建 API Token
  • 妥善保存 Token,用于服务端调用

2)通过 API 创建沙箱

  • 在后端服务中调用 CodeSandbox 提供的创建接口
  • 指定:
    • 基础镜像或模板
    • 初始代码仓库或文件
    • 资源限制(CPU/内存等,如有)

3)运行代码或测试

  • 通过 API 将要执行的代码或命令发送到指定沙箱
  • 在沙箱中运行脚本、测试用例或评估任务
  • 获取执行结果、日志或测试报告

4)管理生命周期

  • 根据业务逻辑在任务完成后休眠或销毁沙箱
  • 使用快照功能在关键节点保存环境状态
  • 对不同用户或代理实例创建独立沙箱,避免相互干扰

3. 教学与团队协作示例流程

1)教师/团队负责人创建模板沙箱

  • 在 CodeSandbox 中搭建好项目基础结构
  • 配置依赖、脚本与示例代码

2)为每位学生/成员复制沙箱

  • 使用“fork”或通过 API 为每人创建独立副本
  • 每个副本互不影响,可独立修改与运行

3)收集与评估

  • 学生或成员完成任务后,提交沙箱链接
  • 教师或负责人在浏览器中直接查看代码与运行结果
  • 如需回滚或对比,可使用快照功能

FAQ 常见问题

Q1:CodeSandbox 是否需要本地安装? A:不需要。只需浏览器和网络连接即可使用,所有开发环境都在云端运行。

Q2:可以运行哪些类型的代码? A:平台支持多种技术栈和语言,底层通过 microVM 提供完整 VM 能力,基本可运行常见 Web、Node.js 及其他后端代码,具体支持范围以官方文档为准。

Q3:沙箱之间会互相影响吗? A:不会。每个沙箱在隔离环境中运行,互不干扰,适合并行运行多个项目或用户环境。

Q4:如何保证运行不受信任代码的安全性? A:不受信任代码在沙箱/microVM 中执行,与宿主系统隔离。即便代码存在问题,也不会直接影响你的本地设备或其他沙箱。

Q5:沙箱休眠后数据会丢失吗? A:不会。休眠只会暂停计算资源使用,代码与快照仍然保留。再次唤醒后可继续从中断处开发。

Q6:是否支持大规模并发使用? A:是。CodeSandbox 的基础设施可以处理数百万级并发 VM,适合大型教学平台、在线评测系统或企业级场景。

Q7:可以与现有系统或产品集成吗? A:可以。通过官方 API,你可以在自己的平台中创建、管理和销毁沙箱,将“在线运行代码”“实验环境”等能力嵌入到产品中。

Q8:如何为 AI 代理提供运行环境? A:为每个代理创建独立沙箱,在其中执行代理生成的代码或任务。可通过 fork 机制复制环境,对不同策略进行 A/B 测试,并行运行多个代理而互不干扰。