사전 요구 사항
시작하기 전에 다음 항목을 준비하세요.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 키로 바꾸세요.
샌드박스 클라이언트 설치
사용할 언어를 선택하고 로컬 프로젝트를 준비하세요.- Python
- TypeScript
샌드박스에서 작업 실행하기
사용하는 언어에 맞는 스크립트를 표시된 파일 이름으로 저장하세요. 각 스크립트는 최대 수명이 30분인 서버리스 샌드박스를 생성하고 다음 단계를 수행합니다.- Meta의 설치 프로그램으로 Muse Code를 설치합니다.
- 저장소를
/workspace/project디렉터리에 복제합니다. muse exec를 실행하여 숫자를 작은 차트로 렌더링하는 스파크라인 CLI를 빌드하고 테스트합니다.- 생성된 CLI를 별도로 실행하여 출력을 확인한 다음,
sparkline.mjs파일을 로컬에 저장합니다. - 설정이나 실행이 실패한 경우에도
finally블록에서 샌드박스를 중지합니다.
muse --version을 실행합니다.
이 예시에서는 --yolo를 사용하여 Muse Code의 승인 프롬프트와 운영 체제(OS) 샌드박스를 비활성화하고, 이번 실행에서 워크스페이스를 신뢰하도록 설정합니다. 외부 샌드박스는 CoreWeave가 제공합니다. Muse는 해당 샌드박스 내에서 사용 가능한 파일, 사용자 인증 정보, 네트워크 대상에 액세스할 수 있습니다. 신뢰할 수 있는 저장소를 사용하고, 작업에 필요한 사용자 인증 정보만 제공하세요. 자세한 내용은 Muse Code 권한을 참조하세요.
- Python
- TypeScript
run_muse.py
[REPOSITORY-URL]을 공개 저장소 URL로 바꾼 다음 스크립트를 실행하세요.
- Python
- TypeScript
sparkline.mjs 파일을 로컬 프로젝트 디렉터리에 저장한 다음 샌드박스를 중지합니다. 로컬에 같은 파일이 이미 있으면 덮어씁니다. 출력 검사는 Muse 자체 테스트와 별개로 실행되며, 이 예제의 입력을 검증합니다. 더 큰 작업에서는 요구 사항에 맞는 테스트로 바꿔 사용하세요.
이 예시에서는 영구 스토리지를 설정하지 않습니다. finally 블록이 실행되기 전에 필요한 파일을 샌드박스 밖으로 복사해 두세요. 자세한 내용은 파일 작업 및 파일 시스템 스냅샷을 참조하세요.
문제 해결
다음 항목을 확인하여 일반적인 문제를 해결하세요.- 샌드박스 생성에 실패하면 CoreWeave API 액세스 토큰과 인증 설정을 확인하세요.
- Muse Code에서 인증 오류가 발생하면
META_API_KEY와 Meta 계정 설정을 확인하세요. 샌드박스 사용자 인증 정보로는 모델 요청을 인증할 수 없습니다. - 설치, 복제 또는 모델 요청에 실패하면 Meta 및 Git 호스트로의 아웃바운드 액세스가 가능한지 확인하세요. 이 예시에서는 서버리스 배치를 사용합니다. 자체 CoreWeave Kubernetes Service(CKS) 클러스터를 사용하려면 CKS 배치 및 정책 설정의 클라이언트 설정을 적용하세요. 또한 러너의 정책에서 해당 대상으로의 이그레스가 허용되어 있는지 확인하세요.
- 규모가 큰 작업이 시간 초과되는 경우, 실행하기 전에 명령어 timeout과 샌드박스 수명을 조정하세요. 30분의 수명에는 시작 및 설치 시간도 포함됩니다. 자세한 내용은 명령어 timeout 및 샌드박스 라이프사이클을 참조하세요.
다음 단계
자세한 내용은 다음 가이드를 참조하세요.- 대화형 셸과 TTY에서는 대화형 에이전트를 위한 터미널 액세스를 다룹니다.
- CoreWeave 샌드박스에서 에이전트 실행하기에서는 에이전트 인테그레이션과 워크스페이스 옵션을 비교합니다.
- Meta의 샌드박스 실행 쿡북에서는 Docker에서 맞춤형 도구 루프를 사용해 재현, 수정, 검증으로 이어지는 워크플로를 보여 줍니다.
- Muse Code 문서에서는 에이전트 구성을 비롯한 여러 CLI 워크플로를 다룹니다.