TL;DR
Claude Code, OpenAI Codex CLI, Gemini CLI는 모두 npm install -g로 설치하는 터미널 AI 도구지만 강점이 다르다. Claude Code는 MCP 서버와 IDE 통합으로 팀 환경에 강하고, Codex CLI는 세밀한 샌드박스 제어와 내장 이미지 생성이 특징이며, Gemini CLI는 2M+ 롱 컨텍스트와 내장 웹 검색으로 대규모 코드베이스 분석에 유리하다. 하나를 주력으로 정하고 필요에 따라 병용하는 전략이 현실적이다.
비교 대상 소개
2025~2026년 사이 Anthropic, OpenAI, Google이 각각 자사 LLM을 터미널에 연결하는 CLI 도구를 출시했다. 세 도구 모두 “자연어로 파일을 읽고, 코드를 수정하고, 명령을 실행한다”는 핵심 개념을 공유한다. 차이는 철학과 생태계에서 나온다.
| 도구 | 제공사 | 패키지 | 기본 모델 |
|---|---|---|---|
| Claude Code | Anthropic | @anthropic-ai/claude-code |
Claude Sonnet 4.6 |
| Codex CLI | OpenAI | @openai/codex |
GPT-5.4 |
| Gemini CLI | @google/gemini-cli |
Gemini 2.5 Flash |
세 도구 모두 Node.js 18+이 필요하고, 각사 API 키로 인증한다. Gemini CLI만 무료 티어가 존재한다.
기준별 비교
프로젝트 컨텍스트 관리
Claude Code — CLAUDE.md 계층
# CLAUDE.md (프로젝트 루트)
## 아키텍처
- 이 프로젝트는 FastAPI + PostgreSQL 기반입니다.
- 새 엔드포인트는 반드시 타입 힌트와 Pydantic 모델을 사용하세요.
## 금지
- main 브랜치에 직접 커밋하지 마세요.
글로벌(~/.claude/CLAUDE.md) → 프로젝트 루트 → 서브디렉터리 순으로 계층적으로 적용된다. 하위 디렉터리 설정이 상위를 오버라이드한다.
Codex CLI — AGENTS.md
# AGENTS.md
## 제외 대상
node_modules/, dist/, *.lock 파일은 수정하지 말 것
## 코드 스타일
TypeScript strict mode 사용
Gemini CLI — GEMINI.md / .gemini/
Gemini CLI는 GEMINI.md를 컨텍스트 파일로 사용하고, .gemini/ 디렉터리에 settings.json과 스킬(.gemini/skills/)을 둔다. .geminiignore로 컨텍스트 제외 파일을 지정한다. 또한 Gemini 2.5 Flash의 2M 토큰 컨텍스트 윈도우 덕분에 수천 개 파일로 구성된 대형 모노레포도 RAG 없이 한 번에 분석할 수 있다.
승인 모드와 샌드박스 제어
세 도구의 자동화 수준 제어 방식이 가장 큰 차이점이다.
Codex CLI — 승인 모드와 샌드박스를 독립적으로 조합:
# 승인 모드 (--ask-for-approval)
codex --ask-for-approval on-request "테스트를 추가해줘" # 매 액션 승인
codex --ask-for-approval on-failure "리팩터링해줘" # 실패 시만 승인
codex --ask-for-approval never "보일러플레이트 생성해줘" # 자동 승인
# 샌드박스 수준 (--sandbox)
codex --sandbox read-only "이 코드 분석해줘" # 읽기 전용
codex --sandbox workspace-write "테스트 추가해줘" # 작업 디렉터리만 쓰기
codex --sandbox danger-full-access "설정 업데이트해줘" # 전체 접근
Claude Code — --dangerously-skip-permissions 플래그로 자동 승인:
# 기본: 모든 도구 사용 시 승인 요청
claude
# 자동 승인 (위험)
claude --dangerously-skip-permissions "파일 전체 리팩터링해줘"
Gemini CLI — --approval-mode yolo:
# Gemini CLI 고유 방식
gemini --approval-mode yolo "보일러플레이트 생성해줘"
외부 도구 연동
Claude Code — MCP(Model Context Protocol)
MCP는 Anthropic이 주도하는 오픈 표준으로, Claude Code가 외부 서비스를 AI 컨텍스트에 연결하는 방식이다. GitHub, Jira, Slack, PostgreSQL, 자체 REST API 등을 등록하면 자연어로 접근할 수 있다.
# CLI에서 MCP 서버 추가
claude mcp add github -- npx -y @modelcontextprotocol/server-github
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres
# 등록된 서버 목록 확인
claude mcp list
카카오나 토스 같은 팀에서 사내 이슈 트래커나 모니터링 시스템을 MCP로 연결하면, Claude Code가 실시간 지표를 참조해 코드 수정을 제안할 수 있다.
Codex CLI — 내장 image_gen
Codex CLI는 별도 API 없이 image_gen 도구로 이미지를 생성한다. 블로그 썸네일, UI 목업, 아이콘 생성을 코딩 워크플로우에 통합할 수 있다.
Gemini CLI — 내장 웹 검색 + Sub-agents
Gemini CLI는 Google Search가 기본 탑재되어 있어 최신 문서나 릴리스 노트를 실시간 참조하면서 코드를 작성할 수 있다. 또한 generalist, codebase_investigator 같은 Sub-agents를 통해 특정 도메인 전문가 역할을 위임할 수 있다.
커스텀 워크플로우
Claude Code — .claude/commands/ (커스텀 슬래시 명령) 또는 .claude/skills/ (스킬):
# .claude/commands/review-pr.md
PR diff를 분석해 한국어 PR 설명을 작성합니다.
Codex CLI — .agents/skills/ 디렉터리에 frontmatter 포함 SKILL.md:
---
name: pr-description
description: PR 설명 초안 자동 작성
---
# PR 설명 작성
git diff main을 분석해 한국어 PR 설명을 작성합니다.
Gemini CLI는 .gemini/skills/로 스킬을 관리하며, generalist, codebase_investigator 같은 Sub-agents를 통해 특정 도메인 전문가 역할을 위임할 수 있다.
시나리오별 선택 가이드
| 시나리오 | 추천 도구 | 이유 |
|---|---|---|
| 팀 공유 프로젝트 컨텍스트 | Claude Code | CLAUDE.md 계층 + MCP로 사내 시스템 연동 |
| IDE 안에서 AI 코딩 | Claude Code | VS Code·JetBrains 익스텐션 |
| CI/CD 파이프라인 통합 | Codex CLI | stdin 파이프 + --ask-for-approval never |
| 블로그·문서 이미지 생성 | Codex CLI | 내장 image_gen으로 썸네일 생성 |
| 대형 모노레포 전체 분석 | Gemini CLI | 2M+ 롱 컨텍스트로 RAG 없이 처리 |
| 최신 라이브러리 정보 참조 | Gemini CLI | 내장 Google Search |
| 비용 최소화 (개인 프로젝트) | Gemini CLI | 무료 티어 존재 |
| 팀 반복 작업 표준화 | Claude Code / Codex CLI | Skills 시스템 공유 가능 |
병용 전략
세 도구는 상호 배타적이지 않다. 실제 활용 예:
# 1. Gemini CLI로 최신 CVE 취약점 분석
gemini "CVE-2026-1234 취약점이 우리 express 의존성에 미치는 영향을 분석해줘" > security-report.md
# 2. Claude Code로 취약한 코드 패치
claude "security-report.md의 내용을 바탕으로 취약한 함수를 패치하고 테스트를 작성해줘"
# 3. Codex CLI로 PR 설명 생성
git diff main | codex "이 diff로 PR 설명을 작성해줘"
주의사항
| 항목 | 내용 |
|---|---|
| 자동 승인 모드 | 세 도구 모두 자동 승인 시 파일 변경이 즉시 반영 — git 커밋 후 사용 필수 |
| 컨텍스트 파일 혼동 | CLAUDE.md vs AGENTS.md vs GEMINI.md — 각 도구가 자기 파일만 읽음 |
| Codex CLI 상태 | research preview — 프로덕션 안정성 미보장 |
| 무료 티어 | Gemini CLI만 존재, Claude Code·Codex CLI는 API 비용 발생 |
| 샌드박스 기술 | Claude Code·Codex CLI: bubblewrap(Linux) / Gemini CLI: gVisor(runsc) |
| MCP 설정 | Claude Code의 MCP 서버는 claude mcp add 명령으로 등록, 설정은 ~/.config/claude/settings.json |
결론
Claude Code는 팀 환경과 IDE 통합이 강점, Codex CLI는 파이프라인 자동화와 이미지 생성, Gemini CLI는 대규모 컨텍스트와 웹 검색이 강점이다. 세 도구가 각자 다른 방향으로 진화하고 있어, 지금 당장 하나를 고르기보다 주력 도구를 정하고 필요에 따라 보조 도구를 병용하는 전략이 현실적이다. 한국 개발팀 기준으로는 Claude Code를 주력으로, 특정 작업(보안 취약점 조사, 이미지 생성)에서 보조 도구를 활용하는 패턴이 검증된 방식이다.
참고: Claude Code 공식 문서 / Codex CLI GitHub / Gemini CLI GitHub