Claude Code vs Codex CLI vs Gemini CLI 비교: 터미널 AI 코딩 에이전트 선택 가이드

1. 도입부: 왜 터미널 AI 코딩 에이전트 비교가 필요한가

VS Code나 Cursor 같은 IDE 기반 AI 도구가 익숙한 개발자도 많지만, 실제 개발 환경에서는 여전히 터미널이 중심인 경우가 많습니다. Git 브랜치 전환, Docker Compose 실행, 테스트 재현, 로그 확인, 배포 스크립트 검토, 리팩터링 diff 확인까지 대부분의 실무 흐름은 결국 CLI에서 마무리됩니다.

그래서 최근에는 터미널 AI 코딩 에이전트가 단순한 챗봇이 아니라 “프로젝트 폴더 안에서 코드를 읽고, 파일을 수정하고, 테스트를 실행하고, Git 변경사항을 설명하는 개발 보조 에이전트”로 쓰이고 있습니다. 이 글에서는 Claude Code Codex CLI Gemini CLI 비교를 중심으로, 개인 개발자와 팀이 어떤 기준으로 도구를 선택해야 하는지 정리합니다.

이 글의 기준일은 2026년 6월 15일 KST입니다. 가격, 요금제, 쿼터, 지원 계정, Gemini CLI와 Antigravity CLI 전환 일정은 변동 가능성이 높으므로 실제 도입 전 공식 문서를 반드시 다시 확인해야 합니다.

이 글은 공식 문서와 공개된 기능을 기준으로 한 정성 비교입니다. 필자가 세 도구를 동일한 저장소에서 벤치마크했다는 의미가 아니며, “직접 테스트 결과”처럼 단정하지 않습니다.

2. 5줄 핵심 요약

• 터미널 중심 개발자라면 Claude Code와 Codex CLI가 가장 자연스러운 후보입니다.
• 개인 개발자 가성비는 기존 구독이 무엇인지에 따라 달라지며, ChatGPT를 이미 쓴다면 Codex CLI가 유리할 수 있습니다.
• 기존 코드베이스 분석·멀티파일 수정은 Claude Code와 Codex CLI가 강한 편이고, Gemini CLI는 Google 생태계와 1M 컨텍스트 장점이 있습니다.
• Gemini CLI 개인/Google AI Pro/Ultra 사용자는 2026년 6월 18일 전후 Antigravity CLI 전환 이슈를 반드시 확인해야 합니다.
• 회사 코드에는 개인 무료 계정보다 Team/Business/Enterprise, API 키, 데이터 보존·학습 정책, 명령 승인 정책을 먼저 확인해야 합니다.

3. 작성 시점 기준 업데이트: Gemini CLI와 Antigravity CLI 확인

작성 시점 기준: 2026년 6월 15일 KST
Google은 Gemini CLI와 Gemini Code Assist IDE 확장을 Antigravity 중심으로 통합한다고 공지했습니다. 공식 Google Developers Blog에 따르면 Antigravity CLI는 이미 제공되며, 2026년 6월 18일부터 Google AI Pro, Google AI Ultra, 무료 개인용 Gemini Code Assist 계정의 Gemini CLI 및 Gemini Code Assist IDE 확장은 요청 처리를 중단합니다. 반면 Gemini Code Assist Standard/Enterprise 라이선스 또는 Google Cloud 기반 기업 사용자는 Gemini CLI 접근이 유지된다고 안내되어 있습니다.

이 때문에 이 글에서 Gemini CLI를 설명할 때는 다음처럼 해석하는 것이 안전합니다.

구분작성 시점 기준 설명

개인 Gmail / 무료 Gemini Code Assist	Gemini CLI를 새로 학습하기보다 Antigravity CLI 전환을 우선 고려
Google AI Pro / Google AI Ultra	2026년 6월 18일 이후 Gemini CLI 요청 중단 예정이므로 Antigravity CLI 기준으로 재검토
Gemini Code Assist Standard / Enterprise	Google 공지상 Gemini CLI 접근 유지
Google Cloud 기반 팀	Gemini Code Assist, Vertex AI, Google Cloud 프로젝트·IAM·VPC Service Controls 정책과 함께 검토
블로그 발행 후 업데이트 필요 지점	2026년 6월 18일 이후 Gemini CLI 개인 계정 실행 가능 여부, Antigravity CLI 가격·쿼터·기능 parity

Antigravity CLI는 공식 GitHub README 기준으로 macOS/Linux 설치 스크립트, Windows PowerShell/CMD 설치 스크립트를 제공하며, 시스템 키링과 Google Sign-In 기반 인증을 사용한다고 설명되어 있습니다. 또한 AI 코딩 에이전트의 자율 코드 실행, 데이터 유출, 프롬프트 인젝션, 공급망 리스크를 사용자가 모니터링해야 한다고 명시합니다.

4. Claude Code, Codex CLI, Gemini CLI 한눈에 비교

표 1. 핵심 비교표

항목Claude CodeCodex CLIGemini CLI추천 도구

설치 난이도	macOS/Linux/WSL, Windows PowerShell/CMD, Homebrew, WinGet 지원	macOS/Linux 설치 스크립트, Windows, npm, Homebrew 지원	Node.js 20+ 기반 npm/npx/Homebrew 중심	초보자는 Codex CLI 또는 Claude Code
지원 OS	macOS, Linux, WSL, Windows. IDE·Desktop·Web도 제공	macOS, Windows, Linux. Windows PowerShell 또는 WSL2 지원	macOS, Linux, Windows. 공식 설치 문서상 Node.js 20+ 필요	OS 범위는 세 도구 모두 충분
인증 방식	Claude 구독, Anthropic Console, 일부 클라우드 제공자	ChatGPT 로그인 또는 API 키	Google 로그인, Gemini API Key, Vertex AI, Cloud Shell	회사는 기업 계정 우선
터미널 UX	대화형 CLI, 파일 수정 승인, Git 작업, MCP	전체 화면 TUI, diff 표시, 승인/거절, /review	터미널 우선, Google Search grounding, MCP, 정책 엔진	터미널 UX는 Claude Code·Codex CLI
코드베이스 이해	전체 코드베이스 이해·멀티파일 작업을 공식 문서에서 강조	선택 디렉터리에서 코드 읽기·수정·실행	1M 토큰 로컬 코드베이스 인식 쿼터 안내	대규모 분석은 Claude/Codex, Google 생태계는 Gemini
멀티파일 수정	강점	강점	가능	Claude Code 또는 Codex CLI
테스트 실행	테스트 실행·실패 수정 흐름에 적합	샌드박스 안에서 테스트 러너 실행	shell command·sandbox expansion 기반 실행 가능	Claude Code 또는 Codex CLI
Git 작업	commit, branch, PR 생성, GitHub Actions	diff 리뷰, GitHub @codex review, 자동 리뷰	Gemini Code Assist GitHub 리뷰 가능하나 소비자 버전 종료 일정 주의	PR 리뷰 자동화는 Codex 또는 Claude
명령 실행 권한	읽기 기본, 수정·테스트·명령은 승인	OS sandbox, 네트워크 기본 off, workspace-write	default approval, plan, auto_edit, yolo, policy engine	안전 기본값은 Claude/Codex
MCP 지원	공식 지원	CLI·IDE Extension에서 MCP 지원	MCP 서버 지원	세 도구 모두 가능
IDE 연동	VS Code, Cursor 계열, JetBrains	IDE Extension, Codex app	Gemini Code Assist IDE 확장. 개인용은 전환 주의	VS Code 병행은 Claude/Codex/Gemini 기업
무료/유료 사용성	Pro/Max/Team/Enterprise 또는 Console/API 중심	Free/Go/Plus/Pro/Business/Edu/Enterprise 포함, API 키 가능	개인 무료 쿼터가 있었지만 Antigravity 전환 영향 큼	개인 가성비는 기존 구독 기준
팀 도입 적합성	Team/Enterprise, managed settings, OTel	Business/Enterprise, RBAC, retention, GitHub review	Standard/Enterprise, IAM, Google Cloud 보안	회사 환경 따라 다름
초보자 추천도	Claude 구독이 있으면 좋음	ChatGPT 계정 기반으로 시작하기 쉬움	개인은 Antigravity 전환 때문에 신중	Codex CLI 우선, Claude 구독자는 Claude Code

Claude Code는 공식 문서에서 코드베이스 읽기, 파일 수정, 명령 실행, 개발 도구 통합을 제공한다고 설명하고, Codex CLI는 OpenAI의 로컬 터미널 코딩 에이전트로 선택한 디렉터리 안에서 코드 읽기·수정·실행이 가능하다고 안내합니다. Gemini CLI는 오픈소스 터미널 에이전트, Google Search grounding, 파일 작업, shell command, MCP 등을 제공하지만, 개인 계정은 Antigravity CLI 전환 일정을 함께 봐야 합니다.

5. Claude Code란?

Claude Code는 Anthropic의 터미널 기반 AI 코딩 에이전트입니다. 공식 문서상 Claude Code는 코드베이스를 읽고, 파일을 수정하고, 명령을 실행하고, 개발 도구와 통합되는 agentic coding tool로 설명됩니다. 터미널 CLI뿐 아니라 VS Code, JetBrains, Desktop, Web 환경도 제공됩니다.

Claude Code 장점

장점설명

코드베이스 이해와 수정 흐름이 자연스러움	프로젝트 폴더에서 claude를 실행하고, 구조 파악·버그 수정·테스트 실행·커밋 메시지 작성까지 이어가기 좋습니다.
권한 승인 모델이 명확함	기본은 읽기 중심이며, 파일 수정·테스트·명령 실행은 명시적 승인을 요구합니다.
Git 작업과 PR 작성 흐름 지원	commit message, branch, PR 생성, GitHub Actions 연동을 공식 문서에서 안내합니다.
MCP·CLAUDE.md·skills·hooks	팀의 코딩 규칙, 반복 워크플로우, 외부 도구 연동을 구조화하기 좋습니다.
팀 보안 설정에 유리	managed settings, 권한 설정, OpenTelemetry 모니터링 등 조직 도입에 필요한 기능이 있습니다.

Claude Code는 read-only 권한을 기본으로 하며, 편집·테스트·명령 실행이 필요할 때 명시적 승인을 요청합니다. Bash 명령 중 시스템을 수정할 수 있는 명령은 승인 대상이고, 쓰기 권한은 기본적으로 시작한 폴더와 하위 폴더로 제한됩니다.

Claude Code 단점

단점설명

무료 체험 관점에서는 진입 장벽이 있을 수 있음	대부분의 주요 사용은 Claude Pro/Max/Team/Enterprise 또는 Console 계정 기준입니다.
사용량 예측이 단순하지 않음	코드베이스 크기, 모델 선택, 세션 길이, MCP 사용량에 따라 비용·쿼터 체감이 달라집니다.
강한 권한을 주면 위험도도 커짐	Accept Edits, allowlist, MCP 서버, shell command 권한을 과하게 열면 보안 검토가 필요합니다.
회사 코드에는 플랜별 데이터 보존 정책 확인 필요	소비자·상업용·API 계정의 데이터 보존·학습 설정이 다르므로 사내 정책과 맞춰야 합니다.

Claude Code 데이터 보존은 계정 유형과 설정에 따라 다릅니다. Anthropic 문서는 소비자 사용자의 모델 개선 허용 여부에 따라 5년 또는 30일 보존, Team/Enterprise/API의 표준 30일 보존, 일부 Enterprise의 Zero Data Retention 가능성을 설명합니다. 로컬 세션 transcript가 기본적으로 ~/.claude/projects/에 plaintext로 저장된다는 점도 확인해야 합니다.

6. Codex CLI란?

Codex CLI는 OpenAI의 터미널 기반 코딩 에이전트입니다. 공식 문서 기준 Codex CLI는 로컬 터미널에서 실행되며, 선택한 디렉터리 안의 코드를 읽고 수정하고 실행할 수 있습니다. OpenAI는 Codex CLI가 Rust로 빌드되었고 오픈소스라고 설명합니다.

Codex CLI 장점

장점설명

설치와 시작이 단순함	codex 실행 후 ChatGPT 계정 또는 API 키로 인증할 수 있습니다.
터미널 TUI가 강함	전체 화면 터미널 UI에서 계획, diff, 승인/거절, prompt history를 확인할 수 있습니다.
sandbox와 approval 모델이 명확함	기본적으로 네트워크 접근이 꺼져 있고, 쓰기 권한은 active workspace로 제한됩니다.
GitHub PR 리뷰 자동화가 강함	@codex review, 자동 리뷰, GitHub Action, 로컬 /review 흐름이 공식 문서에 있습니다.
개인 개발자 가성비가 좋을 수 있음	ChatGPT Free/Go/Plus/Pro 등 기존 계정에 Codex가 포함되는 구조입니다.

OpenAI 문서에 따르면 Codex CLI는 기본 권한 모드에서 sandbox를 자동 적용하며, 로컬 CLI/IDE 기본값은 네트워크 접근 없음과 active workspace 쓰기 제한을 포함합니다. ChatGPT 로그인과 API 키 인증을 모두 지원하고, 로그인 방식에 따라 workspace 권한·RBAC·retention 또는 API 조직 데이터 정책이 적용됩니다.

Codex CLI 단점

단점설명

사용량 제한이 모델·작업 복잡도에 따라 체감 차이가 큼	공식 문서도 작업 크기, 코드베이스 복잡도, 로컬/클라우드 여부에 따라 메시지 소모가 달라진다고 설명합니다.
API 키 사용 시 비용 예측이 필요	API 키 인증은 표준 API 요금으로 과금되며, ChatGPT 플랜 포함 사용량과 다릅니다.
자동화 권한을 과하게 열면 위험	approval과 sandbox를 낮추면 명령 실행 위험이 커집니다.
GitHub 자동 리뷰는 cloud 설정과 저장소 권한 검토 필요	팀 저장소 연결, AGENTS.md, review settings, GitHub 권한을 확인해야 합니다.

Codex 가격 문서 기준 Codex는 ChatGPT Free, Go, Plus, Pro, Business, Edu, Enterprise에 포함되며, Plus는 월 $20, Pro는 월 $100부터 시작합니다. 사용량은 5시간 창 기준 모델별 메시지 범위로 안내되며, 실제 한도는 작업 복잡도와 모델에 따라 달라집니다.

7. Gemini CLI란?

Gemini CLI는 Google Gemini를 터미널에서 직접 사용할 수 있게 만든 오픈소스 AI 에이전트입니다. 공식 GitHub README는 Gemini CLI를 터미널에 Gemini 기능을 가져오는 오픈소스 AI agent로 설명하고, 무료 tier, Gemini 3 모델, 1M token context window, Google Search grounding, 파일 작업, shell command, web fetching, MCP 지원을 강조합니다.

Gemini CLI 장점

장점설명

Google 계정 기반 진입이 쉬웠음	개인 Google 계정 무료 쿼터가 컸고, API key·Vertex AI 인증도 가능했습니다.
긴 컨텍스트와 Google 생태계	1M token local codebase awareness와 Google Cloud 연동 관점에서 강점이 있습니다.
MCP·policy engine·sandbox 기능	MCP 서버, 정책 엔진, sandbox expansion, trusted folders 등을 제공합니다.
Cloud Shell·Cloud Workstations와 궁합	Google Cloud 기반 개발 환경에서는 설치·인증 흐름이 자연스럽습니다.

Gemini CLI 인증은 Login with Google, Gemini API key, Vertex AI, headless mode, Cloud Shell을 지원합니다. 공식 Codelab은 로컬 설치 시 Node.js 20+가 필요하며 npm install -g @google/gemini-cli 또는 npx 실행을 안내합니다.

Gemini CLI 단점

단점설명

개인 계정은 Antigravity CLI 전환 영향이 큼	2026년 6월 18일 이후 개인/Google AI Pro/Ultra 계정에서 Gemini CLI 요청 중단 예정입니다.
제품 포지셔닝이 변하는 중	Gemini CLI 자체보다 Antigravity CLI가 개인 사용자의 장기 경로가 될 가능성이 큽니다.
보안 설정이 다양해 초보자에게 복잡할 수 있음	approval mode, yolo, tool sandboxing, policy engine, trusted folders를 이해해야 합니다.
회사 도입은 Google Cloud 라이선스·IAM 전제	Standard/Enterprise, Google Cloud 프로젝트, IAM, VPC Service Controls까지 함께 봐야 합니다.

Gemini CLI의 /settings 문서는 default approval mode가 도구 실행 시 승인을 요청하고, auto_edit은 편집 도구 자동 승인, plan은 read-only 계획 모드, yolo는 command line에서만 가능하다고 설명합니다. 또한 policy engine은 tool call을 allow, deny, ask_user로 제어할 수 있습니다.

8. 세 도구의 핵심 차이

비교 축Claude CodeCodex CLIGemini CLI

제품 방향	Claude 기반 개발 에이전트, terminal+IDE+web+desktop	OpenAI Codex 생태계의 로컬·클라우드·GitHub 코딩 에이전트	Google Gemini 터미널 에이전트, 단 개인은 Antigravity로 전환
가장 강한 사용처	기존 코드베이스 이해, 수정, Git 작업, 팀 규칙 반영	터미널 TUI, sandbox, local review, GitHub PR review	Google 생태계, 긴 컨텍스트, Cloud Shell/Vertex AI
개인 개발자 기준	Claude 구독자가 쓰기 좋음	ChatGPT 계정 보유자에게 유리	개인은 Antigravity CLI 전환 고려
팀 기준	Claude Team/Enterprise, managed settings	ChatGPT Business/Enterprise, RBAC, GitHub review	Gemini Code Assist Standard/Enterprise, Google Cloud IAM
장기 안정성	비교적 명확	비교적 명확	Gemini CLI 개인 사용은 전환기

핵심은 “어떤 모델이 더 똑똑한가”가 아니라 내 개발 흐름에서 권한, 비용, 보안, Git 리뷰, 테스트 실행을 어디까지 맡길 수 있는가입니다. 터미널 코딩 도구는 코드를 제안하는 수준을 넘어 실제 파일과 명령을 다루기 때문에, 모델 성능만 보고 선택하면 안 됩니다.

9. 설치와 실행 방식 비교

공식 문서 기준 설치 명령어

Claude Code 설치

 

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew
brew install --cask claude-code

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# 프로젝트 폴더에서 실행
cd your-project
claude

 

Claude Code 공식 문서는 macOS/Linux/WSL, Windows PowerShell/CMD, Homebrew, WinGet 설치와 프로젝트 폴더에서 claude 실행을 안내합니다.

Codex CLI 설치

 

# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# 프로젝트 폴더에서 실행
cd your-project
codex

 

OpenAI 공식 Codex CLI 문서는 macOS/Linux 설치 스크립트와 codex 실행, 첫 실행 시 ChatGPT 계정 또는 API 키 인증을 안내합니다. Codex CLI는 macOS, Windows, Linux에서 사용할 수 있고 Windows에서는 PowerShell native 또는 WSL2를 사용할 수 있습니다.

공식 GitHub 저장소와 문서 기준으로 npm, Homebrew, Windows 설치 옵션도 제공됩니다.

 

# npm
npm install -g @openai/codex

# Homebrew
brew install --cask codex

# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

 

Gemini CLI 설치

 

# Node.js 20+ 필요
npm install -g @google/gemini-cli

# 실행
gemini

# 설치 없이 실행
npx @google/gemini-cli

 

Gemini CLI 공식 자료는 Node.js 20+를 요구하고, npm global install 또는 npx 실행을 안내합니다. GitHub README에는 npm, npx, Homebrew, MacPorts, Anaconda 설치 옵션이 정리되어 있습니다.

Antigravity CLI 전환 대비 설치

 

# macOS / Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Windows PowerShell
irm https://antigravity.google/cli/install.ps1 | iex

# Windows CMD
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

 

Antigravity CLI 공식 GitHub README는 위 설치 명령어와 Google Sign-In 기반 인증 흐름을 안내합니다.

로그인/인증 방식 비교

항목Claude CodeCodex CLIGemini CLI

기본 로그인	Claude 계정, 구독, Console	ChatGPT 로그인	Google 로그인
API 키	Anthropic Console/API 사용 가능	OpenAI API key 가능	Gemini API Key 가능
클라우드/기업	Bedrock, Vertex AI, Foundry 등	ChatGPT workspace, Enterprise, API org	Vertex AI, Google Cloud Project
로컬 credential	공식 문서 기준 보안 저장소·파일 권한	ChatGPT access token 또는 API key	Google credential cache
회사 사용 시	Team/Enterprise 또는 API 정책 확인	Business/Enterprise 또는 API org 정책 확인	Standard/Enterprise 또는 Vertex AI 권장

Codex는 ChatGPT 로그인과 API 키 인증을 모두 지원하며, ChatGPT 로그인은 workspace 권한·RBAC·retention 설정을 따르고 API key는 API 조직의 retention·data-sharing 설정을 따릅니다. Gemini CLI는 Google 로그인, API key, Vertex AI를 지원하고, Google AI Pro/Ultra 사용자는 Google 로그인 방식 사용을 안내합니다.

10. 코드베이스 이해와 수정 능력 비교

코드베이스 이해 능력

기준Claude CodeCodex CLIGemini CLI

처음 보는 프로젝트 구조 파악	강함. CLAUDE.md, auto memory, 코드 읽기 흐름	강함. TUI에서 plan과 diff 확인	1M context 장점, Google Search grounding
대규모 코드베이스	강함. 다만 사용량 관리 필요	강함. sandbox와 diff review 장점	긴 컨텍스트 장점, 단 개인 전환 이슈
기존 패턴 반영	CLAUDE.md, skills, hooks	AGENTS.md, config, MCP	GEMINI.md, settings, MCP
팀 규칙 주입	managed settings, CLAUDE.md	AGENTS.md, managed config	workspace settings, policy, Google Cloud 설정

Claude Code는 프로젝트 루트의 CLAUDE.md를 읽어 코딩 표준, 아키텍처 결정, 선호 라이브러리, 리뷰 체크리스트를 반영할 수 있다고 설명합니다. Codex는 프로젝트별 .codex/config.toml, AGENTS.md, MCP 설정을 통해 팀 규칙과 외부 컨텍스트를 연결할 수 있습니다. Gemini CLI는 settings.json, MCP, policy engine, trusted folders, GEMINI.md 기반 흐름이 있습니다.

멀티파일 수정 능력

작업추천

작은 버그 수정	Codex CLI, Claude Code
여러 파일에 걸친 리팩터링	Claude Code, Codex CLI
Google Cloud 관련 설정 포함	Gemini CLI 또는 Gemini Code Assist Standard/Enterprise
팀 규칙을 강하게 적용해야 하는 작업	Claude Code, Codex CLI
개인 무료 계정으로 실험	Codex CLI 우선, Gemini는 Antigravity 전환 확인

멀티파일 수정은 “수정 자체”보다 수정 전 계획 → 변경 diff 확인 → 테스트 실행 → 실패 재수정 → Git diff 리뷰까지 이어지는지가 중요합니다. 이 흐름에서는 Claude Code와 Codex CLI가 안정적인 선택지입니다. Gemini CLI는 기능 자체는 강하지만, 개인 계정은 전환 일정 때문에 장기 선택지로 보기 어렵습니다.

11. 명령 실행, 파일 수정, 승인 방식 비교

항목Claude CodeCodex CLIGemini CLI

기본 안전 모델	read-only 기본, 수정·테스트·명령 승인	sandbox + approval, network off	default approval, plan mode, policy engine
파일 수정	제안 변경 승인 후 적용	workspace-write 범위에서 적용	write_file tool, approval mode 영향
shell command	시스템 수정 명령 승인 필요	sandbox 안에서 실행, 경계 밖은 승인	shell_exec, sandbox expansion
위험한 명령 차단	allow/deny, sandbox, permissions	sandbox mode, approval policy	policy engine으로 deny/ask_user 가능
초보자 권장 설정	자동 승인 최소화	default 또는 read-only 시작	plan/default 모드, yolo 금지

Claude Code는 read-only 기본 권한, explicit permission, write access restriction을 공식 보안 문서에서 설명합니다. Codex는 OS-enforced sandbox와 approval policy를 함께 사용하며, 기본적으로 네트워크는 꺼져 있고 쓰기는 active workspace로 제한됩니다. Gemini CLI는 sandbox expansion, tool-level sandboxing, default approval mode, policy engine을 제공합니다.

실무에서는 세 도구 모두 다음 원칙을 지키는 것이 좋습니다.

원칙이유

처음에는 read-only 또는 plan 모드로 시작	에이전트가 프로젝트 구조를 이해하기 전 파일을 바꾸지 않게 하기 위해
.env, private key, production config를 프롬프트에 넣지 않기	모델 전송·로그·세션 저장 리스크 때문
rm, mv, curl, wget, docker, kubectl, terraform 명령은 수동 승인	로컬·클라우드 자원에 영향을 줄 수 있음
변경 후 반드시 git diff 확인	에이전트가 의도하지 않은 파일까지 수정할 수 있음
테스트 실패 원인 설명을 먼저 요구	무작정 수정 루프를 돌리면 비용과 위험이 증가

12. Git, 테스트, Docker 작업에서의 차이

Git diff 확인과 변경사항 검토 방식 비교

작업Claude CodeCodex CLIGemini CLI

git diff 설명	가능	가능	가능
전용 코드 리뷰 흐름	/code-review 계열, PR/CI 연동	/review, GitHub @codex review	Gemini Code Assist GitHub 리뷰, CLI extension 가능
커밋 메시지 작성	공식 예시 있음	가능	가능
PR 생성	Claude가 PR 설명 생성 가능	Codex cloud/GitHub 연동 가능	Gemini Code Assist GitHub 가능
자동 PR 리뷰	GitHub Actions, GitHub Code Review	GitHub automatic reviews	Gemini Code Assist GitHub. 소비자 버전 종료 일정 주의

Codex GitHub 통합은 PR 댓글에서 @codex review를 호출하거나 automatic reviews를 설정할 수 있고, Codex는 PR diff와 repository guidance를 보고 GitHub code review를 게시합니다. Claude Code GitHub Actions는 PR이나 issue에서 @claude mention으로 코드 분석, PR 생성, 기능 구현, 버그 수정을 할 수 있다고 안내합니다. Gemini Code Assist on GitHub는 PR 요약과 코드 리뷰를 제공하지만, 소비자 버전은 2026년 7월 17일 종료 일정이 공지되어 있습니다.

테스트 실행과 오류 수정

작업Claude CodeCodex CLIGemini CLI

테스트 명령 찾기	package.json, pyproject, Makefile 등 분석 요청	TUI에서 계획 확인 후 실행	코드베이스 인식 후 shell command
실패 테스트 재현	승인 후 실행	sandbox 안에서 실행	sandbox expansion 필요 가능
테스트 코드 생성	기존 패턴을 보고 추가 요청 가능	기존 테스트 스타일 기반 요청 가능	가능
실패 원인 설명	강점	강점	가능
권장 프롬프트	“수정 전 원인과 diff 계획을 먼저 보여줘”	“먼저 실패를 재현하고 최소 수정만 해줘”	“plan mode로 분석 후 수정 제안”

테스트 작업은 “AI가 테스트를 만들어준다”보다 “테스트를 실행할 권한을 줄 것인가”가 더 중요합니다. 사내 저장소에서는 네트워크, 데이터베이스, Docker, 외부 API 호출이 섞여 있을 수 있으므로 테스트 명령도 무조건 승인하면 안 됩니다.

Docker Compose 오류 수정

Docker Compose는 로컬 파일만 수정하는 작업처럼 보여도 실제로는 컨테이너 실행, 네트워크, 볼륨 마운트, 이미지 pull, secret 노출이 얽힐 수 있습니다. 따라서 다음 흐름이 안전합니다.

1. docker-compose.yml과 관련 env 예시 파일을 먼저 설명해줘.
2. 실제 명령을 실행하지 말고, 어떤 명령을 실행할지 계획만 보여줘.
3. .env 값은 읽지 말고 변수 이름만 기준으로 문제를 추정해줘.
4. 수정이 필요한 파일과 예상 diff를 먼저 보여줘.
5. 내가 승인한 뒤에만 docker compose config 또는 테스트 명령을 실행해줘.

 

13. MCP와 외부 도구 연동 비교

항목Claude CodeCodex CLIGemini CLI

MCP 지원	공식 지원	CLI·IDE extension 지원	MCP server 지원
설정 위치	Claude settings, 프로젝트 설정	~/.codex/config.toml, .codex/config.toml	settings.json, mcpServers
활용 예	Jira, Slack, PostgreSQL, Figma, Google Drive	Figma, browser, third-party docs, 내부 도구	DB, API, custom scripts, Google 생태계
보안 포인트	신뢰된 MCP만 사용, permission 설정	trusted project, OAuth/bearer token 관리	env secret 하드코딩 금지, trust dialog 확인
추천 사용법	한 번에 많이 붙이지 말고 반복 업무부터	PR 리뷰·문서·디자인 연동부터	Google Cloud·검색·사내 API 연동부터

Claude Code, Codex CLI, Gemini CLI 모두 MCP 코딩 에이전트로 확장할 수 있습니다. 다만 MCP는 외부 도구 호출 권한을 모델에 주는 것이므로, 사내 데이터베이스, 이슈 트래커, 배포 시스템을 연결하기 전에는 권한 범위, 감사 로그, 토큰 저장 위치, destructive action 승인 정책을 확인해야 합니다. Claude Code 문서는 MCP 서버를 신뢰할 수 있는 제공자 또는 자체 서버 중심으로 구성하라고 권장하고, Codex와 Gemini CLI 문서도 MCP 설정과 인증 방식을 별도로 설명합니다.

14. 가격, 요금제, 쿼터 비교

표 3. 비용과 사용량 비교표

도구명무료 사용 가능 여부유료 플랜API 키 사용 가능 여부사용량 제한 또는 쿼터비용 예측 난이도공식 문서 재확인 필요 항목

Claude Code	Claude Free만으로 주요 Code 사용은 제한적일 수 있음. Pro 이상 확인 필요	Pro 월 $20, Max 월 $100부터, Team Standard/Premium, Enterprise	Anthropic Console/API 가능	Pro/Max/Team/Enterprise 사용량 제한, API token consumption, usage credits	중간~높음	지역별 가격, Pro/Max 한도, Team/Enterprise seat, API rate limit
Codex CLI	Codex가 ChatGPT Free, Go, Plus, Pro, Business, Edu, Enterprise에 포함된다고 공식 문서 안내	Go 월 $8, Plus 월 $20, Pro 월 $100부터, Business/Enterprise	OpenAI API key 가능	5시간 창 기준 모델별 local messages 범위. API key는 token 과금	중간	Free/Go 제공 범위, 모델별 한도, Code Review usage, API pricing
Gemini CLI	개인 무료/AI Pro/Ultra 계정은 2026년 6월 18일 전환 영향	Gemini Code Assist Standard/Enterprise, Google AI Pro/Ultra, Antigravity 플랜 확인 필요	Gemini API key, Vertex AI 가능	개인 free 1000 req/day, AI Pro 1500, AI Ultra 2000, Standard 1500, Enterprise 2000로 문서 안내. 단 개인은 중단 예정	높음	Antigravity CLI 가격, Gemini CLI 개인 요청 처리 여부, Standard/Enterprise 쿼터
Antigravity CLI	개인 플랜 가능 여부는 공식 Antigravity 문서 확인	Google AI Pro/Ultra, Antigravity 관련 플랜 확인 필요	Google Cloud project 연동 가능	작성 시점 기준 Gemini CLI와 별도 확인 필요	높음	개인/기업별 쿼터, 데이터 사용 opt-out, Google Cloud 프로젝트 과금

Claude 공식 가격 페이지는 Pro가 월 $20 또는 연 $200, Max가 월 $100부터, Team Standard가 월 $25 또는 연간 월 $20, Team Premium이 월 $125 또는 연간 월 $100이라고 안내합니다. Codex 공식 가격 문서는 Free/Go/Plus/Pro/Business/Edu/Enterprise 포함과 Plus 월 $20, Pro 월 $100부터, API key 사용 시 token 기반 과금을 안내합니다. Gemini Code Assist 쿼터 문서는 Gemini CLI와 Code Assist agent mode 요청량이 합산되고, 개인 무료 1000/day, AI Pro 1500/day, AI Ultra 2000/day, Standard 1500/day, Enterprise 2000/day를 안내하지만, 개인/Pro/Ultra는 Antigravity 전환 일정이 붙어 있습니다.

Google Code Assist Standard/Enterprise 가격은 공식 제품 페이지 기준 Standard 월 $22.80 또는 연간 월 $19, Enterprise 월 $54 또는 연간 월 $45로 안내됩니다. 가격은 지역·계약·프로모션에 따라 달라질 수 있으므로 공식 가격 페이지 재확인이 필요합니다.

15. 보안과 개인정보 관점 비교

표 4. 보안 체크리스트

체크 항목왜 중요한가확인 방법

사내 코드가 외부 모델로 전송되는지	비공개 저장소, 고객 데이터, 영업비밀 유출 위험	플랜별 데이터 처리·retention·training 정책 확인
로컬 파일 수정 권한이 어디까지 허용되는지	에이전트가 의도치 않은 파일을 수정할 수 있음	workspace 범위, write permission, sandbox 설정 확인
터미널 명령 실행 전 승인 절차가 있는지	rm, curl, docker, kubectl 등 위험 명령 실행 가능	approval mode, permission policy, command allow/deny 설정
민감한 .env 파일을 읽지 않도록 설정할 수 있는지	API 키, DB 비밀번호, JWT secret 노출 위험	.gitignore, .env.example, deny rules, prompt 규칙 사용
Git diff를 반드시 검토하는지	AI가 의도하지 않은 변경을 만들 수 있음	git diff, /review, PR review, staged diff 확인
API 키, 토큰, 비밀번호가 프롬프트에 포함되지 않는지	세션 로그와 모델 입력에 secret이 들어갈 수 있음	secret scanning, pre-commit hook, prompt policy
팀/기업용 데이터 보호 정책이 있는지	개인 계정과 기업 계정은 데이터 사용 조건이 다름	Team/Business/Enterprise, Standard/Enterprise, API org 정책 확인
로그와 세션 기록이 어디에 저장되는지	로컬 transcript, cloud logs, telemetry가 남을 수 있음	로컬 저장 경로, retention, OTel, Cloud Logging 설정 확인

Claude Code는 계정 유형에 따라 데이터 보존 정책이 다르고, 로컬 세션 transcript가 기본적으로 plaintext로 저장될 수 있습니다. OpenAI Codex는 ChatGPT 로그인과 API key 로그인에 따라 각각 ChatGPT workspace 정책 또는 API organization 정책이 적용됩니다. Google Code Assist Standard/Enterprise는 Customer Data와 Service Data를 구분하고, Google이 허가 없이 데이터를 모델 학습에 사용하지 않는다고 설명하지만, 개인용 Gemini Code Assist privacy notice는 prompt, 관련 코드, 생성 output, code edit 등이 수집될 수 있다고 설명합니다.

회사 코드나 비공개 저장소에 써도 되는가?

가능 여부는 도구 이름이 아니라 계정 유형과 보안 설정에 달려 있습니다.

상황권장

개인 무료 계정으로 회사 private repo 작업	권장하지 않음. 회사 보안팀 승인 필요
사내 소스코드가 모델 학습에 쓰이면 안 됨	Enterprise/Business/Team/API paid data policy 확인
금융·의료·공공·계약상 보안 의무가 있음	ZDR, retention, audit log, SSO, IAM, DPA 확인
외부 MCP 서버 연결	사내 승인된 MCP만 허용
GitHub PR 자동화	GitHub App 권한, secret, branch protection, audit log 확인

가장 안전한 운영 방식은 “에이전트를 믿는 것”이 아니라 권한을 좁게 열고, diff를 보고, 테스트를 재현하고, 사람이 merge하는 것입니다.

16. 사용 목적별 추천

표 2. 사용 목적별 추천표

사용 목적추천 도구이유

처음 AI 코딩 에이전트를 써보는 개인 개발자	Codex CLI	ChatGPT 계정 기반 시작이 쉽고, 개인 플랜 포함 구조가 명확합니다.
대규모 코드베이스 리팩터링	Claude Code 또는 Codex CLI	멀티파일 수정, 계획, diff, 테스트 루프에 적합합니다.
테스트 코드 작성	Claude Code 또는 Codex CLI	기존 테스트 패턴 파악 후 추가하는 흐름이 좋습니다.
GitHub PR 리뷰	Codex CLI 또는 Claude Code	Codex @codex review, Claude GitHub Actions 모두 공식 지원이 강합니다.
터미널 중심 개발	Claude Code 또는 Codex CLI	CLI 사용성과 승인 흐름이 안정적입니다.
VS Code와 함께 사용	Claude Code 또는 Codex CLI, Google Cloud 팀은 Gemini Code Assist	IDE 연동과 터미널 병행이 가능합니다.
회사/팀 도입	보안 정책에 맞는 Enterprise 계정	Claude Team/Enterprise, ChatGPT Business/Enterprise, Gemini Code Assist Standard/Enterprise 중 선택해야 합니다.
무료 또는 저렴한 사용	Codex CLI 우선, 단 공식 쿼터 확인	Gemini CLI 개인 무료는 Antigravity 전환 영향이 큽니다.
장기적으로 안정적인 도구 선택	Claude Code 또는 Codex CLI	Gemini CLI 개인 사용은 전환기라 Antigravity CLI까지 함께 봐야 합니다.

개인 개발자 추천

• ChatGPT Plus/Pro를 이미 쓰는 개인 개발자: Codex CLI부터 시작하는 것이 가성비가 좋습니다.
• Claude Pro/Max를 이미 쓰고 리팩터링·코드 이해 작업이 많다면: Claude Code가 자연스럽습니다.
• Google AI Pro/Ultra 또는 무료 Gemini CLI를 쓰던 개인 개발자: Gemini CLI 자체보다 Antigravity CLI 전환을 먼저 확인하는 것이 안전합니다.
• API 비용을 직접 관리하고 싶은 개발자: Codex API key 또는 Anthropic Console/API 방식이 좋지만 spend limit을 설정해야 합니다.

팀/회사 추천

• 보안·권한·감사 로그가 중요한 팀: Claude Team/Enterprise, ChatGPT Business/Enterprise, Gemini Code Assist Standard/Enterprise 중 기존 IDP·SSO·DPA·IAM 구조에 맞는 것을 선택합니다.
• GitHub PR 자동 리뷰를 먼저 도입하려는 팀: Codex GitHub review 또는 Claude Code GitHub Actions가 빠른 후보입니다.
• Google Cloud 중심 조직: Gemini Code Assist Standard/Enterprise와 Gemini CLI, Vertex AI, IAM, VPC Service Controls를 함께 검토합니다.
• 비공개 저장소가 많은 조직: 개인 계정 금지, enterprise retention, no-training 정책, MCP allowlist가 필수입니다.

주니어 개발자 추천

주니어 개발자에게는 “코드를 대신 짜주는 도구”보다 왜 그렇게 수정하는지 설명하고, diff를 보여주고, 테스트 실패를 함께 읽는 도구가 좋습니다. 초보자에게는 Codex CLI가 시작하기 쉽고, Claude 구독이 있다면 Claude Code도 좋은 선택입니다. Gemini CLI는 2026년 6월 15일 기준 개인 계정 전환 이슈가 있어, 새로 배우려면 Antigravity CLI 문서까지 함께 보는 편이 안전합니다.

오픈소스 기여자 추천

• PR 리뷰와 이슈 대응: Codex CLI, Claude Code GitHub Actions
• 문서·테스트 보강: Claude Code, Codex CLI
• Google 생태계 오픈소스: Gemini CLI 또는 Antigravity CLI 전환 후 Google 도구
• 주의점: 오픈소스 저장소라도 maintainer token, release token, package registry token은 절대 프롬프트에 포함하지 않아야 합니다.

대규모 코드베이스 추천

대규모 코드베이스에서는 모델 컨텍스트보다 더 중요한 것이 작업 쪼개기입니다. 한 번에 “전체 리팩터링”을 맡기기보다 다음 순서가 좋습니다.

1. 구조 파악만 해줘. 파일 수정 금지.
2. 변경 영향 범위를 3단계로 나눠줘.
3. 첫 번째 단계만 수정 계획을 제안해줘.
4. diff를 보여준 뒤 내가 승인하면 수정해줘.
5. 관련 테스트만 먼저 실행해줘.
6. 실패하면 원인 설명 후 최소 수정해줘.

 

17. 비교 기준 5점 만점 점수

아래 점수는 공식 문서의 기능 범위, 보안 모델, 설치·운영 난이도, 제품 안정성, 전환 리스크를 기준으로 한 정성 평가입니다. 동일 저장소에서 직접 벤치마크한 성능 점수가 아닙니다.

비교 기준Claude CodeCodex CLIGemini CLI

1. 설치와 초기 설정 난이도	4.5	4.5	3.8
2. 터미널 사용성	4.6	4.7	4.0
3. 코드베이스 이해 능력	4.6	4.5	4.1
4. 멀티파일 수정 능력	4.6	4.5	4.0
5. 리팩터링 능력	4.5	4.4	3.9
6. 테스트 코드 작성 능력	4.4	4.4	4.0
7. 버그 수정 능력	4.5	4.4	4.0
8. Git diff 검토 편의성	4.4	4.7	3.8
9. 명령 실행 안전성	4.6	4.7	4.1
10. 승인/권한 관리	4.6	4.6	4.2
11. MCP 및 외부 도구 연동	4.6	4.4	4.3
12. IDE 연동	4.5	4.4	3.6
13. 개인 개발자 가성비	3.8	4.5	2.8
14. 팀/기업 도입 적합성	4.5	4.5	4.0
15. 문서와 커뮤니티	4.4	4.4	4.0
16. 장기적으로 계속 쓸 수 있는 안정성	4.3	4.3	2.5

Gemini CLI의 점수가 낮은 항목은 기능 부족 때문이라기보다 개인 계정 기준 제품 전환 리스크 때문입니다. Standard/Enterprise 또는 Google Cloud 기반으로 사용하는 팀이라면 Gemini CLI 점수는 더 높게 볼 수 있습니다.

18. 실전 시나리오별 추천

시나리오Claude Code로 할 때 장점Codex CLI로 할 때 장점Gemini CLI로 할 때 장점구현 난이도주의해야 할 보안/권한 문제초보자 추천실무 개발자 추천

1. 처음 보는 프로젝트 구조 파악하기	CLAUDE.md, auto memory, 전체 구조 설명 흐름이 좋음	TUI에서 plan과 설명을 보며 진행 가능	1M context와 Google Search grounding 활용 가능	낮음	파일 수정 금지, read-only로 시작	Codex CLI	Claude Code 또는 Codex CLI
2. React 또는 Next.js 프로젝트에 기능 추가하기	멀티파일 수정, 테스트 실행, PR 설명 작성 흐름이 좋음	컴포넌트·테스트·diff 리뷰가 편함	웹 문서 grounding이 도움될 수 있음	중간	.env, API endpoint, auth token 노출 주의	Codex CLI	Claude Code 또는 Codex CLI
3. Node.js API 서버 버그 수정하기	로그·테스트·원인 추적을 대화형으로 처리	sandbox에서 테스트 실행과 최소 수정 흐름이 좋음	Google Cloud API나 Firebase 연동이면 유리	중간	DB 연결 문자열, production secret, migration 명령 주의	Codex CLI	Codex CLI 또는 Claude Code
4. Python 코드 리팩터링하기	함수 분리, 타입 힌트, 테스트 추가에 적합	diff review와 단계별 수정이 좋음	데이터/클라우드 문맥이 있으면 장점	중간	대량 파일 수정 전 단계 분리	Claude Code	Claude Code
5. 테스트 코드 생성하고 실행하기	기존 테스트 스타일 분석 후 추가 요청이 쉬움	/review와 테스트 실패 재현 흐름이 좋음	가능하지만 승인·sandbox 설정 확인 필요	중간	테스트가 외부 API·DB를 호출하지 않는지 확인	Codex CLI	Claude Code 또는 Codex CLI
6. Docker Compose 설정 오류 수정하기	config 설명, 최소 수정 제안, 명령 승인 흐름	sandbox와 approval이 안전	Google Cloud Run, GKE 문맥이면 도움	중간~높음	볼륨, 네트워크, secret, image pull, destructive command 주의	Codex CLI	Codex CLI
7. Git 변경사항을 리뷰하고 커밋 메시지 작성하기	Git 작업과 PR 설명 생성이 자연스러움	diff review, /review, GitHub @codex review 강점	Gemini Code Assist GitHub 가능하나 소비자 종료 일정 주의	낮음~중간	커밋 전 diff, secret, unintended file 확인	Codex CLI	Codex CLI 또는 Claude Code

실전 프롬프트 예시

아래는 공식 명령어가 아니라, 세 도구 모두에서 사용할 수 있는 자연어 요청 예시입니다.

코드베이스 설명 요청

이 저장소의 목적, 주요 진입점, 폴더 구조, 실행 명령, 테스트 명령을 요약해줘.
아직 파일을 수정하지 말고 분석만 해줘.

 

버그 수정 요청

현재 failing test를 먼저 재현하고, 실패 원인을 설명한 뒤 최소 수정안을 제안해줘.
파일을 수정하기 전에 어떤 파일을 바꿀지와 예상 diff를 먼저 보여줘.

 

테스트 코드 생성 요청

src/auth/login.ts의 주요 분기 조건에 대한 단위 테스트를 작성해줘.
기존 테스트 파일의 스타일과 assertion 패턴을 먼저 확인하고 같은 방식으로 추가해줘.

 

Git diff 리뷰 요청

git diff를 읽고 기능 변경, 위험한 변경, 보안 이슈, 누락된 테스트를 항목별로 리뷰해줘.
아직 커밋하지 말고, 커밋 메시지 후보만 3개 제안해줘.

 

19. 선택 체크리스트

질문Claude Code 선택Codex CLI 선택Gemini CLI / Antigravity 선택

Claude Pro/Max/Team을 이미 쓰는가?	예	선택 가능	아니오
ChatGPT Plus/Pro/Business를 이미 쓰는가?	선택 가능	예	아니오
Google Cloud와 Gemini Code Assist Standard/Enterprise를 쓰는가?	선택 가능	선택 가능	예
개인 무료로 먼저 써보고 싶은가?	제한적	예	Gemini CLI는 전환 확인, Antigravity 고려
GitHub PR 자동 리뷰가 중요한가?	예	매우 예	기업용은 가능, 소비자 종료 주의
터미널 TUI와 diff 확인이 중요한가?	예	매우 예	가능
보안 승인이 중요한 회사 저장소인가?	Team/Enterprise 검토	Business/Enterprise 검토	Standard/Enterprise 검토
대규모 리팩터링인가?	예	예	기업/Google 생태계면 가능
초보자가 처음 써보는가?	Claude 구독자에게 추천	가장 무난	Antigravity 전환 후 검토
장기 도구 안정성이 중요한가?	예	예	개인 Gemini CLI는 전환 리스크

20. 최종 결론

터미널에서 코딩 에이전트를 가장 편하게 쓰려면 Claude Code와 Codex CLI가 우선 후보입니다. Claude Code는 코드베이스 이해, 멀티파일 수정, 팀 규칙 반영, permission 기반 안전 흐름이 강하고, Codex CLI는 터미널 TUI, sandbox, local review, GitHub PR 리뷰 자동화, 개인 개발자 가성비가 좋습니다.

기존 코드베이스를 이해하고 수정하는 능력은 세 도구 모두 가능하지만, 실전에서는 Claude Code와 Codex CLI가 더 안정적인 선택입니다. Gemini CLI는 긴 컨텍스트와 Google 생태계 장점이 있으나, 개인 계정 기준으로는 Antigravity CLI 전환 이슈가 가장 큰 변수입니다.

개인 개발자에게 가장 가성비가 좋은 도구는 기존 구독에 따라 다릅니다. ChatGPT 계정을 이미 사용한다면 Codex CLI가 유리하고, Claude Pro/Max를 이미 사용한다면 Claude Code가 낫습니다. Gemini CLI 개인 무료 사용자는 2026년 6월 18일 이후 Antigravity CLI 기준으로 다시 판단해야 합니다.

회사 코드나 비공개 저장소에는 개인 무료 계정보다 Team/Business/Enterprise 또는 API/Cloud 기반 계정을 사용해야 합니다. 사내 코드를 모델 학습에 쓰지 않는지, 데이터 보존 기간이 얼마인지, 로컬 로그가 어디에 남는지, 명령 실행과 파일 수정 승인을 어떻게 관리하는지 확인해야 합니다.

초보자가 먼저 써볼 만한 도구는 작성 시점 기준으로 Codex CLI입니다. 다만 Claude 구독자라면 Claude Code도 좋은 첫 선택입니다. Gemini CLI는 개인 계정에서는 Antigravity CLI 전환이 임박했으므로, 새로 학습한다면 Gemini CLI 사용법만 보지 말고 Antigravity CLI 문서까지 함께 봐야 합니다.

21. FAQ

Q1. Claude Code, Codex CLI, Gemini CLI 중 터미널에서 가장 편한 도구는 무엇인가요?

일반적인 터미널 중심 개발 흐름에서는 Codex CLI와 Claude Code가 가장 무난합니다. Codex CLI는 전체 화면 TUI, diff 확인, approval flow가 강하고, Claude Code는 프로젝트 이해와 Git·PR·테스트 작업 흐름이 자연스럽습니다. Gemini CLI도 터미널 우선 도구지만, 개인 계정 사용자는 Antigravity CLI 전환 일정을 먼저 확인해야 합니다.

Q2. 기존 코드베이스를 이해하고 수정하는 능력은 어떤 도구가 좋나요?

대규모 기존 코드베이스 분석과 멀티파일 수정은 Claude Code 또는 Codex CLI를 먼저 고려하는 것이 좋습니다. Gemini CLI는 1M token context와 Google 생태계 장점이 있지만, 개인 계정에서는 제품 전환 리스크가 큽니다.

Q3. 개인 개발자에게 가장 가성비가 좋은 AI 코딩 에이전트는 무엇인가요?

ChatGPT Free/Go/Plus/Pro 계정을 이미 사용한다면 Codex CLI가 가성비 측면에서 유리할 수 있습니다. Claude Pro/Max를 이미 사용한다면 Claude Code가 좋습니다. Gemini CLI는 과거 개인 무료 쿼터가 강점이었지만, 작성 시점 기준 개인/AI Pro/Ultra 계정은 Antigravity CLI 전환 영향을 받습니다.

Q4. 회사 비공개 저장소에 Claude Code나 Codex CLI를 써도 되나요?

가능 여부는 도구 이름이 아니라 계정·계약·보안 설정에 달려 있습니다. 개인 무료 계정으로 회사 코드를 넣는 것은 권장하기 어렵고, Team/Business/Enterprise, API org, 데이터 보존, 모델 학습 제외, audit log, SSO, IAM, MCP 권한을 확인해야 합니다.

Q5. Gemini CLI와 Antigravity CLI 전환은 어떻게 봐야 하나요?

2026년 6월 15일 기준 Google 공지에 따르면 2026년 6월 18일부터 개인 무료, Google AI Pro, Google AI Ultra 계정의 Gemini CLI와 Gemini Code Assist IDE 확장은 요청 처리를 중단합니다. 기업용 Standard/Enterprise와 Google Cloud 기반 사용은 유지된다고 공지되어 있습니다. 따라서 개인 개발자는 Gemini CLI를 새로 시작하기보다 Antigravity CLI를 기준으로 보는 것이 안전합니다.

Q6. MCP 코딩 에이전트로 확장하려면 어떤 도구가 좋나요?

세 도구 모두 MCP를 지원합니다. Claude Code는 팀 문서·Jira·Slack·DB 연동에 좋고, Codex CLI는 Figma·브라우저·문서·GitHub review 흐름과 잘 맞습니다. Gemini CLI는 Google Cloud, custom API, MCP server 구성이 강점입니다. 단 MCP는 외부 시스템 권한을 모델에 연결하는 것이므로 최소 권한과 승인 정책이 필수입니다.

Q7. GitHub PR 리뷰 자동화는 어떤 도구가 좋나요?

Codex CLI/Codex Cloud는 @codex review와 automatic reviews 흐름이 강합니다. Claude Code도 GitHub Actions와 @claude 기반 이슈·PR 자동화가 가능합니다. Gemini Code Assist on GitHub도 가능하지만, 소비자 버전은 2026년 7월 17일 종료 일정이 공지되어 있으므로 기업 버전 여부를 확인해야 합니다.

Q8. 초보자는 어떤 도구부터 써보는 것이 좋나요?

작성 시점 기준으로는 Codex CLI가 가장 무난합니다. 설치와 인증이 단순하고, ChatGPT 계정 기반으로 시작하기 쉽기 때문입니다. Claude Pro/Max를 이미 쓰는 개발자는 Claude Code도 좋습니다. Gemini CLI는 개인 계정 전환 이슈 때문에 Antigravity CLI를 함께 확인해야 합니다.

Q9. AI 코딩 도구가 만든 코드를 바로 커밋해도 되나요?

권장하지 않습니다. 반드시 git diff를 확인하고, 테스트를 실행하고, 변경된 파일 목록을 검토해야 합니다. 특히 인증, 권한, 결제, 데이터 삭제, migration, Docker, Kubernetes, Terraform 관련 변경은 사람이 직접 리뷰해야 합니다.

Q10. Docker, DB, 배포 명령도 AI 에이전트에게 맡겨도 되나요?

초기에는 맡기지 않는 것이 좋습니다. 먼저 분석과 계획만 요청하고, 실행 명령을 하나씩 승인하는 방식이 안전합니다. docker compose up, docker compose down -v, kubectl, terraform apply, DB migration, production secret 접근은 반드시 수동 검토가 필요합니다.