Gemini CLI 설정

Gemini CLI는 Google의 AI 코딩 어시스턴트이며 큰 컨텍스트가 필요한 코드 작업에 유용합니다.

먼저 환경 설정 장을 완료하고 Node.js와 npm이 설치되어 있는지 확인하세요.

Linux / macOS

1단계: Gemini CLI 설치

npm i -g @google/gemini-cli

2단계: 환경 변수 설정

~/.bashrc 또는 ~/.zshrc에 추가합니다:

# Relay base URL: domain only, do not append /v1beta
export GOOGLE_GEMINI_BASE_URL="https://api.icodeeasy.cc"

# Use your I Code Easy API Key
export GEMINI_API_KEY="your API Key"

# Recommended fast model. You can also use stronger models such as gemini-3.1-pro-preview
export GEMINI_MODEL="gemini-3.5-flash"

# Explicitly use Gemini API v1beta
export GOOGLE_GENAI_API_VERSION="v1beta"

파일을 저장한 뒤 source ~/.bashrc 또는 source ~/.zshrc를 실행합니다.

Note: Do not set GOOGLE_GEMINI_BASE_URL to https://api.icodeeasy.cc/v1beta, or Gemini CLI will build paths like /v1beta/v1beta/models/.... 현재 네트워크에서 api.icodeeasy.cc가 느리면 GOOGLE_GEMINI_BASE_URL을 https://jp.icodeeasy.cc로 변경하세요. 이때도 /v1beta는 붙이지 않습니다.

3단계: Gemini 시작

cd your-project-folder
gemini

Windows

1단계: Gemini CLI 설치

npm i -g @google/gemini-cli

2단계: 환경 변수 설정 in PowerShell

# Relay base URL: domain only, do not append /v1beta
[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.icodeeasy.cc", "User")

# Use your I Code Easy API Key
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your API Key", "User")

# Recommended fast model. You can also use stronger models such as gemini-3.1-pro-preview
[Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3.5-flash", "User")

# Explicitly use Gemini API v1beta
[Environment]::SetEnvironmentVariable("GOOGLE_GENAI_API_VERSION", "v1beta", "User")

환경 변수를 설정한 뒤 새 PowerShell 창을 여세요.

현재 네트워크에서 api.icodeeasy.cc가 느리면 GOOGLE_GEMINI_BASE_URL을 https://jp.icodeeasy.cc로 변경하세요. 이때도 /v1beta는 붙이지 않습니다.

3단계: Gemini 시작

새 PowerShell 창을 열고 프로젝트 디렉터리로 이동한 뒤 시작합니다:

cd your-project-folder
gemini

모델 선택

자주 쓰는 모델:

Gemini CLI의 내장 flash 옵션은 이전 gemini-3-flash-preview로 해석될 수 있습니다. 클라이언트나 플러그인이 gemini-3-flash를 보내면 이 서비스가 자동으로 gemini-3-flash-preview로 매핑합니다.

Raw API 테스트 예시

CLI 없이 네이티브 Gemini API를 직접 테스트하려면:

curl "https://api.icodeeasy.cc/v1beta/models/gemini-3.5-flash:streamGenerateContent?alt=sse" \
  -H "x-goog-api-key: your API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "Hello, briefly introduce yourself"}]
      }
    ]
  }'

비스트리밍 엔드포인트 경로:

/v1beta/models/{model}:generateContent

스트리밍 엔드포인트 경로:

/v1beta/models/{model}:streamGenerateContent?alt=sse

FAQ