Claude Code 模板

更新时间:
复制 MD 格式

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_urldomain

  • 已安装依赖:pip install e2b==2.31.0 e2b-code-interpreter==2.8.1

  • 已准备模型 API Key,创建沙箱时通过 envs 注入 — 镜像内不预置

镜像地址

按地域选取 FROM_IMAGE

Region

镜像

cn-beijing

fc-e2b-registry.cn-beijing.cr.aliyuncs.com/runtime/claude-code:v0.0.44

cn-shenzhen

fc-e2b-registry.cn-shenzhen.cr.aliyuncs.com/runtime/claude-code:v0.0.44

ap-southeast-1

fc-e2b-registry.ap-southeast-1.cr.aliyuncs.com/runtime/claude-code:v0.0.44

cn-hongkong

fc-e2b-registry.cn-hongkong.cr.aliyuncs.com/runtime/claude-code:v0.0.44

cn-shanghai

fc-e2b-registry.cn-shanghai.cr.aliyuncs.com/runtime/claude-code:v0.0.44

cn-hangzhou

fc-e2b-registry.cn-hangzhou.cr.aliyuncs.com/runtime/claude-code:v0.0.44

推荐构建规格:cpu_count=2memory_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 路径

/home/user/.local/bin/claude

默认用户 / 工作目录

user / /home/user

MCP Gateway

不支持

MCP 与 Skill 能力约定

能力

支持情况

claude mcp add(stdio / HTTP)

支持

SDK mcp 创建参数

不支持

getMcpUrl() / getMcpToken()

不支持

作用域

路径

个人(本沙箱内全局)

/home/user/.claude/skills/<name>/SKILL.md

项目

<项目>/.claude/skills/<name>/SKILL.md

连接 MCP、扩展 Skill 的完整示例见使用 Claude Code Sandbox

相关文档