# Gemini CLI 마스터하기(심화): v11 - 인터랙티브 모드 시작하기

이전 v1-v10 시리즈에서는 Gemini CLI를 통해 프롬프트를 보내고 텍스트 응답을 받는 '스크립트' 또는 '워크플로우' 중심의 활용법을 다루었습니다. 이제부터는 Gemini CLI를 한 차원 높은 'AI 에이전트'로 활용하는 **인터랙티브 모드**에 대해 심층적으로 알아보겠습니다.

그 첫 번째 단계로, 인터랙티브 모드가 무엇이며 왜 필요한지, 그리고 어떻게 시작하는지 알아보겠습니다.

---

## 1. 인터랙티브 모드란 무엇인가?

인터랙티브 모드는 Gemini CLI가 단순한 텍스트 생성기를 넘어, 웹 브라우저나 GitHub과 같은 외부 시스템과 상호작용하는 '에이전트'로서 동작하는 방식입니다. 이 모드에서 에이전트는 주어진 목표를 달성하기 위해 스스로 행동을 계획하지만, 실제로 그 행동을 실행하기 전에는 **반드시 사용자에게 제안하고 승인을 받습니다.**

이러한 '인간-참여형(Human-in-the-Loop)' 접근 방식은 AI 에이전트의 작업을 투명하게 만들고, 사용자가 모든 과정을 통제할 수 있도록 보장합니다.

**작동 방식:**

1.  **목표 제시:** 사용자가 에이전트에게 높은 수준의 목표를 부여합니다. (예: "이 GitHub 이슈를 분석하고 적절한 라벨을 붙여줘.")
2.  **행동 계획:** 에이전트는 목표를 달성하기 위해 필요한 행동을 계획합니다. (예: "GitHub API를 호출하여 'bug' 라벨을 추가한다.")
3.  **사용자에게 제안:** 에이전트는 계획된 행동을 실행하기 전에 사용자에게 "이러한 행동을 실행해도 될까요?"라고 제안합니다.
4.  **사용자 승인/거부:** 사용자는 웹 인터페이스를 통해 제안된 행동을 검토하고, 승인하거나 거부합니다.
5.  **행동 실행:** 사용자가 승인한 경우에만 에이전트는 실제 행동을 실행합니다.

## 2. 왜 인터랙티브 모드가 필요한가?

AI 에이전트가 파일 삭제, 댓글 작성, API 호출 등 외부 시스템에 영향을 미치는 작업을 수행할 때, 의도치 않은 실수는 큰 문제로 이어질 수 있습니다. 인터랙티브 모드는 이러한 위험을 방지하고 안전을 보장합니다.

*   **안전성(Safety):** 중요한 파일을 실수로 삭제하거나, 잘못된 정보를 게시하는 등의 사고를 예방합니다.
*   **제어권(Control):** 에이전트의 모든 행동에 대한 최종 결정권을 사용자가 가집니다. 사용자는 에이전트의 경로를 수정하거나, 더 나은 대안을 제시할 수 있습니다.
*   **투명성 및 신뢰(Transparency & Trust):** 에이전트가 어떤 판단을 내리는지 명확히 볼 수 있으므로, 시스템에 대한 신뢰를 구축할 수 있습니다.

## 3. 인터랙티브 모드 시작하기

인터랙티브 모드를 시작하는 과정은 간단한 환경 변수 설정과 특정 명령어로 이루어집니다.

### 단계 1: `INTERACTIVE` 환경 변수 설정

Gemini CLI 프레임워크가 인터랙티브 모드로 부팅되도록 `INTERACTIVE` 환경 변수를 `1`로 설정해야 합니다.

**Linux / macOS:**

```bash
export INTERACTIVE=1
```

**Windows (CMD):**

```bash
set INTERACTIVE=1
```

**Windows (PowerShell):**

```bash
$env:INTERACTIVE="1"
```

이 설정은 현재 터미널 세션에만 적용됩니다.

### 단계 2: `gemini web` 명령어로 웹 인터페이스 실행

환경 변수를 설정한 후, `gemini web` 명령어를 실행하여 로컬 웹 서버를 시작합니다.

```bash
gemini web
```

이 명령어를 실행하면, 터미널에 다음과 유사한 메시지가 출력되며 웹 서버가 특정 포트(예: `8080`)에서 실행됩니다.

```
* Serving Flask app 'gemini_web'
* Running on http://127.0.0.1:8080 (Press CTRL+C to quit)
```

### 단계 3: 웹 브라우저로 접속

웹 브라우저를 열고, 터미널에 출력된 주소(예: `http://127.0.0.1:8080` 또는 `http://localhost:8080`)로 접속합니다. 접속하면 Gemini CLI 인터랙티브 모드를 위한 웹 UI가 나타납니다.

## 4. 요약

이번 단계에서는 Gemini CLI를 안전하고 제어 가능한 AI 에이전트로 활용하기 위한 '인터랙티브 모드'의 개념과 필요성, 그리고 시작 방법을 알아보았습니다. `INTERACTIVE=1` 환경 변수를 설정하고 `gemini web` 명령어를 실행하면, 사용자가 모든 행동을 검토하고 승인할 수 있는 강력하고 안전한 작업 환경이 준비됩니다.

다음 단계에서는 `gemini web`을 실행했을 때 나타나는 웹 인터페이스의 각 구성 요소를 자세히 살펴보고, 실제 상호작용이 어떻게 이루어지는지 알아보겠습니다.