Gemini CLI 대안: 워크플로와 API 제어 기준으로 선택하기

Gemini CLI는 종료되지 않았지만 무료 접근 경로는 종료되었으므로, "대안"은 서로 다른 두 가지 결정으로 나뉩니다. 저장소는 살아 있습니다. google-gemini/gemini-cli는 보관되지 않았고 Apache-2.0을 적용하며 2026년 9월 21일에 마지막으로 푸시되었습니다. npm stable @google/gemini-cli는 0.60.0이며 2026년 9월 15일에 게시되었고, 나이틀리는 매일 계속 빌드되며 지원 중단 플래그가 없습니다(GitHub 및 npm API, 2026년 9월 21일 확인). 종료된 것은 접근 권한입니다. 로그인이 작동하지 않아 떠나는 것이라면 새로운 접근 권한이 필요합니다. 에이전트 뒤에 자체 엔드포인트를 두고 싶어서 떠나는 것이라면 새로운 클라이언트가 필요합니다. 두 번째 결정은 선호도가 아니라 프로토콜의 제약으로 결정됩니다.

수치를 보기 전에 먼저 혼동을 해소하겠습니다. Gemini라는 이름의 암호화폐 거래소도 자체 "Gemini API" 문서와 자체 수수료 체계를 제공하고, MacPaw는 Gemini 2라는 macOS 중복 파일 검색기를 판매하며, gemini:// 프로토콜에는 자체 터미널 브라우저가 있습니다. 이들의 가격은 이 페이지에 포함되지 않습니다. Google의 자체 명칭도 여섯 가지로 나뉩니다. Gemini CLI, Antigravity CLI, Gemini Code Assist, Gemini 앱 구독, Gemini API, Gemini Enterprise Agent Platform입니다. 따라서 아래의 모든 수치는 어느 제품에서 나온 것인지 명시합니다.

지금 사람들이 Gemini CLI를 떠나는 이유

Google은 2026년 5월 19일 Gemini CLI를 Antigravity CLI로 전환한다고 발표하면서 다음과 같이 밝혔습니다. "2026년 6월 18일, Gemini CLI와 Gemini Code Assist IDE 확장은 Google AI Pro 및 Ultra 사용자와 무료로 사용하는 사용자에 대한 요청 제공을 중단합니다." Google의 소비자 지원 중단 페이지는 2026년 9월 2일에 마지막으로 업데이트되었으며, "더 이상 Google 로그인 옵션으로 IDE 확장 또는 Gemini CLI에 액세스할 수 없다"고 덧붙였습니다. Standard 및 Enterprise 구독은 "변경 없이 유지"되며, 영향을 받은 사용자는 Antigravity 제품군으로 이전할 수 있습니다.

이 모든 내용과 모순되는 오래된 소스가 하나 있을 것으로 예상하세요. main의 README는 여전히 "개인 Google 계정으로 분당 60개 요청 및 하루 1,000개 요청"을 광고하고, 무료 등급을 두 번 더 반복하며, Antigravity나 6월 18일을 어디에도 언급하지 않습니다(2026년 9월 21일 가져옴). Google의 날짜가 명시된 지원 중단 페이지가 더 최신의 공식 입장입니다. README가 함정입니다.

두 번째 함정은 구독 가격을 기준점으로 삼는 것입니다. Google AI는 무료 등급을 $0, Plus를 월 $4.99, Pro를 월 $19.99로 표시하며, Google의 2026년 5월 19일 발표는 Ultra를 월 $100 및 $200으로 제시합니다. 그러나 이는 Gemini 앱 구독 가격이며, Pro는 전환 발표에서 Ultra 및 개인용 무료 Code Assist와 함께 제공이 중단되었다고 명시된 바로 그 등급입니다. 해당 구독 페이지의 어떤 등급도 Gemini CLI 할당량을 구매한다고 설명하지 않습니다. Ultra 수치가 현재도 유효한지는 최신 가격 페이지에서 확인하지 않았습니다. 구독 페이지에는 Ultra가 전혀 표시되어 있지 않습니다.

계속 사용하기: 무료 접근 경로가 닫힌 후 Gemini CLI 비용

측정형 경로는 두 가지가 남아 있습니다. 라이선스 경로는 사용자별 구매이며, Gemini Code Assist 할당량(하단 날짜 2026년 9월 18일)은 요청 수로 제한됩니다. 일일 한도는 "Gemini CLI 또는 에이전트 모드에서 사용되는 모든 모델 버전 또는 제품군(예: Pro, Flash)과의 모든 상호작용에 걸쳐 합산"된다고 명시되어 있습니다. 따라서 하나의 프롬프트가 여러 요청을 사용할 수 있으며, 더 저렴한 모델로 전환해도 여유 용량이 늘어나지 않습니다.

2026년 9월 21일 Google의 Gemini 가격 페이지에서 확인한 가격입니다. 해당 페이지에는 시간당 환산액도 표시되어 있으며 구독 요금은 월별로 청구된다고 명시합니다. 키 기반 경로는 토큰당 과금입니다. 2026년 9월 16일에 마지막으로 업데이트된 Gemini API 가격에는 이 두 모델을 비롯한 여러 모델이 나열되어 있습니다. Flash 수치는 정해진 날짜에 인상되는 도입 가격이며, 이런 수치는 블로그 게시물에서 오래된 정보가 되기 쉽습니다.

동일한 페이지에는 비용이 50% 절감되는 Batch API도 나와 있으며, 이 모델들의 배치 열에는 표준 요율의 절반이 표시됩니다. Pro의 컨텍스트 등급 구분에 유의하세요. 에이전트 루프는 매 단계마다 컨텍스트를 다시 보내므로 200k 미만 수치만 인용하면 실제 비용을 과소평가하게 됩니다. 캐싱, 그라운딩 및 도구 사용 항목은 여기서 추출하지 않았으므로 이 수치는 총액이 아니라 기본 토큰 요율로 취급하세요. Gemini CLI 할당량에서 요청 수 계산 측면을 더 자세히 다룹니다.

최종 후보를 결정하는 제약

Gemini CLI는 사용자 지정 엔드포인트를 지원합니다. 저장소 내 구성 참조 문서에는 GOOGLE_GEMINI_BASE_URL이 "Gemini API 요청의 기본 URL(gemini-api-key 인증 사용 시)을 재정의"한다고 설명되어 있으며, 대상이 localhost가 아닌 경우 HTTPS가 필요합니다. 또한 Google이 이후 Gemini Enterprise Agent Platform으로 이름을 변경한 경로에는 별도의 GOOGLE_VERTEX_BASE_URL가 있습니다. Google의 렌더링된 문서 사이트에는 기본 URL 재정의가 전혀 나와 있지 않습니다. 따라서 이 변수는 저장소에는 문서화되어 있지만 게시된 사이트에는 없으며, 실제로 존재하지만 쉽게 놓칠 수 있습니다.

핵심 문제는 와이어 형식입니다. main에 공개된 소스에서는 해당 URL이 @google/genai SDK에 httpOptions.baseUrl로 전달되고 vertexai는 false이므로, 모든 요청은 Google의 기본 Gemini 프로토콜로 전송되며 인증 enum에는 OpenAI 호환 옵션도 Anthropic 옵션도 없습니다. 기본적으로 키는 x-goog-api-key 헤더에 전달됩니다. 같은 파일은 GEMINI_API_KEY_AUTH_MECHANISM도 읽으며, 이를 bearer로 설정하면 gemini-api-key 및 vertex-ai 경로에서 키가 Authorization 헤더로 이동합니다. 하지만 이는 와이어 형식이 아니라 헤더만 변경하므로 해결책이 되지 않습니다. 이 소스에는 문서화되지 않은 GATEWAY 인증 유형도 있으며, GOOGLE_GEMINI_BASE_URL가 설정되어 있으면 환경에서 선택됩니다. 이는 명시적인 Google 로그인 및 Vertex 스위치보다 우선하고 GEMINI_API_KEY보다 후순위이며, 키의 기본값은 빈 문자열입니다. 구성 문서 어디에도 "gateway"라는 단어는 없고, 이는 API 계약이 아니라 코드를 읽어 해석한 것이며, 여전히 기본 프로토콜을 사용하므로 아무것도 해결하지 못합니다.

Kunavo는 /v1/chat/completions, /v1/messages 및 /v1/responses를 제공합니다. 2026년 9월 21일에 다시 확인한 결과, api.kunavo.com/v1/models는 401을 반환했고 /v1beta/models와 /v1beta/models/<model>:generateContent는 모두 404를 반환했습니다. Kunavo는 GOOGLE_GEMINI_BASE_URL의 유효한 대상이 아니며, 그렇지 않은 척하면 오후 한나절을 허비하게 됩니다. 엔드포인트가 아니라 클라이언트를 변경하세요.

Kunavo는 임베딩, 텍스트 음성 변환 또는 음성 텍스트 변환 모델도 제공하지 않으므로, 이 중 하나가 필요한 워크플로에서는 해당 단계에 기존 제공자를 계속 사용해야 합니다.

Antigravity CLI도 같은 제약을 물려받습니다. 설치 및 인증 문서에는 "로그인한 Google 계정 대신 자신의 Gemini API 키로" 실행할 수 있고, GOOGLE_GEMINI_BASE_URL를 설정해 "다른 Gemini 호환 엔드포인트"에 연결할 수 있다고 나와 있습니다. OpenAI 호환이 아니라 Gemini 호환입니다. 별도로 요금제 페이지에는 현재 "추가 속도 제한을 위한 Bring-your-own-key 또는 bring-your-own-endpoint"를 지원하지 않는다고 명시되어 있습니다. 두 내용은 양립하며, 이 한정어가 중요합니다. 자신의 키로 실행할 수는 있지만, 그렇게 해도 구독 할당량은 제공되지 않습니다. Individual 요금제는 월 $0로 기재되어 있으며(2026년 9월 21일 확인), 어떤 요금제에도 숫자로 된 속도 제한은 표시되어 있지 않습니다. 해당 요금제의 포함 항목은 좁게 해석해야 합니다. 목록에는 모델 액세스, 무제한 탭 완성, 무제한 명령 요청 및 "Basic weekly rate limits"가 나열되어 있지만 CLI는 나열되어 있지 않습니다. 해당 페이지에서 CLI를 명시한 유일한 요금제는 Google Cloud를 통한 조직 요금제입니다. 무료 요금제가 agy에 도달하는지는 그 페이지가 어느 쪽으로도 답하지 않습니다.

어떤 이탈 이유에 어떤 대안이 적합한가

상태는 2026년 9월 21일 GitHub REST API와 npm 레지스트리에서 확인했습니다. OpenCode에 관한 한 가지 주의점은 별도의 opencode-ai/opencode 저장소가 2025년 9월부터 보관되었고 Crush로 계속되었다는 것입니다. 따라서 그곳에서 찾은 구성이나 가격은 OpenCode가 아니라 Crush의 계보를 설명합니다. Crush와 OpenCode 비교에서 둘을 비교하고, 해당 경로의 비용은 Qwen Code 가격을 참조하세요.

무엇을 가져오고 무엇을 남길 것인가

Qwen Code가 가장 짧은 이동 경로이므로 정확한 비용을 산정할 가치가 있습니다. 양쪽의 자체 문서를 2026년 9월 21일에 확인했습니다. Gemini CLI의 구성 참조와 확장 기능 참조, Qwen Code의 설정 및 인증 페이지입니다. 아래의 계보 주장은 Qwen Code 자체 README에서 가져왔으며, 해당 프로젝트가 원래 Gemini CLI v0.8.2를 기반으로 했고 Qwen Code v0.1에서 업스트림과의 동기화를 중단했다고 명시합니다.

Antigravity 경로에는 자체적인 마이그레이션 방식이 있으며, 처음 읽을 때보다 범위가 좁습니다. CLI 개요에는 온보딩이 "기존 Gemini CLI 확장, 스킬 및 설정을 자동으로 마이그레이션하기 위한 일회성 가져오기를 지원"한다고 나와 있습니다. 이 세 가지는 명시하지만 채팅 기록, 체크포인트 및 셸 기록에 대해서는 침묵합니다. 이는 해당 항목에 대한 약속도 부인도 아닙니다.

Qwen Code 경로에서는 전체 변경이 하나의 병합된 설정 블록입니다. 환경에 키를 설정하고, 전체 chat-completions 경로가 아니라 API의 /v1 루트에 기본 URL을 지정하며, 기존 프로젝트 지침이 계속 로드되도록 컨텍스트 목록에 GEMINI.md을 유지하세요:

{
  "context": { "fileName": ["QWEN.md", "GEMINI.md"] },
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-4-6",
        "name": "Claude Sonnet 4.6 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": { "KUNAVO_API_KEY": "sk-kn-..." },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "claude-sonnet-4-6" }
}

롤백은 쉽고, 시작하기 전에 준비해 둘 가치가 있습니다. 이 작업은 Gemini CLI 설치에 영향을 주지 않습니다. Qwen Code를 설정해도 ~/.gemini/은 변경되지 않으며, Code Assist Standard 또는 Enterprise 라이선스나 유료 Gemini 키를 여전히 보유하고 있다면 gemini은 이전과 정확히 동일하게 계속 작동합니다. 새 클라이언트에서 실제 작업 하나를 처음부터 끝까지 실행할 때까지 해당 경로의 비용을 유지하세요. 그래도 먼저 ~/.gemini/settings.json를 안전한 곳에 복사하세요. 손으로 두 번 편집하게 될 가능성이 가장 높은 파일입니다.

새 클라이언트에 대한 계산 예시

이는 측정된 작업 비용도, 청구 한도도 아닌 예시적 토큰 계산입니다. 10단계로 구성된 에이전트 세션 하나를 가정하세요. 각 단계에서 캐시되지 않은 입력 토큰 60,000개를 전송하고 — 루프가 매 단계마다 컨텍스트를 다시 전송함 — 출력 토큰 1,500개를 받습니다. 총 입력은 600,000, 총 출력은 15,000입니다. 캐싱, 도구 호출 오버헤드 및 재시도는 모델링하지 않았으며 실제 세션은 아래 차이보다 더 크게 달라질 수 있습니다. 요율은 백만 토큰당 실시간 Kunavo 카탈로그 가격입니다.

클라이언트를 떠난다고 해서 모델 제품군을 떠나는 것은 아닙니다. Kunavo 카탈로그에는 Claude 및 GPT 모델과 함께 Gemini 모델도 있으므로 Qwen Code 또는 OpenCode 설정에서도 Gemini 3.8 Flash을 호출할 수 있습니다. 이 글을 읽는 날 등록된 항목은 최신 카탈로그에서 확인하세요. Kunavo 카탈로그 금액은 상한이 아니라 청구 하한입니다. 업스트림에서 요금을 보고하면 청구액은 카탈로그 비용과 업스트림 비용에 해당 마크업을 곱한 값 중 큰 금액입니다. 최소 충전액은 선불 크레딧 $10이며, 작업 요금이나 구독료가 아닌 자금 충전 최소액입니다. 청구 세부 정보를 참조하세요.

이 표가 어떤 질문에 답하는지 유의하세요. 등록된 요율 중 가장 저렴한 것과 작업을 완료하는 최저 비용은 서로 다른 주장입니다. 낮은 요율의 모델을 세 번 시도해야 한다면 한 번에 성공하는 모델보다 비용이 더 들 수 있습니다. 요율을 기준으로 후보를 추린 다음, 자신의 저장소에서 범위가 정해진 작업 하나를 측정하고 계정에 실제로 기록된 내용을 확인하세요.

설정하고 첫 작업 확인하기

Kunavo는 가장 가까운 이동 경로에 대한 설정 참조를 제공합니다. 이는 호환성 테스트가 아니라 게시된 구성 페이지입니다. Qwen Code는 여기서 Kunavo 엔드포인트에 대해 런타임 테스트를 거치지 않았으며, 이 페이지의 다른 클라이언트도 마찬가지입니다. Qwen Code 통합 가이드에서 시작하거나, 이탈 이유에 더 잘 맞는다면 OpenCode, Crush, Cline 및 Aider 페이지를 참조하세요. 키에 자금을 충전할 준비가 되면 Kunavo 계정을 만드세요.

클라이언트를 바꿀지 아직 결정하지 못했나요? Gemini CLI와 Claude Code 비교는 워크플로를 직접 비교하고, OpenCode 제공자 비교는 반대편에서 같은 라우팅 문제를 다룹니다.

자주 묻는 질문

저장소 및 npm 상태, Google의 지원 종료 및 가격 페이지, Antigravity의 설치 및 요금제 문서, Qwen Code 자체 구성 문서를 모두 2026년 9월 21일에 확인했으며, Kunavo 엔드포인트도 같은 날 다시 확인했습니다. 이 페이지의 어떤 내용도 런타임 테스트를 거치지 않았습니다. CLI를 설치하지 않았고 어떤 엔드포인트에서도 세션을 실행하지 않았습니다. Kunavo 토큰 요율은 실시간 카탈로그에서 가져왔으며, 달러 예시는 예시적 토큰 계산입니다.