02-GeminiCLI

1. GeminiCLI

Note

공식깃허브링크 Gemini CLI

Gemini CLI는 Gemini는 터미널에서 직접 사용할 수 있도록 해주는 오픈 소스 AI 에이전트이다. Gemini에 간편하게 접근할 수 있다.

1.1. 특징

🎯 무료 요금제 : 개인 Google 계정으로 분당 60건, 하루 1,000건의 요청이 가능합니다.

🧠 강력한 Gemini 2.5 Pro : 100만 토큰 컨텍스트 창에 액세스 가능.

🔧 내장 도구 : Google 검색 기반 작업, 파일 작업, 셸 명령, 웹 가져오기.

🔌 확장성 : 사용자 정의 통합을 위한 MCP(모델 컨텍스트 프로토콜) 지원.

💻 터미널 우선 : 명령줄 환경에서 주로 작업하는 개발자를 위해 설계되었습니다.

🛡️ 오픈 소스 : Apache 2.0 라이선스 적용.

1.2. 설치환경

Node.js 버전 20 이상 macOS, Linux 또는 Windows

1.3. 설치하기

1. 윈도우

   npx https://github.com/google-gemini/gemini-cli

2. MAC

   brew install gemini-cli

1.4. 구글로그인 인증

1. 터미널에 gemini 입력 후 엔터.

2. 화면에 질문이 나오면 방향키로 선택:

3. How would you like to authenticate? -> Login with Google 선택.

4. 자동으로 열리는 웹 브라우저에서 구글 계정 클릭 및 권한 허용.

5. 터미널에 Authenticated successfully! 메시지 확인.

1.5. 실행

터미널에 아래의 명령어 입력

gemini

1.6. Gemini CLI 명령어

1.6.1. 설치 및 실행 (Terminal)

구분	명령어 (Command)	설명
설치	npm install -g @google/gemini-cli	도구 설치 (최초 1회)
실행	gemini chat	대화 시작
버전	gemini --version	설치된 버전 확인

1.6.2. 대화 제어 (In-Chat)

명령어	기능 설명
/clear	대화 내역 지우기 (화면 청소)
/history	이전 대화 목록 불러오기
/model	사용 중인 모델 확인/변경
/exit	대화 종료
/settings	사용자 설정 파일 열기

1.6.3. 고급 기능 (Context)

구분	사용법	설명
파일 참조	@파일명	해당 파일을 읽고 답변에 참고함 (예: @data.csv 이 데이터 분석해줘)
페르소나	GEMINI.md	폴더에 이 파일을 만들면 전역 설정(System Prompt)으로 작동
단축키	커스텀	/settings에서 등록한 나만의 명령어 사용

1.7. 활용

Note

예제링크

1.7.1. 파일명 일괄변경

1. 아래의 구조처럼 파일을 준비

photos/photo1.png
photos/photo2.png
photos/photo3.png

2. 터미널 창에 명령어 입력

gemini
Rename the photos in my "photos" directory based on their contents.

3. 제미나이가 권한 요청시 허용