메인 콘텐츠로 건너뛰기

​
개요

Gemini CLI Interface Gemini CLI는 터미널에서 Gemini 모델과 상호작용하기 위한 Google 공식 커맨드라인 도구입니다. Gemini CLI를 EvoLink API와 통합하면 공식 모델 제한을 넘어 Gemini, GPT, Claude 시리즈 모델을 포함한 EvoLink의 다양한 모델 세트에 하나의 진입점으로 접근할 수 있습니다.

​
사전 준비

설정하기 전에 다음 사항을 확인하세요:

​
1. Node.js 및 npm 설치

왜 필요한가요? Node.js는 CLI 도구의 런타임 환경입니다 (휴대폰에 카카오톡을 설치해야 채팅할 수 있듯이, 컴퓨터에 Node.js를 설치해야 CLI 도구를 실행할 수 있습니다). 이미 설치된 경우: node -v 및 npm -v를 실행하여 버전을 확인하세요. v20 이상이면 이 단계를 건너뛰세요. 처음 설치하는 경우: 
node -v
npm -v
Node.js and npm version verification
  • EvoLink Dashboard에 로그인
  • 대시보드에서 API Keys를 찾아 ‘새 키 생성’ 버튼을 클릭한 후 생성된 Key를 복사
  • API Key는 보통 sk-로 시작합니다

​
1단계: Gemini CLI 설치

팁: 커맨드라인 터미널을 여는 방법을 모르시면 FAQ - 커맨드라인 터미널 여는 방법을 참고하세요

​
1. 설치 명령어

npm install -g @google/gemini-cli
예상 결과: 다운로드 정보가 스크롤되며 마지막에 added XX packages가 표시됩니다 (1~3분 소요). 오류 발생 시: permission denied이 나타나면 Windows에서는 “관리자 권한으로 실행”한 PowerShell을 사용하고, macOS/Linux에서는 명령어 앞에 sudo를 추가하세요.

​
2. 설치 확인

gemini --version
성공 표시: 버전 번호가 표시됩니다 (예: 1.x.x). Gemini CLI Version ⚠️ 중요: Gemini CLI 설정은 다른 도구보다 약간 더 복잡하며, 설치 파일을 수정해야 합니다. 프로그래밍이 처음이라면 먼저 Claude CLI 또는 Codex CLI 사용을 고려해 보세요 (설정이 더 간단합니다).

​
1. 설치 디렉토리 찾기

npm root -g
다음과 같은 경로가 표시됩니다:
  • Windows: C:\Users\YourUsername\AppData\Roaming\npm\node_modules
  • macOS: /usr/local/lib/node_modules
  • Linux: /usr/lib/node_modules
Find Gemini CLI installation directory

​
2. API 엔드포인트 수정

2개의 파일을 수정합니다: File location 파일 1: {install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.mjs ~11222 번째 줄을 찾으세요: 
// Before
initHttpOptions.baseUrl = `https://generativelanguage.googleapis.com/`;

// After
initHttpOptions.baseUrl = `https://code.evolink.ai/`;
Modify mjs file 파일 2: {install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.cjs ~11244 번째 줄을 찾아 동일하게 수정합니다. Modify cjs file

​
3. API Key 설정

임시 (현재 세션만)
$env:GEMINI_API_KEY = "your-evolink-api-key"
영구 설정
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your-evolink-api-key", "User")
변경 사항을 적용하려면 터미널을 재시작하세요.설정 확인
echo $env:GEMINI_API_KEY
API Key가 출력되면 설정이 완료된 것입니다.Check environment variable

​
3단계: Gemini CLI 사용 시작

​
1. 작업 디렉토리로 이동

cd your-working-directory
참고: your-working-directory를 실제 경로로 바꾸세요

​
2. 단일 질의 모드

gemini "Who are you"

​
3. 대화형 모드

gemini
Gemini CLI Interface 성공 표시:
  • AI 응답 텍스트가 표시됨 (여러 줄)
  • 401, 403, API Key invalid 같은 오류가 없음
오류가 표시되는 경우:
  • 401 Unauthorized: API Key가 설정되지 않았거나 유효하지 않음 → 환경 변수를 확인하세요
  • 403 Forbidden: API Key 권한 부족 → API 엔드포인트 수정을 확인하세요
  • Network error: 네트워크 문제 → 연결 상태를 확인하세요

​
FAQ

​
1. Gemini CLI란 무엇이며 어디에 사용하나요?

Gemini CLI는 터미널에서 Gemini 모델과 상호작용하기 위한 Google 공식 커맨드라인 도구입니다. EvoLink 설정을 통해 GPT, Claude 및 기타 모델에도 접근할 수 있습니다.

​
2. 처음 사용 시 설치 및 설정을 어떻게 확인하나요?

다음 명령어를 순서대로 실행하세요:
  • node -v 및 npm -v: Node.js와 npm 설치 확인
  • gemini --version: Gemini CLI 설치 확인
  • gemini "Who are you": API 설정이 올바른지 확인

​
3. 대화형 모드와 단일 명령어 모드의 차이점은 무엇인가요?

  • 대화형 모드: gemini를 실행하여 다중 턴 대화를 위한 연속 대화에 진입
  • 단일 명령어 모드: gemini "질문"을 실행하여 단일 응답을 받고 종료

​
4. Gemini CLI가 자동으로 로컬 파일과 코드를 읽거나 업로드하나요?

아니요. Gemini CLI는 사용자가 명시적으로 참조하거나 승인한 경우에만 파일 내용을 읽습니다. 전용 프로젝트 폴더에서 사용하는 것을 권장합니다.

​
5. Gemini CLI로 로컬 파일 내용을 분석하려면 어떻게 하나요?

대화형 모드에서 다음과 같이 파일을 참조할 수 있습니다:
  • 파일 경로를 입력하여 Gemini가 읽도록 함
  • 터미널 창에 파일을 드래그 앤 드롭

​
6. Gemini CLI는 한국어 입출력을 지원하나요?

네, 완벽하게 지원됩니다.

​
7. 실행 후 출력이 없는 경우 원인은 무엇인가요?

일반적인 원인:
  • 네트워크 연결 문제
  • 유효하지 않은 API Key 또는 잔액 부족
  • 잘못된 API 엔드포인트 설정
  • 방화벽 또는 프록시가 요청을 차단

​
8. API 엔드포인트 또는 환경 변수 변경이 적용되지 않는 이유는 무엇인가요?

  • 터미널 또는 커맨드라인 창을 재시작하세요
  • GEMINI_API_KEY 환경 변수가 올바르게 설정되었는지 확인하세요
  • API 엔드포인트 파일이 올바르게 수정되었는지 확인하세요 (node_modules의 .mjs 및 .cjs 파일을 수정해야 합니다)

​
9. 401/403 오류의 원인은 무엇인가요?

  • 401 오류: GEMINI_API_KEY가 설정되지 않았거나 유효하지 않음
  • 403 오류: 권한 부족 또는 만료된 키
  • API 엔드포인트가 https://code.evolink.ai/인지 확인하세요

​
10. Gemini CLI는 어떤 시나리오에 적합한가요?

적합한 경우:
  • 코드 작성, 디버깅 및 리팩토링
  • 커맨드라인 환경에서의 빠른 질의응답
  • 파일 내용 분석
  • 자동화 스크립트 통합
적합하지 않은 경우:
  • 복잡한 GUI 상호작용
  • 실시간 협업 편집
  • 대규모 배치 파일 처리

​
11. 모델을 어떻게 전환하나요?

대화형 모드에서 /model을 입력하세요. Gemini CLI Switch Model 사용 가능한 모델:
  • gemini-2.5-pro
  • gemini-2.5-flash
  • gemini-3-pro-preview
  • gemini-3-flash-preview

​
12. 이미지를 어떻게 업로드하나요?

  • 방법 1: 이미지 경로를 참조
  • 방법 2: 터미널에 이미지를 드래그 앤 드롭
모든 방법은 사용자의 조작이 필요합니다. Gemini CLI는 자동으로 로컬 이미지를 읽거나 업로드하지 않습니다.

​
13. 커맨드라인 터미널 여는 방법

  • 방법 1: Win + R을 누르고 cmd 또는 powershell을 입력한 후 Enter를 누르세요
  • 방법 2: 시작 메뉴에서 “명령 프롬프트” 또는 “PowerShell”을 검색하세요
  • 방법 3: 폴더에서 Shift를 누른 채 마우스 오른쪽 버튼을 클릭하고 “여기에 PowerShell 창 열기”를 선택하세요

​
주의사항

Gemini CLI는 전용 프로젝트 폴더에서 실행하세요. 민감한 디렉토리(시스템 폴더 또는 자격 증명이 포함된 디렉토리 등)에서 실행하지 마세요. Gemini CLI는 현재 작업 디렉토리를 기준으로 작동합니다.