샌드박스

curl -fsSL https://glac.ai/install.sh | sh
export GLAC_API_KEY=ak_...

API=https://api.glac.ai/v1/sandboxes
AUTH="Authorization: Bearer $GLAC_API_KEY"

from glac import Glac
glac = Glac()

import { Glac } from "glac";
const glac = new Glac();

# give your agent the tools (Claude Code here)
claude mcp add glac -e GLAC_API_KEY=ak_... -- npx glac-mcp

1. 01

   만들기

   어떤 이미지로든 만드는 전용 머신.

   glac sandboxes create --name web \
     --image python:3.12

   curl $API -H "$AUTH" \
     --json '{"name": "web", "image": "python:3.12"}'

   sbx = glac.sandboxes.create(name="web", image="python:3.12")

   const sbx = await glac.sandboxes.create(
     { name: "web", image: "python:3.12" });

   # no call of its own: the first sandbox_run
   # that names "web" makes it, from the image

2. 02

   그 안에서 실행하기

   명령과 파일 작업을, 걸리는 만큼 얼마든지.

   glac sandboxes exec web -- \
     pip install pandas

   curl $API/web/run -H "$AUTH" \
     --json '{"command": "pip install pandas"}'

   print(sbx.run("pip install pandas").stdout)

   console.log((await sbx.run("pip install pandas")).stdout);

   sandbox_run {"sandbox": "web", "image": "python:3.12",
                "command": "pip install pandas"}

3. 03

   통째로 저장하고 포크하기

   메모리, 프로세스, 디스크를 그 시점부터 이어 가는 사본으로.

   glac sandboxes snapshots create web \
     --name ready
   glac sandboxes fork web --count 16

   curl $API/web/snapshots -H "$AUTH" \
     --json '{"name": "ready"}'
   curl $API/web/fork -H "$AUTH" --json '{"count": 16}'

   snap = sbx.snapshot(name="ready")
   copies = sbx.fork(16)

   const snap = await sbx.snapshot({ name: "ready" });
   const copies = await sbx.fork(16);

   sandbox_snapshot {"sandbox": "web", "name": "ready"}
   sandbox_fork {"sandbox": "web", "count": 16}

ID를 쓰는 곳 어디서나 이름도 쓸 수 있습니다. 깨우는 호출은 따로 없습니다. 잠든 샌드박스가 필요한 작업이 오면 그 작업이 샌드박스를 깨웁니다.