Gemini

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

출처: 문서

본문

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

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

공식 문서: Gemini CLI

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

$ sbx run gemini ~/my-project

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

$ cd ~/my-project
$ sbx run gemini

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

Gemini는 Google API 키 또는 Gemini 접근 권한이 있는 Google 계정이 필요해요.

$ sbx secret set google

Google 계정: API 키가 없으면 Gemini가 시작할 때 대화형 로그인을 요청해요. 대화형 인증은 샌드박스에 한정되며, 샌드박스를 지웠다가 다시 만들면 유지되지 않아요.

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

샌드박스는 Gemini에 내장된 샌드박스 도구를 비활성화해요(이미 격리를 제공하기 때문이죠).

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

gemini --yolo

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

$ sbx run --name <sandbox-name> -- -p "explain this"  # gemini --yolo -p "explain this" 를 실행

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

템플릿: docker/sandbox-templates:gemini

Gemini는 내장 OAuth 흐름을 비활성화하도록 설정되어 있어요. 인증은 API 키로 프록시를 통해 관리돼요.

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

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