Skip to main content

Windows Terminal + Git Bash + Gemini API 설정 가이드

등록일: 2026. 4. 5. 10:44

본 문서는 윈도우 환경에서 Windows Terminal을 활용한 Git Bash 최적화 및 Gemini 3.0 Flash 모델의 기본 설정 방법을 기술함.

1. Windows Terminal에서 Git Bash 프로필 설정​

Windows Terminal의 세련된 UI에서 Git Bash의 Linux 명령어를 사용하기 위한 설정임.

  1. Windows Terminal 실행 후 Ctrl + ,를 눌러 설정 창을 엶.
  2. 좌측 메뉴 하단의 [새 프로필 추가] -> [새 빈 프로필]을 클릭함.
  3. 아래 항목들을 입력함:
    • 이름: Git Bash
    • 명령줄: "C:\Program Files\Git\bin\bash.exe" -i -l
    • 시작 디렉터리: %USERPROFILE% (또는 원하는 작업 폴더)
    • 아이콘: C:\Program Files\Git\mingw64\share\git\git-for-windows.ico
  4. [모양] 설정에서 글꼴을 D2Coding으로 변경하고 저장함.

2. 프로젝트별 전용 바로 가기 만들기​

특정 폴더에서 특정 프로필로 즉시 실행되는 바로 가기 생성 방법임.

  1. 바탕 화면 우클릭 -> [새로 만들기] -> [바로 가기]를 선택함.
  2. 항목 위치 입력에 아래 형식을 맞춰 입력함: wt.exe -p "Git Bash" -d "C:\내_프로젝트_경로"
  3. 바로 가기 이름을 설정하고 완료함. (예: Gemini_Project_A)

3. Gemini 3.0 Flash 모델 기본값 고정 (Export)​

CLI 사용 시 매번 모델을 지정하지 않아도 되도록 환경 변수를 설정함.

  1. Git Bash (Windows Terminal)를 실행함.
  2. 홈 디렉토리의 .bashrc 파일을 편집기로 염: nano ~/.bashrc
  3. 파일 맨 아래에 다음 내용을 추가함: 
    # Gemini CLI 모델 고정 (도구에 따라 변수명 확인 필요)
    export GEMINI_MODEL="gemini-3.0-flash"

    # 폐쇄망 프록시 설정이 필요한 경우 (필요 시 주석 해제)
    # export http_proxy="http://proxy.server:port"
    # export https_proxy="http://proxy.server:port"
  4. 저장(Ctrl + O, Enter) 후 종료(Ctrl + X)함.
  5. 설정을 즉시 적용함: source ~/.bashrc

💡 설정 확인 팁​

터미널에서 아래 명령어를 입력하여 설정한 모델명이 출력되면 성공임! echo $GEMINI_MODEL