Gemini CLI 사용법: 터미널에서 처음 시작할 때 가장 쉬운 흐름

Gemini CLI는 터미널에서 바로 AI에게 코드와 파일 작업을 맡길 수 있게 만든 도구입니다. 에디터 안에서 쓰는 도구와 달리, 현재 디렉터리와 셸 명령을 중심으로 흐름이 잡히기 때문에 개발자 입장에서는 꽤 직접적인 사용감이 있습니다.

이 글은 Gemini CLI 사용법을 처음 보는 기준으로 정리했습니다. 설치 명령만 나열하기보다, 무엇을 먼저 준비해야 하는지, 로그인은 어떤 식으로 하는지, 첫 실행 뒤에 무엇을 확인하면 좋은지 중심으로 설명합니다.

Gemini CLI는 어떤 도구인가

Google의 공식 공개 저장소 설명 기준으로 Gemini CLI는 터미널에서 Gemini를 직접 다루는 오픈소스 AI agent입니다. 코드 이해, 파일 작업, 셸 명령, 웹 기반 정보 보강 같은 흐름을 하나의 CLI 안에서 다룰 수 있게 설계돼 있습니다.

즉 간단한 질문 도구라기보다, 현재 작업 폴더를 기준으로 개발 흐름을 이어가는 쪽에 더 가깝습니다.

설치 전에 먼저 확인할 것

공식 저장소 기준으로 설치 전 요구사항은 비교적 단순합니다. 기본적으로 Node.js 20 이상이 필요하고, macOS, Linux, Windows를 지원합니다.

node --version
npm --version

버전이 정상적으로 나온다면 다음 단계로 넘어가면 됩니다. Node.js가 준비되지 않았다면 설치부터 먼저 끝내는 편이 좋습니다.

가장 쉬운 설치 방법

공식 저장소에는 두 가지 흐름이 먼저 보입니다. 설치 없이 바로 시험해보는 방식과, 전역 설치 방식입니다.

npx https://github.com/google-gemini/gemini-cli
npm install -g @google/gemini-cli

처음에는 설치 없이 npx로 감을 보는 것도 괜찮고, 계속 쓸 생각이면 전역 설치가 더 편합니다.

로그인은 어떻게 시작하나

공식 문서 기준으로 개인 사용자는 Google 계정으로 로그인하는 방식이 가장 단순합니다. CLI를 실행한 뒤 브라우저 인증 흐름을 따라가면 됩니다.

gemini

또는 Gemini API Key 방식도 가능합니다. 어떤 방식이 맞는지는 사용 목적에 따라 갈립니다. 개인 테스트 위주라면 로그인 방식이 단순하고, 특정 모델 통제나 별도 과금 관리가 필요하다면 API 키 방식이 더 나을 수 있습니다.

처음 실행 뒤에 해보면 좋은 것

• 현재 폴더 구조 설명 요청
• README 요약 요청
• 작은 파일 수정 요청
• 문제 있는 로그 분석 요청

처음부터 복잡한 작업을 맡기기보다, 지금 열어둔 폴더를 얼마나 잘 이해하는지부터 보는 편이 좋습니다.

Gemini CLI의 장점은 어디서 체감될까

공식 저장소 설명을 보면 Gemini CLI는 Google Search grounding, 파일 작업, shell commands, MCP 확장 같은 흐름을 강조합니다. 따라서 단순 질답보다, 코드와 도구를 같이 다루는 작업에서 의미가 커집니다.

특히 터미널을 자주 쓰는 개발자라면 에디터 바깥으로 나가지 않고 흐름을 이어갈 수 있다는 점이 편합니다.

자주 헷갈리는 부분

처음에는 로그인 방식과 API 키 방식 중 무엇이 더 좋나요?
개인 테스트 위주라면 Google 로그인 방식이 더 단순합니다. 별도 프로젝트 단위 관리가 필요하면 API 키 방식이 더 맞을 수 있습니다.

설치 없이도 쓸 수 있나요?
공식 저장소에는 npx로 바로 실행하는 예시가 먼저 나옵니다. 짧게 시험해보는 용도로는 이 방식이 편합니다.

Cursor나 Claude Code와 무엇이 다른가요?
Gemini CLI도 터미널 중심 도구지만, Google 계정 기반 로그인 흐름과 Gemini 생태계 연결성이 강한 편입니다. 반면 다른 도구들은 제품 구조와 가격 정책, 연결 기능에서 차이가 있습니다.

함께 보면 좋은 글

• 클로드 코드 hooks 사용법
• GitHub Copilot vs Cursor 비교

정리

Gemini CLI를 처음 시작할 때는 설치 명령만 보는 것보다 Node.js 확인, 로그인 방식 선택, 첫 실행 확인 순서로 흐름을 잡는 편이 훨씬 낫습니다. 그리고 처음에는 작은 작업부터 맡겨보는 쪽이 이 도구의 장단점을 빨리 파악하기 좋습니다.

참고한 공식 문서

• Google Gemini CLI GitHub repository