[Gemini CLI] Gemini CLI 실전 사용 가이드 (기본편)

AI를 활용해 테스트 코드를 만들어보고 싶다는 생각에서 여러 AI 도구들을 살펴보던 중 Gemini CLI를 알게 되었다.

터미널 환경에서 바로 사용할 수 있고, 프로젝트 맥락을 함께 가져갈 수 있다는 점이 인상적이어서
이번 글에서는 Gemini CLI의 기본적인 사용법을 정리해보려고 한다.

 

☑️ Gemini CLI란?

Gemini CLI는 터미널에서 실행하는 AI 도구로, 현재 디렉터리(프로젝트)를 기준으로 파일을 읽고 그 맥락을 바탕으로 질문에 답하거나 작업을 수행할 수 있다.

 

예를 들어,

• 특정 파일이나 디렉터리 기준으로 코드 요약
• 프로젝트 전체에서 키워드 검색
• Controller 코드를 기준으로 테스트 코드 초안 생성

같은 작업을 IDE를 벗어나지 않고 터미널에서 바로 처리할 수 있다.

 

☑️ 설치 및 실행 (mac 기준)

1. gemini cli 설치

brew install gemini

 

2. gemini 실행

gemini

이렇게 터미널 환경에 할 수 있습니다.

또한 인텔리제이 터미널창에서도 사용할 수 있습니다.

 

☑️ 자주 사용하는 명령어

명렁어	설명
/search	프로젝트 전체 검색
/model	사용할 모델 확인/변경
/setting	현재 설정 확인
/compact	대화 내용을 간단히 정리

 

☑️ 설정 파일 (선택)

GEMINI.md

►프로젝트 루트에 GEMINI.md 파일을 두고 Gemini CLI 사용 시 지켜야 할 규칙을 간단히 정리

# Gemini CLI Usage Rules

- 테스트 코드 생성 시 기존 코드의 동작을 변경하지 않는다.
- 추측으로 로직이나 응답 값을 생성하지 않는다.
- 프로젝트 외부 파일은 분석 대상에서 제외한다.

 

settings.json

프로젝트 단위 설정을 위해 settings.json을 사용할 수 있다.

{
  // CLI 실행 시 기본으로 사용할 모델
  "model": "gemini-3-flash-preview",

  // Gemini CLI 기능 활성화 옵션
  "features": {
    "preview": true,
    "extensions": true,
    "search": true
  },

  // 답변 성향 관련 파라미터
  "parameters": {
    // 0에 가까울수록 보수적, 높을수록 창의적인 답변
    // 테스트 코드 생성 시에는 0.2~0.3 권장
    "temperature": 0.5,
    "maxOutputTokens": 2048,
    "topP": 0.9
  },

  // 프로젝트 기준 설정
  "project": {
    "root": "./",

    // Gemini가 읽지 말아야 할 경로
    "exclude": [
      "node_modules/**",
      "dist/**",
      "build/**",
      ".git/**",
      "*.log"
    ],

    // 분석 대상으로 포함할 파일
    "include": [
      "src/**",
      "docs/**/*.md"
    ]
  },

  // 대화 컨텍스트 관련 설정
  "context": {
    // 이전 대화를 기억할지 여부
    // 팀 단위 사용 시에는 false를 권장
    "rememberSession": true,
    "maxHistoryLines": 50
  },

  // 사용 로그 및 분석 데이터 전송 여부
  "telemetry": false
}

위 설정은 Gemini CLI를 프로젝트 단위로 사용하기 위한 예시이다.

include / exclude 설정을 통해 Gemini가 분석할 파일 범위를 명확히 제한하고 temperature 값을 조절해 답변의 성향을 제어할 수 있다.

테스트 코드처럼 정확성이 중요한 작업에서는 temperature 값을 더 낮게 설정하는 것이 좋으며, 아이디어 정리나 구조 설계 단계에서는

상황에 따라 값을 조정해 사용할 수 있다.