설치 가이드
시스템에 Gemini CLI를 설치하고 구성하세요
시스템 요구사항
시스템이 이러한 요구사항을 충족하는지 확인하세요
Windows
- Windows 10 이상
- Node.js 18.0.0 이상
- PowerShell 5.1 또는 PowerShell Core 7+
- Windows Terminal (권장)
macOS
- macOS 10.15 (Catalina) 이상
- Node.js 18.0.0 이상
- Xcode Command Line Tools
- Terminal 또는 iTerm2
Linux
- Ubuntu 18.04+ / CentOS 8+ / Debian 10+
- Node.js 18.0.0 이상
- curl 또는 wget
- bash 또는 zsh 셸
설치 방법
필요에 가장 적합한 설치 방법을 선택하세요
NPM 설치
대부분의 사용자에게 권장되는 방법
단계 1: npm을 통해 전역 설치
시스템에 Gemini CLI를 전역으로 설치합니다
npm install -g @google/generative-ai-cli단계 2: 설치 확인
설치가 성공했는지 확인합니다
gemini --version단계 3: API 키 설정
Google AI API 키를 구성합니다
gemini config set api-key YOUR_API_KEYDocker 설치
일관된 배포를 위한 컨테이너화된 환경
단계 1: Docker 이미지 풀
공식 Docker 이미지를 다운로드합니다
docker pull google/gemini-cli:latest단계 2: API 키로 실행
API 키로 컨테이너를 시작합니다
docker run -e GEMINI_API_KEY=your_key google/gemini-cli:latest단계 3: 대화형 모드
대화형 채팅 세션을 시작합니다
docker run -it -e GEMINI_API_KEY=your_key google/gemini-cli:latest chat소스에서 설치
개발을 위해 소스 코드에서 빌드
단계 1: 저장소 복제
GitHub에서 소스 코드를 가져옵니다
git clone https://github.com/google-gemini/gemini-cli.git단계 2: 종속성 설치
필요한 모든 종속성을 설치합니다
cd gemini-cli && npm install단계 3: 빌드 및 링크
프로젝트를 빌드하고 전역 심볼릭 링크를 생성합니다
npm run build && npm linkAPI 키 구성
Gemini CLI 사용을 시작하기 위해 Google AI API 키를 설정하세요
API 키 받기
- 1Google AI Studio 방문
- 2Google 계정으로 로그인
- 3"API 키 생성"을 클릭하고 키를 복사
키 구성
CLI 명령 사용:
gemini config set api-key YOUR_API_KEY환경 변수 사용:
export GEMINI_API_KEY=YOUR_API_KEY설치 확인
모든 것이 정상적으로 작동하는지 확인하기 위해 설치를 테스트하세요
버전 확인
gemini --version설치된 버전 번호가 표시되어야 합니다
API 연결 테스트
gemini ask "안녕하세요, 들리시나요?"Gemini로부터 응답이 반환되어야 합니다
구성 확인
gemini config list현재 구성 설정이 표시되어야 합니다
일반적인 문제
일반적인 설치 문제에 대한 해결책
명령을 찾을 수 없음
설치 후 "명령을 찾을 수 없음" 오류가 발생하면 PATH에 npm의 전역 bin 디렉토리가 포함되지 않았을 수 있습니다.
npm config get prefix셸 프로필(.bashrc, .zshrc 등)의 PATH에 bin 디렉토리를 추가하세요
권한 거부됨
macOS/Linux에서는 sudo를 사용하거나 npm이 다른 디렉토리를 사용하도록 구성해야 할 수 있습니다.
npm config set prefix ~/.npm-global그런 다음 ~/.npm-global/bin을 PATH에 추가하세요