Skip to main content

개요

Gemini CLI는 터미널에서 Gemini AI 모델과 직접 상호작용할 수 있게 해주는 Google의 공식 명령줄 도구입니다. APIYI를 통해 다음과 같이 사용할 수 있습니다.
  • 🚀 터미널에서 Gemini 모델을 빠르게 호출할 수 있습니다
  • 💻 AI 지원 프로그래밍 및 코드 생성
  • 🔍 코드 리뷰 및 최적화 제안
  • 📝 기술 Q&A 및 문서 생성
  • 🌐 크로스 플랫폼 지원(Linux, macOS, Windows)
왜 APIYI를 선택해야 합니까?APIYI를 통해 Gemini CLI를 사용하면 더 안정적인 네트워크 연결, 더 나은 가격, 그리고 24/7 기술 지원을 이용할 수 있습니다.

빠른 시작

사전 준비

  • Node.js >= 18.0.0
  • npm or yarn 패키지 관리자
  • APIYI 계정 및 API Key

1단계: Gemini CLI 설치

2단계: APIYI API Key 가져오기

1

APIYI에 등록/로그인

등록 또는 로그인을 위해 api.apiyi.com에 접속합니다
2

API Key 생성

대시보드의 “토큰 관리” 페이지(api.apiyi.com/token)로 이동한 다음 “새 토큰 생성”을 클릭합니다
3

키 복사

생성된 API Key(형식: sk-***)를 복사하여 안전하게 보관합니다

3단계: 환경 변수 구성

중요 설정: GOOGLE_GEMINI_BASE_URL은 추가 경로(예: /v1 또는 /gemini) 없이 https://api.apiyi.com로 설정해야 하며, 그렇지 않으면 연결에 실패합니다.

4단계: 초기화 및 테스트

1

Gemini CLI 실행

2

최초 인증

대화형 인터페이스에서 다음을 입력합니다:
선택: Gemini API Key (AI Studio)
3

연결 테스트

핵심 기능

코드 생성

예시 출력:

코드 리뷰

기술 Q&A

문서 생성

대화형 명령

Gemini CLI 대화형 모드에서는 다음 명령을 사용할 수 있습니다:
모델 전환: /model 명령을 사용하여 gemini-3-pro-preview, gemini-2.5-flash, gemini-2.5-pro 등 다양한 Gemini 모델 간에 전환할 수 있습니다.

지원되는 모델

APIYI를 통해 최신 Gemini 모델을 사용할 수 있습니다:

Gemini 3 시리즈 (추천)

Gemini 2.5 시리즈

추천 구성:
  • 복잡한 프로그래밍, 아키텍처 설계: gemini-3-pro-preview
  • 일상적인 코드 생성, Q&A: gemini-2.5-flash
  • 배치 처리, 빠른 반복: gemini-2.5-flash-lite

전체 모델 목록 보기

APIYI에서 지원하는 모든 Gemini 모델, 상세한 가격 및 성능 비교 보기

고급 사용

VS Code 통합

VS Code에서 Gemini CLI 확장 프로그램을 사용합니다:

GitHub Actions 통합

자동 코드 리뷰:

배치 스크립트

자동화 스크립트를 생성합니다:

자주 묻는 질문

체크리스트:
  1. 환경 변수 확인:
    출력은 다음과 같아야 합니다:
    • GOOGLE_GEMINI_BASE_URL: https://api.apiyi.com (/v1 또는 다른 경로 없음)
    • GEMINI_API_KEY: sk-로 시작하는 전체 키
  2. 환경 변수 다시 불러오기:
  3. 터미널 재시작: 터미널을 완전히 닫았다가 다시 여십시오
  4. API Key 확인: APIYI 대시보드에 로그인하여 키가 유효하고 잔액이 충분한지 확인하십시오
대화형 모드에서 /model 명령을 사용하십시오:
또는 명령에서 직접 지정할 수 있습니다:
방법 1: /save 명령 사용
방법 2: 출력을 리디렉션
방법 3: 세션 관리 사용
권장 사항: nvm으로 Node.js 버전을 관리하십시오:
가능한 원인과 해결 방법:
  1. 네트워크 문제: APIYI는 최적화된 국내 노드를 제공하므로 일반적으로 빠릅니다
  2. 모델 선택: 가장 빠른 응답을 위해 gemini-2.5-flash 또는 gemini-2.5-flash-lite를 사용하십시오
  3. token 제한: 한 번의 요청 복잡도를 줄이십시오
  4. 동시 요청: 너무 많은 요청을 동시에 보내지 마십시오
연결 속도 테스트:
권장 사항: PowerShell을 사용하십시오:
  1. Node.js를 설치하십시오(공식 웹사이트에서 설치 프로그램 다운로드)
  2. PowerShell을 관리자 권한으로 실행하십시오
  3. 환경 변수를 설정하십시오:
  4. PowerShell을 다시 시작하십시오
  5. Gemini CLI를 설치하고 사용하십시오
또는 WSL(Windows Subsystem for Linux)을 사용하면 더 나은 경험을 얻을 수 있습니다.

모범 사례

프롬프트 최적화

구체적으로 작성합니다

❌ “이 코드를 최적화해 주세요”✅ “이 코드를 성능 위주로 최적화해 주세요. 반복문 효율과 메모리 사용에 중점을 두십시오”

맥락을 제공합니다

❌ “이 함수의 무엇이 잘못되었습니까?”✅ “이 함수는 비동기 오류가 발생하는 사용자 로그인 함수입니다. 문제를 찾아 주세요”

단계별로 진행합니다

❌ “전체 프로젝트를 완성하는 데 도움을 주세요”✅ “1단계: 데이터베이스 모델을 설계합니다. 2단계: API 경로를 생성합니다. 3단계: …”

예시를 요청합니다

❌ “클로저를 설명해 주세요”✅ “JavaScript 클로저를 3가지 실용적인 사용 사례와 코드 예시와 함께 설명해 주세요”

워크플로 권장 사항

1

문제를 정의합니다

해결할 문제나 구현할 기능을 명확하게 설명합니다
2

해결책을 얻습니다

Gemini CLI를 사용하여 초기 해결책이나 코드를 생성합니다
3

검토 및 최적화

AI에게 자신의 코드를 검토하고 잠재적인 문제를 찾아 달라고 요청합니다
4

반복합니다

요구 사항을 충족할 때까지 피드백을 바탕으로 점진적으로 최적화합니다
5

문서를 추가합니다

필요한 주석과 문서를 생성합니다

과금

APIYI를 통해 Gemini 모델을 사용하는 비용은 선택한 모델과 사용량에 따라 달라집니다.

자세한 과금 보기

모든 Gemini 모델의 상세 과금 및 비용 효율 비교를 확인합니다
APIYI는 충전 보너스를 제공합니다: 충전할수록 보너스가 더 높아집니다(10%-20%). 첫 충전 시 추가 보너스를 받습니다. 충전 프로모션 상세를 확인하십시오.

관련 자료

도움 받기

기업용 WeChat

기업용 WeChat QR 코드QR 코드를 스캔하거나 지원팀에 문의하려면 클릭기술 상담, 사용 안내

이메일 문의

고객 서비스: [email protected]비즈니스: [email protected]
빠른 시작: 위의 “빠른 시작” 섹션을 따라 설정을 완료하고 5분 안에 Gemini CLI 사용을 시작하십시오!