개발짱 김크램

gemini-cli 설치, 사용 솔직 후기 - npm vs Homebrew 본문

개발짱 성장일지/AI

gemini-cli 설치, 사용 솔직 후기 - npm vs Homebrew

김크램 2026. 5. 3. 11:59

Mac OS 에서 gemini-cli를 설치하고 사용해 본 경험에 대해 공유하고자 포스팅을 해본다.

gemini-cli란?

터미널 환경에서 구글의 gemini를 호출하여 사용할 수 있게하는 도구다.

터미널 창에서 다른 명령어의 출력 결과를 Gemini에게 전달하여 분석하거나,

작성 중인 소스 코드 리팩토링이나 코드 생성 작업에 최적화되어 있다.

텍스트뿐만 아니라 이미지 파일 경로를 입력하여 이미지 분석 결과를 얻는 기능도 지원한다. 

설치 방법 : node.js vs Homebrew

두 방식의 차이점

Homebrew로 설치하는 것은 이 도구를 단순한 라이브러리가 아닌 독립적인 시스템 유틸리티로 취급하는 방식이다. 그래서 개발 환경의 Node.js 버전이 바뀌거나 프로젝트 설정이 변경되어도 영향을 받지 않는 실행 안정성을 제공한다.

 

반면 Node.js 패키지 매니저(npm)를 통한 설치는 JavaScript 생태계 내에서 도구를 관리하는 방식이다.

별도의 설치 없이 npx로 즉시 실행하거나 프로젝트의 package.json에 포함시켜 팀원들과 개발 환경을 동기화하기에 유리하다는 유연성이 있다.

npm install -g로 설치하면 Homebrew와 비슷하게 어디서든 쓸 수 있지만, nvm 등으로 Node.js 버전을 바꿀 때마다 글로벌 패키지를 다시 관리해야 하는 번거로움이 생길 수 있다.

1. node.js

공식홈페이지(https://geminicli.com/)에서는 npm 방식을 소개하고 있다

npm install -g @google/gemini-cli
 

Build, debug & deploy with AI

 

geminicli.com

2. Homebrew

brew install gemini-cli

이 명령어만 입력하면 설치 끝!

난 프로젝트 설정에 영향받지 않고 전역으로 쓰기 위해 홈브루를 통해 설치했다.

둘 중 편한 방법으로 설치하면 될 거 같다!

 

실행방법 : gemini 입력

gemini

설치가 완료되고 나면 터미널창에 gemini라고 하면 제미나이와 대화가 시작된다

 

장단점

장점

vscode intelliJ 터미널에서 손쉽게 실행하고 내 프로젝트를 같이 보면서 대화하고 바로바로 수정해준다!
전문가가 옆에 딱 붙어서 도와주는 느낌이다


단점

UX가 별로다 ..ㅎ 프롬프트에 개행문자를 넣고싶은데, 컨트롤엔터 쉬프트엔터 알트엔터 아무것도 안됨 ㅡㅡ
이건 내가 사용법이 미숙해서 그런거겠지..? 익숙해지면 상관없어질 단점!