Hunny's Daily

개발과 일상에서의 달콤한 순간들을 기록하며, 유용한 팁과 인사이트를 공유합니다.

Gemini CLI 이용하기

Homebrew 설치부터 콘솔 사용 예시까지

Gemini CLI는 Google의 생성형 AI 모델인 Gemini를 커맨드라인 환경에서 사용할 수 있도록 제공되는 도구다. 브라우저나 IDE를 열지 않아도 터미널에서 바로 질문하고 응답을 받을 수 있다는 점이 특징이다. 따라서 개발 흐름을 유지한 상태에서 AI 기능을 활용할 수 있다. 이 글에서는 Gemini CLI의 개념과 함께 Homebrew를 이용한 설치 방법, 그리고 실제 콘솔 호출 예시를 정리한다.

Gemini CLI란 무엇인가

Gemini CLI는 Gemini API를 기반으로 동작하는 커맨드라인 인터페이스다. 이를 통해 텍스트 생성, 요약, 코드 설명, 간단한 질의응답을 터미널에서 직접 수행할 수 있다.

예를 들어 다음과 같은 작업에 활용된다.

  • 코드 설명 및 간단한 리뷰
  • 로그와 에러 메시지 요약
  • 문서 초안 작성
  • 개발 중 아이디어 정리

이처럼 CLI 환경에 익숙한 개발자에게는 접근 비용이 낮은 도구다.

Gemini CLI를 사용하는 이유

개발 환경에서는 브라우저를 전환하지 않고 빠르게 정보를 얻어야 하는 경우가 많다. 이때 Gemini CLI는 터미널 중심의 작업 흐름을 유지하는 데 도움이 된다.

또한 다음과 같은 장점이 있다.

  • 서버나 원격 환경에서도 사용 가능
  • 스크립트와 함께 자동화 가능
  • 반복 작업에 쉽게 결합 가능

결과적으로 CLI 기반 개발 환경과 잘 어울리는 도구라고 볼 수 있다.

Gemini CLI 사용을 위한 준비 사항

Gemini CLI를 사용하려면 몇 가지 사전 준비가 필요하다.

먼저 Google 계정과 Gemini API 사용 권한이 필요하다. 그 다음 API Key를 발급받아 로컬 환경에 설정해야 한다. 마지막으로 CLI 도구를 설치하면 기본 준비는 완료된다.

API 호출 기반으로 동작하기 때문에 인증 설정은 필수다.

Homebrew로 Gemini CLI 설치하기 (macOS)

macOS 환경에서는 Homebrew를 통해 Gemini CLI를 설치할 수 있다.

Homebrew 설치 확인

brew --version

만약 Homebrew가 설치되어 있지 않다면 공식 설치 스크립트를 먼저 실행해야 한다.

Gemini CLI 설치

brew install gemini-cli

설치가 끝난 뒤에는 명령어가 정상적으로 등록되었는지 확인한다.

gemini --version

Gemini API Key 설정

Gemini CLI는 API Key를 환경 변수로 사용한다. 따라서 키 값을 환경 변수로 등록해야 한다.

export GEMINI_API_KEY=your_api_key_here

zsh 또는 bash를 사용하는 경우 .zshrc 또는 .bashrc 파일에 추가해두면 편리하다.

echo 'export GEMINI_API_KEY=your_api_key_here' >> ~/.zshrc

이후 터미널을 다시 열거나 아래 명령어를 실행한다.

source ~/.zshrc

Gemini CLI 기본 사용 방법

단일 질문 요청

가장 기본적인 사용 방식은 단일 프롬프트 요청이다.

gemini prompt "Spring Boot에서 Redis는 어떤 용도로 사용되나요?"

그러면 Gemini 모델이 생성한 응답이 터미널에 바로 출력된다.

코드 설명 요청

여러 줄의 코드를 전달해 설명을 요청할 수도 있다. 이 경우 표준 입력을 활용한다.

gemini prompt "아래 Kotlin 코드를 설명해줘" <<EOF
fun sum(a: Int, b: Int): Int {
    return a + b
}
EOF

이 방식은 레거시 코드나 처음 보는 코드 분석에 유용하다.

로그 또는 에러 메시지 요약

또한 긴 에러 로그를 요약하는 데도 활용할 수 있다.

gemini prompt "다음 에러 로그를 요약하고 원인을 설명해줘" <<EOF
java.lang.OutOfMemoryError: Java heap space
	at java.util.Arrays.copyOf(Arrays.java:3332)
	at ...
EOF

이처럼 복잡한 로그를 빠르게 정리할 수 있다.

파일 기반 입력 예시

CLI 환경에서는 파일을 그대로 전달하는 방식도 자주 사용된다.

예를 들어 로그 파일을 전달하는 경우 다음과 같다.

cat error.log | gemini prompt "이 로그의 핵심 원인을 요약해줘"

또는 소스 파일 전체를 전달해 역할을 설명하게 할 수도 있다.

cat Service.kt | gemini prompt "이 Kotlin 서비스 코드의 역할을 설명해줘"

Gemini CLI 사용 시 주의할 점

Gemini CLI를 사용할 때는 몇 가지 주의가 필요하다.

먼저 API Key나 개인정보와 같은 민감한 정보는 입력하지 않는 것이 좋다. 또한 API 호출 비용이 발생할 수 있으므로 사용량 관리가 필요하다. 마지막으로 AI 응답은 참고 자료로 활용하고, 결과에 대한 검증은 반드시 수행해야 한다.

Gemini CLI가 적합한 사용 사례

다음과 같은 상황에서는 Gemini CLI의 활용도가 높다.

  • 터미널 중심 개발 환경
  • 서버 또는 원격 인프라 환경
  • 코드 이해, 로그 분석, 문서 초안 작성
  • 반복 작업에 대한 AI 보조 자동화

반면 긴 대화형 작업이나 복잡한 컨텍스트 관리가 필요한 경우에는 웹 UI가 더 적합할 수 있다.

정리

Gemini CLI는 Gemini 모델을 커맨드라인에서 바로 활용할 수 있는 도구다. Homebrew를 통한 설치와 환경 변수 설정만으로 빠르게 사용할 수 있으며, 코드 설명과 로그 요약 같은 일상적인 개발 작업에 도움을 준다. 따라서 터미널 중심으로 작업하는 개발자라면 실용적인 보조 도구로 활용할 수 있다.