Gemini cli: 두 판 사이의 차이

기술노트
편집 요약 없음
 
(같은 사용자의 중간 판 5개는 보이지 않습니다)
11번째 줄: 11번째 줄:
* '''무료 플랜 지원''' – Gemini 2.5 Pro 모델 기반, 최대 1M 토큰 컨텍스트, 분당 60 요청, 하루 1,000 요청 무료
* '''무료 플랜 지원''' – Gemini 2.5 Pro 모델 기반, 최대 1M 토큰 컨텍스트, 분당 60 요청, 하루 1,000 요청 무료


---
----


== 🛠 설치 가이드 ==
== 🛠 설치 가이드 ==
22번째 줄: 22번째 줄:
* [https://nodejs.org/ Node.js 공식 사이트]에서 최신 버전을 다운로드 및 설치하세요.
* [https://nodejs.org/ Node.js 공식 사이트]에서 최신 버전을 다운로드 및 설치하세요.


=== 2. Gemini CLI 설치 ===
=== 2. Windows PowerShell 실행 정책 설정 ===
Windows에서 기본 PowerShell 정책(`Restricted`)은 스크립트 실행을 막습니다. Gemini CLI 설치나 실행 스크립트를 원활히 사용하려면 아래 명령을 관리자 권한 PowerShell에서 실행하세요.
 
<syntaxhighlight lang="powershell">
Set-ExecutionPolicy RemoteSigned
</syntaxhighlight>
 
* '''이유:''' 
  - 로컬에서 작성한 스크립트는 서명 없이 실행 가능 
  - 인터넷에서 내려받은 스크립트는 신뢰된 서명이 필요 
  - 보안을 유지하면서도 Gemini CLI 설치에 필요한 스크립트 실행을 허용 
=== 3. Gemini CLI 설치 ===


* '''전역 설치 (추천)'''
* '''전역 설치 (추천)'''
29번째 줄: 40번째 줄:
</syntaxhighlight>
</syntaxhighlight>


* '''npx 실행 (비설치)'''
----
<syntaxhighlight lang="bash">
npx @google/gemini-cli
</syntaxhighlight>
 
---


== 🔐 인증 및 실행 ==
== 🔐 인증 및 실행 ==
59번째 줄: 65번째 줄:
</syntaxhighlight>
</syntaxhighlight>


---
----


== 💻 기본 사용 예시 ==
== 💻 기본 사용 예시 ==


<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
gemini "Write a Python function that reads a CSV file"
작업하고자 하는 폴더에서 cmd 도스창으로 들어가서 또는
파워셀로 들어가서 gemini 실행
</syntaxhighlight>
</syntaxhighlight>


71번째 줄: 78번째 줄:
* <code>/tools</code> 명령으로 내장 기능 확인
* <code>/tools</code> 명령으로 내장 기능 확인


---
----


== 📋 주요 명령 및 기능 ==
== 📋 주요 명령 및 기능 ==
88번째 줄: 95번째 줄:
|}
|}


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


== ⚠️ 주의사항 ==
== 📚 참고 자료 ==
* Node.js 18 이상이 반드시 필요
* [https://kmong.com/self-marketing/539751/LUA54VnQsP 💼 개발 면접용 CS PDF]
* 초기 실행 시 Google 계정 인증 또는 API Key 필요
* [https://kmong.com/self-marketing/660133/0lzAfkXXMc 📕 IT 개발 필수 지식 기술노트 도서]
* 요청량 제한(무료 플랜)을 초과할 경우 에러가 발생할 수 있음
* [https://inf.run/o1NX 📦 AWS 클라우드 강의]
```
* [https://inf.run/rpX4 🤖 ChatGPT로 앱개발 강의]
* [https://www.yes24.com/product/goods/146051138 📘 컴퓨터구조 및 운영체제 도서]
* [https://www.yes24.com/Product/Goods/122536127 📘 백엔드 번역서]

2025년 7월 20일 (일) 23:58 기준 최신판

🌟 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. Windows PowerShell 실행 정책 설정

Windows에서 기본 PowerShell 정책(`Restricted`)은 스크립트 실행을 막습니다. Gemini CLI 설치나 실행 스크립트를 원활히 사용하려면 아래 명령을 관리자 권한 PowerShell에서 실행하세요.

Set-ExecutionPolicy RemoteSigned
  • 이유:
 - 로컬에서 작성한 스크립트는 서명 없이 실행 가능  
 - 인터넷에서 내려받은 스크립트는 신뢰된 서명이 필요  
 - 보안을 유지하면서도 Gemini CLI 설치에 필요한 스크립트 실행을 허용  

3. Gemini CLI 설치

  • 전역 설치 (추천)
npm install -g @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

💻 기본 사용 예시

작업하고자 하는 폴더에서 cmd 도스창으로 들어가서 또는 
파워셀로 들어가서 gemini 실행
  • 자연어로 코드 생성, 분석, 버그 수정 요청 가능
  • ! 명령으로 셸 명령 실행 (예: !ls -al)
  • /tools 명령으로 내장 기능 확인

📋 주요 명령 및 기능

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

📚 참고 자료