설정 및 구성

Pluely에서 Gemini CLI 사용하기

Google의 AI 명령줄 도구인 Gemini CLI를 연결하면 Pluely 오버레이가 내 Google AI 구독이나 Gemini API 키로 로컬에서 답변해요. Gemini CLI에는 이제 무료 등급이 없으므로 유료 Google AI 플랜이나 Gemini API 키가 필요해요.

1. 설치하고 로그인하기

Gemini CLI를 설치하고(예: npm install -g @google/gemini-cli) 터미널에서 gemini를 한 번 실행해 Google AI 플랜으로 로그인하거나, 셸에 GEMINI_API_KEY를 설정하세요. 터미널에서 응답하면 Pluely에서도 쓸 수 있어요.

2. Pluely에서 연결하기

대시보드 → Dev Space → CLI 연결을 여세요.
Pluely가 Gemini CLI를 자동으로 감지해요. 연결을 클릭하세요.
오버레이 모델 선택기 맨 위에 내 CLI로 나타나요.

Gemini CLI의 워크스페이스 신뢰(workspace trust) 요구 사항은 Pluely가 알아서 처리해요. “not running in a trusted directory” 오류도, 따로 설정할 플래그도 없어요.

3. 모델 고르기

연결된 줄 바로 아래에 모델 패널이 있어요.

기본값(CLI에서 결정): Gemini CLI에 설정된 모델이에요. 언제나 동작해요.
Gemini 3 Pro (preview), Gemini 2.5 Pro, Gemini 2.5 Flash: 각각 클릭 한 번이면 돼요.
사용자 지정 모델 ID: 내 계정에서 쓸 수 있는 정확한 모델 ID라면 무엇이든 입력하세요.

이미지도 돼요

Pluely에서 Gemini는 비전을 지원해요. 첨부한 스크린샷과 이미지가 질문과 함께 자동으로 전달돼요.

생각하는 모델도 돼요

Gemini의 사고 출력은 자동으로 걸러져서 최종 답변만 보여요.

문제 해결

모델 이름이 들어간 “CLI에서 응답하지 못했어요”: 내 계정에서 그 모델을 쓸 수 없는 것일 수 있어요(프리뷰 모델은 순차적으로 배포돼요). 기본값이나 2.5 Pro로 바꾸세요.
로그인이 만료됐어요: 터미널에서 gemini를 실행해 다시 인증하세요.