Gemini cli: 두 판 사이의 차이

기술노트
(새 문서: [Gemini CLI – 설치, 설정 및 사용 튜토리얼 (f‑Izv0ZIeQs)](https://www.youtube.com/watch?v=f-Izv0ZIeQs&utm_source=chatgpt.com) 아래는 영상 기준으로 간단하게 정리한 **Gemini CLI 설치 및 실행 가이드**입니다. 미디어위키에 바로 업로드하기 좋도록 구성했어요! --- ## == 1. Node.js 설치 확인 == ```bash node -v ``` * 버전이 **18 이상**이어야 정상 작동합니다. * 설치되지 않았다면 [Node.js 공식...)
 
편집 요약 없음
1번째 줄: 1번째 줄:
[Gemini CLI – 설치, 설정 및 사용 튜토리얼 (f‑Izv0ZIeQs)](https://www.youtube.com/watch?v=f-Izv0ZIeQs&utm_source=chatgpt.com)
== 🌟 Gemini CLI란? ==


아래는 영상 기준으로 간단하게 정리한 **Gemini CLI 설치 및 실행 가이드**입니다. 미디어위키에 바로 업로드하기 좋도록 구성했어요!
'''Gemini CLI'''는 구글의 차세대 AI 모델인 Gemini(제미니)를 터미널에서 간편하게 사용할 수 있는 명령줄 도구입니다. 
개발자는 별도의 웹 인터페이스 없이 CLI 환경에서 코드 생성, 분석, 명령 실행 등을 빠르게 수행할 수 있습니다.
 
=== 🔑 Gemini CLI의 특징 ===
* '''즉시 실행 가능''' – Node.js 환경만 있으면 설치 후 바로 사용 가능
* '''Google 계정 인증 또는 API Key 기반 사용''' – 로그인만으로 무료 요청 가능
* '''코드 생성·분석 셸 명령 지원''' – 자연어로 명령을 입력해 다양한 작업 수행
* '''내장 툴/확장 기능 지원''' – <code>/tools</code> 명령으로 파일, 셸, 검색 등의 기능 호출 가능
* '''무료 플랜 지원''' – Gemini 2.5 Pro 모델 기반, 최대 1M 토큰 컨텍스트, 분당 60 요청, 하루 1,000 요청 무료


---
---


## == 1. Node.js 설치 확인 ==
== 🛠 설치 가이드 ==


```bash
=== 1. Node.js 설치 확인 ===
<syntaxhighlight lang="bash">
node -v
node -v
```
</syntaxhighlight>
* Node.js 18 이상이 필요합니다.
* [https://nodejs.org/ Node.js 공식 사이트]에서 최신 버전을 다운로드 및 설치하세요.


* 버전이 **18 이상**이어야 정상 작동합니다.
=== 2. Gemini CLI 설치 ===
* 설치되지 않았다면 [Node.js 공식 웹사이트](https://nodejs.org/)에서 다운 후 설치하세요.


---
* '''전역 설치 (추천)'''
 
<syntaxhighlight lang="bash">
## == 2. Gemini CLI 설치 ==
 
### === 2-1. 전역 설치 ===
 
```bash
npm install -g @google/gemini-cli
npm install -g @google/gemini-cli
```
</syntaxhighlight>


### === 2-2. 또는 npx 방식 실행 ===
* '''npx 실행 (비설치)'''
 
<syntaxhighlight lang="bash">
```bash
npx @google/gemini-cli
npx @google/gemini-cli
```
</syntaxhighlight>


---
---


## == 3. CLI 실행 및 인증 ==
== 🔐 인증 및 실행 ==


```bash
=== 1. CLI 실행 ===
<syntaxhighlight lang="bash">
gemini
gemini
```
</syntaxhighlight>
* 최초 실행 시 브라우저가 열리고 '''Google 계정 인증'''을 진행합니다.


* 최초 실행 시 브라우저가 열리며, **Google 계정 인증** 과정을 거칩니다.
=== 2. API Key로 인증 (선택) ===
* 로그인 완료 터미널에 AI 프롬프트가 뜹니다. ([HackerNoon][1])
Google AI Studio에서 발급받은 API Key를 사용하려면 환경변수 설정 실행하세요.


---
* '''Linux/Mac'''
 
<syntaxhighlight lang="bash">
## == 4. 무료 플랜 및 API Key 옵션 ==
 
* **무료 계정 기반**:
 
  * 모델: Gemini 2.5 Pro
  * 최대 1M 토큰 컨텍스트
  * 분당 60회 요청, 일당 1,000회 무료 ([HackerNoon][1])
 
* **API Key 기반**:
 
```bash
export GEMINI_API_KEY="내_API_KEY"
export GEMINI_API_KEY="내_API_KEY"
gemini
gemini
```
</syntaxhighlight>


* Windows PowerShell:
* '''Windows PowerShell'''
 
<syntaxhighlight lang="powershell">
```powershell
$env:GEMINI_API_KEY="내_API_KEY"
$env:GEMINI_API_KEY="내_API_KEY"
gemini
gemini
```
</syntaxhighlight>
 
* API Key는 Google AI Studio에서 발급받을 수 있습니다. ([HackerNoon][1])


---
---


## == 5. 기본 사용 예시 ==
== 💻 기본 사용 예시 ==


```bash
<syntaxhighlight lang="bash">
gemini "Write a Python function that reads a CSV file"
gemini "Write a Python function that reads a CSV file"
```
</syntaxhighlight>


* Gemini가 코드 생성, 분석, 버그 수정 등을 수행합니다.
* 자연어로 코드 생성, 분석, 버그 수정 요청 가능 
* `!`로 시작하면 명령도 실행 가능 (예: `!ls -al`) ([HackerNoon][1])
* <code>!</code> 명령으로 명령 실행 (예: <code>!ls -al</code>)
* <code>/tools</code> 명령으로 내장 기능 확인


---
---


## == 6. 내장 툴 고급 기능 ==
== 📋 주요 명령 및 기능 ==
 
* `/tools` 명령으로 사용 가능한 도구 확인 가능:
 
  * 파일 읽기, 검색, 편집, 셸 실행, 웹 검색 등 ([HackerNoon][1])
 
* **MCP (Model Context Protocol)** 확장 기능도 활용 가능.


  * `.gemini/settings.json` 파일에 서버 설정을 추가해 사용합니다. ([HackerNoon][1])
{| class="wikitable"
|+ '''Gemini CLI 주요 기능'''
! 명령 !! 설명 !! 예시
|-
| 자연어 입력 || 코드 생성/분석 || <code>gemini "Explain binary search in Python"</code>
|-
| !명령 || 셸 명령 실행 || <code>!pwd</code>
|-
| /tools || 내장 도구 확인 || <code>/tools</code>
|-
| /mcp || MCP 확장 관리 || <code>/mcp</code>
|}


---
---


## == 7. 미디어위키 마크업 예시 ==
== ✅ 장점 ==
* 빠른 실행과 간편한 설정
* 코드 작성·분석, CLI 환경에서 AI 활용
* 무료 플랜 지원으로 부담 없이 사용 가능


== ⚠️ 주의사항 ==
* Node.js 18 이상이 반드시 필요
* 초기 실행 시 Google 계정 인증 또는 API Key 필요
* 요청량 제한(무료 플랜)을 초과할 경우 에러가 발생할 수 있음
```
```
<syntaxhighlight lang="bash">
npm install -g @google/gemini-cli
gemini
</syntaxhighlight>
<syntaxhighlight lang="bash">
// 또는 API Key 인증
export GEMINI_API_KEY="내_API_KEY"
gemini
</syntaxhighlight>
```
---
## == 8. 요약 ==
| 단계 | 설명                                                |
| -- | -------------------------------------------------- |
| 1  | Node.js (v18+) 설치 확인                              |
| 2  | `npm install -g @google/gemini-cli` 또는 `npx` 방식 실행 |
| 3  | `gemini` 실행 후 인증                                  |
| 4  | 무료 플랜 또는 API Key 인증                                |
| 5  | 자연어 입력 → 코드 생성, 분석, 셸 작업 등 가능                      |
---
더 필요한 부분, 예를 들어 **미디어위키 전용 전체 마크업**, **MCP 설정 예시**, 또는 **한국어 설명 보강** 원하시면 언제든 말씀해주세요! 😊
[1]: https://hackernoon.com/complete-gemini-cli-setup-guide-for-your-terminal?utm_source=chatgpt.com "Complete Gemini CLI Setup Guide for Your Terminal - HackerNoon"

2025년 7월 19일 (토) 09:15 판

🌟 Gemini CLI란?

Gemini CLI는 구글의 차세대 AI 모델인 Gemini(제미니)를 터미널에서 간편하게 사용할 수 있는 명령줄 도구입니다. 개발자는 별도의 웹 인터페이스 없이 CLI 환경에서 코드 생성, 분석, 명령 실행 등을 빠르게 수행할 수 있습니다.

🔑 Gemini CLI의 특징

  • 즉시 실행 가능 – Node.js 환경만 있으면 설치 후 바로 사용 가능
  • Google 계정 인증 또는 API Key 기반 사용 – 로그인만으로 무료 요청 가능
  • 코드 생성·분석 및 셸 명령 지원 – 자연어로 명령을 입력해 다양한 작업 수행
  • 내장 툴/확장 기능 지원/tools 명령으로 파일, 셸, 검색 등의 기능 호출 가능
  • 무료 플랜 지원 – Gemini 2.5 Pro 모델 기반, 최대 1M 토큰 컨텍스트, 분당 60 요청, 하루 1,000 요청 무료

---

🛠 설치 가이드

1. Node.js 설치 확인

node -v

2. Gemini CLI 설치

  • 전역 설치 (추천)
npm install -g @google/gemini-cli
  • npx 실행 (비설치)
npx @google/gemini-cli

---

🔐 인증 및 실행

1. CLI 실행

gemini
  • 최초 실행 시 브라우저가 열리고 Google 계정 인증을 진행합니다.

2. API Key로 인증 (선택)

Google AI Studio에서 발급받은 API Key를 사용하려면 환경변수 설정 후 실행하세요.

  • Linux/Mac
export GEMINI_API_KEY="내_API_KEY"
gemini
  • Windows PowerShell
$env:GEMINI_API_KEY="내_API_KEY"
gemini

---

💻 기본 사용 예시

gemini "Write a Python function that reads a CSV file"
  • 자연어로 코드 생성, 분석, 버그 수정 요청 가능
  • ! 명령으로 셸 명령 실행 (예: !ls -al)
  • /tools 명령으로 내장 기능 확인

---

📋 주요 명령 및 기능

Gemini CLI 주요 기능
명령 설명 예시
자연어 입력 코드 생성/분석 gemini "Explain binary search in Python"
!명령 셸 명령 실행 !pwd
/tools 내장 도구 확인 /tools
/mcp MCP 확장 관리 /mcp

---

✅ 장점

  • 빠른 실행과 간편한 설정
  • 코드 작성·분석, CLI 환경에서 AI 활용
  • 무료 플랜 지원으로 부담 없이 사용 가능

⚠️ 주의사항

  • Node.js 18 이상이 반드시 필요
  • 초기 실행 시 Google 계정 인증 또는 API Key 필요
  • 요청량 제한(무료 플랜)을 초과할 경우 에러가 발생할 수 있음

```