Crazyrouter한국어Tutorial
Gemini CLI 사용자 가이드 - 터미널에서 사용하는 Google AI
Gemini CLI, 구글의 오픈소스 커맨드라인 AI 도구의 설치 및 설정을 위한 완전 가이드입니다. 프록시 설정 방법, 내장 도구 사용법, Gemini 2.5 Pro로 워크플로를 자동화하는 방법을 배워보세요.
C
Crazyrouter Team
January 24, 2026 / 679 views
Share:
Gemini CLI는 Google에서 제공하는 오픈소스 커맨드라인 AI 도구로, Gemini의 성능을 직접 터미널로 가져옵니다. 프롬프트에서 모델까지 가장 직접적인 경로를 제공하는 가벼운 방식으로 Gemini에 접근할 수 있습니다. 프록시를 설정하면 네트워크가 제한된 환경에서도 Gemini CLI 서비스를 사용할 수 있습니다.
왜 Gemini CLI를 선택해야 할까요?#
- 강력한 Gemini 2.5 Pro: 100만 토큰 컨텍스트 윈도우 제공
- 내장 도구: Google Search 기반 지식, 파일 작업, Shell 명령, 웹 스크래핑
- 확장 가능: 사용자 정의 통합을 위한 MCP(Model Context Protocol) 지원
- 터미널 우선: 커맨드라인에서 작업하는 개발자를 위해 설계
- 오픈 소스: Apache 2.0 라이선스
설치#
빠른 설치#
설치 없이 npx로 바로 실행#
bash
# 공식 리포지토리 사용
npx https://github.com/google-gemini/gemini-cli
npm으로 전역 설치#
bash
npm install -g @google/gemini-cli
Homebrew로 설치 (macOS/Linux)#
bash
brew install gemini-cli
시스템 요구 사항#
- Node.js 20 이상 버전
- macOS, Linux, 또는 Windows
프록시 설정#
환경 변수 설정#
프록시를 사용하기 전에 다음 환경 변수를 설정하세요:
Linux / macOS#
bash
# API Key 설정
export GEMINI_API_KEY=sk-your-api-key-here
# API Proxy URL 설정
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/
Windows CMD#
cmd
set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/
Windows PowerShell#
powershell
$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"
Tip: 이 환경 변수들을 .bashrc, .zshrc 또는 사용 중인 쉘 설정 파일에 추가하면, 터미널을 열 때마다 자동으로 설정됩니다.
빠른 시작#
기본 사용법#
현재 디렉토리에서 시작#
bash
gemini
여러 디렉토리 포함하기#
bash
gemini --include-directories ../lib,../docs
특정 모델 사용하기#
bash
gemini -m gemini-2.5-flash
비대화형 스크립트 모드#
간단한 텍스트 응답 받기:
bash
gemini -p "Explain the architecture of this codebase"
구조화된 JSON 출력 받기:
bash
gemini -p "Explain the architecture of this codebase" --output-format json
빠른 예시#
새 프로젝트 시작하기#
bash
cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided
기존 코드 분석하기#
bash
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday
주요 기능#
코드 이해 및 생성#
- 대규모 코드베이스 질의 및 편집
- 멀티모달 기능을 사용해 PDF, 이미지, 스케치로부터 새로운 애플리케이션 생성
- 자연어로 디버깅 및 문제 해결
자동화 및 통합#
- Pull Request 조회나 복잡한 rebase 처리 같은 운영 작업 자동화
- MCP 서버를 통해 새로운 기능 연결
- 스크립트에서 비대화형으로 실행해 워크플로 자동화
고급 기능#
- 내장 Google Search를 사용한 실시간 정보 조회
- 복잡한 세션을 저장하고 복원하기 위한 대화 체크포인트
- 프로젝트에 맞게 동작을 조정하는 커스텀 컨텍스트 파일(GEMINI.md)
자주 사용하는 명령과 예시#
코드베이스 탐색#
code
> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers
기존 코드 작업#
code
> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan
워크플로 자동화#
code
> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues
시스템 상호작용#
code
> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month
GitHub 통합#
Gemini CLI GitHub Action을 사용해 Gemini CLI를 GitHub 워크플로에 직접 통합할 수 있습니다:
- Pull Request 리뷰: 맥락 있는 피드백과 제안을 포함한 자동 코드 리뷰
- 이슈 분류: 내용 분석을 기반으로 GitHub 이슈에 자동 라벨링 및 우선순위 지정
- 온디맨드 도움말: 이슈와 Pull Request에서
@gemini-cli를 멘션해 디버깅, 설명, 작업 위임에 대한 도움 받기 - 사용자 정의 워크플로: 팀의 요구에 맞춰 자동, 예약, 온디맨드 워크플로 구성
문제 해결#
사용 중 문제가 발생하면 다음을 확인해 보세요:
1. 환경 변수 확인#
bash
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL
2. 네트워크 연결 확인#
bash
curl -I https://crazyrouter.com/
3. 에러 메시지 확인#
에러 메시지는 보통 문제의 원인을 알려줍니다. 일반적인 문제는 다음과 같습니다:
- 잘못된 형식의 API 키
- 네트워크 연결 문제
- 잘못된 프록시 설정
4. SOCKS 프록시 형식#
SOCKS 프록시를 사용하는 경우, 형식이 올바른지 확인하세요:
code
socks5://<user>:<pass>@<proxy>:<port>
5. 버그 보고#
내장 명령을 사용해 이슈를 보고할 수 있습니다:
bash
/bug
릴리스 버전#
Preview#
새로운 프리뷰 버전은 매주 화요일 UTC 23:59에 릴리스됩니다:
bash
npm install -g @google/gemini-cli@preview
Stable#
새로운 안정 버전은 매주 화요일 UTC 20:00에 릴리스됩니다:
bash
npm install -g @google/gemini-cli@latest
Nightly#
Nightly 버전은 매일 UTC 00:00에 릴리스됩니다:
bash
npm install -g @google/gemini-cli@nightly
MCP 서버 사용#
~/.gemini/settings.json 에 MCP 서버를 설정해, 사용자 정의 도구로 Gemini CLI 기능을 확장할 수 있습니다:
text
> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users
Crazyrouter 가격 정보#
할인된 요금으로 Gemini 모델에 접근하세요:
| Model | Input Price | Output Price |
|---|---|---|
| gemini-2.5-pro | $0.625/1M tokens | $2.50/1M tokens |
| gemini-2.5-flash | $0.038/1M tokens | $0.15/1M tokens |
| gemini-2.5-flash-lite | $0.019/1M tokens | $0.075/1M tokens |
모든 가격에는 공식 요금 대비 45% 할인이 적용되어 있습니다.
관련 리소스#
도움이 필요하신가요? 지원팀에 문의하거나 Crazyrouter 문서를 확인해 더 많은 정보를 얻을 수 있습니다.
Implementation Guides
AuthenticationCreate and use API keys with the required authorization headers.Quick Start GuideMake the first Crazyrouter API call and validate your setup.Gemini Native FormatUse Gemini native generateContent requests through Crazyrouter.API EndpointsChoose the correct base URL for OpenAI-compatible, Claude, and Gemini clients.
Available in other languages:
Topics
Tutorial
