code-interpreter-v1 模板

创建沙箱与执行代码

使用 e2b_code_interpreter SDK 创建沙箱并通过 run_code 执行代码：

import os
from e2b_code_interpreter import Sandbox

sbx = Sandbox.create(
    api_key=os.environ["E2B_API_KEY"],
    api_url=os.environ["E2B_API_URL"],
    domain=os.environ["E2B_DOMAIN"],
)
try:
    execution = sbx.run_code("print('hello from code interpreter')")
    print("".join(execution.logs.stdout))
finally:
    sbx.kill()

TypeScript 示例：

import { Sandbox } from "@e2b/code-interpreter";

const sbx = await Sandbox.create("code-interpreter-v1", {
  apiKey: process.env.E2B_API_KEY,
  apiUrl: process.env.E2B_API_URL,
  domain: process.env.E2B_DOMAIN,
});

try {
  const execution = await sbx.runCode("print('hello from code interpreter')");
  console.log(execution.logs.stdout.join(""));
} finally {
  await sbx.kill();
}

logs.stdout 与 logs.stderr 均为字符串列表，需 "".join(...)（Python）或 .join("")（TypeScript）拼接为完整文本。

run_code / runCode 的主要参数：

执行结果 Execution 包含 logs（stdout/stderr 列表）、results（富文本结果，含 text、png 等）、error（执行异常）、execution_count。

上下文保持

同一沙箱的默认上下文中，变量、导入、函数跨调用保留：

sbx = Sandbox.create(**kwargs)
try:
    sbx.run_code("x = 42")
    execution = sbx.run_code("print(x)")
    print("".join(execution.logs.stdout))  # 42
finally:
    sbx.kill()

代码上下文管理

每个代码上下文（Context）拥有独立的变量状态。通过 context 参数将代码路由到指定上下文执行；未指定 context 时使用默认上下文。

context 参数可传 Context 对象或上下文 ID 字符串。create_code_context 的 cwd 默认为 /home/user，language 默认为 python。

from e2b_code_interpreter import Sandbox

sbx = Sandbox.create(**kwargs)
try:
    # 创建独立上下文
    ctx = sbx.create_code_context(language="python", cwd="/home/user")
    sbx.run_code("y = 100", context=ctx)
    execution = sbx.run_code("print(y)", context=ctx)
    print("".join(execution.logs.stdout))  # 100

    # 默认上下文中无法访问 ctx 的变量，execution.error 包含 NameError
    default_execution = sbx.run_code("print(y)")

    # 重启上下文后变量被清空，execution.error 包含 NameError
    sbx.restart_code_context(ctx)
    restarted_execution = sbx.run_code("print(y)", context=ctx)

    # 列出与删除
    print(sbx.list_code_contexts())
    sbx.remove_code_context(ctx)
finally:
    sbx.kill()

TypeScript SDK 的上下文管理方法（createCodeContext / listCodeContexts / restartCodeContext / removeCodeContext）签名与上表一致，用法参考 E2B 官方 Code Contexts 文档。

多语言执行

通过 language 参数指定执行语言，默认为 python：

sbx = Sandbox.create(**kwargs)
try:
    execution = sbx.run_code("console.log('hello js')", language="javascript")
    print("".join(execution.logs.stdout))
finally:
    sbx.kill()

const sbx = await Sandbox.create("code-interpreter-v1", {
  apiKey: process.env.E2B_API_KEY,
  apiUrl: process.env.E2B_API_URL,
  domain: process.env.E2B_DOMAIN,
});
try {
  const execution = await sbx.runCode("console.log('hello js')", { language: "javascript" });
  console.log(execution.logs.stdout.join(""));
} finally {
  await sbx.kill();
}

使用通用 e2b SDK

使用 e2b SDK 需显式指定模板 code-interpreter-v1，此时可使用沙箱的基础能力（文件、命令、进程），但不包含 run_code：

import os
from e2b import Sandbox

sbx = Sandbox.create(
    template="code-interpreter-v1",
    api_key=os.environ["E2B_API_KEY"],
    api_url=os.environ["E2B_API_URL"],
    domain=os.environ["E2B_DOMAIN"],
)
try:
    result = sbx.commands.run("python --version")
    print(result.stdout)
finally:
    sbx.kill()