클로드 코드 vs gemini cli

클로드 코드 vs Gemini CLI: 무료 한도와 모델 선택

Claude Code는 Claude 구독과 별도 API 경로를 사용하는 코딩 에이전트입니다. Gemini CLI는 현재 조직의 Gemini Code Assist와 기존 유료 API·Vertex 경로를 중심으로 제공됩니다. 개인 무료 사용을 찾는다면 Google이 안내하는 Antigravity CLI 이전을 먼저 확인하세요. 모델 선택, 승인 방식, 한도와 실제 청구 주체를 비교한 뒤 같은 과제로 직접 시험하는 것이 좋습니다.

Claude Code와 Gemini CLI의 모델·청구 경로를 비교하고 개인 무료 이용의 Antigravity CLI 이전 안내와 상충하는 할당량 정보를 살펴봅니다.

30초 결론: Claude Code와 Gemini CLI 중 어디를 고를 것인가#

Claude 모델과 구독이 맞으면 Claude Code, 조직의 Google Cloud·Gemini Code Assist 환경이 중요하면 Gemini CLI를 살펴보세요. 개인 무료 경로는 바뀌었으므로 예전 한도만 보고 선택하면 안 됩니다.

비교표: 인터페이스, 모델, 권한, 한국어, 가격 (6–8행)#

공식 자료 확인: 2026-11-01. 계정 유형과 계약에 따라 이용 가능 기능과 청구가 달라집니다.

기준Claude CodeGemini CLI
작업 환경터미널, IDE, 데스크톱, 웹오픈소스 터미널 에이전트와 IDE 연동
모델Claude 모델을 계정·계약 조건에 따라 선택Gemini 모델을 인증 경로와 사용 가능 여부에 따라 선택. 최신 모델 최적화 여부는 공식 안내 확인
접근Claude 유료 구독 또는 별도 API 인증 경로조직 Code Assist와 기존 유료 API·Vertex 경로 중심. 개인 무료 경로는 아래 이전 안내 참조
승인수동 모드에서 파일 수정과 대부분의 셸 명령을 승인하며 설정에 따라 달라짐 (권한)기본 승인, 편집 자동 승인, 계획 모드 등을 제공 (설정)
한도구독 한도와 API 사용량을 구분할당량 문서는 인증별 한도를 설명하나 개인 무료 수치와 이전 배너가 충돌
연결MCP 지원MCP 지원; 설정을 그대로 이전할 수 있는지는 별도 확인
한국어한국어 입력 가능; 작업 결과와 메시지는 직접 확인한국어 입력 가능; 작업 결과와 메시지는 직접 확인. 같은 조건의 품질 비교는 아직 없음
가격Pro 월별 결제 $20, 연간 선결제 $200; 세금과 API 사용량 별도조직 라이선스 또는 API·클라우드 사용량. 현재 계정의 조건 확인

Claude Code가 강한 경우 / Gemini CLI가 강한 경우#

  1. Claude Code: Claude 구독과 터미널 외 IDE·웹 작업을 함께 쓰려면 검토하세요. API 키가 활성화되면 구독과 청구 경로가 달라질 수 있습니다.
  2. Gemini CLI: 조직의 Code Assist와 Google Cloud 인증을 사용한다면 검토하세요. 개인 무료 계정에 예전 Gemini CLI 한도가 그대로 적용된다고 가정하지 마세요.
  3. 개인 무료 이용: Google이 안내하는 Antigravity CLI 이전과 현재 계정 자격을 확인하세요. 이는 별도 제품입니다.

같은 과제 비교: Claude Code와 Gemini CLI에 같은 이슈를 맡겼을 때#

동일 이슈를 두 도구로 실행한 기록은 아직 없습니다. 비교하려면 같은 커밋에서 별도 브랜치로 시작하고 동일한 요청, 승인 범위, 테스트 명령을 사용하세요. 변경 diff와 테스트 출력, 사용 모델과 청구 경로를 기록하되 이 페이지는 아직 결과나 성능 순위를 주장하지 않습니다.

가격: 구독과 사용량#

공식 자료 확인: 2026-11-01. Claude 요금표는 Claude Code가 포함된 Pro를 월별 결제 시 $20, 연간 선결제 시 $200으로 표시합니다. 이는 조회된 세금 제외 가격이며, API 인증은 별도 사용량 청구가 적용됩니다.

환율과 세금을 포함한 실제 금액은 결제 화면에서 확인하세요.

Google 공식 README와 할당량 문서 배너는 개인 무료 및 Google AI 구독 사용자가 2026-06-18 Antigravity CLI로 이전했다고 안내합니다. 반면 같은 할당량 문서 본문에는 이전 무료 한도가 남아 있어 서로 충돌합니다. 따라서 본문의 무료 수치를 현재 제공 조건으로 단정하지 않습니다. 조직 라이선스 또는 기존 유료 API·Vertex 경로의 가격과 한도는 계약과 공식 요금을 확인하세요.

2026-11-03에 확인한 Google 개발자 블로그의 2026-05-19 공지는 경로별로 나눠 적습니다. 6월 18일 이후 중단되는 대상은 Google AI Pro·Ultra 구독자와 개인용 Gemini Code Assist 무료 이용자이고, Standard·Enterprise 라이선스와 유료 API 키로 쓰는 Gemini CLI는 계속 제공된다고 안내합니다. 같은 글은 Google Cloud를 거치지 않는 GitHub용 Gemini Code Assist에 대해서도 6월 18일부터 새 설치를 받지 않는다고 적습니다.

같은 공지는 Antigravity CLI가 Gemini CLI의 핵심 기능인 Agent Skills, Hooks, Subagents, Extensions를 유지하며, Extensions는 Antigravity plugins라는 이름으로 옮긴다고 적습니다. 다만 처음부터 1:1 기능 동등성이 있는 것은 아니라고 명시합니다. 따라서 Gemini CLI에서 쓰던 훅과 서브에이전트 설정은 목록의 기능과 빠진 기능을 나눠 확인하세요.

비교할 접근 경로자료에서 확인할 내용현재 비용으로 단정하지 않을 것
Claude 구독공식 가격의 Code 포함 플랜과 한도다른 인증 경로의 API 사용료까지 포함한다는 가정
Claude API비용 문서의 사용량 청구구독과 API의 같은 요청량·같은 가격 가정
Gemini 개인 무료·Google AI이전 안내와 상충하는 할당량 본문과거 무료 수치를 현재 계정의 보장된 한도로 사용
Gemini 조직·유료 API조직 Code Assist 계약 또는 API 가격조직 라이선스, API와 Vertex를 같은 청구 계정으로 취급

문서가 충돌하는 항목은 계정의 현재 제공 조건을 먼저 확인하세요. 이 표는 한도 소진이나 재시도를 실행한 기록이 아니며, 접근 경로만으로 한국어 결과나 작업당 비용을 비교하지 않습니다.

미르 코드가 맞는 경우 / 맞지 않는 경우#

Mirr Code는 한국어 중심의 터미널 코딩 에이전트를 찾을 때 살펴볼 수 있습니다. 기존 Claude 또는 Google Cloud 연동이 필수라면 각 도구를 유지하는 편이 적합할 수 있습니다. 같은 과제의 비교 결과와 기존 설정의 호환성은 아직 확인하지 않았습니다. Mirr 요금과 조건은 결제 화면에서 다시 확인하세요.

무료라는 말보다 인증 경로를 먼저 봅니다#

이 비교에서 가장 먼저 정할 것은 어떤 계정으로 요청할지입니다. 같은 CLI라도 개인 로그인, 조직 라이선스와 API 키는 접근 조건과 비용이 다를 수 있습니다. Gemini CLI의 과거 무료 안내만 읽고 조직의 유료 API 경로에 같은 한도가 있다고 가정하지 마세요. Claude Code도 구독 로그인과 API 사용을 분리해야 합니다. 프로그램을 무료로 내려받을 수 있다는 사실과 모델 요청이 무료라는 말은 다릅니다. 요청을 보내기 전에 청구 주체와 사용량을 확인할 곳을 정하면 비용 판단의 출발점이 분명해집니다.

현재 개인 무료 경로의 충돌은 앞의 가격 항목에 정리했습니다. 이하에서는 그 예전 무료 수치를 사용하지 않고 조직 라이선스와 기존 유료 API·Vertex, Claude 구독·API라는 경로별 판단을 설명합니다.

한도 초과와 일시 오류를 구분합니다#

요청이 실패했다고 모두 일일 한도를 쓴 것은 아닙니다. 인증, 요청 속도, 모델 접근과 서비스 상태도 확인할 항목입니다. 오류 종류를 구분하지 않고 재시도하면 원인을 알기 어려워집니다. 비밀값 없는 오류 메시지와 발생 시각, 선택 모델과 인증 경로를 기록하세요. 화면의 표현만으로 원인을 확정할 수 없다면 추정으로 남기세요. 이 페이지에는 실제 한도 도달 transcript가 없으며, 특정 오류가 이 계정에서 무엇을 의미했는지 확인한 결과를 제시하지 않습니다.

한도에는 적용 기간도 있습니다. 분당 제한과 긴 기간의 할당량은 다른 문제이므로 재개 조건을 읽어 보세요. 모델별 제한과 계정 전체 제한도 구분하세요. 요청 하나가 내부적으로 어떤 단위를 소비했는지 모르면 사용자가 입력한 질문 수로 남은 양을 역산할 수 없습니다. 작업을 오래 맡길 계획이라면 중간 저장과 안전한 재개를 설계하는 편이 낫습니다. 제한이 있다는 사실만으로 어느 도구가 더 느리거나 불안정하다고 결론 내리지 않습니다. 실제 과제와 계정 조건이 있어야 비교할 수 있습니다.

한도에 도달했을 때 선택할 운영 절차#

처음에는 새 요청을 반복하기보다 현재 상태를 보존하세요. 파일이 어디까지 수정됐고 어떤 검증이 끝났는지 확인합니다. 실행 중인 명령과 이미 보낸 외부 요청도 따로 살펴보세요. 다음으로 제한 종류와 재개 가능 시점을 확인하고 기다릴지 과제를 줄일지 판단합니다. 다른 모델이나 유료 인증 경로로 바꾸는 것은 별도의 결정입니다. 비용과 정책 조건을 다시 확인하지 않은 자동 전환을 기본으로 삼지 마세요. 이 순서는 제안이며 실제 한도 회복 성공을 기록한 것은 아닙니다.

다른 경로로 계속한다면 원래 과제와 현재 상태를 명확히 전달하세요. 이전 모델이 완료했다고 요약한 내용도 파일과 테스트로 대조해야 합니다. 중단 전에 실행한 작업을 다시 실행하면 외부 효과가 중복될 수 있습니다. 저장소 수정만 있는 합성 과제에서도 오래된 결과를 덮어쓰지 않도록 현재 diff를 읽게 하세요. 이후 생성된 결과는 최초 경로와 전환 후 경로의 공동 결과로 기록합니다. 한 도구의 무중단 성공으로 합치지 않으면 실제 재개 부담을 설명할 수 있습니다.

선택확인할 조건기록할 결과
기다리기제한의 종류와 초기화 안내중단 상태와 다시 시작한 시점
과제 줄이기남은 수용 기준과 독립 가능한 범위완료·미완료 부분의 경계
모델 바꾸기접근 자격, 정책과 기능 차이실제 선택과 변경 이유
인증 경로 바꾸기청구 계정과 별도 비용 승인전환 전후의 사용량 구분
수동으로 마치기현재 diff와 남은 검증사람이 보완한 코드와 확인

표는 가능한 대응의 판단 기준입니다. 실제 한도 도달과 재시도 transcript는 아직 없으며 별도 유료 경로로 옮길 때의 비용·데이터 조건도 새로운 판단입니다.

승인 모드와 한도 정책은 다른 설정입니다#

승인 모드는 어떤 도구 동작을 승인할지와 실행 범위를 다루는 설정이며 모델 요청의 무료 이용 자격을 부여하지 않습니다. Claude Code의 권한 모드도 구독 사용량을 늘리는 기능이 아닙니다. 한도 오류를 해결하려고 승인 검사를 끄는 대응은 문제의 계층을 혼동한 것입니다. 버전과 인증, 실행 권한을 각각 기록해야 원인을 좁힐 수 있습니다.

승인 설정의 구성도 두 도구에서 다릅니다. 2026-11-03에 확인한 Claude Code 권한 모드 문서는 수동 모드에서 파일 편집, 셸 명령과 네트워크 접근 전에 멈춘다고 설명하고, acceptEdits, plan, dontAsk, auto, bypassPermissions 모드를 따로 나열합니다. 같은 문서는 auto 모드에서 두 번째 모델인 분류기가 사용자 대신 행동을 검토한다고도 적습니다. 2026-11-03에 확인한 Gemini CLI 설정 참조는 defaultApprovalMode에 default, auto_edit, plan 값을 두고, 모든 도구 호출을 자동 승인하는 yolo는 명령행 플래그로만 켠다고 적습니다. 이때 샌드박스도 기본으로 켜진다고 안내합니다.

조직에서 통제하려면 설정을 한 단계 더 봐야 합니다. Gemini CLI 설정 참조는 security.disableYoloMode가 플래그로 yolo를 켰더라도 yolo 모드를 끈다고 적고, security.enablePermanentToolApproval은 도구 확인 대화상자의 '모든 향후 세션에 허용' 옵션을 켜는 설정이라고 설명합니다. Claude Code 권한 문서는 조직이 중앙 통제를 필요로 하면 관리 설정을 배포하며, 일부 보안 관련 키를 제외하면 사용자와 프로젝트 설정이 이를 덮어쓰지 못한다고 적습니다.

계획 모드로 조사한 내용과 실제 파일 수정은 결과가 다릅니다. 파일을 고칠 권한을 주지 않은 실행에서 수정이 없었다고 기능 실패로 세지 마세요. 반대로 넓은 자동 실행 권한을 준 결과가 덜 멈췄다는 이유로 더 안전하다고 판단하지 않습니다. 두 도구를 시험할 때는 허용한 행동과 외부 접속 범위를 맞추거나 차이를 공개해야 합니다. 도구별 문법은 공식 버전 문서를 따르고 다른 제품의 설정 이름을 그대로 옮기지 않습니다. 여기서는 정책 집행의 실제 시험을 수행하지 않았습니다.

한국어 과제에서 남겨야 할 검토 자료#

한국어 품질은 설명의 말투만으로 평가하기 어렵습니다. 요청의 조건을 지켰는지, 한글 파일과 주석을 정확히 다뤘는지, 실패를 숨기지 않고 보고했는지 나눠 보세요. 짧은 문장으로 같은 뜻을 반복하게 하는 과제보다 기존 코드와 연결되는 작은 수정이 실무 판단에 유용할 수 있습니다. 다만 합성 과제에서의 관찰은 그 과제에 한정하세요. 이 페이지에는 한국어와 영어를 짝지어 측정한 두 제품의 결과도 없으므로 언어별 성능 차이를 계산하지 않습니다.

오류를 설명하게 할 때는 실제 출력과 가설의 구분을 봅니다. 모델이 패키지가 없다고 말했더라도 출력이 다른 원인을 가리킬 수 있습니다. 새로운 설치나 외부 접속을 요청하면 그 필요와 권한을 별도로 판단하세요. 한도를 아끼려고 검증을 생략한 결과는 검증한 결과와 같은 성공으로 취급하지 않습니다. 긴 한국어 설명이 도움이 되는지와 필요한 코드 수정이 정확한지도 분리할 수 있습니다. 결과를 읽는 사람이 실제로 다시 확인할 자료가 남는지가 중요합니다.

구독과 종량제의 비용을 비교하는 단위#

구독에는 정해진 기간의 기능과 사용 조건이 있고 종량제에는 실제 사용량에 따른 청구가 있습니다. 두 단위를 억지로 같은 요청 수로 바꾸지 마세요. 작업당 비용을 비교하려면 같은 과제를 끝내기까지 사용한 모델, 재시도와 실제 청구 경로가 필요합니다. 긴 입력이나 출력이 늘면 단순 요청 수로 비용을 설명하기 어렵습니다. 현재 이 글은 Claude의 표시 구독료와 Google의 경로별 조건을 구분하며, 실제 작업량이나 환율을 넣어 월 총액을 산출하지 않습니다.

학습 중인 개인이라면 먼저 필요한 기능과 현재 무료 경로의 자격을 확인하고, 한도 뒤에 지출할지 멈출지를 정하세요. 조직 사용자라면 개인 무료 설명보다 라이선스와 승인된 클라우드 계정을 우선 확인하세요. 기존 유료 API 사용자는 조직 라이선스와 자신의 요청이 같은 청구 경로인지 확인하세요. 어느 경우든 결제 화면과 관리 계약의 조건이 판단 자료입니다. 예전 무료 수치나 다른 사용자의 후기만으로 지금의 비용과 모델 접근을 단정하지 않습니다.

인증별로 중단 뒤 확인할 곳이 달라집니다#

Gemini CLI의 할당량 문서는 조직 라이선스, API key와 Vertex의 경로를 구분합니다. 조직 Code Assist는 할당된 라이선스와 사용자의 접근 조건을 볼 영역이고, API 경로는 선택한 프로젝트·모델의 계량 사용과 제한을 볼 영역입니다. Vertex는 다시 해당 클라우드 프로젝트의 자원과 계약을 읽어 보세요. 사용한 프로그램의 이름이 같다는 이유만으로 한 경로의 제한 안내를 다른 경로의 초기화 규칙으로 옮길 수 없는 구조입니다.

Claude Code의 인증 문서는 Claude 구독과 Console, 외부 클라우드 제공자를 나눕니다. 구독으로 작업한다고 생각했지만 API 인증이 활성화된 환경이라면 비용과 사용량을 확인할 계정부터 달라질 수 있습니다. 반대로 구독의 한도 안내를 읽었다고 별도 API 프로젝트까지 소진됐다고 판단할 수도 없습니다. 따라서 중단 뒤 첫 질문은 “어느 제품인가”에 이어 “이번 요청은 어느 인증·청구 경로인가”가 됩니다. 키 값 자체를 대화에 붙일 필요는 없습니다.

현재 경로먼저 볼 대상다른 경로로 옮길 때 달라질 결정
Claude 구독구독에 적용되는 사용량과 한도API 전환은 별도 계정의 지출
Claude Console·클라우드해당 API·클라우드 계약과 요청개인 구독과 데이터·청구 범위의 차이
Gemini 조직 Code Assist할당 라이선스와 조직 계정개인 계정 우회가 아니라 조직의 승인
Gemini API key선택 프로젝트·모델의 계량 조건조직 라이선스와 포함량을 동일시하지 않음
Gemini Vertex클라우드 프로젝트와 해당 제공 경로API key 경로와 별도 계약·권한

이 표는 현재 계정의 권리를 판정한 자료가 아니라 공식 문서의 경로 구분입니다. 그 문서의 과거 무료 수치를 여기에 끼워 넣어 조직 또는 API 경로의 보장된 요청 수를 계산하지 않습니다.

코드 수정 중 요청이 멈췄을 때의 한 가지 흐름#

실행하지 않은 예시로 한글 파일명의 보고서 변환 함수와 관련 테스트를 고치는 중 모델 요청이 진행되지 않는 상황을 생각할 수 있습니다. 파일 읽기와 일부 수정은 있었을 수 있지만 검증이 끝났다는 가정은 하지 않습니다. 첫 분기는 요청의 실패인지 로컬 명령의 실패인지입니다. 모델에 다음 질문을 보내지 못하는 상황과 테스트 프로세스가 파일 접근 제한으로 종료된 상황은 다른 계층입니다. 후자에 모델 한도라는 원인을 바로 붙이면 필요한 로컬 설정을 놓칠 수 있습니다.

모델 요청 쪽이라면 실제 안내가 인증을 가리키는지, 속도나 장기 할당량을 가리키는지 확인합니다. 로컬 테스트 쪽이라면 실행 명령과 접근한 파일·경로를 봅니다. 원인이 확정되지 않았으면 보고서에 오류 종류를 추정으로 남기고 현재 diff를 보존합니다. 그다음 이어갈 범위는 남은 테스트와 수정의 관계로 정합니다. 구현은 보존하고 테스트만 수동으로 확인할지, 인증 문제를 해결한 뒤 모델에 계속 맡길지 선택할 수 있습니다.

다른 모델을 고르는 분기는 해당 경로에서 사용할 수 있고 조직 정책과 예산에 맞는 경우에만 후보가 됩니다. 단순히 모델 선택기가 보인다는 이유로 전환 뒤의 데이터·지출 조건까지 승인된 것은 아닙니다. 다른 인증 경로로 옮기면 그 경로의 지출을 누가 승인하는지 새로 정하세요. 한편 기다리거나 수동으로 남은 검증을 하는 결정은 추가 모델 요청 없이도 가능한 운영안입니다. 제한을 무조건 우회하는 흐름보다 현재 작업에서 필요한 다음 행동을 고르는 설계입니다.

알림과 실제 차단을 다른 기록으로 읽는 예시#

다음은 채워진 제품 로그가 아니라 관찰을 분류하는 설명용 기록의 두 상태입니다. 첫 상태는 사용량 안내를 읽고 사용자가 더 요청하지 않은 경우입니다. 기록할 수 있는 사실은 안내를 읽었다는 것과 자발적으로 멈췄다는 것입니다. 요청이 실제로 거부됐다는 칸에는 관찰 없음이 맞습니다. 이 상태에서 “무료 한도가 끝나 차단됐다”라고 적으면 안내의 해석을 실제 실행의 결과로 바꾸게 됩니다.

두 번째 상태는 이후 별도로 승인된 요청을 보냈고 서비스가 요청을 처리하지 않았다는 실제 메시지를 받은 경우입니다. 그때는 해당 메시지와 경로, 시각을 연결해 차단 여부를 검토할 자료가 생깁니다. 그래도 그 메시지가 인증과 할당량 중 무엇을 뜻하는지 읽어 보세요. 이 설명은 그러한 요청이 여기서 발생했다는 보고가 아닙니다. 실제 기록이 생겼을 때 두 상태를 같은 표제의 “한도 도달”로 합치지 않는 방법을 보여 줍니다.

설명용 기록 항목안내만 읽고 멈춘 상태실제 요청 거부를 받은 상태
근거읽은 안내의 원문요청과 반환된 메시지의 원문
요청 실행추가 요청을 하지 않음별도 실행한 요청이 있음
차단 판단관찰하지 않음메시지·경로에 따라 판단
초기화 시각추정하지 않음안내가 있으면 그대로 기록
재개 결과아직 없음재시도를 별도로 했을 때만 기록

이 분류는 사용량 숫자가 없어도 적용할 수 있습니다. 임의의 오류 코드와 리셋 시각, 성공 출력을 넣을 필요가 없습니다. 특히 현지 자정이 지났다는 이유로 어느 서비스의 긴 기간 한도가 새로 시작됐다고 가정하지 않습니다. 실제 안내의 시간대와 적용 기간을 읽어 보세요. 모델 변경 뒤 요청이 처리됐다면 어떤 모델·경로로 바뀌었는지 별도 상태로 연결하면 됩니다. 최초 경로가 자동 회복됐다고 해석하지 않는 구분입니다.

승인 모드는 어느 분기에서 의미가 있는가#

이 예시에서 한글 보고서 함수를 조사만 하려면 계획·조사 범위를 선택할 수 있고, 실제 수정으로 넘어갈 때는 편집과 명령의 허용을 봅니다. 하지만 모델 API가 요청을 거부한 문제는 편집 자동 승인으로 해결되는 것이 아닙니다. 설정이 작동하는 계층이 다르기 때문입니다.

Claude Code도 도구 권한과 인증 경로가 별도입니다. 파일 수정은 허용돼 있는데 외부 테스트 명령이 금지됐다면 도구 규칙과 필요한 자원을 검토할 일입니다. 반대로 API 비용이 발생했다고 해서 로컬 명령이 모두 허용된 것도 아닙니다. 중단을 읽는 사람이 이 계층을 나누면 “계속 진행”이라는 모호한 요청 대신 필요한 승인 또는 수정만 전달할 수 있습니다.

사용량 화면이 설명하는 값의 범위#

Gemini CLI v0.39.1의 명령 참조는 /stats의 기본 session 보기, 모델별 token·quota 정보를 설명하는 model 보기와 tools 보기를 나눕니다. 이것은 표시 기능의 문서이며 지금 개인 무료 경로가 다시 제공된다는 뜻은 아닙니다. 버전 문서가 설명하는 화면의 용도와 앞서 밝힌 현재 서비스 이전 문제를 분리해 읽어 보세요.

예시 작업에서 세션 token 수만 읽었다면 그 값은 요청의 소비를 이해하는 자료입니다. 조직 라이선스의 남은 할당량과 같은 단위라고 자동으로 환산하지 않습니다. model 보기의 정보가 있더라도 표시된 모델과 기간을 함께 읽어 보세요. tools 보기는 어떤 도구 사용이 있었는지라는 다른 질문에 답할 수 있습니다. 파일 변환 과제를 진행하다 멈춘 상황에서 token 수, 도구 호출과 실제 오류를 같은 “요청 횟수”로 합치면 어떤 제한에 닿았는지 설명하기 어려워집니다.

2026-11-03에 확인한 Claude Code 비용 문서는 /usage의 Session 블록을 API token 사용 통계로 설명하고, 구독 사용자에게 그 세션의 dollar figure가 실제 청구액을 의미하지 않는다고 명시합니다. 구독에서는 plan usage bars와 활동·사용량 분석을 함께 읽는다고 안내합니다. 따라서 화면에 달러 값이 보인다는 사실만으로 구독에 추가 청구됐다고 보고할 수는 없습니다. 실제로 API 경로를 썼다면 그 계정의 권위 있는 청구 자료와 대조할 일입니다.

구독 한도를 넘어서도 계속 작업하려면 사용량 크레딧을 쓸 수 있다고 Claude Code 비용 문서는 적습니다. 관리는 claude.ai 구독으로 로그인한 뒤 /usage-credits 명령으로 하며, 크레딧이 켜져 있으면 /usage 화면에 별도 행이 나타납니다.

이 구분은 두 제품을 가격으로 비교할 때 실용적입니다. Gemini의 모델별 token·quota 화면과 Claude의 세션 비용 추정은 같은 의미의 통계가 아닙니다. 한쪽에서는 token 수를, 다른 쪽에서는 구독 이용률을 읽어 놓고 어느 쪽이 더 많이 소비했다고 결론 내릴 수 없습니다. 공통으로 비교할 것은 같은 과제의 완료 조건과 실제 인증 경로, 해당 경로의 소비·청구 자료입니다.

같은 비용 문서는 세션 비용을 token과 표시 단가 또는 관리된 가격표로 계산하는 추정이라고 설명합니다. 계약상 할인이나 다른 조건이 있다면 현금 청구와의 차이를 별도로 봐야 합니다. 세션이 새로 시작될 때의 통계 범위도 버전에 따라 달랐다고 문서가 구분하므로 여러 세션의 값이 같은 기간을 요약한다고 가정하지 않습니다. 이 글에서는 해당 명령을 실행하거나 계정 사용량을 읽지 않았습니다. 제품별로 어떤 값을 볼 수 있다고 문서가 설명하는지와 그 값으로 할 수 없는 계산을 정리한 것입니다.

이 예시의 복구 메모에는 표시한 값의 이름과 범위를 그대로 적는 방식이 맞습니다. “모델별 token 보기에서 확인한 범위”와 “구독 이용률에서 확인한 범위”를 분리하고, 실제 요청 거부는 그 메시지에 연결합니다. 여러 세션을 묶는다면 실제로 관찰한 기간도 각 값에 붙입니다. 통계의 숫자를 보기 좋게 같은 지표로 바꾸지 않으면 알림, 실제 차단과 지출이라는 세 판단을 혼동하지 않을 수 있습니다.

긴 작업과 짧은 학습에서 다른 선택#

도구 통계는 모델 사용량과 다른 복구 질문에도 쓰일 수 있습니다. 예시 보고서 함수의 수정 뒤 테스트를 실행하도록 요청했는데 tools 보기에서 필요한 실행에 해당하는 자료를 찾지 못했다면, 아직 확인할 검증이 무엇인지 되짚을 수 있습니다. 다만 통계의 부재만으로 특정 명령이 금지됐다고 확정하는 대신 실제 실행 기록과 연결해야 합니다. session의 경과 시간도 모델 응답 시간과 사람의 승인 대기가 섞일 수 있어 단일 속도 지표로 쓰지 않습니다. 이런 구분은 통계를 실제 차단이나 과제 성공의 대체물로 쓰는 대신 다음 확인을 정하는 자료로 읽게 합니다.

짧은 학습 작업이라면 한도 뒤 기다리는 선택이 가능할 수 있습니다. 조직의 정해진 검증 작업을 끝내야 한다면 남은 부분을 사람이 확인하거나 승인된 다른 경로를 준비하는 운영이 필요할 수 있습니다. 이 차이는 무료와 유료의 보편적인 우열보다 일정과 인증·지출 책임에 가깝습니다. 포함 사용량이 실제 과제에 충분했는지와 전환이 얼마나 필요했는지는 관찰한 작업량이 있어야 계산할 수 있습니다. 현재 공개 가격과 경로만으로 작업당 비용이나 재개 성공을 만들어 결론 내리지 않습니다.

수정·보완 기록#

개인 무료 이전 안내와 조직·유료 인증 경로를 구분했습니다. 상충하는 할당량 본문을 현재 무료 보장으로 바꾸지 않았고, 한도 도달·재시도는 직접 실행한 것으로 표현하지 않았습니다.

검증일 · 출처#

출처: 본문에 링크한 Anthropic·Google 공식 자료는 2026-11-01에 확인했습니다. 이번 자료 확인이 페이지 전체의 실측 검증을 뜻하지는 않습니다.

📋 증거 체크리스트

  • Gemini CLI 할당량 문서와 상충 안내, Claude Code 요금 비교표 및 출처(2026-11-01 확인)
  • 한도 도달·재시도 동작 transcript

관련#

자주 묻는 질문

Claude Code와 Gemini CLI 중 어떤 것이 더 좋은가요?

Claude 구독과 모델을 쓰고 싶다면 Claude Code를, 조직의 Gemini Code Assist 환경을 사용한다면 Gemini CLI를 검토하세요. 개인 무료 이용 경로는 Google의 이전 안내를 먼저 확인해야 합니다.

둘 중 어떤 것이 더 싼가요?

2026-11-01 공식 가격 기준 Claude Pro는 월별 결제 시 $20이며 세금과 API 사용료는 별도입니다. Gemini CLI는 조직 라이선스나 기존 유료 API·Vertex 경로의 계약과 사용량을 확인해야 합니다. Google의 개인 무료 이용 이전 안내와 할당량 문서가 충돌하므로 무료 한도를 전제로 비용을 비교할 수 없습니다.

한국어로도 잘 되나요?

두 도구 모두 한국어 입력은 됩니다. 화면 문구, 오류 메시지, 리뷰 코멘트까지 한국어로 자연스럽게 이어지는지는 설정과 모델에 따라 다릅니다.

Mirr Code는 어디에 해당하나요?

Mirr Code는 한국어 중심 터미널 코딩 에이전트입니다. 현재 요금과 이용 조건은 요금 페이지와 결제 화면에서 확인하세요.

옛 Gemini CLI 무료 한도를 지금 적용해도 되나요?

이전 배너와 할당량 본문이 충돌하므로 옛 무료 수치를 현재 조건으로 단정하지 않습니다. 개인 무료 경로의 Antigravity CLI 이전 안내와 현재 계정 자격을 먼저 확인하세요.

Antigravity CLI와 Gemini CLI는 같은 제품인가요?

이 글에서는 별도 제품으로 구분합니다. 개인 무료 이용 이전 안내만으로 조직 Code Assist나 기존 유료 API·Vertex 계약까지 같은 조건이라고 가정하지 마세요.

한도 도달과 재시도 동작을 직접 확인했나요?

아직 transcript를 확보하지 못했습니다. 인증 방식과 모델, 한도 초기화 시점 및 재시도 결과를 남긴 실제 기록이 필요하며 문서만으로 성공을 주장하지 않습니다.

타사 제품명과 상표는 식별과 설명을 위해 사용했습니다. 상표에 대한 권리는 각 권리자에게 있습니다.

지금 바로 Mirr(미르)를 경험해 보세요.