Cursor

샌드박스에서 Cursor의 인증, 설정, 사용법을 설명해 드릴게요.

출처: 문서

본문

이 페이지는 로컬 샌드박스를 설명해요. 클라우드 동작과 제한 사항은 로컬과 클라우드 샌드박스 비교 문서를 보세요.

이 가이드는 샌드박스 환경에서 Cursor의 인증, 설정, 사용법을 다뤄요.

공식 문서: Cursor CLI

프로젝트 디렉터리용 샌드박스를 만들고 Cursor를 실행해요:

$ sbx run cursor ~/my-project

sbx run은 워크스페이스를 현재 디렉터리로 기본 설정해요:

$ cd ~/my-project
$ sbx run cursor

마운트 없는 샌드박스(mountless sandbox)를 만들려면 워크스페이스 경로 없이 sbx create를 쓰고, 이름으로 붙여서 사용하세요.

Cursor는 API 키 또는 OAuth 두 가지 인증 방법을 지원해요.

$ sbx secret set cursor

OAuth: API 키가 없으면 Cursor가 첫 실행 시 대화형으로 로그인을 요청해요. 프록시가 api2.cursor.sh/auth/poll과의 토큰 교환을 가로채므로 자격 증명은 호스트가 관리하고 샌드박스 안에는 저장되지 않아요.

샌드박스는 호스트의 사용자 수준 설정(예: ~/.cursor)을 가져오지 않아요. 샌드박스 안에서는 작업 디렉터리의 프로젝트 수준 설정만 쓸 수 있어요. 해결 방법은 "샌드박스가 내 사용자 수준 에이전트 설정을 안 쓰는 이유는?" 문서를 참고하세요.

Cursor는 워크스페이스에서 AGENTS.md를 읽어 에이전트별 지침으로 사용해요.

추가 인자 없이 샌드박스는 다음을 실행해요:

cursor-agent --yolo

-- 뒤의 인자는 첫 인자가 플래그(-로 시작)일 때 기본 플래그 뒤에 추가돼요. 그래서 --yolo가 유지돼요:

$ sbx run --name <sandbox-name> -- -p "refactor this"  # cursor-agent --yolo -p "refactor this" 를 실행

첫 인자가 일반 단어(서브커맨드나 프롬프트)면 기본 값을 대신 대체해요.

템플릿: docker/sandbox-templates:cursor-agent-docker

에이전트 트래픽이 호스트 프록시를 통해 흐르도록 HTTP/1.1과 server-sent events를 미리 설정해 두고 있어요. 인증 상태는 샌드박스 재시작 후에도 유지돼요.

도구를 미리 설치하거나 이 환경을 커스터마이즈하려면 Customize 문서를 보세요.

관련 문서와 심화 내용은 원문을 참고해 주세요.