E2B

环境要求

• Node.js 环境（使用 npm 安装 JavaScript/TypeScript SDK）
• Python 环境（使用 pip 安装 Python SDK）
• E2B 账号及 API Key（在官网注册后于 Dashboard 获取）
• 能够访问 E2B 云端沙箱服务的网络环境

安装与启动步骤

1. 1注册并获取密钥

   前往 E2B 官网注册账号，随后在 Dashboard 的 keys 页面获取你的 API Key，形如 e2b_***，请妥善保管。

2. 2安装 Python SDK

   在项目所在环境执行 pip 安装 e2b 包，Python 开发者选择这一步即可。

   pip install e2b

   复制

3. 3安装 JS SDK

   使用 JavaScript / TypeScript 的开发者改用 npm 安装 e2b 包，与上一步二选一。

   npm i e2b

   复制

4. 4配置 API Key

   把获取到的 API Key 写入环境变量 E2B_API_KEY，SDK 会自动读取该变量完成鉴权。

   E2B_API_KEY=e2b_***

   复制

5. 5创建沙箱跑命令

   调用 Sandbox.create() 启动云端沙箱，并通过 commands.run 执行 shell 命令读取输出，用后自动释放。

   from e2b import Sandbox
   
   with Sandbox.create() as sandbox:
       result = sandbox.commands.run('echo "Hello from E2B!"')
       print(result.stdout)  # Hello from E2B!

   复制

关键配置

如何确认成功

运行示例代码后，控制台打印出 Hello from E2B!，说明沙箱创建并执行命令成功。

常见问题

注意事项

• API Key 属于敏感凭证，不要提交到代码仓库，建议通过环境变量注入。
• 示例中的命令输出 Hello from E2B! 仅用于验证链路，可替换为任意 shell 命令。
• SDK 需联网访问 E2B 云服务，离线环境无法直接使用。