Claude Code vs Gemini CLI: 2026년에 어떤 AI 코딩 에이전트를 써야 할까요?

- 이 글의 날짜, 가격, 모델 구성은 작성 시점(2026년 8월)의 공식 문서와 대조해 확인했어요. 이런 정보는 빠르게 바뀌니, 의존하기 전에 반드시 최신 문서에서 확인하세요.

Claude Code가 실제로 무엇인지 잘 모르겠다면, 먼저 Claude Code란 무엇인가부터 읽어 보세요. 이 글은 Claude Code와 Gemini CLI 비교만 다뤄요. Codex도 함께 저울질하고 있다면, 자매 글인 Codex vs Gemini CLI를 끝부분에 링크해 뒀어요.

Claude Code vs Gemini CLI 한눈에 보기

세부 사항에 들어가기 전에, 지금 가장 많이 쓰이는 두 터미널 코딩 에이전트를 나란히 간단히 살펴봐요.

모델 - Claude Sonnet 5(그리고 Fable 5) vs Gemini 3

찾아볼 수 있는 Claude Code vs Gemini CLI 비교의 상당수는 아직도 Claude 4 세대 모델명 - "Claude 4", "Opus 4.6", "Sonnet 4.6" - 을 인용하고 있어요. 그건 낡은 정보예요. 공식 모델 구성 문서(code.claude.com/docs/en/model-config, 2026년 8월 확인)에 따르면, Anthropic API 상에서 sonnet 별칭은 이제 Sonnet 5로, opus는 Opus 5로 해석돼요. 완전히 새로운 별칭도 있어요. fable인데, 이건 Claude Fable 5를 사용해요 - 현재 Claude Code에서 가장 뛰어난 모델로, 어렵고 오래 걸리는 작업(근본 원인 디버깅, 아키텍처 결정, 한 번에 끝나지 않는 작업)에 적합해요.

Fable 5는 기본값이 아니에요 - /model fable로 선택하세요. 플랜과 시트 등급에 따라 일부 Fable 5 요청은 플랜에 포함된 한도가 아니라 사용 크레딧에 청구될 수 있어요(문서에서는 이를 "Fable 5 usage credits"라고 불러요).

Gemini CLI는 Gemini 3(Pro/Flash)로 동작해요. Google은 모델을 자주 업데이트하므로, 이 글을 쓴 시점과 여러분이 읽는 시점 사이에 정확한 버전이 바뀌었을 수 있어요 - 특정 모델명에 의존하기 전에 최신 상태로 확인하세요.

오픈소스 vs 프로프라이어터리 - Codex 비교와는 다른 갈림길

Codex vs Gemini CLI 비교를 읽었더라도, 여기에 같은 패턴이 적용된다고 넘겨짚지 마세요. 거기서는 두 도구 모두 오픈소스(Apache-2.0)예요. 이 조합은 달라요. Gemini CLI는 오픈소스이고(Apache-2.0, GitHub의 google-gemini/gemini-cli 저장소 - 저장소의 라이선스 배지에서 직접 확인), 포크하고, 셀프 호스팅하고, 소스를 읽을 수 있어요. Claude Code는 클로즈드 소스예요 - 바이너리/npm 패키지로 배포되고, 소스는 공개되지 않아요. 포크도, 셀프 호스팅도, 클라이언트 감사도 안 돼요.

이건 각주가 아니라 구조적인 차이예요. 클라이언트를 감사하거나 포크하는 게 필수 요건(사내 컴플라이언스, 에어갭 환경, 클라이언트 동작 수정 희망)이라면, 여러분이 읽는 시점에 어느 모델이 마침 더 강하든 상관없이 여기서는 Gemini CLI가 기본적으로 이겨요.

컨텍스트 윈도우 - "기본값 1M", 그러나 제공자에 따라 다름

대부분의 비교는 이걸 "둘 다 1M"으로 반올림하고 거기서 멈춰요. 그 아래에는 더 중요한 층이 있어요. Anthropic API 상에서는 sonnet 별칭이 Sonnet 5로 해석되고, 기본적으로 1M 토큰 컨텍스트 윈도우를 가져요 - 베타 헤더도, 프리미엄도 필요 없어요(code.claude.com/docs/en/model-config와 platform.claude.com/docs/en/build-with-claude/context-windows에서 2026년 8월 확인). 하지만 바로 그 sonnet 별칭은 Claude Code를 어느 제공자를 통해 실행하느냐에 따라 다른 모델로 해석돼요.

다시 말해, 똑같은 /model sonnet을 입력해도 Claude Code를 어느 채널로 실행하느냐에 따라 실제 컨텍스트 윈도우가 달라질 수 있다는 거예요 - 대부분의 비교가 넌지시 말하는 것처럼 하나의 고정된 숫자가 아니에요.

가격과 무료 티어 - 2026-06-18의 전환

이건 두 도구 사이의 가장 큰 차별점이고, 몇몇 비교 - 최근에 업데이트된 것들을 포함해서 - 가 여전히 잘못 짚는 지점이기도 해요.

Claude Code: Free Claude 플랜에는 Claude Code가 포함되지 않아요(claude.com/pricing에서 직접 확인, 2026년 8월). 하한선은 Pro예요. 연간 결제 시 월 $17(선불 $200), 월간 결제 시 월 $20. Max는 월 $100부터(두 등급, 5x/20x, 사용 한도가 다름). Team Standard: 연간 결제 시 시트당 월 $20, 월간 결제 시 $25. Team Premium: 연간 결제 시 시트당 월 $100, 월간 결제 시 $125. Enterprise: 시트 가격에 더해 API 요율로 사용량 청구. 가격은 빠르게 바뀌니, 약정 전에 최신 상태로 확인하세요.

Gemini CLI: 예전에는 Google 계정 로그인으로 무료였지만, Google은 2026-06-18에 개인 티어의 무료 액세스를 종료했어요 - geminicli.com/docs/resources/quota-and-pricing의 공식 문서에서 직접 확인(2026년 8월): "Gemini CLI will be replaced by Antigravity CLI on June 18th" - 이는 무료 티어와 Google One(AI Pro/Ultra) 구독자에게 적용돼요. 개인은 이제 Antigravity CLI(별도 제품으로, 보도에 따르면 출시 이후 무료 할당량이 반복적으로 줄었다고 해요 - 이번 세션에서는 현행 일차 출처의 수치를 찾지 못했고 제3자 추정치만 있어, 구체적인 숫자는 여기에 적지 않아요)로 이동하거나, Gemini API 키 / Vertex AI를 통해 토큰 단위로 지불해요. 엔터프라이즈 라이선스(Code Assist Standard/Enterprise)는 영향을 받지 않는다고 보도되지만 - 이번 세션에서는 일차 출처로 독립적으로 확인하지 못했으니, 이 사항이 여러분 조직에 해당한다면 최신 상태로 확인하세요.

결론: 매일 무겁게 쓰는 개인 개발자에게 진짜로 무료인 경로는 두 도구 모두 더 이상 남아 있지 않아요. 이걸 주력으로 쓴다면, 어느 쪽이든 어떤 형태로든 지불해야 해요.

2026-06-18 마감 전에 무료 Gemini CLI 사용자였고 아직 전환하지 않았다면, 실무적인 체크리스트는 이래요: (1) geminicli.com의 quota-and-pricing 페이지에서 여러분 Google 계정이 현재 어느 티어에 있는지 확인하세요. (2) 가벼운 용도로 여전히 무료 CLI 에이전트가 필요하다면, 유료 API 키를 사기 전에 Antigravity CLI를 먼저 써 보세요. (3) 하루 종일 코딩한다면, 결정하기 전에 토큰 종량제(Gemini API 키/Vertex AI)와 Claude Code Pro 같은 고정 플랜을 비교하세요 - 무겁게 매일 쓰는 경우 종량제가 고정 플랜보다 더 비싸질 수 있어요.

자율성 - Auto 모드 vs Plan 모드

Claude Code: auto 모드는 이제 Pro, Max, Team 플랜의 기본 시작 권한 모드예요(code.claude.com/docs/en/permission-modes에서 직접 확인, 2026년 8월: "On Pro, Max, and Team plans, the built-in starting permission mode is auto mode"). 이 모드에서는 여러분이 수동으로 확인하는 대신 백그라운드 분류 모델이 각 동작을 검토해요 - 정해진 고위험 동작(시크릿 접근, 프로덕션 인프라, 파괴적 명령)을 차단한 다음, 나머지는 묻지 않고 실행하게 둬요. 모드는 Shift+Tab으로 언제든 전환할 수 있어요. 안전한 사용 패턴은 Claude Code auto 모드를 참고하세요.

Gemini CLI: 프로젝트 문서에 따르면 Plan 모드는 v0.34.0 이후 기본값이에요 - 에이전트는 먼저 읽고, 탐색하고, 변경을 제안해요. 바로 파일을 편집하지 않고, 실행 전에 여러분이 계획을 승인해요. 더 높은 자율성을 원하면 auto_edit 또는 yolo를 켜세요(플래그 이름이 바뀔 수 있으니 최신 상태로 확인하세요).

구체적으로 와닿게 예를 들어 볼게요. 버그 수정 요청을 입력하면, Plan 모드의 Gemini CLI는 먼저 어떤 파일을 왜 건드릴 계획인지 나열하고, 그다음 실행 전에 여러분의 승인을 기다려요 - Claude Code 자체의 Plan 모드(Shift+Tab으로 진입)와 비슷하지만, Gemini CLI에서는 그게 옵트인 단계가 아니라 기본값이라는 점이 달라요.

에코시스템 - Skills, MCP, 플러그인

Claude Code: MCP 클라이언트, Skills(SKILL.md 파일, 온디맨드로 로드), 공식 플러그인 마켓플레이스(GitHub, GitLab, Atlassian, Linear, Notion, Figma, Vercel, Supabase, Sentry, 그리고 언어별 LSP 플러그인), subagents, 그리고 실험적인 Agent Teams 기능을 갖췄어요. Skills가 어떻게 작동하는지 이해하려면 Claude Code Skills 설명을 참고하세요.

Gemini CLI: 여기에도 MCP 클라이언트가 있고, 더해서 Extensions, Agent Skills(v0.23 이후), Jules 멀티 에이전트 확장, GitHub Actions 연동이 있어요. 개념 수준에서는 둘이 꽤 가까워요(둘 다 MCP와 스킬 기반 확장성에 기대요). 진짜 격차는 마켓플레이스 성숙도예요 - Claude Code가 현재 공식 플러그인 목록이 더 길어요.

구체적인 예예요. 한 에이전트가 PR을 열고 라벨을 붙인 뒤, 병합 전에 검토를 위해 두 번째 에이전트로 넘기는 워크플로가 필요하다면, Claude Code는 subagents와 GitHub 플러그인으로 이걸 처리해요 - 이미 만들어져 있으니 연결만 하면 돼요. Gemini CLI는 Jules(멀티 에이전트)와 GitHub Actions 조합으로 같은 걸 커버하지만, 작성 시점에는 Agent Skills가 v0.23 이후에야 나왔고 플러그인 커뮤니티도 얇아서 더 많은 수동 설정이 필요해요.

AgentKit은 Claude Code와 함께 동작해요 - Gemini CLI와는 안 돼요

시간을 아끼려고 솔직히 말할게요. AgentKit(agentkit.best, 이 사이트가 리뷰하는 유료 skills/subagents 키트)을 쓰려고 Gemini CLI로 갈아탈까 고민 중이라면 - 그러지 마세요, 지원되지 않아요. AgentKit의 --target 목록은 현재 claude-code와 codex(이 사이트의 범위), 그리고 실험적 타깃으로 cursor/grok을 지원해요. gemini-cli 타깃은 없어요(docs.agentkit.best/en/beta/concepts/runtime-adapters에서 확인, 2026년 8월).

이미 Claude Code를 쓰고 있다면, AgentKit은 그 위에서 바로 동작하는 기성 키트(skills, subagents, 리뷰 워크플로) 계층을 더해 줘요 - 필수 제품은 아니지만, 프로세스를 직접 조립하는 수고를 덜어 줘요. 더 깊이 살펴보려면 AgentKit 전체 리뷰를 읽어 보세요.

어느 쪽을 써야 할까요?

짧은 답: 여러분이 이미 어느 에코시스템에 돈을 내고 있는지, 그리고 무엇이 가장 필요한지에 달려 있어요.

• Claude Code를 고르세요, 만약: 이미 Claude에 돈을 내고 있거나, 오늘 쓸 수 있는 가장 자율적인 에이전트(기본값이 auto 모드)를 원하거나, Skills/플러그인 마켓플레이스에 직접 접근하고 싶거나, AgentKit을 쓰고 싶다면요.
• Gemini CLI를 고르세요, 만약: 감사 가능하고 포크 가능한 오픈소스 클라이언트가 필요하거나, Google Cloud/Workspace 안에서 많이 작업하거나, 회사가 이미 엔터프라이즈 Code Assist 라이선스를 보유하고 있다면요.

놓치기 쉬운 한 가지 관점이 있어요. 팀이 이미 Google Workspace/Cloud(Docs, Sheets, BigQuery, Vertex AI)에 깊이 들어가 있고 IT가 엔터프라이즈 Code Assist 라이선스를 이미 승인했다면, Gemini CLI를 추가하는 한계 비용은 거의 0에 가까워요 - Claude Code로 갈아타는 건 기존 스택 밖에 새 비용 항목을 여는 셈이에요. 반대로, 채팅이나 다른 곳의 API 사용을 위해 이미 Pro/Max로 Claude에 돈을 내고 있다면, Claude Code는 추가 비용이라기보다 자연스러운 다음 단계에 가까워요.

세 번째 선택지로 Codex도 저울질하고 있나요? 세 갈래 전체 그림은 Claude Code vs Codex와 자매 글 Codex vs Gemini CLI를 참고하세요. 아직 더 많은 선택지 사이에서 고민된다면, 2026 최고의 AI 코딩 도구 총정리가 더 넓은 후보군을 순위 매겨 놨어요.

자주 묻는 질문(FAQ)

Gemini CLI는 아직 무료인가요?

아니요, 2026-06-18 이후 개인에게는 무료가 아니에요. Google은 무료 티어와 Google One(AI Pro/Ultra) 구독자를 Antigravity CLI로 옮겼어요. Gemini CLI를 계속 쓰려면, 엔터프라이즈 라이선스를 보유하지 않은 한 이제 Gemini API 키나 Vertex AI를 통해 토큰 단위로 지불해요.

Claude Code는 오픈소스인가요?

아니요. Claude Code는 클로즈드 소스예요 - 바이너리/npm 패키지로 배포되고, 소스는 공개되지 않아요. Gemini CLI는 그 반대로, Apache-2.0 하에 오픈소스예요.

컨텍스트 윈도우가 더 큰 쪽은?

Gemini CLI는 Gemini 3 Pro를 1M 컨텍스트 윈도우로 실행해요. Claude Code는 Anthropic API 상에서 Sonnet 5와 Fable 5도 프리미엄 없이 기본으로 1M에 도달하지만, Amazon Bedrock이나 Google Cloud's Agent Platform을 통하면 sonnet 별칭이 Sonnet 4.5로 해석되어 컨텍스트 윈도우가 200K뿐이에요 - 실제 컨텍스트 윈도우는 Claude Code를 어느 제공자로 실행하느냐에 달려 있어요.

Claude Fable 5는 무엇인가요?

현재 Claude Code에서 가장 뛰어난 모델로, 근본 원인 디버깅이나 아키텍처 결정처럼 어렵고 오래 걸리는 작업에 적합해요. 기본값이 아니에요 - /model fable로 선택하고, 플랜에 따라 일부 요청은 사용 크레딧에 청구될 수 있어요.

AgentKit은 Gemini CLI와 동작하나요?

아니요. AgentKit의 --target 목록에는 현재 claude-code와 codex(그리고 실험적인 cursor/grok)만 있어요 - gemini-cli는 없어요.

2026년에는 어느 쪽을 골라야 할까요?

가장 자율적인 에이전트, 더 넓은 skills/플러그인 에코시스템이 필요하거나 AgentKit을 쓰고 싶다면 Claude Code를 고르세요. 감사 가능하고 포크 가능한 오픈소스 클라이언트가 필요하거나 이미 Google Cloud/Workspace에 묶여 있다면 Gemini CLI를 고르세요.

결론

둘 다 강력한 터미널 코딩 에이전트지만, 2026년의 이야기는 더 이상 2025년 같지 않아요. Gemini CLI는 개인용 무료 티어를 잃었고, Claude Code의 기본 모델은 Sonnet 5로 올라갔으며 Fable 5가 선택적 업그레이드로 더해졌어요. 무겁게 쓰는 사용자에게는 이제 어느 쪽도 진짜 무료가 아니에요 - 유행하는 모델명이 아니라, 여러분이 이미 투자한 에코시스템과 오픈소스/셀프 호스팅이 필수 요건인지 여부로 고르세요. 세 번째 선택지로 Codex도 저울질하고 있나요? Claude Code vs Codex를 참고하세요.