云环境设置

为您的会话自定义云沙箱。

环境(environment)定义了您的智能体运行所在的沙箱配置。您只需创建一次环境,然后在每次启动会话时引用其 ID。多个会话可以共享同一个环境,但每个会话都会获得自己独立隔离的沙箱(一个全新的 Linux 容器)。

本页介绍 type: cloud 环境。要在您自己的基础设施上运行沙箱,请参阅自托管沙箱。要在两者之间做出选择,请参阅选择智能体环境。

创建环境

示例代码
curl -fsS https://api.anthropic.com/v1/environments \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "name": "python-dev",
    "config": {
      "type": "cloud",
      "networking": {"type": "limited", "allow_package_managers": true}
    }
  }'
示例代码
ant apply environment.yaml
示例代码
# yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json
name: python-dev
config:
  type: cloud
  networking:
    type: limited
    allow_package_managers: true

ant apply 会根据 environment.yaml 创建环境,打印其 ID,并将其记录在 claude-lock.json 中。请提交 claude-lock.json,这样下一次 ant apply 会更新此环境,而不是尝试再次创建它。

示例代码
environment = client.beta.environments.create(
    name="python-dev",
    config={
        "type": "cloud",
        "networking": {"type": "limited", "allow_package_managers": True},
    },
)

print(f"Environment ID: {environment.id}")
示例代码
const environment = await client.beta.environments.create({
  name: "python-dev",
  config: {
    type: "cloud",
    networking: { type: "limited", allow_package_managers: true }
  }
});

console.log(`Environment ID: ${environment.id}`);
示例代码
var environment = await client.Beta.Environments.Create(new()
{
    Name = "python-dev",
    Config = new BetaCloudConfigParams
    {
        Networking = new BetaLimitedNetworkParams
        {
            AllowPackageManagers = true,
        },
    },
});

Console.WriteLine($"Environment ID: {environment.ID}");
示例代码
environment, err := client.Beta.Environments.New(ctx, anthropic.BetaEnvironmentNewParams{
	Name: "python-dev",
	Config: anthropic.BetaEnvironmentNewParamsConfigUnion{
		OfCloud: &anthropic.BetaCloudConfigParams{
			Networking: anthropic.BetaCloudConfigParamsNetworkingUnion{
				OfLimited: &anthropic.BetaLimitedNetworkParams{
					AllowPackageManagers: anthropic.Bool(true),
				},
			},
		},
	},
})
if err != nil {
	panic(err)
}

fmt.Printf("Environment ID: %s\n", environment.ID)
示例代码
var environment = client.beta().environments().create(EnvironmentCreateParams.builder()
    .name("python-dev")
    .config(BetaCloudConfigParams.builder()
        .networking(BetaLimitedNetworkParams.builder()
            .allowPackageManagers(true)
            .build())
        .build())
    .build());
IO.println("Environment ID: " + environment.id());
示例代码
$environment = $client->beta->environments->create(
    name: 'python-dev',
    config: [
        'type' => 'cloud',
        'networking' => ['type' => 'limited', 'allow_package_managers' => true],
    ],
);
echo "Environment ID: {$environment->id}\n";
示例代码
environment = client.beta.environments.create(
  name: "python-dev",
  config: {
    type: "cloud",
    networking: {type: "limited", allow_package_managers: true}
  }
)

puts "Environment ID: #{environment.id}"

请使用唯一且具有描述性的 name (csharp, go: Name),以便区分不同的环境。此示例使用 limited 网络并允许包管理器,因此沙箱可以访问包注册表和代码托管站点。要让它访问其他主机,请将这些主机添加到 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 中。

在会话中使用环境

在创建会话时,以字符串形式传入环境 ID(请参阅启动会话)。

示例代码
curl -fsS https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "agent": "'"$AGENT_ID"'",
    "environment_id": "'"$ENVIRONMENT_ID"'"
  }'
示例代码
ant beta:sessions create --agent "$AGENT_ID" --environment-id "$ENVIRONMENT_ID"
示例代码
session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
)
示例代码
const session = await client.beta.sessions.create({
  agent: agent.id,
  environment_id: environment.id
});
示例代码
var session = await client.Beta.Sessions.Create(new()
{
    Agent = agent.ID,
    EnvironmentID = environment.ID,
});
示例代码
session, err := client.Beta.Sessions.New(ctx, anthropic.BetaSessionNewParams{
	Agent: anthropic.BetaSessionNewParamsAgentUnion{
		OfString: anthropic.String(agent.ID),
	},
	EnvironmentID: environment.ID,
})
if err != nil {
	panic(err)
}
示例代码
var session = client.beta().sessions().create(SessionCreateParams.builder()
    .agent(agent.id())
    .environmentId(environment.id())
    .build());
示例代码
$session = $client->beta->sessions->create(
    agent: $agent->id,
    environmentID: $environment->id,
);
示例代码
session = client.beta.sessions.create(
  agent: agent.id,
  environment_id: environment.id
)

配置选项

软件包

packages (csharp, go: Packages) 字段会在智能体使用沙箱之前将软件包安装到沙箱中。包管理器按字母顺序运行(apt、cargo、gem、go、npm、pip)。您可以固定特定版本。如果环境使用 limited 网络,还需将 networking (csharp, go: Networking) 中的 allow_package_managers (java, php: allowPackageManagers; csharp, go: AllowPackageManagers) 设置为 true;否则,API 会拒绝该请求并返回 400 错误。

示例代码
curl -fsS https://api.anthropic.com/v1/environments \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "name": "data-analysis",
    "config": {
      "type": "cloud",
      "packages": {
        "pip": ["pandas", "numpy", "scikit-learn"],
        "npm": ["express"]
      },
      "networking": {"type": "limited", "allow_package_managers": true}
    }
  }'
示例代码
ant apply environment.yaml
示例代码
# yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json
name: data-analysis
config:
  type: cloud
  packages:
    pip:
      - pandas
      - numpy
      - scikit-learn
    npm:
      - express
  networking:
    type: limited
    allow_package_managers: true
示例代码
environment = client.beta.environments.create(
    name="data-analysis",
    config={
        "type": "cloud",
        "packages": {
            "pip": ["pandas", "numpy", "scikit-learn"],
            "npm": ["express"],
        },
        "networking": {"type": "limited", "allow_package_managers": True},
    },
)
示例代码
const environment = await client.beta.environments.create({
  name: "data-analysis",
  config: {
    type: "cloud",
    packages: {
      pip: ["pandas", "numpy", "scikit-learn"],
      npm: ["express"]
    },
    networking: { type: "limited", allow_package_managers: true }
  }
});
示例代码
using Anthropic.Models.Beta.Environments;

var environment = await client.Beta.Environments.Create(new()
{
    Name = "data-analysis",
    Config = new BetaCloudConfigParams
    {
        Packages = new()
        {
            Pip = ["pandas", "numpy", "scikit-learn"],
            Npm = ["express"],
        },
        Networking = new BetaLimitedNetworkParams
        {
            AllowPackageManagers = true,
        },
    },
});
示例代码
environment, err := client.Beta.Environments.New(ctx, anthropic.BetaEnvironmentNewParams{
	Name: "data-analysis",
	Config: anthropic.BetaEnvironmentNewParamsConfigUnion{
		OfCloud: &anthropic.BetaCloudConfigParams{
			Packages: anthropic.BetaPackagesParams{
				Pip: []string{"pandas", "numpy", "scikit-learn"},
				Npm: []string{"express"},
			},
			Networking: anthropic.BetaCloudConfigParamsNetworkingUnion{
				OfLimited: &anthropic.BetaLimitedNetworkParams{
					AllowPackageManagers: anthropic.Bool(true),
				},
			},
		},
	},
})
if err != nil {
	panic(err)
}
示例代码
import com.anthropic.models.beta.environments.*;
import java.util.List;

var environment = client.beta().environments().create(EnvironmentCreateParams.builder()
    .name("data-analysis")
    .config(BetaCloudConfigParams.builder()
        .packages(BetaPackagesParams.builder()
            .pip(List.of("pandas", "numpy", "scikit-learn"))
            .npm(List.of("express"))
            .build())
        .networking(BetaLimitedNetworkParams.builder()
            .allowPackageManagers(true)
            .build())
        .build())
    .build());
示例代码
$environment = $client->beta->environments->create(
    name: 'data-analysis',
    config: [
        'type' => 'cloud',
        'packages' => [
            'pip' => ['pandas', 'numpy', 'scikit-learn'],
            'npm' => ['express'],
        ],
        'networking' => ['type' => 'limited', 'allow_package_managers' => true],
    ],
);
示例代码
environment = client.beta.environments.create(
  name: "data-analysis",
  config: {
    type: "cloud",
    packages: {
      pip: %w[pandas numpy scikit-learn],
      npm: %w[express]
    },
    networking: {type: "limited", allow_package_managers: true}
  }
)

支持的包管理器:

字段包管理器示例
apt系统软件包(apt-get)"graphviz"
cargoRust(cargo)"hyperfine@1.18.0"
gemRuby(gem)"rails:7.1.0"
goGo 模块"golang.org/x/tools/cmd/goimports@latest"
npmNode.js(npm)"express@4.18.0"
pipPython(pip)"sqlalchemy==2.0.30"

网络

networking (csharp, go: Networking) 字段控制沙箱的出站网络访问。

使用 limited 网络时,allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 也适用于在 Anthropic 服务器上运行的 web_search 和 web_fetch 工具。如果 web_fetch 调用的 URL 所在主机与 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 不匹配,则会向智能体返回错误结果。web_search 会省略来自与 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 不匹配的主机的结果。allow_package_managers (java, php: allowPackageManagers; csharp, go: AllowPackageManagers) 和 allow_mcp_servers (java: allowMcpServers; php: allowMCPServers; csharp: AllowMcpServers; go: AllowMCPServers) 不会为这些工具添加任何主机。当 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 未列出任何主机时,任何 web_fetch 或 web_search 调用都不会返回页面或搜索结果。您为这些工具添加到 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 的主机也会对沙箱开放。unrestricted 网络和自托管环境不会限制这些工具。要进一步限制它们,请在智能体工具集中该工具的条目上设置 allowed_domains (java, php: allowedDomains; csharp, go: AllowedDomains) 或 blocked_domains (java, php: blockedDomains; csharp, go: BlockedDomains)。请参阅限制网页搜索和网页抓取的域名。

模式描述
limited将沙箱网络访问限制为 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 中的主机。将 allow_package_managers (java, php: allowPackageManagers; csharp, go: AllowPackageManagers) 和 allow_mcp_servers (java: allowMcpServers; php: allowMCPServers; csharp: AllowMcpServers; go: AllowMCPServers) 设置为 true 可允许额外的访问。除非智能体必须访问您无法预先列出的站点,否则请使用此模式。
unrestricted完全的出站网络访问,但通用安全阻止列表中的主机除外。使用前,请阅读不受限网络的风险。

以下示例创建一个使用 limited 网络模式的环境:

示例代码
curl -fsS https://api.anthropic.com/v1/environments \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d '{
    "name": "api-access",
    "config": {
      "type": "cloud",
      "networking": {
        "type": "limited",
        "allowed_hosts": ["api.example.com"],
        "allow_mcp_servers": true,
        "allow_package_managers": true
      }
    }
  }'
示例代码
ant apply environment.yaml
示例代码
# yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json
name: api-access
config:
  type: cloud
  networking:
    type: limited
    allowed_hosts:
      - api.example.com
    allow_mcp_servers: true
    allow_package_managers: true
示例代码
environment = client.beta.environments.create(
    name="api-access",
    config={
        "type": "cloud",
        "networking": {
            "type": "limited",
            "allowed_hosts": ["api.example.com"],
            "allow_mcp_servers": True,
            "allow_package_managers": True,
        },
    },
)
示例代码
const environment = await client.beta.environments.create({
  name: "api-access",
  config: {
    type: "cloud",
    networking: {
      type: "limited",
      allowed_hosts: ["api.example.com"],
      allow_mcp_servers: true,
      allow_package_managers: true
    }
  }
});
示例代码
using Anthropic.Models.Beta.Environments;

var environment = await client.Beta.Environments.Create(new()
{
    Name = "api-access",
    Config = new BetaCloudConfigParams
    {
        Networking = new BetaLimitedNetworkParams
        {
            AllowedHosts = ["api.example.com"],
            AllowMcpServers = true,
            AllowPackageManagers = true,
        },
    },
});
示例代码
environment, err := client.Beta.Environments.New(ctx, anthropic.BetaEnvironmentNewParams{
	Name: "api-access",
	Config: anthropic.BetaEnvironmentNewParamsConfigUnion{
		OfCloud: &anthropic.BetaCloudConfigParams{
			Networking: anthropic.BetaCloudConfigParamsNetworkingUnion{
				OfLimited: &anthropic.BetaLimitedNetworkParams{
					AllowedHosts:         []string{"api.example.com"},
					AllowMCPServers:      anthropic.Bool(true),
					AllowPackageManagers: anthropic.Bool(true),
				},
			},
		},
	},
})
if err != nil {
	panic(err)
}
示例代码
import com.anthropic.models.beta.environments.*;
import java.util.List;

var environment = client.beta().environments().create(EnvironmentCreateParams.builder()
    .name("api-access")
    .config(BetaCloudConfigParams.builder()
        .networking(BetaLimitedNetworkParams.builder()
            .allowedHosts(List.of("api.example.com"))
            .allowMcpServers(true)
            .allowPackageManagers(true)
            .build())
        .build())
    .build());
示例代码
$environment = $client->beta->environments->create(
    name: 'api-access',
    config: [
        'type' => 'cloud',
        'networking' => [
            'type' => 'limited',
            'allowed_hosts' => ['api.example.com'],
            'allow_mcp_servers' => true,
            'allow_package_managers' => true,
        ],
    ],
);
示例代码
environment = client.beta.environments.create(
  name: "api-access",
  config: {
    type: "cloud",
    networking: {
      type: "limited",
      allowed_hosts: %w[api.example.com],
      allow_mcp_servers: true,
      allow_package_managers: true
    }
  }
)

使用 limited 网络且未设置其他字段时,不允许任何主机。您附加到会话的文件、记忆存储和 GitHub 仓库仍然可用。当沙箱在端口 80 或 443 上发出的请求因其主机不被允许而遭拒时,响应为 403,并会指明被阻止的主机。

使用 limited 网络时:

  • allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 指定沙箱可以访问的主机。请指定裸主机名或通配符模式(例如 *.example.com)。不要包含 URL 协议、端口或路径。裸主机名仅匹配该确切主机:example.com 不匹配 www.example.com。*.example.com 匹配 example.com 的所有子域名,但不匹配 example.com 本身。
  • allow_mcp_servers (java: allowMcpServers; php: allowMCPServers; csharp: AllowMcpServers; go: AllowMCPServers) 允许对智能体上配置的 MCP 服务器端点进行出站访问,这些端点不限于 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 数组中列出的主机。默认为 false。当其为 false 时,如果智能体声明的 MCP 服务器的主机不在 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 中,会话创建将失败并返回 400 错误。这同样适用于它可以委派任务的智能体。要解决此问题,请将该主机添加到 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts),或将 allow_mcp_servers (java: allowMcpServers; php: allowMCPServers; csharp: AllowMcpServers; go: AllowMCPServers) 设置为 true。
  • allow_package_managers (java, php: allowPackageManagers; csharp, go: AllowPackageManagers) 允许对一组公共包注册表和代码托管站点进行出站访问,这些主机不限于 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 数组中列出的主机。有关列表,请参阅包管理器主机。默认为 false。只要环境指定了 packages (csharp, go: Packages),就请将其设置为 true。否则,API 会拒绝该请求并返回 400 错误,即使 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 已列出注册表主机也是如此。

包管理器主机

当 allow_package_managers (java, php: allowPackageManagers; csharp, go: AllowPackageManagers) 为 true 时,除了 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 中的主机外,沙箱还可以访问以下主机。此列表由 Anthropic 维护,并可能发生变化。

生态系统主机
代码托管github.com、api.github.com、codeload.github.com、raw.githubusercontent.com、objects.githubusercontent.com、release-assets.githubusercontent.com、gitlab.com、bitbucket.org
Node.jsregistry.npmjs.org、registry.yarnpkg.com、nodejs.org
Pythonpypi.org、files.pythonhosted.org
Rustcrates.io、index.crates.io、static.crates.io、static.rust-lang.org
Goproxy.golang.org、sum.golang.org
Javarepo1.maven.org、repo.maven.apache.org、services.gradle.org、plugins.gradle.org、plugins-artifacts.gradle.org
Rubyrubygems.org、index.rubygems.org
PHPpackagist.org、repo.packagist.org
Ubuntu(apt)archive.ubuntu.com、security.ubuntu.com、ppa.launchpad.net
容器registry-1.docker.io、auth.docker.io、production.cloudflare.docker.com、download.docker.com、ghcr.io

不受限网络的风险

使用 unrestricted 网络时,沙箱中的代码可以向互联网上的任何主机发送请求,但通用安全阻止列表中的主机除外。在选择此模式之前,请考虑智能体可以利用这种访问权限做什么:

  • 智能体可以更改外部站点上的内容,而不仅仅是读取: bash 工具可以发送任何请求。智能体可以发布数据、提交表单、调用 API,以及运行会更改外部站点数据的脚本。在某些站点上,即使只是获取 URL 的请求也可能更改数据。
  • 默认情况下,没有任何机制会暂停这些请求: 智能体工具集的默认权限策略是 always_allow,因此 bash 命令无需批准即可运行。
  • 沙箱中的任何内容都可能被传出: 这包括文件、工具输出,以及您放入沙箱的任何凭据或密钥。
  • 获取的内容可能操纵智能体: 智能体读取的网页、API 响应和其他内容可能包含改变其下一步行为的指令(提示注入)。
  • 智能体代表您行事: 它的操作可能违反站点的服务条款,或在站点上创建账户和记录。
  • 模型行为不是安全控制手段: 智能体可能以您未要求的方式在外部站点上执行操作,包括在站点阻止请求后换一种方式重试。请使用网络设置和权限策略来限制它能做的事情。
  • 安全阻止列表不是允许列表: 它不会限制智能体访问哪些其他站点,也不会限制智能体在这些站点上做什么。

为降低这些风险,请使用带有显式主机列表的 limited 网络。以下 networking 值允许 api.example.com,并为安装软件包的智能体允许包管理器主机:

示例代码
{
  "type": "limited",
  "allowed_hosts": ["api.example.com"],
  "allow_package_managers": true
}

如果您能列出智能体所需的站点,那么仅使用 web_search 和 web_fetch 工具的智能体不需要 unrestricted 网络。使用 limited 网络时,allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 也适用于这些工具(请参阅网络),因此请在 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 中列出这些站点。同时在 web_search 的 allowed_domains (java, php: allowedDomains; csharp, go: AllowedDomains) 中列出它们,可使其在这些站点中搜索。您添加到 allowed_hosts (java, php: allowedHosts; csharp, go: AllowedHosts) 的主机也会对沙箱开放。要进一步限制这些工具,请参阅限制网页搜索和网页抓取的域名。

仅当智能体必须访问您无法预先列出的站点时,才使用 unrestricted。在这种情况下,请勿将密钥和敏感文件放入沙箱,并仅向智能体提供任务所需的凭据。请考虑将 bash 工具的权限策略设置为 always_ask 或 auto,并监视会话的事件。

环境生命周期

  • 环境会一直保留,直到您将其归档或删除。
  • 每个会话都会获得自己的沙箱实例,即使多个会话引用同一个环境也是如此。会话之间不共享文件系统状态。
  • 环境不进行版本管理。如果您频繁更新环境,请自行记录变更,以便了解每个会话使用的是哪种配置。

管理环境

示例代码
# 列出环境
curl -fsS https://api.anthropic.com/v1/environments \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "anthropic-beta: managed-agents-2026-04-01"

# 获取特定环境
curl -fsS "https://api.anthropic.com/v1/environments/$ENVIRONMENT_ID" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "anthropic-beta: managed-agents-2026-04-01"

# 归档环境(只读,不可创建新会话)
curl -fsS -X POST "https://api.anthropic.com/v1/environments/$ENVIRONMENT_ID/archive" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "anthropic-beta: managed-agents-2026-04-01"

# 删除环境
curl -fsS -X DELETE "https://api.anthropic.com/v1/environments/$ENVIRONMENT_ID" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -H "anthropic-beta: managed-agents-2026-04-01"
示例代码
# 列出环境
ant beta:environments list

# 获取指定环境
ant beta:environments retrieve --environment-id "$ENVIRONMENT_ID"

# 归档环境(只读,不可创建新会话)
ant beta:environments archive --environment-id "$ENVIRONMENT_ID"

# 删除环境
ant beta:environments delete --environment-id "$ENVIRONMENT_ID"
示例代码
# 列出环境
environments = client.beta.environments.list()

# 获取指定环境
env = client.beta.environments.retrieve(environment.id)

# 归档环境(只读,不可创建新会话)
client.beta.environments.archive(environment.id)

# 删除环境
client.beta.environments.delete(environment.id)
示例代码
// 列出环境
const environments = await client.beta.environments.list();

// 检索特定环境
const env = await client.beta.environments.retrieve(environment.id);

// 归档环境(只读,不可创建新会话)
await client.beta.environments.archive(environment.id);

// 删除环境
await client.beta.environments.delete(environment.id);
示例代码
// 列出环境
var environments = await client.Beta.Environments.List();

// 检索特定环境
var env = await client.Beta.Environments.Retrieve(environment.ID);

// 归档环境(只读,不可创建新会话)
await client.Beta.Environments.Archive(environment.ID);

// 删除环境
await client.Beta.Environments.Delete(environment.ID);
示例代码
// 列出环境
environments, err := client.Beta.Environments.List(ctx, anthropic.BetaEnvironmentListParams{})
// ...

// 检索特定环境
env, err := client.Beta.Environments.Get(ctx, environment.ID, anthropic.BetaEnvironmentGetParams{})
// ...

// 归档环境(只读,不可创建新会话)
_, err = client.Beta.Environments.Archive(ctx, environment.ID, anthropic.BetaEnvironmentArchiveParams{})
// ...

// 删除环境
_, err = client.Beta.Environments.Delete(ctx, environment.ID, anthropic.BetaEnvironmentDeleteParams{})
示例代码
// 列出环境
var environments = client.beta().environments().list();
// 获取指定环境
var env = client.beta().environments().retrieve(environment.id());
// 归档环境(只读,不可创建新会话)
client.beta().environments().archive(environment.id());
// 删除环境
client.beta().environments().delete(environment.id());
示例代码
// 列出环境
$environments = $client->beta->environments->list();
// 获取特定环境
$env = $client->beta->environments->retrieve($environment->id);
// 归档环境(只读,不可创建新会话)
$client->beta->environments->archive($environment->id);
// 删除环境
$client->beta->environments->delete($environment->id);
示例代码
# 列出环境
environments = client.beta.environments.list

# 检索特定环境
env = client.beta.environments.retrieve(environment.id)

# 归档环境(只读,不可创建新会话)
client.beta.environments.archive(environment.id)

# 删除环境
client.beta.environments.delete(environment.id)

预安装的运行时

云沙箱包含常用的语言运行时、数据库和命令行工具。完整列表请参阅云沙箱参考。

后续步骤

云沙箱参考

云沙箱中可用的预安装软件包、数据库和实用工具。

启动会话

创建会话以运行您的智能体并开始执行任务。

可用性

云沙箱在所有模型上处于 beta 阶段。

API 支持

Managed Agents

  • 可用性:可用

所需的 beta 请求头

Beta 请求头概览

Beta 请求头让您可以在实验性功能和新模型能力成为标准 API 的一部分之前访问它们。

  • managed-agents-2026-04-01

数据处理

数据处理概览

项目零数据保留HIPAA
状态不具备资格不具备资格
详细信息不具备 ZDR 资格,自托管 Managed Agents 除外。会话是有状态的资源;对话记录会一直保留,直到您将其删除。 了解更多不具备 HIPAA 资格。适用于所有 Managed Agents 子功能。

适用的端点:

  • /v1/agents
  • /v1/sessions
  • /v1/environments
文档内容持续同步更新