Skip to main content
CoreWeave 샌드박스에서 Muse Code를 실행하면 원격 워크스페이스에서 파일을 편집하고 명령어를 실행할 수 있습니다. 이 가이드에서는 샌드박스 소프트웨어 개발 키트(SDK)로 명령줄 인터페이스(CLI)를 설치하고 저장소를 복제합니다. 그런 다음 대화형 터미널 없이 작업을 실행하고 결과를 조회한 후 샌드박스를 중지합니다. 에이전트 프로세스와 워크스페이스는 CoreWeave에서 실행되며, 모델 요청은 Meta로 전송됩니다.

사전 요구 사항

시작하기 전에 다음 항목을 준비하세요.
  • SANDBOX_USER 액션이 부여된 CoreWeave API 액세스 토큰
  • Muse Code에 액세스할 수 있는 Meta API 키
  • 샌드박스에서 복제할 수 있는 공개 저장소 URL. 비공개 저장소를 사용하려면 샌드박스 내부에 Git 사용자 인증 정보가 있어야 합니다.
  • uv가 설치된 Python 3.11 이상 또는 npm이 설치된 Node.js 22 이상
시크릿 관리자에 저장된 사용자 인증 정보를 로컬 터미널 환경으로 불러오세요. [API-ACCESS-TOKEN]은 CoreWeave API 액세스 토큰으로, [META-API-KEY]는 Meta API 키로 바꾸세요.
이 스크립트는 Meta 키를 표준 입력으로 전달하므로 키가 명령어 인수나 샌드박스 구성에 노출되지 않습니다. 샌드박스를 생성할 때 환경 변수로 주입되는 팀 공유 사용자 인증 정보는 Forge 시크릿을 참조하세요.

샌드박스 클라이언트 설치

사용할 언어를 선택하고 로컬 프로젝트를 준비하세요.

샌드박스에서 작업 실행하기

사용하는 언어에 맞는 스크립트를 표시된 파일 이름으로 저장하세요. 각 스크립트는 최대 수명이 30분인 서버리스 샌드박스를 생성하고 다음 단계를 수행합니다.
  1. Meta의 설치 프로그램으로 Muse Code를 설치합니다.
  2. 저장소를 /workspace/project 디렉터리에 복제합니다.
  3. muse exec를 실행하여 숫자를 작은 차트로 렌더링하는 스파크라인 CLI를 빌드하고 테스트합니다.
  4. 생성된 CLI를 별도로 실행하여 출력을 확인한 다음, sparkline.mjs 파일을 로컬에 저장합니다.
  5. 설정이나 실행이 실패한 경우에도 finally 블록에서 샌드박스를 중지합니다.
이 예시는 Muse Code 1.3.0에서 테스트되었습니다. 설치 프로그램이 더 새로운 버전을 설치할 수 있으므로, 각 스크립트는 설치 후 muse --version을 실행합니다. 이 예시에서는 --yolo를 사용하여 Muse Code의 승인 프롬프트와 운영 체제(OS) 샌드박스를 비활성화하고, 이번 실행에서 워크스페이스를 신뢰하도록 설정합니다. 외부 샌드박스는 CoreWeave가 제공합니다. Muse는 해당 샌드박스 내에서 사용 가능한 파일, 사용자 인증 정보, 네트워크 대상에 액세스할 수 있습니다. 신뢰할 수 있는 저장소를 사용하고, 작업에 필요한 사용자 인증 정보만 제공하세요. 자세한 내용은 Muse Code 권한을 참조하세요.
run_muse.py
로컬 프로젝트 디렉터리에서 [REPOSITORY-URL]을 공개 저장소 URL로 바꾼 다음 스크립트를 실행하세요.
설치 로그와 에이전트 출력이 표시되고 나면 스크립트가 스파크라인을 확인하고 출력합니다.
스크립트는 생성된 sparkline.mjs 파일을 로컬 프로젝트 디렉터리에 저장한 다음 샌드박스를 중지합니다. 로컬에 같은 파일이 이미 있으면 덮어씁니다. 출력 검사는 Muse 자체 테스트와 별개로 실행되며, 이 예제의 입력을 검증합니다. 더 큰 작업에서는 요구 사항에 맞는 테스트로 바꿔 사용하세요. 이 예시에서는 영구 스토리지를 설정하지 않습니다. finally 블록이 실행되기 전에 필요한 파일을 샌드박스 밖으로 복사해 두세요. 자세한 내용은 파일 작업 및 파일 시스템 스냅샷을 참조하세요.

문제 해결

다음 항목을 확인하여 일반적인 문제를 해결하세요.
  • 샌드박스 생성에 실패하면 CoreWeave API 액세스 토큰과 인증 설정을 확인하세요.
  • Muse Code에서 인증 오류가 발생하면 META_API_KEY와 Meta 계정 설정을 확인하세요. 샌드박스 사용자 인증 정보로는 모델 요청을 인증할 수 없습니다.
  • 설치, 복제 또는 모델 요청에 실패하면 Meta 및 Git 호스트로의 아웃바운드 액세스가 가능한지 확인하세요. 이 예시에서는 서버리스 배치를 사용합니다. 자체 CoreWeave Kubernetes Service(CKS) 클러스터를 사용하려면 CKS 배치 및 정책 설정의 클라이언트 설정을 적용하세요. 또한 러너의 정책에서 해당 대상으로의 이그레스가 허용되어 있는지 확인하세요.
  • 규모가 큰 작업이 시간 초과되는 경우, 실행하기 전에 명령어 timeout과 샌드박스 수명을 조정하세요. 30분의 수명에는 시작 및 설치 시간도 포함됩니다. 자세한 내용은 명령어 timeout 및 샌드박스 라이프사이클을 참조하세요.

다음 단계

자세한 내용은 다음 가이드를 참조하세요.
마지막 수정일 2026년 10월 15일