제미나이 CLI 사용법, 개발자의 역할이 완전달라집니다.

개발 흐름이 끊기는 순간은 대부분 비슷합니다. 코드를 작성하다가 구현 방법이나 에러 원인을 확인하기 위해 AI에게 질문을 던지다 보면, 작업 흐름이 쉽게 흩어지곤 합니다.

그래서 요즘 트렌드 파악이 빠른 개발자들은 Google의 제미나이 CLI를 활용해, 터미널 환경 안에서 AI를 호출하며 개발 흐름을 더 빠르게 가져가고 있습니다. IDE나 웹 UI를 오가지 않고도 코드 작성 · 분석 · 자동화 작업을 이어갈 수 있다는 점에서, 개발 과정에 AI를 자연스럽게 포함시키는 방식으로 주목받고 있습니다.

이 글에서는 제미나이 CLI가 어떤 작업 흐름에서 효과적인지, 그리고 실무에서 바로 활용할 수 있는 사용법을 중심으로 살펴봅니다.

제미나이 CLI란?

제미나이 CLI는 터미널 환경에서 제미나이 모델을 직접 호출해 사용할 수 있도록 제공되는 커맨드라인 기반 인터페이스입니다.

개발자와 운영 환경을 중심으로 설계된 도구로, 웹 화면을 열지 않아도 되고 별도의 UI 조작 없이 명령어만으로 AI 기능을 실행할 수 있습니다.

단순히 CLI를 중심으로 작업 흐름을 구성하고 있는 개발 환경에 자연스럽게 녹아드는 형태를 지향합니다.

제미나이 CLI 설치 방법 

제미나이 CLI 설치는 크게 준비 → 설치 → 인증 → 동작 확인 4단계로 진행하는데요. 설치하기에 앞서 준비 단계에서 것을 확인해야하는지 바로 알아볼게요.

제미나이 CLI를 설치, 먼저 이것부터 확인하세요.

• 터미널 사용이 가능한 환경인지 여부
   로컬 개발 환경 또는 서버 환경에서 터미널 접근이 가능한 상태여야 합니다.
• CLI 실행을 위한 기본 런타임 설치 여부
   Node.js 20 이상이 설치되어 있어야 하며, npm 사용이 가능한 상태여야 합니다.
• 구글 계정 및 제미나이 사용 권한 보유 여부
   최초 실행 시 Google 계정 로그인을 통해 인증 절차가 진행됩니다.
• 네트워크 및 인증 관련 제한이 없는 환경인지 여부
   사내망, 방화벽, 보안 정책 등으로 인해 외부 인증이 차단되어 있지 않아야 합니다.

이 조건이 충족되지 않으면 설치를 하더라도 정상적으로 사용하기 어렵습니다. 특히 사내 개발 환경이나 보안이 강화된 서버 환경에서는 사전 점검이 필요합니다.

Node.js 설치 방법

* 이미지 출처: Node.js 홈페이지

제미나이는 Node.js 환경에서 작동되도록 만들어진 CLI 패키지입니다. 그래서 Node.js 20이상의 버전이 설치되어 있어야 합니다.

제미나이 CLI 설치 명령어 입력하기

macOS에서는 기본 Terminal 앱, Windows에서는 PowerShell 또는 Windows Terminal을 사용하면 됩니다. Linux 역시 일반 터미널 환경이면 충분합니다. 터미널을 열고 npm install -g @google/gemini-cli를 입력합니다. 

이 명령어는 npm을 통해ㅡ 제미나이 CLI를 시스템 전역에 설치합니다. 
 

설치가 완료되면 gemini 명령어를 입력해 제미나이 CLI를 실행합니다.

제미나이 CLI + VS Code 연동 방법

제미나이 CLI는 VS Code의 내장 터미널을 통해서도 사용할 수 있습니다. VS Code에서 터미널을 실행해 동일하게 gemini를 입력해줍니다.

Node.js에서 설치가 되지 않은 분들이라면 npm install -g @google/gemini-cli의 과정을 거친 뒤 입력해 주시면 됩니다.

VS Code에서 사용하면 별도의 환경 전환 없이 작업 흐름에 그대로 녹여 활용할 수 있습니다. 코드는 에디터에서 관리하고, 판단과 보조는 CLI가 맡는 구조가 만들어지면서 전체 과정이 훨씬 단순해집니다. 

VS Code 사용법을 모르는 분들은 아래 링크를 참고하세요.

▶ Visual Studio Code 사용법 (Feat. 한글팩 · Python · 테마 · AI) 보러가기

제미나이 CLI 사용방법

제미나이 CLI가 실행되었다면 이제 초기 접근 방법을 설정해야합니다. 설정 방법은 총 3가지가 있습니다.

1) Login with Google

구글 계정으로 로그인해 사용하는 방식입니다. 별도의 키 발급이나 추가 설정 없이 바로 사용할 수 있어, 개인 개발, 학습, 테스트 용도로 가장 간단한 선택지입니다.

2) Use Gemini API Key

제미나이 API Key를 발급해 연동하는 방식입니다. 로그인 없이 CLI를 실행할 수 있어 자동화 스크립트, 서버 환경, CI/CD 파이프라인 등 비대화형 환경에 적합합니다.

3) Vertex AI

Google Cloud 기반의 Vertex AI와 연동해 사용하는 방식입니다. 조직 단위 권한 관리, 보안 정책, 비용 통제가 필요한 기업 환경이나 대규모 프로젝트에서 사용됩니다.

세팅은 초기 회만 진행하면 됩니다. 개인 사용이나 빠른 테스트 목적이라면 대부분 Login with Google을 선택하면 충분합니다. 

세팅은 최초 1회만 진행하면 됩니다. 개인 사용이나 빠른 테스트 목적이라면 Login with Google 방식만으로도 충분히 활용가능합니다. 

접근 방법을 설정했다면 바로 사용할 수 있습니다.명령어 창에 프롬프트를 입력하면 제미나이가 터미널 창에서 바로 답변을 하는 것을 볼 수 있습니다. 

터미널 중심 워크플로우에서 모든 작업을 자연어로 실행하기

제미나이 CLI는 기존 IDE나 웹 기반 도구와 달리, 터미널만으로 코드 작성과 분석, 테스트, 심지어 셸 명령 실행까지 할 수 있습니다. 

코드 작성이 필요하거나 문제가 생겼을 때 코드의 명령어를 입력하는게 아니라 자연어를 입력해 필요한 작업을 처리할 수 있습니다. 

스크립트 실행, 파일 생성 편집, 문제 원인 분석까지 제미나이 CLI 하나로 모두 처리 가능합니다.

제미나이 CLI로 개발 시간을 줄이는 명령어 10가지

아래 명령어들은 제미나이 CLI에서 작업 맥락과 세션을 효율적으로 관리해 개발 시간을 줄이는 데 도움이 됩니다.

1️) /help

현재 제미나이 CLI에서 사용할 수 있는 모든 명령어 목록을 확인합니다.

2️) /init

현재 디렉터리에 GEMINI.md를 생성해 프로젝트 기준과 맥락을 정의합니다.

3️) /memory show

현재 로드된 프로젝트 기준(GEMINI.md) 내용을 확인합니다.

4️) /chat

Gemini와 대화를 시작해 코드 분석, 설계, 리뷰, 수정 요청을 진행합니다.

5️) @파일경로

파일 또는 디렉터리를 프롬프트에 직접 첨부해 코드 기반 질문을 할 수 있습니다.

6️) !쉘명령어

제미나이 CLI 안에서 실제 터미널 명령어를 실행해 현재 상태를 확인합니다.

7️) /compress

누적된 대화 히스토리를 내부적으로 축약해 컨텍스트 토큰 사용량을 줄입니다.

8️) /stats

현재 세션의 토큰 사용량과 컨텍스트 압축 결과를 확인합니다.

9️) /clear

현재 세션의 대화 맥락을 완전히 초기화합니다.

10) /quit

제미나이 CLI 세션을 종료합니다.

제미나이 CLI를 사용하면, 

작업 방식이 어떻게 달라질까?

제미나이 CLI를 활용하면 개발 절차를 확연하게 줄일 수 있습니다. 이 차이가 실제 작업에서 어떻게 나타나는지, 개발자들이 가장 자주 만드는 화면 하나를 기준으로 비교해보겠습니다. 실무에서 개발자들이 가장 많이 만드는 화면 중 하나는 데이터를 관리하는 화면입니다. 

이런 화면은 보통 다음과 같은 요구사항을 포함합니다.

1. 사용자 목록을 한 눈에 볼 수 있고
2. 이름으로 검색할 수 있으며
3. 페이지를 넘겨가며 확인할 수 있는 구조

게시판, 사용자 관리, 주문 목록, 로그 조회처럼 거의 모든 서비스에서 반복해서 등장하는 요구사항입니다.

이 작업을 Next.js로 직접 구현했을 때와 제미나이 CLI를 사용했을 때, 개발자가 실제로 어떤 절차를 거치게 되는지 비교해보겠습니다.

1) Next.js로 작업했을 때의 절차

이 작업은 어렵지 않지만, 항상 같은 결정을 반복하게 됩니다.

1. app/users/page.tsx 파일 생성
2. 서버 컴포넌트 / 클라이언트 컴포넌트 구조 판단
3. 사용자 데이터를 가져올 fetchUsers 함수 설계
4. searchParams를 이용한 검색어·페이지 처리
5. 리스트 UI 반복 렌더링 코드 작성
6. 페이지네이션 상태 및 이동 로직 구현
7. 검색 input과 submit 이벤트 연결
8. 로딩 상태 / 데이터 없음 상태 UI 처리
9. User, UserResponse 등 타입 정의
10. 컴포넌트 분리 여부 및 폴더 구조 정리

코드 자체보다, 구조를 결정하고 연결하는 절차가 작업의 대부분을 차지합니다.

2) 제미나이 CLI를 사용했을 때의 절차

제미나이 CLI를 사용할 때 사람이 실제로 하는 행동만 정리하면 아래와 같습니다.

1. 프로젝트 폴더에서 제미나이 CLI 실행
2. 요구사항 입력
3. 실행 승인(Allow once)
4. 생성된 결과 확인

사람이 직접 한 일은  요구사항 설명 1회와 승인뿐입니다.

* 두 방식의 차이를 한 눈에 비교해보세요.

이 차이는 단순히 코드를 얼마나 빨리 작성했느냐의 문제가 아닙니다. Next.js로 작업할 때 개발자가 반복해서 하던 구조 결정과 연결 작업을, 제미나이 CLI는 한 번의 요구사항 정의로 정리해줍니다.

개발자는 생성된 결과를 검토하고, 중요한 업무에 집중할 수 있습니다.

업무 효율과 생산성이 동시에 높아지는 AI 활용 콘텐츠 TOP 3

바로 써먹을 수 있는 Replit AI 사용법

Cursor AI 사용법 가이드, 개발할 때 바로 써먹는 활용 팁 3가지

생산성이 배로 높아지는 젠스파크(Genspark)의 사용법 5가지

제미나이 CLI가 보여주는 것은

개발 속도의 차이가 아니라 

'개발 역할의 변화’입니다.

AI 도구가 코드를 생성해주는 시대, 개발자의 역할은 만드는 사람에서 ‘설계하고 검증하는 사람’으로 바뀌고 있습니다.  AI를 활용해도 실무에서는 여전히 이런 순간이 찾아옵니다. 

• AI가 생성한 구조를 실서비스 기준으로 재설계해야 할 때
• 데이터 모델과 권한 구조를 처음부터 다시 잡아야 할 때 
• 이 방식이 맞는지 빠르게 검증이 필요할 때 

AI는 빠르게 만드는 것을 도와주지만, ‘제대로 만드는 것’은 여전히 개발자의 몫입니다.

제미나이 CLI 같은 도구를 이해하고 활용할 수 있는 개발자,

이랜서에서 매칭받으세요

이랜서는 27년간 8만 건의 프로젝트 경험을 바탕으로, AI · 클라우드 실무 경험이 있는 IT 프리랜서를 정밀하게 선별해 24시간 내 연결합니다. 

전문성과 협업 능력까지 검증된 IT 프리랜서 매칭 서비스로 프로젝트 재의뢰율 98%기록하고 있습니다.

AI 도구를 활용하면서도 설계 원칙과 실무 기준을 놓치지 않는 개발자를 찾는다면 이랜서와 함께하세요.