Gemini CLI 설치 및 chat 하기

🚀 터미널에서 AI와 페어 프로그래밍하기: Gemini CLI 완벽 가이드

개발하다가 모르는 게 나오면 매번 브라우저를 켜고, 구글링하고, 다시 에디터로 돌아오시나요? 이제 그럴 필요가 없습니다.

오늘은 Google의 강력한 AI 모델인 Gemini를 내 터미널(Terminal)에 심어두고, 마치 사수와 대화하듯 코딩하는 방법을 소개합니다. 설치부터 자주 발생하는 에러 해결법까지 한 번에 정리했습니다.

 

1. 🛠️ 설치하기 (30초 컷)

Node.js가 설치된 환경이라면 npm으로 아주 간단하게 설치할 수 있습니다.

npm i -g @google/gemini-cli

 

 

2. 🔑 API 키 설정 (가장 중요!)

Gemini를 내 컴퓨터에서 부리려면(?) API 키가 필요합니다.

1. Google AI Studio에 접속해서 무료로 키를 발급받으세요.
2. 발급받은 키를 환경 변수로 등록해야 합니다. (매번 입력하면 귀찮으니까요!)

윈도우 PowerShell 기준:

$env:GEMINI_API_KEY="여러분의_API_키_붙여넣기"

 

 

💡 꿀팁: 위 명령어는 현재 창을 닫으면 사라집니다. 계속 쓰려면 윈도우 검색창에 '시스템 환경 변수 편집'을 검색해서 GEMINI_API_KEY를 새로 만들어 등록해 두세요.

3. 💻 실전 사용법: 딱 2개만 기억하세요

① 궁금한 건 바로 물어보기: gemini chat

개념이 헷갈리거나 간단한 코드가 필요할 때 사용합니다.

# 예시: JavaScript 배열 메서드 추천받기
gemini chat "자바스크립트에서 배열 중복 제거하는 가장 효율적인 방법은?"

# 예시: CSS 중앙 정렬 까먹었을 때
gemini chat "Flexbox로 div 정가운데 정렬하는 코드 줘."

 

 

 

② 내 코드 리뷰 & 리팩토링: gemini generate

이 기능이 진짜 치트키입니다. 파일 경로를 같이 적어주면 AI가 내 코드를 읽고 답변해 줍니다.

# 예시: 레거시 코드 해석 요청
gemini generate "이 코드가 무슨 역할을 하는지 주니어 눈높이로 설명해 줘." ./src/complex-utils.js

# 예시: 리팩토링 요청
gemini generate "이 함수를 화살표 함수로 바꾸고 가독성을 높여줘." ./src/old-function.js

 

 

---

🚨 트러블슈팅: 미리 알고 가면 당황하지 않는 에러들

설치하다 보면 마주칠 수 있는 에러들과 해결법입니다. (이것만 알아도 삽질 시간 1시간 줄입니다!)

Q1. You have exhausted your daily quota 에러가 떠요!

A. 모델을 바꿔보세요.
기본 모델의 하루 사용량이 꽉 찼다는 뜻입니다. 더 가볍고 빠른 Flash 모델을 명시적으로 지정하면 해결됩니다.

# --model 옵션 추가
gemini chat --model gemini-2.5-flash "안녕?"

 

Q2. Error executing tool write_file... 같은 로그가 떠요!

A. 무시하셔도 됩니다. (정상입니다)

Error executing tool write_file: Tool "write_file" not found in registry...

 

이건 Gemini가 "코드를 파일로 저장해 줄까?" 하고 시도하다가, 보안상 막혀있어서 실패했다는 내부 로그입니다. 코드 생성과 답변에는 전혀 문제가 없으니 안심하고 무시하세요.

 

Q3. Running in system directory 권한 경고가 떠요!

A. 사용자 폴더로 이동하세요.

C:\Windows\System32 같은 곳에서 실행하지 마시고, cd C:\Users\내이름 명령어로 내 사용자 폴더나 프로젝트 폴더로 이동해서 실행하면 깔끔하게 해결됩니다.

---

🎁 마무리

Gemini CLI는 단순한 도구가 아니라, 터미널 상주하는 친절한 AI 사수입니다.

• 문법이 헷갈릴 때
• 에러 로그 해석이 안 될 때
• 변수명이 도저히 안 떠오를 때