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。
國際站:Anthropic 直連
from e2b_code_interpreter import Sandbox
sandbox = Sandbox.create(
template=TEMPLATE_NAME,
envs={"ANTHROPIC_API_KEY": "<your-anthropic-api-key>"},
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、結構化輸出等情境教程)