샌드박스에서 Cursor 실행하기

​

사전 요구 사항

• cws-agent 경로에 대한 SANDBOX_USER 액션 권한이 있는 CoreWeave API 액세스 토큰. SDK는 시크릿 주입에 Forge API 키를 사용하는 방식도 지원합니다. 자세한 내용은 Cursor 키 제공 방법 선택을 참조하세요.
• Cursor 사용자 API 키 및 Cursor CLI에서 지원하는 모델에 대한 액세스 권한.
• 공개 저장소 URL. 비공개 저장소를 사용하려면 샌드박스 내부에 Git 사용자 인증 정보가 있어야 합니다.
• Cursor, Cursor 다운로드 호스트, Git 호스트에 대한 아웃바운드 연결.

export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

​

cws-agent로 Cursor CLI 실행

export CURSOR_API_KEY="[CURSOR-API-KEY]"

1. cws-agent 설치 안내를 따르세요.
2. [SANDBOX-NAME]을 소문자, 숫자, 하이픈으로 구성된 1~40자의 세션 이름으로 바꾸세요. 이름은 문자나 숫자로 시작해야 합니다. [REPOSITORY-URL]은 사용자의 저장소 URL로 바꾸세요.
   cws-agent launch [SANDBOX-NAME] --agent cursor --repo-url [REPOSITORY-URL] --lifetime 2h --permission-mode native --no-config-sync
   
   Cursor는 /workspace/project에서 열립니다. 워크스페이스 신뢰 프롬프트가 표시되면 수락하세요. --permission-mode native를 지정하면 Cursor의 승인 설정이 유지되며, 지정하지 않으면 cws-agent는 --force를 사용합니다. --no-config-sync를 지정하면 로컬 스킬과 Model Context Protocol(MCP) 설정을 임포트하지 않습니다.
3. 나중에 조회할 수 있는 파일을 생성하도록 Cursor에 요청하세요.
   Create sandbox-proof.txt in the current directory containing exactly
   Hello from CoreWeave followed by a newline, then read it back.
   Do not commit or push anything.
   
   작업 중 표시되는 프롬프트는 모두 승인하세요. /exit로 Cursor를 종료한 다음, 로컬 터미널에서 파일을 읽으세요.
   cws-agent exec [SANDBOX-NAME] 'cat /workspace/project/sandbox-proof.txt'
   
   Hello from CoreWeave가 출력되어야 합니다. Cursor를 종료해도 샌드박스는 계속 실행됩니다.
4. 샌드박스의 Cursor 세션을 모두 종료한 후, Cursor가 남긴 worker.sock 소켓 파일을 제거하고 워크스페이스를 저장한 다음 컴퓨팅을 중지하세요.
   cws-agent exec [SANDBOX-NAME] 'find /workspace/home/.cursor/projects -type s -name worker.sock -delete'
   cws-agent down [SANDBOX-NAME]
   
   정리 작업에서는 스냅샷 생성을 방해할 수 있는 소켓 파일을 제거합니다. down은 샌드박스를 중지하기 전에 스냅샷을 생성합니다. 스냅샷 생성에 실패하면 샌드박스는 계속 실행됩니다. 복원하기 전에 오류를 해결하고 down을 다시 시도하세요.
5. 저장된 워크스페이스로 돌아가려면 로컬에서 CURSOR_API_KEY를 export한 상태로 유지하고 다음 명령어를 실행하세요.
   cws-agent restore [SANDBOX-NAME] --connect --permission-mode native --no-config-sync
   
   Cursor에 sandbox-proof.txt 파일을 읽도록 요청하여 파일이 복원되었는지 확인하세요. 작업이 끝나면 Cursor를 종료하고 정리 작업과 down 명령어를 다시 실행하세요.

​

무인 모드로 프롬프트 실행

cws-agent launch [SANDBOX-NAME] --agent cursor --repo-url [REPOSITORY-URL] --lifetime 2h --permission-mode native --no-config-sync --detach
cws-agent run [SANDBOX-NAME] 'Create sandbox-proof.txt containing exactly Hello from CoreWeave followed by a newline, then read it back. Do not commit or push anything.'

cws-agent connect [SANDBOX-NAME] --permission-mode native --no-config-sync

​

Sandboxes SDK로 작업 실행하기

​

Cursor 키 제공 방식 선택

export FORGE_API_KEY="[FORGE-API-KEY]"
export FORGE_TEAM="[FORGE-TEAM]"
export CURSOR_SECRET_NAME="[CURSOR-SECRET-NAME]"

export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"
export CURSOR_API_KEY="[CURSOR-API-KEY]"

​

클라이언트 설치

uv init --python 3.11
uv add 'cwsandbox==1.14.2'

npm install @coreweave/cwsandbox@0.5.0-beta.0 tsx

​

생성, 실행 및 정리

import os
import sys

from cwsandbox import AuthHeaders, AuthStrategy, Sandbox, Secret

if len(sys.argv) != 3 or sys.argv[1] not in ("forge", "coreweave"):
    raise SystemExit("Pass forge or coreweave, then a repository URL.")

mode, repository = sys.argv[1:]
if mode == "forge":
    auth = AuthHeaders(
        headers={
            "x-wandb-api-key": os.environ["FORGE_API_KEY"],
            "x-entity-id": os.environ["FORGE_TEAM"],
        },
        strategy="wandb_api_key",
    )
    credentials = {"secrets": [Secret(
        store="wandb", name=os.environ["CURSOR_SECRET_NAME"],
        env_var="CURSOR_API_KEY",
    )]}
else:
    auth = AuthStrategy.COREWEAVE_API_KEY
    credentials = {
        "environment_variables": {"CURSOR_API_KEY": os.environ["CURSOR_API_KEY"]},
    }

sandbox = Sandbox.run(
    auth=auth,
    placement_mode="serverless",
    container_image="node:22-bookworm",
    resources={"cpu": "2", "memory": "4Gi"},
    max_lifetime_seconds=2 * 3600,
    **credentials,
)
try:
    sandbox.wait()
    commands = [
        ["bash", "-o", "pipefail", "-ec", "curl -fsSL https://cursor.com/install | bash"],
        ["mkdir", "-p", "/workspace"],
        ["git", "clone", "--", repository, "/workspace/project"],
    ]
    for command in commands:
        sandbox.exec(command, timeout_seconds=900, check=True).result()

    result = sandbox.exec(
        [
            "/root/.local/bin/agent",
            "--print", "--force", "--trust", "--output-format", "text",
            "Create sandbox-proof.txt containing exactly Hello from CoreWeave "
            "followed by a newline, then read it back. Do not commit or push anything.",
        ],
        cwd="/workspace/project",
        timeout_seconds=300,
        check=True,
    ).result()
    print(result.stdout)
    proof = sandbox.exec(
        ["cat", "/workspace/project/sandbox-proof.txt"], check=True
    ).result()
    print(proof.stdout, end="")
finally:
    sandbox.stop().result()

import { createSandboxClientFromEnv as coreweaveClient } from "@coreweave/cwsandbox/node";
import { createSandboxClient as forgeClient } from "@coreweave/cwsandbox/wandb";

const [mode, repository] = process.argv.slice(2);
if (!repository || (mode !== "forge" && mode !== "coreweave")) {
  throw new Error("Pass forge or coreweave, then a repository URL.");
}

const credential = mode === "forge"
  ? process.env.CURSOR_SECRET_NAME : process.env.CURSOR_API_KEY;
if (!credential) {
  throw new Error("Set CURSOR_SECRET_NAME for forge or CURSOR_API_KEY for coreweave.");
}
const client = mode === "forge"
  ? forgeClient({ apiKey: process.env.FORGE_API_KEY, entity: process.env.FORGE_TEAM })
  : coreweaveClient();
const credentials = mode === "forge"
  ? { secrets: [{ store: "wandb", name: credential, envVar: "CURSOR_API_KEY" }] }
  : { environmentVariables: { CURSOR_API_KEY: credential } };
const sandbox = await client.create({
  containerImage: "node:22-bookworm",
  resources: { cpu: "2", memory: "4Gi" },
  maxLifetimeSeconds: 2 * 3600,
  ...credentials,
  waitUntilRunning: false,
});
try {
  await sandbox.wait();
  const commands = [
    ["bash", "-o", "pipefail", "-ec", "curl -fsSL https://cursor.com/install | bash"],
    ["mkdir", "-p", "/workspace"],
    ["git", "clone", "--", repository, "/workspace/project"],
  ];
  for (const command of commands) {
    await sandbox.commands.run(command, { timeoutMs: 900_000, check: true });
  }

  const result = await sandbox.commands.run(
    [
      "/root/.local/bin/agent",
      "--print", "--force", "--trust", "--output-format", "text",
      "Create sandbox-proof.txt containing exactly Hello from CoreWeave " +
        "followed by a newline, then read it back. Do not commit or push anything.",
    ],
    { cwd: "/workspace/project", timeoutMs: 300_000, check: true },
  );
  console.log(result.stdout);
  const proof = await sandbox.commands.run(
    ["cat", "/workspace/project/sandbox-proof.txt"], { check: true },
  );
  process.stdout.write(proof.stdout);
} finally {
  await sandbox.stop();
}

uv run python run_cursor_sandbox.py [AUTH-MODE] [REPOSITORY-URL]

npx tsx run_cursor_sandbox.mts [AUTH-MODE] [REPOSITORY-URL]

​

문제 해결

• 샌드박스 생성에 실패하면 선택한 인증 모드에 맞는 사용자 인증 정보를 확인하세요.
• Forge 시크릿을 가져올 수 없으면 FORGE_TEAM, CURSOR_SECRET_NAME, API 키의 팀 액세스 권한을 확인하세요.
• Cursor에서 인증 오류가 발생하면 모드에 따라 Forge 시크릿 또는 로컬 CURSOR_API_KEY의 키를 확인하고, 계정의 모델 액세스 권한도 확인하세요.
• SDK 프롬프트가 변경 사항을 제안하기만 하고 적용하지 않는다면 Cursor 명령어에 --force가 포함되어 있는지 확인하세요.
• 설치, 복제 또는 모델 요청이 실패하면 아웃바운드 연결 상태와 공급자 사용자 인증 정보를 확인하세요. CoreWeave Kubernetes Service(CKS)에 배치하는 경우 러너 정책에서 필요한 대상을 허용해야 합니다.

​

다음 단계

• CoreWeave 샌드박스에서 에이전트 실행하기에서는 배치, 장시간 세션, 워크스페이스 라이프사이클을 설명합니다.
• cws-agent와 함께 Cursor 사용하기에서는 저장된 대화와 설정 임포트를 설명합니다.
• Cursor CLI 문서에서는 에이전트 설정과 지원되는 모드를 설명합니다.