Gemini CLI 설치와 사용법: Google 로그인과 첫 코딩 작업

공식 절차로 Gemini CLI를 설치하고 Google로 로그인한 뒤, 현재 저장소에서 첫 코딩 작업을 끝낸다.

터미널에서 Gemini로 저장소를 읽고 코드를 고치려면 세 가지를 먼저 끝낸다. Gemini CLI를 설치하고, Google 계정으로 로그인한 뒤, 현재 프로젝트에서 첫 코딩 작업을 끝낸다.

공식 시작 경로를 따르고 명령을 짐작하지 않는다. 검색어는 Gemini CLI 설치, Gemini CLI Google 로그인, 명령 gemini. 문서는 geminicli.com/docs/get-started/.

런타임을 맞춘 뒤 설치 경로를 고른다

설치, 로그인, 첫 코딩

1. 01
   Node를 확인하고 설치한다

   공식은 Node.js 20.0.0+, macOS 15+, Windows 11 24H2+, Ubuntu 20.04+를 적는다. 설치 후 gemini를 실행하고 인증 프롬프트를 기다린다.

2. 02
   Google로 로그인한다

   1. Sign in with Google을 고르고 계정을 선택한 뒤 Sign in. 자격 증명은 로컬에 남는다. 회사 계정이 프로젝트를 요구하면 다음 세션 전에 환경 변수를 넣는다.

3. 03
   저장소에서 한 건을 끝낸다

   프로젝트 루트에서 gemini를 연다. 먼저 진입 파일의 읽기 전용 설명을 받는다. 그다음 공식 예처럼 기존 모듈에 단위 테스트를 쓰거나 작은 변경을 제안하게 한다.

4. 04
   쓰기 전에 diff를 본다

   CLI는 파일을 고치거나 부작용 있는 명령을 돌리기 전에 묻는다. Allow once를 고르고 기본으로 영구 허용하지 않는다. 할당량은 /stats model.

node -v
npm install -g @google/gemini-cli
gemini
# 로그인 후 저장소 루트에서 예:
# Read the entry file and explain how the app starts.
# Then write unit tests for Login.js and wait before writing files.

개인 Google 계정에 Cloud 프로젝트가 꼭 필요한가?

공식은 대부분의 개인 계정에는 필요 없다고 적는다. 회사, 학교, Workspace는 보통 필요하다. 공식 예외에 해당하면 개인도 프로젝트를 요구받을 수 있다.

로그인 페이지가 열리지 않는다.

OAuth는 브라우저를 CLI가 듣는 localhost로 되돌린다. 원격 SSH, 화면 없는 호스트, localhost를 막는 망에서는 실패한다. Gemini API 키를 쓰거나 브라우저가 열리는 기기에서 로그인한다.

첫 코딩 작업은 얼마나 커야 하는가?

바로 테스트하거나 diff로 볼 수 있는 일로 고른다. 공식 예는 Login.js 테스트, 또는 chalk를 클론하고 소스를 설명하는 것이다. 처음부터 저장소 전체 재작성을 시키지 않는다.

설치하면 디자인 리뷰를 대체하는가?

아니다. 터미널 도우미다. 회의가 같은 모듈 그림이면 sitdraw를 연다.