문제 해결 가이드
Gemini CLI에 대한 일반적인 문제와 자주 묻는 질문에 대한 솔루션. 다양한 문제에 대한 빠른 수정 및 자세한 지침을 찾아보세요.
빠른 진단 명령
일반적인 문제를 진단하려면 이러한 명령으로 시작하세요
gemini --versionCLI 버전 및 빌드 정보 확인
gemini config list현재 구성 설정 표시
gemini config reset구성을 기본값으로 재설정
gemini logs최근 오류 로그 및 디버그 정보 보기
gemini doctor진단 검사 및 상태 확인 실행
gemini cache clear캐시된 데이터 및 임시 파일 지우기
일반적인 문제 및 해결책
특정 문제에 대한 해결책을 찾으려면 카테고리별로 찾아보세요
설치 문제
설치 및 설정 중 문제
npm install이 권한 오류로 실패함
--global 플래그와 함께 npm을 사용하거나 npm이 다른 디렉토리를 사용하도록 구성하세요. macOS/Linux에서는 sudo를 사용하거나 npm을 올바르게 구성해야 할 수 있습니다.
해결책:
npm install -g @google/generative-ai-cli설치 후 명령을 찾을 수 없음
npm 글로벌 bin 디렉토리가 PATH에 있는지 확인하세요. `npm config get prefix`로 확인하고 bin 디렉토리를 PATH에 추가하세요.
해결책:
export PATH=$PATH:$(npm config get prefix)/binNode.js 버전 호환성 문제
Gemini CLI는 Node.js 16 이상이 필요합니다. nvm을 사용하여 Node.js를 업데이트하거나 nodejs.org에서 다운로드하세요.
해결책:
node --version # Should be 16.0.0 or higher인증 및 API 문제
API 키 및 인증 문제
유효하지 않은 API 키 오류
API 키가 올바르고 적절한 권한을 가지고 있는지 확인하세요. 필요한 경우 Google AI Studio에서 새 키를 받으세요.
해결책:
gemini config set api-key YOUR_API_KEYAPI 할당량 초과
Google AI Studio에서 사용 한도를 확인하세요. 플랜 업그레이드 또는 속도 제한 구현을 고려하세요.
해결책:
gemini config set rate-limit 10 # Requests per minute네트워크 연결 문제
인터넷 연결 및 방화벽 설정을 확인하세요. 기업 방화벽 뒤에 있는 경우 프록시 구성을 확인하세요.
해결책:
gemini config set proxy http://proxy.company.com:8080Configuration Problems
Issues with CLI configuration and settings
구성 파일이 손상되었거나 누락됨
구성을 기본값으로 재설정하고 다시 구성하세요. 먼저 중요한 설정을 백업하세요.
해결책:
gemini config reset
gemini config set api-key YOUR_API_KEY모델을 사용할 수 없거나 더 이상 사용되지 않음
사용 가능한 모델을 확인하고 구성을 업데이트하세요. 일부 모델에는 지역 제한이 있을 수 있습니다.
해결책:
gemini models list
gemini config set model gemini-pro환경 변수가 인식되지 않음
환경 변수가 올바르게 설정되고 내보내졌는지 확인하세요. 변수 이름과 값을 확인하세요.
해결책:
export GEMINI_API_KEY=your_key_here
export GEMINI_MODEL=gemini-pro성능 문제
느린 응답 및 성능 문제
느린 응답 시간
네트워크 연결을 확인하고, 요청 크기를 줄이거나, 다른 모델을 시도하세요. 긴 응답에는 스트리밍 사용을 고려하세요.
해결책:
gemini config set stream true
gemini config set max-tokens 1000높은 메모리 사용량
대화 기록을 제한하고, 배치 크기를 줄이거나, CLI 세션을 주기적으로 재시작하세요.
해결책:
gemini config set history-limit 10
gemini session clear시간 초과 오류
시간 초과 설정을 늘리거나 큰 요청을 작은 청크로 나누세요.
해결책:
gemini config set timeout 60000 # 60 seconds도구 및 플러그인 문제
도구 및 플러그인 기능 문제
도구 실행 실패
도구 권한, 파일 경로 및 종속성을 확인하세요. 도구가 올바르게 설치되고 구성되었는지 확인하세요.
해결책:
gemini tools list
gemini tools test tool-name플러그인이 로드되지 않음
플러그인 경로를 확인하고, 구문 오류를 검사하며, 모든 종속성이 설치되었는지 확인하세요.
해결책:
gemini plugins list
gemini plugins reload plugin-nameMCP 서버 연결 문제
서버 상태, 네트워크 연결 및 프로토콜 버전 호환성을 확인하세요.
해결책:
gemini mcp status
gemini mcp reconnect server-name