Codex CLI와 Claude Code, 터미널 에이전트 역할은 어떻게 나누나
Codex CLI와 Claude Code를 한 레포에서 같이 쓸 때는 가격이 아니라 역할 분업이 핵심입니다. Codex는 AGENTS.md와 ~/.codex/config.toml의 승인·샌드박스 축이 강하고, Claude Code는 CLAUDE.md·permissions·훅·서브에이전트/에이전트 뷰 축이 강합니다.
이 글은 공식 Codex·Claude Code 문서를 바탕으로 각자 강한 작업, 같은 레포 충돌 방지, IDE 에이전트와의 삼각형만 정리합니다. 요금·한도 숫자는 다루지 않습니다.
각각 강한 작업은?
한 줄 답: Codex는 AGENTS.md 기반의 터미널 TUI·샌드박스 작업에, Claude Code는 권한 규칙·훅·멀티 에이전트 오케스트레이션에 무게를 둡니다.
| 축 | Codex CLI | Claude Code |
|---|---|---|
| 지시 파일 | AGENTS.md (+ override·중첩) | CLAUDE.md (+ settings) |
| 설정 | ~/.codex/config.toml | ~/.claude/settings.json, .claude/settings.json |
| 안전 경계 | approval_policy + sandbox_mode | permissions allow/ask/deny + sandbox |
| 병렬·분업 | 세션/워크트리를 사람이 나눔 | 서브에이전트, agent view, (실험) agent teams |
| 확장 | MCP·앱 서버 연동 | 훅, skills/commands, MCP |
실사용 분업 예(단정 후기 아님):
- Codex에 맡기기 쉬운 것: AGENTS.md에 적힌 테스트·린트를 따라가며 패치하는 단일 작업, 샌드박스를 좁힌 채 셸을 돌리는 작업.
- Claude Code에 맡기기 쉬운 것: 도구별 allow/deny를 레포에 고정한 채 긴 세션, PreToolUse 훅이 필요한 가드, 서브에이전트로 탐색·구현을 나누는 작업.
- 둘 다 가능한 것: 단일 파일 버그픽스 — 이미 켜 둔 도구·지시 파일이 있는 쪽으로.
모델·제품 UI는 자주 바뀌므로, “어느 쪽이 항상 더 똑똑하다”는 문장 대신 지시 파일·권한 모델이 맞는 쪽을 고릅니다.
같은 레포 충돌은?
한 줄 답: 동시에 같은 워킹 트리에 쓰지 말고, 브랜치·worktree·이슈 단위로 나누며, 공통 명령은 AGENTS.md에 한 번만 둡니다.
충돌이 나는 지점:
- 같은 파일 동시 편집 — 두 TUI가 한 dirty tree에서 저장하면 머지 지옥입니다.
- 지시 파일 불일치 — Codex는 AGENTS.md, Claude는 CLAUDE.md. 테스트 명령이 다르면 각자 “초록”을 다른 기준으로 선언합니다.
- 권한/샌드박스 불일치 — 한쪽만 네트워크·
.env를 막아 두면 결과가 갈립니다.
예방 체크리스트:
- 작업마다 브랜치 또는
git worktree하나. - 루트
AGENTS.md에 Setup 명령을 두고,CLAUDE.md는 “레포 규칙은 AGENTS.md” + Claude 전용 permissions만. - lock 파일·생성물(
.next,target/)은 에이전트 ignore 목록에 공통으로. - PR은 사람(또는 IDE 리뷰)이 한 번에 하나만 머지.
Codex 쪽 /import로 Claude·Cursor 설정을 가져오는 경로가 문서화되어 있으나, 동시 실행 충돌을 자동으로 막지는 않습니다.
IDE 에이전트와 삼각형은?
한 줄 답: IDE(Cursor 등)는 편집·디프·훅, 터미널 에이전트(Codex/Claude Code)는 긴 셸·레포 전역 작업, 지시 파일은 AGENTS.md를 허브로 맞춥니다.
삼각형 역할:
| 꼭짓점 | 맡기기 좋은 것 |
|---|---|
| IDE 에이전트 | 파일 단위 편집, 인라인 디프, 저장/커밋 훅, MCP UI |
| Claude Code CLI | 권한 JSON·훅이 있는 장기 터미널 세션, 서브에이전트 |
| Codex CLI | AGENTS.md·샌드박스 중심의 터미널 TUI 세션 |
운영 규칙 초안:
- 허브 문서:
AGENTS.md(명령·보안). - IDE: Cursor rules/hooks는 “포맷·위험 셸”만 — 레포 설명 복붙 금지.
- 터미널 하나 선택: 한 이슈에 Codex 또는 Claude Code — 둘 다 붙이지 않기.
- 핸드오프: IDE에서 스펙을 고정 → 터미널 에이전트가 구현 → IDE에서 디프 리뷰.
가격·플랜 한도는 팀 정책에 맡기고, 이 글의 기준은 충돌 없는 역할 분리입니다.
마무리
역할을 나누려면 ① 강한 축(AGENTS+sandbox vs permissions+훅) → ② worktree로 충돌 방지 → ③ IDE·터미널·지시파일 삼각형을 고정하면 됩니다. 상세는 Codex CLI·AGENTS.md 가이드·Claude Code permissions·Claude Code agents를 참고하시기 바랍니다.