Claude Code 是 Anthropic 的终端 AI 编程 Agent,可在沙箱内读代码、改文件、执行命令。我们已在各地域 ACR 预置 Claude Code 镜像,您无需自行推送镜像或配置 ACR EE,选取下方镜像地址,通过 from_image + Template.build 构建模板后即可使用。本页说明镜像规格与完整用法:前置条件、镜像地址、构建 Template、创建沙箱、运行 Claude Code、环境与能力约定;克隆仓库、连接 MCP、扩展 Skill、结构化输出等场景教程见使用 Claude Code Sandbox。
首次使用请先完成通过 SDK 使用云沙箱中的前置准备、API Key 创建和 SDK 配置。
前置条件
已完成 SDK 接入(E2B API Key、
api_url、domain)已安装依赖:
pip install e2b==2.31.0 e2b-code-interpreter==2.8.1已准备模型 API Key,创建沙箱时通过
envs注入 — 镜像内不预置中国站:百炼控制台 获取 API Key(
sk-开头)国际站:Anthropic Console 获取
ANTHROPIC_API_KEY
镜像地址
按地域选取 FROM_IMAGE:
Region | 镜像 |
cn-beijing |
|
cn-shenzhen |
|
ap-southeast-1 |
|
cn-hongkong |
|
cn-shanghai |
|
cn-hangzhou |
|
推荐构建规格:cpu_count=2,memory_mb=8192。
快速开始
以下以北京地域为例,分四步:构建 Template → 创建 Sandbox → 运行 Claude Code → 销毁沙箱。
构建 Template
import time
from e2b import Template, default_build_logger
FROM_IMAGE = "fc-e2b-registry.cn-beijing.cr.aliyuncs.com/runtime/claude-code:v0.0.44"
TEMPLATE_NAME = f"claude-code-{int(time.time())}"
OPTS = {
"api_key": "<你的 E2B API Key>",
"api_url": "https://api.cn-beijing.e2b.fc.aliyuncs.com",
"domain": "cn-beijing.e2b.fc.aliyuncs.com",
}
build = Template.build(
Template().from_image(FROM_IMAGE),
name=TEMPLATE_NAME,
cpu_count=2,
memory_mb=8192,
on_build_logs=default_build_logger(),
**OPTS,
)
print(f"template: {build.name}") # 保存,后续可复用构建完成后控制台模板状态应为 ready。同一模板名称可多次创建 Sandbox,无需每次重新构建。
创建 Sandbox
创建沙箱时通过 envs 注入模型 API Key。
中国站:百炼 DashScope
from e2b_code_interpreter import Sandbox
sandbox = Sandbox.create(
template=TEMPLATE_NAME,
envs={
"ANTHROPIC_AUTH_TOKEN": "<your-bailian-api-key>",
"ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.7-max",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.7-max",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
},
timeout=600,
**OPTS,
)
# 首次运行前须初始化 `~/.claude.json`,否则可能报配置损坏。
sandbox.commands.run("echo '{}' > /home/user/.claude.json")运行 Claude Code
非交互模式使用 -p;在沙箱内可加 --dangerously-skip-permissions 跳过权限确认。建议加 < /dev/null 避免 stdin 等待警告:
result = sandbox.commands.run(
'claude --dangerously-skip-permissions < /dev/null '
'-p "Create a hello world HTTP server in Go"',
timeout=0,
)
print(result.stdout)销毁沙箱
任务完成后释放资源:
sandbox.kill()环境概览
项目 | 规格 |
操作系统 | Ubuntu 25.04 |
Claude Code 路径 |
|
默认用户 / 工作目录 |
|
MCP Gateway | 不支持 |
MCP 与 Skill 能力约定
能力 | 支持情况 |
| 支持 |
SDK | 不支持 |
| 不支持 |
作用域 | 路径 |
个人(本沙箱内全局) |
|
项目 |
|
连接 MCP、扩展 Skill 的完整示例见使用 Claude Code Sandbox。
相关文档
使用 Claude Code Sandbox(克隆仓库、MCP、Skill、结构化输出等场景教程)