Gemini CLI를 설치하려는데 오류가 나서 막히셨나요? 대부분 Node.js 버전이나 권한 문제입니다.
정상 설치 방법 (먼저 확인)
npm install -g @anthropic-ai/gemini-cli설치 전 Node.js 18 이상이 필요합니다. node -v로 확인하세요.
오류 1: “npm ERR! code EACCES” (권한 오류)
원인: 전역 설치 경로에 쓰기 권한이 없음.
- Mac/Linux:
sudo npm install -g @google/gemini-cli - Windows: 터미널을 “관리자 권한으로 실행”한 뒤 재시도
- 근본 해결: nvm으로 Node.js를 관리하면 sudo 없이 가능
오류 2: “engine node incompatible” (Node 버전)
원인: Node.js 버전이 요구 사항보다 낮음.
node -v로 현재 버전 확인.- 18 미만이면 nodejs.org에서 LTS 버전 다운로드·설치.
- nvm 사용자:
nvm install 22→nvm use 22
오류 3: “command not found: gemini” (실행 안됨)
원인: npm 전역 bin 경로가 PATH에 없음.
npm bin -g로 경로 확인.- 해당 경로를 환경변수 PATH에 추가.
- Windows: 터미널을 껐다 다시 열면 해결되기도 합니다.
오류 4: 네트워크 타임아웃
- VPN을 끕니다.
- npm 레지스트리 확인:
npm config get registry→https://registry.npmjs.org/여야 정상. - 회사 네트워크라면 프록시 설정:
npm config set proxy http://프록시주소:포트
설치 확인
gemini --version버전 번호가 출력되면 정상 설치된 것입니다.
이 글은 2026년 7월 기준 실제 설치 경험을 바탕으로 작성되었습니다.