(4/4) Claude Code · Codex · Gemini CLI 비교 — 권한 모드부터 컨텍스트 파일까지
🛠️ AI 코딩 CLI 명령어 모음 시리즈 (전체 4편)
- Claude Code 자주 쓰는 명령어 모음 — CLI 플래그부터 슬래시 명령어까지
- Codex CLI 자주 쓰는 명령어 모음 — 서브커맨드부터 슬래시 명령어까지
- Gemini CLI 자주 쓰는 명령어 모음 — 헤드리스 모드와 슬래시 명령어까지
- Claude Code · Codex · Gemini CLI 비교 — 권한 모드부터 컨텍스트 파일까지 ← 지금 글
Summary
1편 ~ 3편 에서 Claude Code · Codex · Gemini CLI 세 도구의 명령어를 각각 정리했어요. 4편은 시리즈 마무리로, 셋을 같은 축으로 나란히 놓고 비교해보는 글이에요. 명령어 카탈로그를 다시 나열하기보단, 실제로 도구를 고를 때 갈리는 포인트(권한 모드 이름 차이, 헤드리스 모드의 깊이, 세션 이어가기 방식, 컨텍스트 파일 컨벤션, MCP/확장 통합)를 한 표에 정리하고 작업 성격별로 어떤 도구가 어울리는지 정리합니다.
💡 이 글에서 다루는 것
- 한눈에 보는 세 도구 비교 표 (모드·플래그·컨텍스트 파일 이름)
- 권한/승인 모델 비교 —
permission-modevsapproval-modevs/permissions- 헤드리스 자동화 비교 —
-p/codex exec/-p -o stream-json- 세션 이어가기와 체크포인트 비교
- 컨텍스트 파일:
CLAUDE.md/AGENTS.md/GEMINI.md차이- MCP·확장·스킬 통합 결의 차이
- 작업 유형별 추천 매트릭스
1. 한눈에 보는 차이
먼저 세 도구를 같은 축으로 나란히 놓아볼게요. “같은 개념인데 이름만 다른 것” 이 많아서 이 표가 머릿속 매핑에 도움 돼요.
| 축 | Claude Code | Codex | Gemini CLI |
|---|---|---|---|
| 인터랙티브 모드 | claude |
codex |
gemini |
| 비대화(헤드리스) | claude -p |
codex exec |
gemini -p |
| 세션 이어가기 | claude -c / -r |
codex resume --last / <ID> |
gemini -r / <index> / <UUID> |
| 권한 모드 플래그 | --permission-mode |
(세션 내 /permissions) |
--approval-mode |
| 풀자동 모드 이름 | bypassPermissions |
Full Access |
yolo |
| 자동 편집 모드 이름 | acceptEdits |
Auto (기본) |
auto_edit |
| 플랜(읽기) 모드 | plan |
Read-only |
plan |
| worktree 격리 | -w |
— (--cd + 외부 worktree) |
-w |
| 추가 디렉토리 | --add-dir |
--add-dir |
--include-directories |
| 컨텍스트 파일 | CLAUDE.md |
AGENTS.md |
GEMINI.md |
| 출력 포맷 | --output-format |
--json |
--output-format |
| 세션 이름 | --name |
— | — |
| 이미지 첨부 | — (@로 첨부) |
-i, --image |
— |
| 외부 도구 | /mcp, /agents |
/mcp, 프로필 |
gemini mcp, extensions, skills |
큰 그림은 정말 비슷한데, 모드 이름과 컨텍스트 파일명이 각자 따로 진화한 거예요. 셋 다 쓰다 보면 머릿속에서 자연스럽게 매핑이 잡힙니다.
2. 권한·승인 모델 — 가장 헷갈리는 지점
세 도구가 모두 “위험한 액션은 사용자에게 묻는다” 는 같은 결인데, 모델 이름과 단계 수가 미묘하게 달라요.
2-1. Claude Code — 5단계, 플래그 중심
default → acceptEdits → auto → plan → bypassPermissions
default매번 묻기acceptEdits파일 편집 자동 / 셸은 묻기auto분류기 기반 자동 (위험한 것만 묻기) ← 일상에서 가장 자주 쓰는 모드plan코드 안 건드림bypassPermissions전부 자동 (위험)
CLI 띄울 때 --permission-mode auto 같이 박거나, 세션 안에서 Shift+Tab 으로 순환.
2-2. Codex — 3단계, 세션 내 전환 중심
Read-only → Auto (기본) → Full Access
Read-only파일/명령 손 못 댐Auto작업 폴더 내 자동, 외부는 묻기Full Access전 시스템·네트워크 자동
대부분 인터랙티브 세션 안에서 /permissions 로 전환하는 흐름. CLI 플래그로 한 번에 박는 경로가 다른 둘보다 약해요.
2-3. Gemini CLI — 4단계, 플래그 + alias
default → auto_edit → yolo → plan
default매번 묻기auto_edit파일 편집 자동 / 셸은 묻기 (= Claude 의acceptEdits)yolo전부 자동 (= Claude 의bypassPermissions)plan코드 안 건드림
CLI 띄울 때 --approval-mode yolo 식으로 박는 게 가장 깔끔.
2-4. 같은 개념 매핑
| 의미 | Claude | Codex | Gemini |
|---|---|---|---|
| 매번 묻기 | default |
(없음) | default |
| 읽기 전용 | plan |
Read-only |
plan |
| 편집 자동, 셸 묻기 | acceptEdits |
(없음) | auto_edit |
| 작업 폴더 자동 | auto |
Auto |
(별도 없음) |
| 전부 자동 | bypassPermissions |
Full Access |
yolo |
🚨 풀자동 모드(
bypassPermissions/Full Access/yolo) 는 호스트 파일·네트워크에 자유롭게 액션이 들어가서 한 번의 실수가 크게 번질 수 있어요. 세 도구 모두 격리된 컨테이너/VM 안에서만 권장합니다.
3. 헤드리스 자동화 비교
CI·스크립트에 끼워넣을 때의 사용감이 가장 갈리는 지점이에요.
3-1. Claude Code — -p + --output-format json
claude -p "/review" --output-format json
/review 같은 슬래시 명령을 -p 안에 그대로 박을 수 있는 게 특징. CI 에서 셀프 리뷰 봇 만들기 편해요.
3-2. Codex — codex exec + --json
codex exec --json "이 PR diff 요약"
전용 서브커맨드(exec)로 분리돼 있어서 의도가 명확해요. --json 한 줄로 깔끔.
3-3. Gemini — -p + -o stream-json
gemini -p "긴 리팩토링" -o stream-json | tee progress.jsonl
stream-json 출력이 두드러져요. 토큰 단위 스트리밍을 라인 단위로 받아서 파이프로 흘리면 진행 상황을 CI 로그에 실시간으로 박을 수 있어요. 셋 중 헤드리스 모드의 깊이가 가장 다듬어진 인상.
3-4. 매칭 매트릭스
| 시나리오 | 추천 |
|---|---|
| 한 번에 결과 받고 끝 | 셋 다 OK — claude -p / codex exec / gemini -p |
| 진행 상황 실시간 스트리밍 | Gemini (-o stream-json) |
| 슬래시 명령 그대로 자동화 | Claude Code (-p "/review") |
| 단순 JSON 파싱 후처리 | Codex (exec --json) 가 의도가 가장 명확 |
4. 세션 이어가기와 체크포인트
작업 도중 끊겼다가 돌아올 때의 사용감 비교.
4-1. Claude Code
claude -c # 현재 디렉토리 최근 세션
claude -r # 피커
claude -r "blog" # 이름 검색
--name 으로 세션에 이름 박아두면 -r "blog" 같이 검색해서 복귀 가능. 세션 명명 이 강점.
4-2. Codex
codex resume # 피커
codex resume --last # 최근
codex resume <SESSION_ID>
이름 검색이 별도로 없고 ID 기반. 단, codex cloud 와 결합되면 클라우드 세션도 같은 결로 이어가기 가능해서 멀리 떨어진 환경 간 연속성에서 강해요.
4-3. Gemini CLI
gemini -r # 최근
gemini -r 1 # 인덱스
gemini -r <UUID> # UUID
gemini --list-sessions
gemini --delete-session 2
세션 삭제·목록 같은 관리 명령이 CLI 1급 시민이라는 게 특징. 거기에 세션 안에서 /resume save <이름> 으로 체크포인트 를 박을 수 있어서 한 세션 안에서 가지치기가 깔끔해요.
4-4. 매칭
| 시나리오 | 추천 |
|---|---|
| 짧게 끊고 자주 복귀 | Claude (-c) 가 가장 빠름 |
| 세션 안에서 분기·되돌리기 | Gemini (/resume save <이름>) |
| 원격(클라우드) ↔ 로컬 연속성 | Codex (cloud + resume) |
5. 컨텍스트 파일 — CLAUDE.md / AGENTS.md / GEMINI.md
각 도구가 저장소를 처음 열 때 자동으로 읽는 컨텍스트 파일이에요. 이름만 다를 뿐 역할은 거의 같아요.
| 파일 | 도구 | 위치 | 자동 로드 |
|---|---|---|---|
CLAUDE.md |
Claude Code | 저장소 루트, 사용자 홈 | ✅ |
AGENTS.md |
Codex | 저장소 루트, ~/.codex/AGENTS.md |
✅ |
GEMINI.md |
Gemini | 저장소 루트, ~/.gemini/GEMINI.md |
✅ (/memory reload 로 핫리로드) |
같은 저장소에서 셋을 다 굴리고 싶다면 보통 두 가지 패턴이 있어요.
- 세 파일 모두 같은 내용으로 유지 — 가장 단순. 한쪽 수정하면 나머지에 복붙. 작은 저장소에서 OK.
- 한 파일을 마스터로 두고 나머지는 심볼릭 링크 — 예:
CLAUDE.md를 마스터로 하고AGENTS.md,GEMINI.md는ln -s CLAUDE.md ...로 링크. 한 곳만 고치면 셋 다 반영.
# 마스터 = CLAUDE.md 전략
ln -sf CLAUDE.md AGENTS.md
ln -sf CLAUDE.md GEMINI.md
💡 단, 도구별로 다른 규칙이 있다면 심볼릭 링크는 깨져요. 그땐 공통부와 도구별 추가분을 섹션으로 나눠두고 각 파일에서 필요한 섹션만 포함하는 식이 안전합니다.
6. MCP · 확장 · 스킬 — 외부 도구 통합
세 도구 모두 외부 도구를 붙이는 통로를 가지고 있는데, 결이 조금씩 달라요.
6-1. Claude Code
- MCP:
/mcp로 관리. 가장 표준에 가까움. - 서브에이전트:
/agents로 페르소나 등록 (코드 리뷰 전용 등). - 스킬/플러그인:
/skills로 외부 능력 모듈 호출. 표준화된 인터페이스.
6-2. Codex
- MCP:
codex mcp와~/.codex/config.toml의[mcp_servers]섹션. - 프로필:
--profile <name>으로 모델·MCP·권한 조합을 통째로 묶어서 띄움. 작업 컨텍스트 전환이 한 글자로 끝나는 강점. codex cloud와 결합되면 클라우드 환경 안에서도 같은 도구 셋업 유지.
6-3. Gemini CLI
- MCP:
gemini mcp로 관리. - 확장(Extensions):
gemini extensions로 더 큰 단위(파일·UI 통합 등) 의 확장 관리.@github같은 mention 이 여기서 옴. - 스킬(Skills):
gemini skills로 명시적인 능력 모듈 시스템. 셋 중 가장 모듈화 단위가 세분돼 있어요.
6-4. 매칭
| 시나리오 | 추천 |
|---|---|
| 표준 MCP 만 잘 쓰면 됨 | 셋 다 OK |
| 작업별로 도구·모델 셋업 통째 전환 | Codex (--profile) |
@github 처럼 확장이 mention 으로 자연스럽게 호출 |
Gemini (@<extension> mention) |
| 페르소나/역할 분리 (리뷰어·테스터) | Claude (/agents) |
7. 작업 유형별 추천 매트릭스
실제로 도구를 고를 때 가장 도움이 되는 표예요. “지금 하려는 작업” 을 기준으로 어떤 도구가 가장 매끄러운지 정리했어요.
| 작업 | 추천 도구 | 이유 |
|---|---|---|
| 여러 세션을 이름으로 구분해 동시 작업 | Claude Code | --name + -r "<name>" 검색 |
| PR 셀프 리뷰 자동화 | Claude Code | -p "/review" 가 가장 짧음 |
| 이미지 시안 보고 코드 만들기 | Codex | -i screenshot.png,mockup.png 다중 이미지 |
| 모노레포 인접 패키지 같이 만지기 | 셋 다 OK | --add-dir / --include-directories |
| CI 파이프라인에서 진행 상황 스트리밍 | Gemini | -p -o stream-json |
| 격리 환경에서 풀자동 실행 | Codex | /permissions Full Access + 컨테이너 |
| 읽기 전용으로 안전하게 훑기 | Claude / Gemini | plan 모드 |
| 외부 시스템(GitHub·Linear 등) 호출 | Gemini | @github 확장 mention 자연스러움 |
| 클라우드 환경에서 긴 작업 위임 | Codex | codex cloud exec --env --attempts |
| 세션 안에서 분기·되돌리기 | Gemini | /resume save <name> 체크포인트 |
| 새 저장소 처음 셋업 | 셋 다 OK | /init 또는 컨텍스트 파일 수동 작성 |
물론 한 도구로 다 할 수 있는 작업이 대부분 이에요. 이 표는 “굳이 고른다면” 의 가이드이고, 실제 작업에선 본인이 손에 익은 도구를 그대로 쓰는 게 가장 빠릅니다.
8. 한 줄 결론
- Claude Code: 세션 명명·서브에이전트·플러그인 같은 워크플로우 인프라 가 가장 두텁다. 매일 여러 작업을 동시에 굴리는 사람에게 어울려요.
- Codex: 프로필 과 클라우드 통합 이 강점. 작업 컨텍스트 전환·원격 위임이 잦은 사람에게.
- Gemini CLI: 헤드리스 자동화 와 확장 mention 이 정돈됨. CI·스크립트 자동화 비중이 큰 사람에게.
셋 다 무료/저렴한 티어로 깔아볼 수 있으니, 이 표를 가이드 삼아 본인 워크플로우에서 한 번씩 굴려보고 손에 가장 잘 붙는 걸 메인으로 잡는 걸 추천드려요. 저는 작업 종류에 따라 셋을 번갈아 쓰고 있는데, 이 시리즈를 정리하면서 “어떤 작업엔 어떤 도구가 더 빠른지” 가 머릿속에서 한층 정리됐어요.
일단 오늘은 여기까지…..
다음 글에서는 시리즈 후속으로 CLAUDE.md / AGENTS.md / GEMINI.md 한 파일로 통합 관리하는 패턴 을 더 자세히 정리해볼게요.