[기타/AI] Gemini CLI 설치와 사용법: 터미널에서 구글 Gemini 에이전트 시작하기
업데이트:
한눈에 고르기
| 상황 | 먼저 보기 |
|---|---|
| 한 번만 빠르게 체험 | npx @google/gemini-cli로 시작
|
| 계속 쓸 CLI를 찾는 중 | npm 전역 설치나 Homebrew로 고정 |
| 브라우저보다 터미널 작업 비중이 높음 | Gemini CLI, Claude Code, Codex CLI를 같이 비교 |
빠른 답
- Gemini CLI는 터미널에서 Gemini를 다루는 공식 CLI 에이전트입니다.
- 가장 가볍게 시작하려면
npx @google/gemini-cli, 계속 쓸 거면 전역 설치나 Homebrew가 편합니다. - 셸 명령, 파일 작업, MCP 연결까지 같이 다루고 싶을 때 특히 잘 맞고, IDE 중심 작업이면 Cursor나 Copilot이 더 직관적일 수 있습니다.
어떤 도구인가
Gemini CLI는 터미널 한복판에서 프롬프트, 파일 작업, 셸 명령, 웹 가져오기, MCP 도구 연결을 같이 다루는 타입의 에이전트입니다. 코드베이스를 훑어보게 하거나, 작은 자동화 스크립트를 같이 다듬는 데 특히 잘 맞습니다.
개념이나 비교 관점이 먼저 필요하면 2026 프론티어 모델 비교도 같이 보면 연결이 더 잘 됩니다. Gemini 모델 계열 자체가 궁금하면 이 글도 같이 보면 좋습니다.
공식 사이트와 다운로드 경로
- 공식 사이트: Gemini CLI GitHub 저장소
- 다운로드/접속 경로: Gemini CLI 설치 문서
- 공식 문서: Gemini CLI 공식 문서
지원 환경과 설치 방법
Windows
Windows에서는 Node.js와 npm이 준비되어 있으면 npx @google/gemini-cli로 바로 실행하거나 npm install -g
@google/gemini-cli로 전역 설치할 수 있습니다. GUI 설치 마법사보다는 Node 생태계에 얹히는 방식이라, PowerShell이나 Windows
Terminal에서 쓰는 흐름에 더 자연스럽습니다.
가볍게 체험만 할 때는 npx, 계속 쓸 거면 전역 설치가 대표 경로입니다.
npx @google/gemini-cli
npm install -g @google/gemini-cli
gemini
macOS
macOS에서는 npm install -g @google/gemini-cli로 설치할 수 있고, 공식 README 기준으로 Homebrew와 MacPorts 경로도
제공됩니다. 터미널 권한과 기본 셸 설정만 정리해 두면 바로 사용할 수 있습니다.
대표적인 설치법은 npm 전역 설치와 Homebrew입니다.
npm install -g @google/gemini-cli
gemini
brew install gemini-cli
gemini
Linux
Linux에서는 npm 전역 설치가 가장 단순하고, Homebrew를 쓰는 배포판이라면 brew install gemini-cli 경로도 가능합니다. 서버나 원격 개발
환경에서도 CLI라서 설정이 비교적 가볍습니다.
보통은 npm 전역 설치 하나만 기억해도 충분하고, Homebrew를 이미 쓰는 환경이면 brew도 괜찮습니다.
npm install -g @google/gemini-cli
gemini
brew install gemini-cli
gemini
기본 사용법
처음에는 모델 성능보다 인증 방식과 작업 디렉터리 범위를 먼저 안정시키는 편이 좋습니다. 개인 Google 계정 로그인으로 가볍게 시작할지, GEMINI_API_KEY로 프로젝트 단위 인증을 잡을지 정한 뒤 작은 폴더에서 먼저 써보면 감이 빨리 옵니다.
npx @google/gemini-cli또는 전역 설치 후gemini를 실행합니다.- 처음 실행에서 Google 계정 로그인 또는
GEMINI_API_KEY기반 인증을 마칩니다. - 프로젝트 폴더에서 파일을 읽게 하거나 셸 명령을 제안받고, 필요한 경우 MCP 서버를 연결해 도구 범위를 넓힙니다.
npx @google/gemini-cli
# 또는
npm install -g @google/gemini-cli
gemini
어떤 사람에게 잘 맞나
Gemini CLI는 브라우저 탭이 아니라 터미널에서 바로 에이전트를 부리고 싶다는 사람에게 잘 맞습니다. 특히 긴 컨텍스트, Google 계정 기반 접근, 검색과 셸 명령을 한 흐름으로 잇고 싶은 개발자에게 장점이 큽니다.
주의할 점
권한을 준 디렉터리와 셸 명령 범위는 늘 의식해야 합니다. CLI 에이전트는 편하지만, 프로젝트 루트와 인증 키 관리가 느슨하면 실수도 빠르게 커집니다.
요약
Gemini CLI는 설치 자체보다 인증과 작업 범위를 어떻게 설계하느냐가 더 중요합니다. 공식 저장소와 문서를 기준으로 npm 또는 Homebrew 경로를 잡고, 먼저 작은 작업부터 맡기면서 감을 익히는 편이 좋습니다.
참고 자료
이 글과 함께 보면 좋은 글
지금 읽은 내용을 바로 확장하거나, 실제 선택과 설치까지 이어질 만한 글들만 골랐습니다.
- 2026 프론티어 모델 비교 Gemini가 어디에 강한지 먼저 볼 때
- MCP란 무엇인가 도구 연결 개념까지 같이 잡고 싶을 때
- Claude Code 설치와 사용법 다른 CLI 에이전트와 비교할 때
이런 주제는 어떠신가요?
비교 글과 설치 가이드를 함께 보면 나에게 맞는 도구를 더 빨리 고르기 좋습니다.
댓글남기기