Gemini CLI 설치 안됨, 오류별 해결법 (2026)

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 버전이 요구 사항보다 낮음.

1. node -v로 현재 버전 확인.
2. 18 미만이면 nodejs.org에서 LTS 버전 다운로드·설치.
3. nvm 사용자: nvm install 22 → nvm use 22

오류 3: “command not found: gemini” (실행 안됨)

원인: npm 전역 bin 경로가 PATH에 없음.

• npm bin -g로 경로 확인.
• 해당 경로를 환경변수 PATH에 추가.
• Windows: 터미널을 껐다 다시 열면 해결되기도 합니다.

오류 4: 네트워크 타임아웃

1. VPN을 끕니다.
2. npm 레지스트리 확인: npm config get registry → https://registry.npmjs.org/여야 정상.
3. 회사 네트워크라면 프록시 설정: npm config set proxy http://프록시주소:포트

설치 확인

gemini --version

버전 번호가 출력되면 정상 설치된 것입니다.

이 글은 2026년 7월 기준 실제 설치 경험을 바탕으로 작성되었습니다.