2025년 대부분의 기간 동안, 터미널 AI 코딩 도구 비교는 간단했습니다: Claude Code 대 Gemini CLI. 그러다 2026년 6월 18일이 찾아왔습니다. Google은 개인 사용자를 위한 Gemini CLI의 무료 호스팅 티어(free hosted tier)를 종료하고, 이들을 Antigravity CLI로 이동시켰습니다. 이는 다른 명령어(agy)와 더 야심 찬 멀티 에이전트 아키텍처 (multi-agent architecture)를 가진 새로운 폐쇄 소스 (closed-source) 도구입니다. 이로 인해 비교 구도가 상당히 바뀌었습니다.

이 기사는 두 도구가 현재 어디에 위치해 있는지 다룹니다: Claude Code가 무엇을 제공하는지, Gemini CLI가 무엇이었는지(그리고 유료 API 키 사용자에게는 여전히 무엇인지), Antigravity CLI가 무엇을 도입했는지, 그리고 — 가장 실용적으로 — 여러분이 터미널에서 어떤 것을 실행해야 하는지를 다룹니다.

각 도구의 실제 정체

Claude Code는 Anthropic의 터미널 AI 에이전트 (agent)입니다. 로컬에서 실행되며, 파일 시스템 (filesystem)을 읽고, 승인 하에 셸 명령 (shell commands)을 실행하며, 프로젝트 컨텍스트 파일 (project context files)을 통해 코드베이스 (codebase)를 이해하고, 자율적으로 작업을 반복합니다. Claude 모델 (기본적으로 Sonnet 4, 최대 성능을 위해 Opus 4 사용)을 사용하며, Anthropic 구독 또는 API 키가 필요합니다.

Gemini CLI는 Google I/O 2025에서 출시된 Google의 오픈 소스 (open-source) 터미널 AI 에이전트였습니다. 기본적인 모델은 동일합니다: 터미널에서 실행되고, 파일을 편집하며, 셸 명령을 실행하고, 프로젝트 메모리 (project memory)를 지원합니다. 표준 Google 계정에서 분당 60회 요청, 일일 1,000회 요청이라는 진정으로 매력적인 무료 티어를 제공하는 Gemini 모델을 사용했습니다. 오픈 소스 코드베이스는 여전히 존재하며 유료 Gemini API 키로 여전히 작동합니다.

Antigravity CLI는 Google I/O 2026에서 발표되어 6월 18일부터 운영 중인 Gemini CLI의 무료 개인 티어를 대체하는 Google의 도구입니다. 이는 폐쇄 소스 (closed-source)이며, Go 언어로 작성되었고, agy로 호출되며, 멀티 에이전트 (multi-agent) 접근 방식을 취합니다. 즉, 터미널을 차단하지 않고 복잡한 작업을 처리하기 위해 백그라운드 에이전트 (background agents)를 생성할 수 있습니다.

설정 및 인증 (Setup and Authentication)

Claude Code

npm install -g @anthropic-ai/claude-code
claude

Claude.ai Pro 또는 Max를 사용하는 경우 첫 실행 시 브라우저 인증 (browser auth)이 열립니다. 또는 직접적인 API 액세스를 위해 ANTHROPIC_API_KEY를 설정하십시오.

Gemini CLI (API 키 모드 — 여전히 작동함)

npm install -g @google/gemini-cli
export GEMINI_API_KEY=your_key_here
gemini

Antigravity CLI

npm install -g @google/antigravity-cli
agy

Antigravity는 Google 계정 (OAuth)을 통해 인증하거나, 기업용의 경우 Vertex AI 자격 증명을 사용합니다.

프로젝트 메모리 (Project Memory): CLAUDE.md vs GEMINI.md

두 도구 모두 프로젝트 루트(root)에 있는 마크다운 (markdown) 파일을 사용하여 AI에게 코드베이스에 대한 지속적인 컨텍스트 (context)를 제공합니다.

Claude Code는 CLAUDE.md를 사용합니다:

# Project: Payment API

## Architecture
...

Gemini CLI는 동일한 형식의 GEMINI.md를 사용합니다. Antigravity CLI는 GEMINI.md를 인식하지만, ANTIGRAVITY.md가 존재할 경우 이를 함께 읽습니다.

2026년 가격 정책 (Pricing)

컨텍스트 윈도우 (Context Window)

Google의 툴링은 Gemini 1.5부터 1M 토큰 컨텍스트를 지원해 왔습니다. Claude의 1M 컨텍스트는 특히 Opus 4 (Max 구독)가 필요합니다. 일상적인 코딩 작업에는 200K로도 충분합니다. 하지만 "이 300개 파일로 구성된 전체 코드베이스를 분석해줘"와 같은 작업에서는 1M가 진정으로 중요합니다.

에이전트 능력 (Agentic Capabilities)

Claude Code의 강점

**훅 (Hooks)**은 자동화를 위한 Claude Code의 독보적인 기능입니다. 도구 호출 전/후, 또는 Claude가 파일을 수정할 때와 같이 모든 이벤트에서 셸 명령 (shell commands)을 실행할 수 있습니다:

{
  "hooks": {
    "PostToolUse": [
...

Claude가 작성하는 모든 파일은 자동으로 린트 (lint)됩니다. 이러한 긴밀한 통합 덕분에 Claude Code는 실제 개발 환경처럼 느껴집니다.

**서브에이전트 (Subagents)**를 통해 Claude Code는 독립적인 하위 작업을 동시에 처리하기 위해 병렬로 Claude 인스턴스를 실행할 수 있습니다. 15분이 걸리는 작업도 세 개의 서브에이전트가 병렬로 작동하면 외부 오케스트레이션 (orchestration) 없이 5분 만에 완료될 수 있습니다.

**MCP 통합 (MCP integration)**은 모델 컨텍스트 프로토콜 (Model Context Protocol)을 통해 Claude Code를 데이터베이스, API, 웹 브라우저와 같은 외부 도구에 연결합니다.

Antigravity CLI의 강점

**백그라운드 에이전트 (Background agents)**는 터미널을 차단하지 않고 실행됩니다:

agy task "Refactor all API routes to use the new error handling middleware" --background
agy status  # 실행 중인 작업 확인

Google Search grounding을 통해 Antigravity는 최신 문서나 에러 메시지 조회가 필요할 때 Google을 직접 검색할 수 있습니다. 이는 익숙하지 않은 라이브러리를 디버깅할 때 유용합니다.

멀티모달 입력 (Multi-modal input): 이미지, PDF 또는 스크린샷을 터미널에서 직접 전달하면 Antigravity가 이를 네이티브하게 처리합니다.

코드 품질: 솔직한 평가

복잡한 다중 파일 리팩토링 (Complex multi-file refactors): Claude Code는 상호 의존성이 있는 10개 이상의 파일에 걸친 변경 사항에 대해 더 신뢰할 수 있는 경향이 있습니다. 대규모 작업 전반에 걸쳐 무엇이 왜 변경되었는지 추적하는 능력이 더 뛰어납니다.

대규모 코드베이스 분석 (Large codebase analysis): Google의 1M 토큰 컨텍스트 (context)는 전체 대규모 코드베이스를 한 번에 로드해야 하는 작업에서 우위를 점하게 해줍니다.

디버깅 추론 (Debugging reasoning): Claude Code는 단순히 해결책만 제시하는 것이 아니라 근본 원인을 설명합니다. Antigravity는 설명은 적지만 해결책을 더 빠르게 제공하는 경향이 있습니다.

Claude Code를 사용해야 할 때

• 여러 파일에 걸친 복잡한 리팩토링이 필요할 때
• 훅 (hooks)을 통한 긴밀한 자동화 (모든 쓰기 작업 시 lint, format, test 수행)가 필요할 때
• 애플리케이션에서 이미 Claude API를 사용 중일 때
• 병렬 작업 실행을 위한 서브에이전트 (Subagents)가 필요할 때
• 팀이 CLAUDE.md 표준을 따르고 있을 때

Antigravity CLI를 사용해야 할 때

• 1M 컨텍스트가 필요한 매우 큰 코드베이스를 다룰 때
• 실시간 문서 조회를 위한 Google Search grounding이 필요할 때
• 이미 Google Cloud / Workspace 생태계를 사용 중일 때
• 이미지/PDF를 터미널 입력으로 직접 사용할 때
• 차단되지 않는 장시간 실행 작업을 위한 백그라운드 에이전트가 필요할 때
• 비용 우선순위가 높을 때 — 개인 계정을 위한 Antigravity의 무료 티어

빠른 참조 (Quick Reference)

# Claude Code
npm install -g @anthropic-ai/claude-code
claude                           # 세션 시작
...

실제로 많은 개발자들은 두 가지를 모두 사용합니다. 대화형 개발과 진지한 리팩토링에는 Claude Code를 사용하고, 1M 컨텍스트나 Google Search grounding이 차이를 만드는 작업에는 Antigravity CLI를 사용합니다.

전체 기사는 stacknotice.com/blog/claude-code-vs-gemini-cli-2026에서 확인하실 수 있습니다.