Claude Code와 Codex 함께 사용하기: 작업 패턴 3가지
MarkdownClaude Code와 Codex 함께 사용하기: 코드 작성 및 검토, 초안 작성과 아키텍처 설계, 인프라와 비즈니스 로직 분리, 지침 동기화.
전체 글 읽기
핵심 요점
에이전트 하나, 작업 속도 하나: 아키텍처를 신중하게 검토하거나 초안을 빠르게 쏟아낼 수 있습니다. Claude Code와 Codex를 함께 사용하면 두 방식 모두를 활용할 수 있습니다. Claude Code는 충분히 숙고하고 질문하며 신중하게 접근합니다. Codex는 샌드박스에서 결과를 향해 빠르게 나아갑니다. 2026년에는 대부분의 강력한 팀이 두 도구를 모두 사용하고 상황에 따라 전환합니다.
에이전트 활용과 바이브 코딩에 관한 실용 자료: Ailoot 문서.
2026년에는 왜 도구 하나만으로 부족할까요?
핵심 요점
2026년 6월이면 “모든 것을 처리할 수 있는 단 하나의 올바른 에이전트”라는 통념은 무너졌습니다. Claude Code는 아키텍처 작업과 장기 리팩터링에서 앞섭니다. Codex는 자율 PR과 병렬 샌드박스 작업을 더 빠르게 처리합니다.
2026년 5월, OpenAI는 Codex CLI에 GPT-5.5 모델을 도입해 Anthropic의 영역에 진입했습니다. 최근 벤치마크에서 Codex는 터미널 작업과 SWE-bench Verified 모드에서 뚜렷한 우위를 보입니다. Anthropic은 Opus 4.8과 Dynamic Workflows로 대응해 SWE-bench Pro에서 우위를 유지했습니다(데이터 유출을 방지하도록 설계된 테스트로, 모델을 벤치마크 데이터로 학습해도 도움이 되지 않습니다). 상세한 맞대결 비교는 Codex vs Claude Code 가이드에서 다루며, 여기서는 바로 두 도구의 조합으로 넘어가겠습니다.
2026년에는 단 하나의 승자가 없습니다. 두드러지는 패턴은 팀이 저렴한 자율 작업에는 Codex를, 위험 부담이 큰 아키텍처 결정에는 Claude Code를 사용한다는 것입니다.
작업을 나누는 방식을 결정하는 핵심 차이는 다음과 같습니다.
- Claude Code는 연구자입니다. 길고 심도 있는 대화를 이어가며 가정을 의심하고, 해결책을 선택하기 전에 여러 접근 방식을 검토합니다. 처음부터 올바른 조치가 분명하지 않은 상황에 적합합니다.
- Codex는 실행자입니다. 작업을 받아 샌드박스에서 결과를 향해 나아갑니다. 빠른 “요청과 결과” 주기가 필요한 명확한 작업에 적합합니다.
두 도구를 모두 사용할 수 있다면 “생각하기”와 “실행하기” 중 하나를 고를 필요가 없습니다. 작업 유형에 따라 위임하면 됩니다. 둘 중 어떤 도구를 먼저 설치할지 아직 결정하지 못했다면 Codex vs Claude Code 가이드에서 직접 비교를 볼 수 있습니다.
패턴 1: Claude Code가 코드를 작성하고 Codex가 검토합니다
핵심 요점
시작하기 가장 쉬운 패턴입니다. Claude Code는 Plan Mode에서 아키텍처를 검토하고 맥락을 이해한 상태로 기능을 작성합니다. Codex는 풀 리퀘스트의 diff를 받아 테스트를 실행하고, 엣지 케이스를 확인하며, 환각 때문에 Claude가 놓친 버그를 찾습니다. 품질과 두 번째 검토자의 시선이 필요한 상황에 적합합니다.
이 패턴에서는 Claude Code가 계속 주 편집자 역할을 맡습니다. Codex는 클라우드 모드를 통해 PR 단계에서만 참여합니다(Codex는 ChatGPT나 GitHub 앱에서 바로 실행되므로 두 번째 터미널이 필요하지 않습니다).
실제로는 다음과 같이 진행됩니다:
1단계: Claude Code에서 기능 작성하기
VS Code에서 저장소를 열고 Claude Code를 실행한 다음 Plan Mode로 전환해 기능 아키텍처를 논의합니다. 코드 초안, 테스트, 마이그레이션을 만들 수 있습니다. 기능 브랜치에 커밋합니다.
2단계: GitHub에서 PR 만들기
기능 브랜치에서 main으로 풀 리퀘스트를 엽니다. 설명에
@codex review this PR for edge cases, security issues, and test coverage gaps를 입력합니다.3단계: Codex가 비동기식으로 검토하기
클라우드 모드에서 Codex는 저장소를 샌드박스에 복제하고 diff를 읽은 다음 테스트와 린터를 실행하며 취약점을 찾습니다. 5-15분 후 PR에 직접 의견을 남깁니다.
4단계: Claude Code에서 수정하기
Claude Code로 돌아가 Codex의 의견을 맥락으로 전달합니다. “검토에서 발견한 내용이야. 1, 3, 5번 항목을 수정해.” Claude가 수정 사항을 반영하고 저장소에 게시합니다.
이 패턴이 효과적인 이유는 Claude와 Codex가 서로 다른 데이터셋으로 학습했고 철학도 다르기 때문입니다. Codex는 모델의 사각지대 때문에 Claude가 놓친 점을 발견하며, 그 반대도 마찬가지입니다.
패턴 1의 위험:
- Codex는 아키텍처 문제를 놓친 채 PR을 승인하고 닫을 수 있습니다. 중요한 결정은 직접 검토하세요.
- 토큰 비용이 두 배로 듭니다. Claude와 Codex가 같은 코드를 분석합니다. 복잡한 기능에서는 비용을 감수할 만하지만 작은 기능에는 부담이 큽니다.
- 클라우드 모드의 Codex는 환경 변수나 로컬 데이터베이스 같은 로컬 환경을 볼 수 없습니다. 기능이 이에 영향을 받는다면 수동 실행으로 전환하세요.
패턴 2: Codex가 초안을 만들고 Claude Code가 아키텍처를 다듬습니다
핵심 요점
정반대 방식의 패턴입니다. Codex가 모델, 폼 또는 엔드포인트 같은 대략적인 초안을 빠르게 작성합니다. 몇 분이면 결과를 얻습니다. 그런 다음 Claude Code에서 파일을 열고 아키텍처를 정리하고, 계층을 분리하고, 타입을 추가하고, 이름을 다듬도록 요청합니다. 초기 완성도보다 시작 속도가 중요한 상황에 적합합니다.
이 패턴은 2026년에 소개된 프로젝트에서 사용되었습니다. 이메일 알림이 포함된 가입 퍼널 프로토타입을 어느 날 저녁 안에 만들어야 했습니다. 이 상황에서 Claude Code와 아키텍처를 논의하는 데 한 시간을 쓸 수도 있었지만, Codex는 12분 만에 작동하는 초안을 만들었습니다.
작동 방식:
| 단계 | 담당 | 시간 | 결과물 |
|---|---|---|---|
| 명세 | 작업 작성자 | 5분 | 원하는 것, 필드, 제약 조건을 담은 한 문단 |
| 대략적인 초안 | Codex | 5-15분 | 작동하는 코드, 테스트, 문서 |
| 아키텍처 정리 | Claude Code | 20-30분 | 분리된 계층, 엄격한 타입, 알기 쉬운 이름 |
| 최종 테스트 | Claude Code | 10분 | 완전한 커버리지, 누락 없음 |
방식은 이렇습니다. Codex가 처음 15분 동안 반복 작업을 처리하고, Claude가 결과를 프로덕션 수준으로 끌어올립니다.
Codex에게 처음부터 완성도 높게 만들어 달라고 하면 모호함 앞에서 막힙니다. Claude Code에게 처음부터 빠르게 하라고 하면 계속 재검토하기 시작합니다. 각 도구에 잘 맞는 일을 맡기세요.
패턴 2의 위험:
- Codex가 나중에 정리하기 어려운 가정을 포함한 초안을 만들 수 있습니다. 초안이 잘못된 방향으로 갔다면 수정하는 것보다 버리고 다시 시작하는 편이 저렴합니다.
- Claude Code가 변수 이름을 바꾸느라 30분을 쓰고 실제 아키텍처 문제를 잊을 수 있습니다. “정리해 줘”라고 하기보다 구체적인 변경 사항을 지정하세요.
- 세션이 바뀌면 맥락이 사라집니다. Codex가 의도한 바를 Claude Code가 이해하려면
AGENTS.md(패턴 5 참조)나 파일 시작 부분의 자세한 주석이 필요합니다.
패턴 3: Codex는 인프라를, Claude Code는 비즈니스 로직을 담당합니다
핵심 요점
2-5명 팀을 위한 가장 고급 패턴입니다. Codex는 CI/CD, 테스트, 마이그레이션, 인프라 코드, 설정 등 인프라를 처리합니다. Claude Code는 모델, 제품 기능, 사용자 시나리오 처리 등 비즈니스 로직을 담당합니다. 각 도구는 자체 책임 영역 안에서 작업합니다.
아이디어는 간단합니다. 코드베이스의 각 부분에는 서로 다른 작업 방식이 필요합니다.
이 패턴은 Claude Code 인스턴스 여러 개를 병렬로 실행하는 접근 방식을 보완합니다. 그 방식에서는 같은 모델이 git worktree를 통해 서로 다른 작업을 처리하고, 여기서는 서로 다른 두 에이전트가 책임 영역을 나눕니다.
인프라 계층 (Codex):
- GitHub Actions: 새 작업 추가, 캐싱 조정, CI 속도 개선.
- 테스트: 리팩터링 후 통합 테스트 모음 작성.
- Prisma 마이그레이션: 마이그레이션을 생성하고 롤백 가능한지 확인.
- Docker / Coolify 설정: 환경 변수 추가, 상태 점검 업데이트.
- Cron 작업: cron 핸들러 모음 작성.
인프라 작업은 흔히 보일러플레이트 코드가 포함된 작은 파일이 많기 때문에 Codex가 여기서 강점을 보입니다. Codex는 “더 생각해 봐야 한다”며 주저하지 않고 끝까지 진행합니다.
비즈니스 로직 (Claude Code):
- 가입 퍼널: 각 단계에서 사용자에게 무엇을 보여줄지.
- 할인, 할부, 선물용 프로모션 코드를 고려한 가격 계산.
- 자동 알림 워크플로: 어떤 트리거와 조건을 사용할지.
- 외부 API 통합: 오류 처리, 재시도, 캐싱.
- 재무 모델: 단위 경제성 계산과 수익 예측.
이 작업에는 제품 관점을 고려한 심층 대화가 필요하므로 Claude Code가 강점을 보입니다. 시나리오를 논의하지 않으면 사용자의 실제 불편을 고려하지 않은 기술적 해결책을 내놓게 됩니다.
저장소에서 작업을 나누는 방식:
project/
├── .github/workflows/ ← Codex (CI, tests)
├── infra/ ← Codex (Docker, Coolify, migrations)
├── scripts/ ← Codex (task scripts)
├── tests/ ← Codex (integration tests)
├── src/
│ ├── lib/ ← Claude Code (business logic)
│ ├── app/ ← Claude Code (routes, forms, pages)
│ └── components/ ← Claude Code (UI)
└── prisma/
└── schema.prisma ← Claude Code (data models—product decision)
엄격한 규칙은 아닙니다. 예를 들어 게시 후 알림을 보내는 것처럼 GitHub Action이 제품 의미를 지닌다면 Claude Code가 수정할 수도 있습니다. 그래도 작업의 80%는 이 분류에 잘 들어맞습니다.
CLAUDE.md와 AGENTS.md는 어떻게 동기화하나요?
핵심 요점
두 도구가 서로 다른 규칙을 따른다는 점이 조합의 주요 위험입니다. Claude Code는 CLAUDE.md를 대화형 선호 사항으로 읽습니다. Codex는 AGENTS.md를 테스트 명령, 린트, 금지된 디렉터리, 커밋 형식 등을 담은 운영 지침으로 읽습니다. 공통 기술 규칙은 두 파일에 재사용할 수 있습니다. 복사한 텍스트에서 도구별 명령과 설정을 검토하세요. Markdown 복사 자체가 Codex를 망가뜨리지는 않습니다. /context/의 표준 원본에서 두 파일을 생성하는 것도 한 방법입니다.
Claude Code와 Codex를 병렬로 사용한 경험을 설명하면서 예상치 못한 문제가 드러났습니다. Claude Code는 CLAUDE.md의 규칙(“확인 없이 마이그레이션을 건드리지 말 것”)을 따랐습니다. Codex는 이 규칙을 볼 수 없었고 작업 환경에서 주저 없이 마이그레이션을 실행했습니다. 데이터베이스가 세 번째로 손상된 뒤 두 파일을 제대로 동기화하는 방법을 찾아야 했습니다.
두 파일 모두 프로젝트 맥락, 대화 선호, 테스트 명령, 제외 디렉터리, 커밋 표준을 담을 수 있습니다. 공통 규칙을 재사용하고 도구별 명령과 설정은 분리하세요. 예를 들어 마이그레이션 변경 금지가 두 에이전트 모두에 적용되면 두 지침에 모두 있어야 합니다.
두 파일에 공통으로 들어가는 내용:
- 기술 스택: 사용하는 프레임워크, 데이터베이스, ORM.
- 프로젝트 설명: 무엇인지, 누구를 위한 것인지, 주요 엔터티는 무엇인지.
- 금지 사항: 건드리지 말아야 할 폴더와 실행하지 말아야 할 명령.
서로 다른 내용:
- Claude Code 전용 훅, 설정 계층, MCP 설정은 해당 구성 파일에 둡니다. CLAUDE.md에서 설명을 참조할 수 있지만 복사한 산문이 이식 가능한 실행 설정이 되지는 않습니다.
AGENTS.md는 공개 표준입니다. Codex, Cursor, Aider, Continue, Cline, Factory Droid 등 25+ 에이전트가 읽습니다. 별도 가이드에서 AGENTS.md 형식을 더 자세히 다룹니다. Codex MCP 설정은~/.codex/config.toml에 저장됩니다(Claude처럼 JSON이 아니라 TOML입니다).
2026년에 흔히 쓰이는 패턴은 모노레포의 /context/ 폴더에 표준 규칙 원본을 두고 동기화 스크립트로 CLAUDE.md, .cursor/rules/*.mdc, AGENTS.md를 생성하는 것입니다. 도구별 파일은 읽기 전용으로 표시하고 원본만 편집합니다.
동기화 스크립트는 pre-commit hook 또는 GitHub Action에서 실행하세요. CLAUDE.md를 직접 수정하면 CI가 실패합니다. 이를 통해 도구마다 규칙이 달라지는 것을 막습니다.
또 다른 옵션은 공식 Claude Code용 Codex Plugin입니다(2026년 3월 30일 발표, 버전 1.0.4). Claude Code에 /codex:review, /codex:adversarial-review, /codex:rescue 명령을 추가합니다. Codex는 자체 ~/.codex/config.toml과 AGENTS.md를 사용해 하위 에이전트로 실행됩니다. 두 번째 터미널이 필요하지 않지만 AGENTS.md는 여전히 필요합니다.
두 도구를 함께 쓰는 비용은 얼마이며 어디서 절약할 수 있나요?
핵심 요점
대략적인 가격은 Claude Code Max (5x) 월 $100, Codex Plus 월 $20, Codex Pro 월 $200입니다. 한 사람이라면 Claude Max + Codex Plus = 월 $120입니다. 작업 시간 한 시간만 절약해도 비용을 회수할 수 있습니다. 주요 절감 효과는 올바른 해결책을 더 빨리 찾는 데서 나오며, 토큰은 부차적입니다.
2026년 6월 기준 가격입니다(Anthropic 및 OpenAI 구독 페이지의 데이터와 공식 Codex 페이지):
| 구독 | 가격 | 포함 내용 |
|---|---|---|
| Claude Pro | $20/월 | Claude.ai + Claude Code (Pro 한도) |
| Claude Max 5x | $100/월 | Claude Code, Pro 한도의 5배 |
| Claude Max 20x | $200/월 | Claude Code, Pro 한도의 20배 |
| ChatGPT Plus | $20/월 | Codex CLI + 클라우드 (Plus 한도) |
| ChatGPT Pro 5x | $100/월 | Codex CLI + 클라우드, Plus 한도의 5배 |
| ChatGPT Pro 20x | $200/월 | Codex CLI + 클라우드, Plus 한도의 20배 |
최소한으로 작동하는 조합: Claude Pro ($20) + ChatGPT Plus ($20) = 월 $40. 하루에 몇 번씩 세션을 진행하는 개인 프로젝트에 충분합니다.
활발하게 바이브 코딩하는 사람에게 적합한 조합: Claude Max 5x ($100) + ChatGPT Plus ($20) = 월 $120. 설명된 경험에서는 지난 2개월 동안 이 조합을 사용했으며, 그동안 프로젝트 세 개를 출시했고 Claude 한도에 도달한 적은 없었습니다.
팀을 위한 조합: Claude Max 20x ($200) + Codex Pro ($200) = 월 $400. PR 검토와 클라우드 작업이 로컬 작업과 병렬로 꾸준히 진행되는 경우 적합합니다.
절감 효과가 발생하는 이유:
- 기능당 소요 시간 감소. 작성자의 측정 결과, 5월과 6월에 진행한 기능 12개에서 “아이디어가 떠오른 순간”부터 “프로덕션에 반영된 순간”까지 걸린 시간이 Claude Code 하나를 쓸 때 4시간에서 조합을 사용할 때 2.5시간으로 줄었습니다. 작성자의 작업을 측정한 결과이므로 여러분의 결과는 다를 수 있습니다.
- 결함 감소. 설명된 관찰에 따르면 Codex의 PR 검토는 Claude가 놓치는 문제 10개 중 2-3개를 찾아냅니다. 프로덕션에서 문제 하나를 해결하려면 한두 시간이 들고 잠재적으로 서비스 중단도 발생할 수 있습니다.
- 병렬 작업. 사용자가 Claude와 기능 B를 작업하는 동안 Codex는 클라우드 모드에서 기능 A를 처리합니다. 처리량이 두 배가 됩니다.
일주일에 기능을 1-2개 작성한다면 비용을 회수하기 어렵습니다. 그런 경우 Claude Code Pro 하나면 충분합니다.
두 번째 도구가 필요하지 않은 경우는 언제인가요?
핵심 요점
조합이 과한 네 가지 상황: 일주일에 기능 1-2개를 만드는 개인 프로젝트, 월 $20의 엄격한 예산, CI/CD가 없는 단순한 아키텍처의 프로젝트, Claude Code가 이미 모든 작업을 안정적으로 처리하는 팀입니다. 이런 경우 Codex를 추가하면 막연한 이득을 위해 동기화에 시간을 쓰게 됩니다.
이 조합이 모두에게 필요한 것은 아닙니다. 오히려 잡음만 늘어나는 경우가 많습니다. 두 번째 도구가 필요하지 않은 네 가지 상황은 다음과 같습니다.
시작 단계의 개인 프로젝트. 아이디어 하나를 시험하는 단계라면 Claude Code + Plan Mode만으로도 한 달은 충분합니다. 속도가 병목이 되면 조합을 추가하세요.
엄격한 예산. 월 $20이 한도라면 Claude Pro를 이용하면 됩니다. Claude 하나만으로도 바이브 코더 작업의 80%를 처리할 수 있습니다.
단순한 아키텍처. 폼이 있는 웹사이트, 몇 가지 시나리오가 있는 봇, API 래퍼 스크립트라면 계층별로 나눠도 얻는 것이 없습니다. Claude Code 하나로 처리할 수 있습니다.
이미 모든 것이 잘 작동함. 한 달 동안 Claude Code를 사용했는데 막히거나 실패한 작업이 한 번도 없었다면 잘 작동하는 것을 고치지 마세요. 필요성이 분명해질 때 Codex를 추가하세요.
반대로 두 번째 도구를 도입할 때가 되었다는 분명한 신호는 다음과 같습니다.
- Claude Code가 병목이 되어 작업하는 대신 Claude Code를 기다리고 있습니다.
- Claude로 처리하기 싫은 반복적인 인프라 작업(마이그레이션, CI, 테스트)이 많이 생겼습니다.
- 팀원마다 이미 다른 도구를 사용하고 있어 공통 언어가 필요합니다.
- 벤치마크에서 Codex가 여러분의 작업 유형(예: 터미널 작업)을 더 빠르게 처리하는 것으로 나타납니다.
저녁 한 번으로 조합을 설정하는 방법
핵심 요점
저녁 한 번 동안 단계별로 진행합니다. Claude Code와 함께 Codex CLI를 설치하고, 공통 기술 규칙을 AGENTS.md에 재사용하되 도구별 지침을 분리한 다음, 현재 프로젝트에 맞는 패턴 3가지 중 하나를 선택해 기능 3-5개에 적용하고 이전 작업 속도와 비교합니다. 그런 다음 패턴을 바꾸고 규칙을 동기화하고 MCP 서버를 추가하면서 개선합니다.
첫날 저녁에 따라 할 구체적인 계획입니다.
1단계: Codex CLI 설치하기
터미널에서
npm install -g @openai/codex를 실행합니다.codex login으로 로그인하면 브라우저가 열리고 ChatGPT 계정으로 로그인할 수 있습니다. Codex는 구독(Plus / Pro)을 확인하고 해당 한도를 사용합니다.2단계: 운영 문서로 AGENTS.md 작성하기
CLAUDE.md에서 두 도구에 적용되는 규칙을 검토해 AGENTS.md에 재사용하세요. 테스트·린트 명령, 커밋 형식, 금지 폴더, 스택 설명과 대화 선호도 공유할 수 있습니다. 도구별 명령 참조는 조정하고 실행 가능한 훅과 MCP는 각 도구의 자체 구성에 두세요. Markdown 복사만으로 설정되지는 않습니다.
3단계: 프로젝트에 맞는 패턴 선택하기
CI를 사용하는 개인 개발자라면 패턴 1(Claude가 작성하고 Codex가 검토)을 사용하세요. 새 프로젝트에서 속도가 필요하다면 패턴 2(Codex가 초안을 만들고 Claude가 다듬기)를 사용하세요. 인프라 계층이 있는 기존 프로젝트라면 패턴 3(계층별 분담)을 사용하세요.
4단계: 일주일 동안 실험하기
선택한 패턴으로 기능 5-7개를 작업하세요. 시간을 기록하고 각 작업을 어느 도구가 더 잘 처리했는지 적어 두세요. 일주일이 지나면 실제 사용 양상을 파악할 수 있습니다.
5단계: 규칙 동기화 설정하기
scripts/sync-agent-rules.sh스크립트를 추가하세요(동기화 섹션 참조). pre-commit hook이나 GitHub Action에 연결하세요. 그러면 규칙이 두 파일에 자동으로 반영됩니다.
이 조합은 마법이 아닙니다. 한 명이 아니라 두 가지 사고방식을 활용해 서로의 약점을 보완하는 것입니다. 핵심은 “Claude냐 Codex냐”를 두고 논쟁하는 데 갇히지 않는 것입니다. 답은 오래전부터 “각기 다른 작업에 Claude와 Codex 둘 다”였습니다.
에이전트 활용에 관한 실용 자료: Ailoot 문서.
출처
추가 자료와 도구: Ailoot.
자세히 보기
Claude Code와 Codex 함께 사용하기: 작업 패턴 3가지 | Ailoot: 자주 묻는 질문
CLAUDE.md 내용을 AGENTS.md에 재사용해도 되나요?
네. 두 도구에 적용되는지 확인한 공통 프로젝트 사실, 테스트 명령, 코딩 규칙, 제한을 재사용하세요. 도구별 명령과 구성 참조는 조정해야 하지만 Markdown 복사 자체가 Codex를 망가뜨리지는 않습니다.
두 에이전트 작업과 기존 방식을 어떻게 비교하나요?
협업 패턴 하나를 골라 일주일 동안 실제 기능 여러 개에 쓰세요. 시간과 발견 결함을 기록하고 비슷한 단일 도구 작업과 비교한 뒤 동기화나 에이전트를 추가하세요.