Droid

샌드박스에서 Factory의 AI 코딩 에이전트 Droid의 인증, 설정, 사용법을 설명해 드릴게요.

출처: 문서

본문

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

이 가이드는 샌드박스 환경에서 Factory가 만든 AI 코딩 에이전트 Droid의 인증, 설정, 사용법을 다뤄요.

공식 문서: Droid

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

$ sbx run droid ~/my-project

워크스페이스 파라미터는 선택 사항이고, 기본값은 현재 디렉터리예요:

$ cd ~/my-project
$ sbx run droid

Droid는 Factory 계정이 필요해요. 두 인증 방법 모두 Factory의 서비스에 직접 인증해요 — 다른 에이전트처럼 모델 제공 업체 키를 넣는 것과 달리, Factory가 여러분의 Factory 계정을 통해 모델 접근을 관리해요.

$ sbx secret set droid

OAuth: API 키가 없으면 첫 실행 시 Droid가 대화형 인증을 요청해요. 프록시가 OAuth 흐름을 처리하므로 자격 증명이 샌드박스 안에 저장되지 않아요.

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

샌드박스는 암시적 플래그 없이 droid를 실행해요. -- 뒤의 인자는 그대로 전달돼요:

$ sbx run droid -- exec "fix the build"

템플릿: docker/sandbox-templates:droid-docker

승인 프롬프트 없이 실행되도록 미리 설정되어 있어요. 인증 상태는 샌드박스 재시작 후에도 유지돼요.

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

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