クラウド環境のセットアップ

環境は、エージェントが実行されるサンドボックスの構成を定義します。環境を一度作成すれば、セッションを開始するたびにそのIDを参照できます。複数のセッションが同じ環境を共有できますが、各セッションには独自の分離されたサンドボックス（新しいLinuxコンテナ）が割り当てられます。

このページでは type: cloud 環境について説明します。独自のインフラストラクチャでサンドボックスを実行する場合は、セルフホスト型サンドボックスを参照してください。



環境を作成する

ant beta:environments create < python-dev.environment.yaml

name: python-dev
config:
  type: cloud
  networking:
    type: unrestricted

環境を区別できるように、一意でわかりやすい name を使用してください。



セッションで環境を使用する

セッションを作成する際に、環境IDを文字列として渡します。



構成オプション



パッケージ

packages フィールドは、エージェントが起動する前にサンドボックスにパッケージを事前インストールします。パッケージはそれぞれのパッケージマネージャーによってインストールされ、同じ環境を共有するセッション間でキャッシュされます。複数のパッケージマネージャーが指定されている場合、アルファベット順（apt、cargo、gem、go、npm、pip）で実行されます。オプションで特定のバージョンを固定できます。バージョンが固定されていないパッケージは最新バージョンがインストールされます。

サポートされているパッケージマネージャー：



ネットワーク

networking フィールドは、サンドボックスのアウトバウンドネットワークアクセスを制御します。これは、Anthropicのサーバー上で実行される web_search ツールや web_fetch ツールには影響しません。これらのツールがアクセスできるサイトを制限するには、エージェントのツールセット内の該当ツールのエントリで allowed_domains または blocked_domains を設定してください。詳細はWeb検索とWebフェッチのドメインを制限するを参照してください。

次の例では、limited ネットワークを使用した環境を作成します。

limited ネットワークを使用する場合：

• allowed_hosts は、サンドボックスがアクセスできるドメインを指定します。ベアホスト名またはワイルドカードパターン（*.example.com など）を指定してください。URLスキーム、ポート、パスは含めないでください。
• allow_mcp_servers は、allowed_hosts 配列にリストされているもの以外に、エージェントに構成されたMCPサーバーエンドポイントへのアウトバウンドアクセスを許可します。デフォルトは false です。
• allow_package_managers は、allowed_hosts 配列にリストされているもの以外に、パブリックパッケージレジストリ（PyPIやnpmなど）へのアウトバウンドアクセスを許可します。デフォルトは false です。



環境のライフサイクル

• 環境は、明示的にアーカイブまたは削除されるまで保持されます。
• 複数のセッションが同じ環境を参照している場合でも、各セッションには独自のサンドボックスインスタンスが割り当てられます。セッション間でファイルシステムの状態は共有されません。
• 環境はバージョン管理されません。環境を頻繁に更新する場合は、各セッションがどの構成を使用したかを把握できるように、変更内容を独自に記録しておいてください。



環境を管理する



プリインストールされたランタイム

クラウドサンドボックスには、一般的なランタイムがあらかじめ含まれています。プリインストールされている言語、データベース、ユーティリティの完全なリストについては、クラウドサンドボックスリファレンスを参照してください。



次のステップ