> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini CLI

> Gemini CLI를 EvoLink.AI에 연결하기

## 개요

<img src="https://mintcdn.com/muyutechnology/ogYegfyiYikRHauR/images/integration-guide/image-2.png?fit=max&auto=format&n=ogYegfyiYikRHauR&q=85&s=164ba3d3b5cdc5deaff461189e96ba50" alt="Gemini CLI Interface" width="1711" height="578" data-path="images/integration-guide/image-2.png" />

Gemini CLI는 터미널에서 Gemini 모델과 상호작용하기 위한 Google 공식 커맨드라인 도구입니다.
Gemini CLI를 **EvoLink API**와 통합하면 공식 모델 제한을 넘어 **Gemini, GPT, Claude** 시리즈 모델을 포함한 EvoLink의 다양한 모델 세트에 하나의 진입점으로 접근할 수 있습니다.

## 사전 준비

설정하기 전에 다음 사항을 확인하세요:

### 1. Node.js 및 npm 설치

**왜 필요한가요?** Node.js는 CLI 도구의 런타임 환경입니다 (휴대폰에 카카오톡을 설치해야 채팅할 수 있듯이, 컴퓨터에 Node.js를 설치해야 CLI 도구를 실행할 수 있습니다).

**이미 설치된 경우:** `node -v` 및 `npm -v`를 실행하여 버전을 확인하세요. v20 이상이면 이 단계를 건너뛰세요.

**처음 설치하는 경우:**

* [Node.js 공식 웹사이트](https://nodejs.org/)에서 다운로드 및 설치 (LTS 버전 권장)
* 설치 과정이 익숙하지 않다면 [Runoob - Node.js 설치 가이드](https://www.runoob.com/nodejs/nodejs-install-setup.html)를 참고하세요
* 권장: **Node.js v20 이상**
* 설치 확인:

```bash theme={null}
node -v
npm -v
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/claude-node-npm-verify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=13be4f60f117fca3024b2b2c1d0fd208" alt="Node.js and npm version verification" width="1730" height="923" data-path="images/integration-guide/claude-node-npm-verify.png" />

### 2. EvoLink API Key 발급

* [EvoLink Dashboard](https://evolink.ai/dashboard)에 로그인
* 대시보드에서 API Keys를 찾아 '새 키 생성' 버튼을 클릭한 후 생성된 Key를 복사
* API Key는 보통 `sk-`로 시작합니다

## 1단계: Gemini CLI 설치

<Note>
  **팁:** 커맨드라인 터미널을 여는 방법을 모르시면 [FAQ - 커맨드라인 터미널 여는 방법](#13-커맨드라인-터미널-여는-방법)을 참고하세요
</Note>

### 1. 설치 명령어

```bash theme={null}
npm install -g @google/gemini-cli
```

**예상 결과:** 다운로드 정보가 스크롤되며 마지막에 `added XX packages`가 표시됩니다 (1\~3분 소요).

**오류 발생 시:** `permission denied`이 나타나면 Windows에서는 "관리자 권한으로 실행"한 PowerShell을 사용하고, macOS/Linux에서는 명령어 앞에 `sudo`를 추가하세요.

### 2. 설치 확인

```bash theme={null}
gemini --version
```

**성공 표시:** 버전 번호가 표시됩니다 (예: `1.x.x`).

<img src="https://mintcdn.com/muyutechnology/ImpSKD1BzFmyJCJ-/images/integration-guide/gemini-version.png?fit=max&auto=format&n=ImpSKD1BzFmyJCJ-&q=85&s=3fd01705c8f519f6d81ba1fb78d25cb2" alt="Gemini CLI Version" width="1730" height="923" data-path="images/integration-guide/gemini-version.png" />

## 2단계: EvoLink API 설정

**⚠️ 중요:** Gemini CLI 설정은 다른 도구보다 **약간 더 복잡**하며, 설치 파일을 수정해야 합니다. 프로그래밍이 처음이라면 먼저 **Claude CLI** 또는 **Codex CLI** 사용을 고려해 보세요 (설정이 더 간단합니다).

### 1. 설치 디렉토리 찾기

```bash theme={null}
npm root -g
```

**다음과 같은 경로가 표시됩니다:**

* Windows: `C:\Users\YourUsername\AppData\Roaming\npm\node_modules`
* macOS: `/usr/local/lib/node_modules`
* Linux: `/usr/lib/node_modules`

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-find-install-dir.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=b532f9ef42e03905f6b23a216debb194" alt="Find Gemini CLI installation directory" width="1730" height="923" data-path="images/integration-guide/gemini-find-install-dir.png" />

### 2. API 엔드포인트 수정

2개의 파일을 수정합니다:

<img src="https://mintcdn.com/muyutechnology/ImpSKD1BzFmyJCJ-/images/integration-guide/gemini-modify-api.png?fit=max&auto=format&n=ImpSKD1BzFmyJCJ-&q=85&s=02aaff8284dabd21e029e42b85310dd5" alt="File location" width="1028" height="236" data-path="images/integration-guide/gemini-modify-api.png" />

**파일 1:** `{install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.mjs`

**\~11222** 번째 줄을 찾으세요:

```javascript theme={null}
// Before
initHttpOptions.baseUrl = `https://generativelanguage.googleapis.com/`;

// After
initHttpOptions.baseUrl = `https://direct.evolink.ai/`;
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-mjs-modify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=5ba761a74f73a50df86f72a2303c2087" alt="Modify mjs file" width="1302" height="896" data-path="images/integration-guide/gemini-mjs-modify.png" />

**파일 2:** `{install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.cjs`

**\~11244** 번째 줄을 찾아 동일하게 수정합니다.

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-cjs-modify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=84ee7886704faaebddad7b44a565e285" alt="Modify cjs file" width="1301" height="865" data-path="images/integration-guide/gemini-cjs-modify.png" />

### 3. API Key 설정

<Tabs>
  <Tab title="Windows PowerShell">
    **임시 (현재 세션만)**

    ```powershell theme={null}
    $env:GEMINI_API_KEY = "your-evolink-api-key"
    ```

    **영구 설정**

    ```powershell theme={null}
    [Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your-evolink-api-key", "User")
    ```

    변경 사항을 적용하려면 터미널을 재시작하세요.

    **설정 확인**

    ```powershell theme={null}
    echo $env:GEMINI_API_KEY
    ```

    API Key가 출력되면 설정이 완료된 것입니다.

    <img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-check-env.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=588d9271f5c882ec0fbdd463f12877e1" alt="Check environment variable" width="1730" height="923" data-path="images/integration-guide/gemini-check-env.png" />
  </Tab>

  <Tab title="macOS / Linux">
    **임시 (현재 세션만)**

    ```bash theme={null}
    export GEMINI_API_KEY="your-evolink-api-key"
    ```

    **영구 설정**
    `~/.bashrc` 또는 `~/.zshrc`를 편집하여 다음을 추가하세요:

    ```bash theme={null}
    export GEMINI_API_KEY="your-evolink-api-key"
    ```

    그런 다음 `source ~/.bashrc` 또는 `source ~/.zshrc`를 실행하여 적용하거나 터미널을 재시작하세요.

    **설정 확인**

    ```bash theme={null}
    echo $GEMINI_API_KEY
    ```

    API Key가 출력되면 설정이 완료된 것입니다.
  </Tab>
</Tabs>

## 3단계: Gemini CLI 사용 시작

### 1. 작업 디렉토리로 이동

```shell theme={null}
cd your-working-directory
```

**참고:** `your-working-directory`를 실제 경로로 바꾸세요

### 2. 단일 질의 모드

```shell theme={null}
gemini "Who are you"
```

### 3. 대화형 모드

```shell theme={null}
gemini
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-interface.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=390483a8f111f322165b81ff8bbe0626" alt="Gemini CLI Interface" width="1730" height="923" data-path="images/integration-guide/gemini-interface.png" />

**성공 표시:**

* AI 응답 텍스트가 표시됨 (여러 줄)
* `401`, `403`, `API Key invalid` 같은 오류가 **없음**

**오류가 표시되는 경우:**

* `401 Unauthorized`: API Key가 설정되지 않았거나 유효하지 않음 → 환경 변수를 확인하세요
* `403 Forbidden`: API Key 권한 부족 → API 엔드포인트 수정을 확인하세요
* `Network error`: 네트워크 문제 → 연결 상태를 확인하세요

## FAQ

### 1. Gemini CLI란 무엇이며 어디에 사용하나요?

Gemini CLI는 터미널에서 Gemini 모델과 상호작용하기 위한 Google 공식 커맨드라인 도구입니다. EvoLink 설정을 통해 GPT, Claude 및 기타 모델에도 접근할 수 있습니다.

### 2. 처음 사용 시 설치 및 설정을 어떻게 확인하나요?

다음 명령어를 순서대로 실행하세요:

* `node -v` 및 `npm -v`: Node.js와 npm 설치 확인
* `gemini --version`: Gemini CLI 설치 확인
* `gemini "Who are you"`: API 설정이 올바른지 확인

### 3. 대화형 모드와 단일 명령어 모드의 차이점은 무엇인가요?

* **대화형 모드**: `gemini`를 실행하여 다중 턴 대화를 위한 연속 대화에 진입
* **단일 명령어 모드**: `gemini "질문"`을 실행하여 단일 응답을 받고 종료

### 4. Gemini CLI가 자동으로 로컬 파일과 코드를 읽거나 업로드하나요?

아니요. Gemini CLI는 사용자가 명시적으로 참조하거나 승인한 경우에만 파일 내용을 읽습니다. 전용 프로젝트 폴더에서 사용하는 것을 권장합니다.

### 5. Gemini CLI로 로컬 파일 내용을 분석하려면 어떻게 하나요?

대화형 모드에서 다음과 같이 파일을 참조할 수 있습니다:

* 파일 경로를 입력하여 Gemini가 읽도록 함
* 터미널 창에 파일을 드래그 앤 드롭

### 6. Gemini CLI는 한국어 입출력을 지원하나요?

네, 완벽하게 지원됩니다.

### 7. 실행 후 출력이 없는 경우 원인은 무엇인가요?

일반적인 원인:

* 네트워크 연결 문제
* 유효하지 않은 API Key 또는 잔액 부족
* 잘못된 API 엔드포인트 설정
* 방화벽 또는 프록시가 요청을 차단

### 8. API 엔드포인트 또는 환경 변수 변경이 적용되지 않는 이유는 무엇인가요?

* 터미널 또는 커맨드라인 창을 재시작하세요
* `GEMINI_API_KEY` 환경 변수가 올바르게 설정되었는지 확인하세요
* API 엔드포인트 파일이 올바르게 수정되었는지 확인하세요 (node\_modules의 .mjs 및 .cjs 파일을 수정해야 합니다)

### 9. 401/403 오류의 원인은 무엇인가요?

* **401 오류**: `GEMINI_API_KEY`가 설정되지 않았거나 유효하지 않음
* **403 오류**: 권한 부족 또는 만료된 키
* API 엔드포인트가 `https://direct.evolink.ai/`인지 확인하세요

### 10. Gemini CLI는 어떤 시나리오에 적합한가요?

**적합한 경우:**

* 코드 작성, 디버깅 및 리팩토링
* 커맨드라인 환경에서의 빠른 질의응답
* 파일 내용 분석
* 자동화 스크립트 통합

**적합하지 않은 경우:**

* 복잡한 GUI 상호작용
* 실시간 협업 편집
* 대규모 배치 파일 처리

### 11. 모델을 어떻게 전환하나요?

대화형 모드에서 `/model`을 입력하세요.

<img src="https://mintcdn.com/muyutechnology/ogYegfyiYikRHauR/images/integration-guide/image-3.png?fit=max&auto=format&n=ogYegfyiYikRHauR&q=85&s=9fd12b04bfc76875a9652b480a44b786" alt="Gemini CLI Switch Model" width="1280" height="570" data-path="images/integration-guide/image-3.png" />

사용 가능한 모델:

* `gemini-2.5-pro`
* `gemini-2.5-flash`
* `gemini-3-pro-preview`
* `gemini-3-flash-preview`

### 12. 이미지를 어떻게 업로드하나요?

* 방법 1: 이미지 경로를 참조
* 방법 2: 터미널에 이미지를 드래그 앤 드롭

모든 방법은 사용자의 조작이 필요합니다. Gemini CLI는 자동으로 로컬 이미지를 읽거나 업로드하지 않습니다.

### 13. 커맨드라인 터미널 여는 방법

<Tabs>
  <Tab title="Windows">
    * 방법 1: `Win + R`을 누르고 `cmd` 또는 `powershell`을 입력한 후 Enter를 누르세요
    * 방법 2: 시작 메뉴에서 "명령 프롬프트" 또는 "PowerShell"을 검색하세요
    * 방법 3: 폴더에서 Shift를 누른 채 마우스 오른쪽 버튼을 클릭하고 "여기에 PowerShell 창 열기"를 선택하세요
  </Tab>

  <Tab title="macOS">
    * 방법 1: `Command + Space`를 눌러 Spotlight를 열고 `Terminal`을 입력한 후 Enter를 누르세요
    * 방법 2: "응용 프로그램" → "유틸리티" → "터미널"로 이동하세요
  </Tab>

  <Tab title="Linux">
    * 방법 1: `Ctrl + Alt + T` 단축키를 누르세요
    * 방법 2: 애플리케이션 메뉴에서 "Terminal"을 검색하세요
  </Tab>
</Tabs>

## 주의사항

<Warning>
  Gemini CLI는 전용 프로젝트 폴더에서 실행하세요. 민감한 디렉토리(시스템 폴더 또는 자격 증명이 포함된 디렉토리 등)에서 실행하지 마세요. Gemini CLI는 현재 작업 디렉토리를 기준으로 작동합니다.
</Warning>