🤖 Gemini CLI 단계별 사용법 정리

Gemini CLI(Command Line Interface)는 터미널에서 직접 Gemini 모델의 강력한 기능을 사용할 수 있게 해주는 오픈 소스 AI 에이전트입니다. 코드 생성, 디버깅, 파일 처리 등 다양한 개발 작업을 자연어로 자동화할 수 있습니다.

Gemini CLI를 사용하려면 Node.js가 필요하며, npm을 사용해 설치합니다.

Node.js 설치: Node.js v18 이상 버전이 설치되어 있는지 확인합니다. 공식 웹사이트에서 다운로드하여 설치하거나, nvm 같은 버전 관리 도구를 사용할 수 있습니다.
Gemini CLI 설치: 터미널을 열고 다음 명령어를 입력하여 전역으로 설치합니다.
Bash
```
npm install -g @google/gemini-cli
```
버전 확인 (선택 사항): 설치 후 다음 명령어로 버전이 제대로 설치되었는지 확인해 볼 수 있습니다.
Bash
```
gemini -v
```

설치가 완료되면 gemini 명령어를 입력하여 CLI를 실행하고 인증을 진행합니다.

Gemini > 프롬프트에서 자연어 명령이나 슬래시(/) 명령어를 사용하여 CLI를 활용합니다.

일반적인 질문/요청: Gemini > 뒤에 원하는 내용을 자연어로 입력합니다.

Gemini > Write Python code using turtle to draw a blue circle with radius 100.
로컬 파일/경로 참조: @ 기호를 사용하여 현재 디렉터리에 있는 파일이나 경로를 AI 컨텍스트에 추가하여 질문합니다.

Gemini > @main.py Identify and fix the bug in this function

! 기호를 입력하면 시스템 쉘 모드로 전환되어 터미널 명령을 직접 실행할 수 있습니다.

Gemini > ! ls -l (현재 디렉토리의 파일 목록을 표시)

GEMINI.md 파일 활용: 프로젝트의 루트 디렉터리에 GEMINI.md 파일을 생성하여 프로젝트별 컨텍스트, 코딩 스타일, 규칙 등을 AI에게 미리 알려줄 수 있습니다. 이는 AI의 응답 정확도를 높이는 데 유용합니다.
설정 파일 (settings.json): 사용자 홈 디렉터리 (~/.gemini/settings.json)나 프로젝트 디렉터리 (.gemini/settings.json)에 설정 파일을 만들어 테마, 인증 방식, 도구 사용 여부 등을 세부적으로 설정할 수 있습니다.
매개변수 사용: gemini ask "질문" 형식으로 CLI를 실행하지 않고 한 줄 명령어로 질문하고 답을 받을 수 있습니다.

gemini ask "Identify and fix the bug in this function in utils.js" @utils.js

Gemini CLI의 설치 및 기본 활용 방법을 영상으로도 확인해 보실 수 있습니다.

Introducing Gemini CLI는 Gemini CLI를 소개하는 내용을 담고 있어 사용법을 시각적으로 이해하는 데 도움이 될 수 있습니다.

💻 VS Code에서 Gemini CLI 설정 및 연동 방법

Gemini CLI는 VS Code의 통합 터미널에서 실행할 때 “Gemini CLI Companion” 확장을 통해 코드 컨텍스트를 인식하는 깊은 통합을 제공합니다.

다음은 Gemini CLI를 VS Code에서 효과적으로 사용하도록 설정하는 단계입니다.

VS Code 연동을 진행하기 전에, 시스템에 Gemini CLI가 먼저 설치되어 있고 인증이 완료되어 있어야 합니다.

Node.js 설치: Node.js v18 이상 버전이 설치되어 있는지 확인합니다.
Gemini CLI 설치: 터미널에 다음 명령어를 입력하여 설치합니다.
Bash
```
npm install -g @google/gemini-cli
```
Gemini CLI 실행 및 인증:
- VS Code 외부 또는 내부 통합 터미널에서 gemini를 실행합니다.
- Google 로그인(OAuth) 또는 API 키를 사용하여 인증을 완료합니다.

Gemini CLI의 /ide install 명령어를 사용하여 필요한 VS Code 확장(Companion Extension)을 설치하고 IDE 통합을 활성화합니다.

VS Code 통합 터미널 열기:
- VS Code를 열고 Ctrl + Shift + ** (또는 macOS에서 **`Cmd` + `Shift` + )를 눌러 통합 터미널을 엽니다.
- 작업할 프로젝트 폴더를 연 상태여야 합니다.
Gemini CLI 실행: 통합 터미널에 gemini를 입력하고 실행합니다.
Companion 확장 설치: Gemini > 프롬프트에서 다음 명령어를 실행하여 “Gemini CLI Companion” 확장을 설치합니다.
Bash
```
/ide install
```
- 이 명령을 실행하면 필요한 VS Code 확장이 자동으로 설치되고, Gemini CLI가 VS Code 환경을 인식하도록 설정됩니다.

설치 후에는 명령어를 통해 VS Code와의 통합을 쉽게 켜고 끌 수 있으며, VS Code의 컨텍스트(열린 파일, 선택 영역)를 활용하여 Gemini CLI를 사용합니다.

통합 활성화 확인:
- /ide install 후에 통합이 자동으로 활성화되지 않았다면, 다음 명령어로 수동으로 활성화할 수 있습니다.
  Bash
  /ide enable
- (선택 사항) 통합을 비활성화하려면 /ide disable 명령어를 사용합니다.
컨텍스트 인식 활용:
- 파일 컨텍스트: VS Code에서 파일을 열어두면, Gemini CLI가 해당 파일의 내용을 인식하고 이에 기반한 답변을 제공합니다.
- 선택 영역 컨텍스트: 코드 블록을 **선택(드래그)**한 상태에서 Gemini CLI에 명령을 내리면, 선택된 코드 스니펫에 대해서만 작업을 수행합니다.
  
  Gemini > explain this snippet of code Gemini > find bug in selected text
네이티브 Diff 기능:
- Gemini CLI가 코드 변경을 제안할 때, VS Code의 Diff 편집기가 자동으로 열리면서 변경 사항을 Side-by-Side로 확인하고 수정하거나 수락/거부할 수 있습니다. 이는 CLI의 변경 제안을 IDE 내에서 검토하고 적용하는 데 매우 편리합니다.

VS Code와의 통합을 설정하는 과정을 Gemini CLI VSCode Setup: How to Use Gemini 2.5 Pro in VS Code 영상에서 시각적으로 확인할 수 있습니다.