Gemini CLI

1. 개요

Gemini CLI는 Google의 공식 명령줄 AI 코딩 도구로, 터미널에서 Gemini 모델과 직접 상호작용할 수 있습니다. GravitexAI를 gateway로 사용하면 다음을 할 수 있습니다:

터미널 네이티브

셸에서 Gemini 3.5 / 3.1 / 2.5 모델 직접 호출

AI 지원 코딩

코드 생성, 리뷰 및 단위 테스트 자동화

스마트 Q&A

기술 질문, 아키텍처 설계 및 디버깅

문서 생성

README, API 문서 및 JSDoc 주석 자동 생성

GravitexAI를 gateway로 사용하면 최적화된 연결, 통합 API key 관리, 단일 계정으로 Claude, GPT, Gemini 원스톱 액세스를 제공합니다.

2. 사전 요구사항

Node.js ≥ 18.0.0
npm 또는 yarn
GravitexAI 콘솔의 API key (형식 sk-xxxxxxxxxx)

3. 빠른 시작

1단계 — Gemini CLI 설치

node --version  # must be >= 18

npm install -g @google/gemini-cli

gemini --version

node --version  # must be >= 18

yarn global add @google/gemini-cli

gemini --version

2단계 — GravitexAI API key 발급

GravitexAI 로그인

maas.gravitex.ai에서 회원가입 또는 로그인합니다.

API key 생성

API Keys 페이지를 열고 “Create new token”을 클릭합니다.

키 복사

생성된 키(형식: sk-xxxxxxxxxx)를 복사하여 안전하게 보관합니다.

3단계 — 환경 변수 설정

중요: GOOGLE_GEMINI_BASE_URL은 https://api.gravitex.ai로 설정해야 합니다. /v1, /gemini 또는 기타 경로를 붙이지 마세요 — 연결이 깨집니다.

Zsh (macOS / Linux)
Bash (Linux)
PowerShell (Windows)
CMD (Windows)

# Edit your .zshrc
nano ~/.zshrc

# Add these environment variables
export GOOGLE_GEMINI_BASE_URL="https://api.gravitex.ai"
export GEMINI_API_KEY="sk-your-gravitex-key"  # replace with your GravitexAI key

# Reload
source ~/.zshrc

nano ~/.bashrc

export GOOGLE_GEMINI_BASE_URL="https://api.gravitex.ai"
export GEMINI_API_KEY="sk-your-gravitex-key"

source ~/.bashrc

# Temporary (current session)
$env:GOOGLE_GEMINI_BASE_URL="https://api.gravitex.ai"
$env:GEMINI_API_KEY="sk-your-gravitex-key"

# Persistent (recommended)
[System.Environment]::SetEnvironmentVariable('GOOGLE_GEMINI_BASE_URL', 'https://api.gravitex.ai', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'sk-your-gravitex-key', 'User')

:: Temporary
set GOOGLE_GEMINI_BASE_URL=https://api.gravitex.ai
set GEMINI_API_KEY=sk-your-gravitex-key

:: Persistent (needs admin)
setx GOOGLE_GEMINI_BASE_URL "https://api.gravitex.ai"
setx GEMINI_API_KEY "sk-your-gravitex-key"

4단계 — 초기화 및 테스트

CLI 시작

gemini

최초 인증

대화형 UI에서 입력:

/auth

**Gemini API Key (AI Studio)**를 선택합니다.

연결 테스트

# Simple test
gemini "Hello, is the connection working?"

# Coding test
gemini "Explain how to use React Hooks"
gemini "Write a Python function that computes Fibonacci numbers"

4. 추천 모델 (GravitexAI 경유)

GravitexAI는 최신 Gemini 제품군을 제공합니다. CLI에서 모두 호출 가능:

Gemini 3.x 시리즈 (권장)

Model ID	Best for	Notes
gemini-3.5-flash ⭐	고처리량 채팅, 저지연 도구	최신 빠른 변형, 클래스 최고 속도
gemini-3.1-pro-preview	심층 추론, 고품질 코드 생성	차세대 핵심 모델
gemini-3.1-flash-lite-preview	고동시성, 배치 작업	최고 가성비 빠른 티어
gemini-3.1-flash-image-preview	이미지 이해 / 텍스트-이미지	멀티모달 강화
gemini-3-pro-image-preview	고품질 텍스트-이미지	이미지 중심 변형
gemini-3-flash-preview	다중 턴 채팅, tool use	속도와 품질 균형

권장 기본값:

복잡한 코딩 / 아키텍처: gemini-3.1-pro-preview
일상 코딩 및 Q&A: gemini-3.5-flash
배치 / 고빈도: gemini-3.1-flash-lite-preview

전체 카탈로그는 GravitexAI 모델 목록을 참조하세요.

5. 핵심 기능

5.1 코드 생성

Function
Project scaffold
Unit tests

gemini "Write a quicksort algorithm in Python with detailed comments"

Sample output:

def quick_sort(arr):
    """
    Quicksort
    Time:  O(n log n) avg, O(n^2) worst
    Space: O(log n)
    """
    if len(arr) <= 1:
        return arr

    pivot = arr[len(arr) // 2]
    left = [x for x in arr if x < pivot]
    middle = [x for x in arr if x == pivot]
    right = [x for x in arr if x > pivot]

    return quick_sort(left) + middle + quick_sort(right)

gemini "Create an Express.js REST API project structure with auth and database config"

gemini "Write Jest unit tests for this function:
function fibonacci(n) {
  if (n <= 1) return n;
  return fibonacci(n - 1) + fibonacci(n - 2);
}"

5.2 코드 리뷰

# Performance / bugs
gemini "Review this code for performance issues and potential bugs:
[paste your code]"

# Security audit
gemini "Audit this code for security vulnerabilities, especially SQL injection and XSS"

# Best practices
gemini "What can be improved in this React component? Does it follow best practices?"

5.3 기술 Q&A

gemini "Explain JavaScript closures with real-world use cases"
gemini "Why is my Promise not resolving correctly?"
gemini "Compare microservices vs. monolithic architecture pros and cons"

5.4 문서 생성

gemini "Generate a professional README.md for my Node.js library, including install, usage and API docs"
gemini "Generate OpenAPI 3.0 spec for this REST endpoint"
gemini "Add detailed JSDoc comments to the following code"

6. 대화형 명령어

Command	Description	Example
`/auth`	재인증	`/auth`
`/model`	모델 전환	`/model gemini-3.1-pro-preview`
`/clear`	대화 초기화	`/clear`
`/help`	도움말 표시	`/help`
`/exit`	CLI 종료	`/exit` or `Ctrl+C`
`/save`	대화를 파일로 저장	`/save conversation.txt`

모델 전환: 대화형 /model 사용, 또는 --model로 지정:

gemini --model gemini-3.1-pro-preview "your question"
gemini --model gemini-3.5-flash "quick test"

7. 고급 사용

7.1 GitHub Actions (자동 리뷰)

name: Gemini Code Review
on:
  pull_request:
    branches: [ main ]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - uses: actions/setup-node@v3
        with:
          node-version: '18'

      - name: Install Gemini CLI
        run: npm install -g @google/gemini-cli

      - name: Run Code Review
        env:
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
          GOOGLE_GEMINI_BASE_URL: https://api.gravitex.ai
        run: |
          gemini "Review this Pull Request for quality, security and performance:
          $(git diff origin/main...HEAD)"

7.2 배치 스크립트

#!/bin/bash

# Batch code review
for file in src/**/*.js; do
  echo "Reviewing $file..."
  gemini "Review code quality of $file" < "$file"
done

# Generate project doc outline
gemini "Generate a technical doc outline for the whole project" < README.md

8. FAQ

연결 또는 인증 실패?

체크리스트:

환경 변수가 올바른가?
echo $GOOGLE_GEMINI_BASE_URL echo $GEMINI_API_KEY
예상값:
- GOOGLE_GEMINI_BASE_URL: https://api.gravitex.ai (/v1 또는 기타 경로 없음)
- GEMINI_API_KEY: 전체 sk-… 키
환경 변수 다시 로드:
source ~/.zshrc # or source ~/.bashrc
터미널 재시작: 터미널 창을 닫고 다시 엽니다.
GravitexAI 콘솔에서 키 확인 — 활성 상태 및 잔액 확인.

Gemini 모델을 전환하려면?

옵션 A — 대화형 /model:

/model gemini-3.1-pro-preview
/model gemini-3.5-flash

옵션 B — CLI 플래그:

gemini --model gemini-3.1-pro-preview "your question"
gemini --model gemini-3.5-flash "quick test"

대화 기록을 저장하려면?

방법 1: /save 사용

/save conversation-2025-01-01.txt

방법 2: 셸 리다이렉션

gemini "your question" > output.txt
gemini "your question" | tee output.txt   # show and save

Node.js 버전이 너무 낮나요?

nvm으로 Node 관리:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

nvm install 18
nvm use 18
nvm alias default 18

node --version

응답이 느린 이유는?

가능한 원인 및 해결:

네트워크: GravitexAI는 최적화된 경로 제공; 콘솔에서 상태 확인.
모델 선택: 가장 빠른 응답을 위해 gemini-3.5-flash 또는 gemini-3.1-flash-lite-preview 사용.
토큰 크기: 요청 복잡도 및 컨텍스트 길이 줄이기.

벤치마크:

time gemini --model gemini-3.5-flash "Hello"

Windows에서 사용하려면?

PowerShell (권장):

nodejs.org에서 Node.js 설치
관리자 권한으로 PowerShell 열기

환경 변수 설정:

[System.Environment]::SetEnvironmentVariable('GOOGLE_GEMINI_BASE_URL', 'https://api.gravitex.ai', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'sk-your-key', 'User')

PowerShell 재시작
설치: npm install -g @google/gemini-cli

또는 WSL로 더 네이티브한 경험 사용.

9. 모범 사례

프롬프트 설계

구체적으로

❌ “Optimize this code”✅ “Optimize this code for performance, focus on loop efficiency and memory use”

맥락 제공

❌ “What’s wrong with this function?”✅ “This handles user login and throws an async error — help me find the bug”

단계별 분할

❌ “Build the whole project”✅ “Step 1: design DB model; Step 2: build API routes; Step 3: …”

예시 요청

❌ “Explain closures”✅ “Explain JS closures with 3 practical scenarios and code examples”

권장 워크플로

문제 정의

해결하거나 구축하려는 것을 명확히 설명합니다.

솔루션 획득

Gemini CLI로 초기 솔루션 또는 코드를 작성합니다.

리뷰 및 개선

AI에게 자체 출력을 리뷰하고 문제를 표시하도록 요청합니다.

반복

피드백을 기반으로 단계별로 개선합니다.

문서 추가

주석 및 문서를 생성합니다.

10. 참고 자료

Gemini CLI 공식 문서: https://ai.google.dev/gemini-api/docs/cli
GravitexAI 콘솔: https://maas.gravitex.ai
모델 목록: https://maas.gravitex.ai/#/models
빠른 시작: /ko/quickstart

5분 안에 시작: 위 “빠른 시작” 섹션을 따르면 Gemini CLI를 바로 사용할 수 있습니다.

대화형 AI

프로그래밍 개발

AI 에이전트

기술 엔지니어링

번역

1. 개요

터미널 네이티브

AI 지원 코딩

스마트 Q&A

문서 생성

2. 사전 요구사항

3. 빠른 시작

1단계 — Gemini CLI 설치

2단계 — GravitexAI API key 발급

3단계 — 환경 변수 설정

4단계 — 초기화 및 테스트

4. 추천 모델 (GravitexAI 경유)

Gemini 3.x 시리즈 (권장)

5. 핵심 기능

5.1 코드 생성

5.2 코드 리뷰

5.3 기술 Q&A

5.4 문서 생성

6. 대화형 명령어

7. 고급 사용

7.1 GitHub Actions (자동 리뷰)

7.2 배치 스크립트

8. FAQ

9. 모범 사례

프롬프트 설계

구체적으로

맥락 제공

단계별 분할

예시 요청

권장 워크플로

10. 참고 자료

​1. 개요

터미널 네이티브

AI 지원 코딩

스마트 Q&A

문서 생성

​2. 사전 요구사항

​3. 빠른 시작

​1단계 — Gemini CLI 설치

​2단계 — GravitexAI API key 발급

​3단계 — 환경 변수 설정

​4단계 — 초기화 및 테스트

​4. 추천 모델 (GravitexAI 경유)

​Gemini 3.x 시리즈 (권장)

​5. 핵심 기능

​5.1 코드 생성

​5.2 코드 리뷰

​5.3 기술 Q&A

​5.4 문서 생성

​6. 대화형 명령어

​7. 고급 사용

​7.1 GitHub Actions (자동 리뷰)

​7.2 배치 스크립트

​8. FAQ

​9. 모범 사례

​프롬프트 설계

구체적으로

맥락 제공

단계별 분할

예시 요청

​권장 워크플로

​10. 참고 자료

1. 개요

2. 사전 요구사항

3. 빠른 시작

1단계 — Gemini CLI 설치

2단계 — GravitexAI API key 발급

3단계 — 환경 변수 설정

4단계 — 초기화 및 테스트

4. 추천 모델 (GravitexAI 경유)

Gemini 3.x 시리즈 (권장)

5. 핵심 기능

5.1 코드 생성

5.2 코드 리뷰

5.3 기술 Q&A

5.4 문서 생성

6. 대화형 명령어

7. 고급 사용

7.1 GitHub Actions (자동 리뷰)

7.2 배치 스크립트

8. FAQ

9. 모범 사례

프롬프트 설계

권장 워크플로

10. 참고 자료