터미널에서 바로 구글의 AI 모델을 불러와 코드를 짜거나 파일을 분석하고 싶을 때 쓰는 도구가 Gemini CLI예요. 브라우저를 열지 않고도 명령줄에서 대화형으로 작업을 진행할 수 있어서, 개발 환경을 벗어나지 않고 AI 도움을 받고 싶은 개발자들이 많이 찾는 도구예요. 설치부터 기본 사용법까지 순서대로 정리해볼게요.
Gemini CLI 설치하는 방법
Gemini CLI는 Node.js 기반으로 동작하기 때문에 먼저 Node.js가 설치되어 있어야 해요. 터미널에서 npm 패키지 매니저를 통해 전역으로 설치하면 어느 디렉터리에서든 명령어를 바로 사용할 수 있어요. 설치가 끝나면 터미널에 명령어 하나만 입력해서 대화형 세션을 바로 시작할 수 있는 구조예요.
운영체제별로 큰 차이는 없지만, 맥과 리눅스는 기본 터미널에서 바로 설치가 가능하고 윈도우는 WSL이나 파워셸 환경에서 설치하는 방식이 안정적이에요. 설치 후에는 버전 확인 명령어로 정상적으로 설치됐는지 점검하는 게 좋아요. 별도의 API 키를 발급받아 환경변수에 등록하는 방식도 지원하지만, 개인 구글 계정으로 로그인해서 무료 사용량 범위 안에서 바로 시작하는 방식이 가장 간단해요.
로그인과 초기 설정
처음 명령어를 실행하면 구글 계정 로그인 절차가 자동으로 안내돼요. 브라우저 창이 열리면서 계정 인증을 진행하고, 인증이 완료되면 터미널로 돌아와 바로 대화를 시작할 수 있어요. 개인 계정으로 로그인하면 별도의 API 키 발급 없이도 일정 한도 내에서 무료로 사용할 수 있는 게 특징이에요.
기업 환경이나 더 높은 사용량이 필요한 경우에는 구글 클라우드 프로젝트와 연결해서 API 키 기반으로 인증하는 방식도 가능해요. 이 경우 사용량에 따라 과금되는 구조로 바뀌기 때문에, 개인 학습이나 가벼운 테스트 목적이라면 기본 계정 로그인만으로 충분한 경우가 많아요. 설정 파일은 사용자 홈 디렉터리에 저장되기 때문에 여러 프로젝트를 오가며 작업해도 로그인 정보를 다시 입력할 필요가 없어요.
기본 명령어와 대화 방식
Gemini CLI를 실행하면 채팅창처럼 자연어로 질문을 입력하고 답변을 받는 대화형 인터페이스가 뜨는데요, 일반적인 질문뿐 아니라 코드 작성, 버그 수정, 파일 요약 같은 작업 지시도 그대로 입력하면 돼요. 슬래시로 시작하는 명령어를 통해 세션 초기화, 도움말 확인, 설정 변경 같은 기능도 빠르게 호출할 수 있어요.
- 대화형 모드: 명령어만 입력하면 프롬프트 창이 열리고, 이후 자연어로 계속 대화하듯 작업을 요청할 수 있어요.
- 단발성 실행: 특정 질문을 옵션과 함께 한 줄로 넘기면 대화형 세션 없이 바로 결과만 받아볼 수 있어요.
- 파이프 입력: 다른 명령어의 출력 결과를 파이프로 연결해서 로그 분석이나 텍스트 요약 같은 작업에 바로 활용할 수 있어요.
파일과 프로젝트 컨텍스트 활용
Gemini CLI의 큰 장점은 현재 작업 중인 디렉터리의 파일들을 컨텍스트로 인식할 수 있다는 점이에요. 특정 폴더 안에서 실행하면 해당 프로젝트의 코드 구조를 파악한 상태로 질문에 답하기 때문에, 파일 전체를 복사해서 붙여넣지 않아도 “이 함수의 버그를 찾아줘” 같은 지시가 바로 통해요.
대형 프로젝트에서는 전체 컨텍스트를 한 번에 넣기보다 특정 파일이나 디렉터리를 지정해서 범위를 좁히는 방식이 효율적이에요. 프로젝트 루트에 설정 파일을 두면 프로젝트별로 참고할 문서나 코딩 규칙을 미리 지정해둘 수 있어서, 매번 같은 맥락을 반복 설명하지 않아도 되는 구조예요.
도구 연동과 확장 기능
Gemini CLI는 셸 명령어 실행, 파일 읽기·쓰기, 웹 검색 같은 도구 호출 기능을 지원해서 단순 대화를 넘어 실제 작업을 대신 수행할 수 있어요. 예를 들어 “이 디렉터리의 테스트를 실행하고 실패한 부분을 고쳐줘” 같은 요청을 하면, 실제로 명령어를 실행하고 결과를 확인한 뒤 코드를 수정하는 흐름으로 동작해요.
MCP(모델 컨텍스트 프로토콜) 서버를 연결하면 외부 서비스나 사내 시스템과 연동해서 기능을 확장할 수도 있어요. 이렇게 도구를 실제로 실행하는 기능이 있는 만큼, 처음 사용할 때는 어떤 명령어가 자동 실행되는지 확인하는 승인 절차를 거치는 게 안전해요.
사용 시 주의할 점
무료 사용량에는 하루 요청 횟수나 시간당 호출 제한이 걸려 있기 때문에, 반복적인 대량 작업을 할 때는 한도를 초과하지 않는지 확인하는 게 좋아요. 또한 파일 수정이나 명령어 실행 권한을 자동 승인으로 설정하면 의도치 않은 변경이 생길 수 있으므로, 중요한 프로젝트에서는 매번 실행 전 확인하는 설정을 유지하는 게 안전해요.
민감한 정보가 담긴 파일이 있는 디렉터리에서는 컨텍스트로 어떤 파일까지 전달되는지 미리 점검하는 습관도 필요해요. 설정 파일을 통해 특정 폴더나 파일 확장자를 컨텍스트에서 제외할 수 있으니, 사내 프로젝트에서 사용할 때는 이 부분을 먼저 설정해두는 게 좋아요.
Gemini CLI는 터미널을 벗어나지 않고 코드 작성부터 파일 분석, 자동화 작업까지 처리할 수 있다는 점에서 개발 워크플로에 자연스럽게 녹아드는 도구예요. 설치와 로그인 과정이 간단한 만큼, 기본 명령어부터 익힌 뒤 프로젝트 컨텍스트 설정과 도구 연동으로 활용 범위를 넓혀가는 방식을 추천해요.