Claude Code와 Codex를 함께 쓰는 다섯 가지 방법
대부분은 이 중 두세 가지를 함께 써요. 아직 어느 에이전트를 쓸지 고민 중이라면 Claude Code vs Codex부터 보세요.
| 방법 | 동작 방식 | 이럴 때 쓰세요 |
|---|---|---|
| 1. 공용 지침 | 두 에이전트가 읽는 AGENTS.md 하나, CLAUDE.md가 이를 가져와요 | 항상요. 가장 싸게 할 수 있고, 두 에이전트가 서로 다른 규칙을 따르는 일을 막아 줘요 |
| 2. worktree 분리 | 에이전트마다 같은 저장소의 자기만의 git worktree와 브랜치에서 작업해요 | 두 에이전트가 동시에 코드를 고칠 때 |
| 3. 한쪽은 쓰고, 다른 쪽은 리뷰 | Claude Code가 쓰고 codex review가 브랜치를 점검해요. 반대도 가능해요 | 첫 번째 모델이 놓친 걸 두 번째 모델이 잡아 주길 원할 때 |
| 4. Claude Code 안의 Codex | OpenAI의 codex-plugin-cc가 Claude Code에 /codex:review, /codex:rescue 등을 추가해요 | Claude Code에서 작업하면서 Codex를 명령 하나로 부르고 싶을 때 |
| 5. 오케스트레이터 | 보드나 앱(Claude Squad, Conductor, Orca, Vibe Kanban, Crewmark)이 둘을 시작하고 추적해요 | 매일 여러 에이전트를 돌려서 터미널을 놓치기 일쑤일 때 |
2. 별도의 worktree에서 실행하기
에이전트 둘이 체크아웃 하나를 고치면 서로 덮어써요. Claude Code 공식 문서도 두 에이전트가 같은 파일을 고치면 덮어쓰기가 생긴다고 경고해요. git worktree는 저장소의 히스토리를 공유하면서 자기만의 파일과 브랜치를 가진 두 번째 작업 디렉터리라서, 에이전트마다 고칠 사본을 따로 가질 수 있어요.
Claude Code는 claude --worktree <name>으로 .claude/worktrees/ 아래에 하나를 만들어 줘요. Codex CLI에도 새 관리형 worktree에서 세션이나 codex exec 실행을 시작하는 --worktree 플래그가 있고, Codex 데스크톱 앱은 작업마다 worktree를 관리해요. 어느 에이전트든 일반 git worktree add도 돼요. 정리 방법, .env 파일용 .worktreeinclude, 기준 브랜치는 Claude Code worktree 가이드에 있어요.
3. 한쪽이 쓰고 다른 쪽이 리뷰하게 하기
둘을 함께 쓴다고 할 때 사람들이 가장 많이 떠올리는 방식이에요. 다른 회사의 두 번째 에이전트는 첫 에이전트의 가정 없이 diff를 읽기 때문에, 작성자가 놓친 걸 잡아낼 수 있어요.
- Codex가 Claude를 리뷰:
codex review --base main은 main 대비 브랜치를 리뷰하고,--uncommitted는 스테이징한 변경, 하지 않은 변경, 추적되지 않는 변경을 리뷰하고,--commit <SHA>는 커밋 하나를 리뷰해요. - Claude가 Codex를 리뷰: 비대화형 모드인
claude -p에 diff를 파이프로 넘기세요. Claude Code 문서에도git diff main | claude -p를 리뷰어로 돌리는 빌드 스크립트로 같은 아이디어가 나와요. - 리뷰 결과는 코드를 쓴 에이전트에게 돌려보내 고치게 하세요. 리뷰어가 같은 브랜치를 함께 고치게 두지 마세요.
4. Claude Code 안에서 Codex 호출하기 (공식 플러그인)
OpenAI는 "Claude Code에서 Codex를 써서 코드를 리뷰하거나 작업을 위임"하게 해 주는 Apache-2.0 Claude Code 플러그인 codex-plugin-cc를 공개했어요. 이미 컴퓨터에 설치된 codex CLI를 그대로 쓰기 때문에 로그인, 설정, 체크아웃도 같아요. ChatGPT 요금제(Free도 해당) 또는 OpenAI API 키와 Node.js 18.18 이상이 필요해요. 사용량은 Codex 사용 한도에서 차감돼요.
Claude Code 안에서 /plugin marketplace add openai/codex-plugin-cc, /plugin install codex@openai-codex, /reload-plugins, /codex:setup 순서로 설치하세요.
/codex:review: 커밋하지 않은 변경, 또는--base main으로 브랜치를 Codex가 읽기 전용으로 리뷰해요. README에 따르면 Codex에서 직접/review를 실행하는 것과 같아요./codex:adversarial-review: 설계 선택, 트레이드오프, 위험한 부분을 겨냥해 방향을 잡아 줄 수 있는 읽기 전용 리뷰예요./codex:rescue: 버그 조사나 수정 시도 같은 작업을 서브에이전트를 통해 Codex에게 넘겨요. 오래 걸리는 작업에는--background를 붙이고/codex:status와/codex:result로 확인하세요./codex:transfer: 지금의 Claude Code 대화를 Codex 스레드로 바꾸고, 거기서 이어 갈codex resume명령을 보여 줘요.- 선택 기능인 리뷰 게이트(
/codex:setup --enable-review-gate)는 Claude가 멈추려 할 때마다 Codex 리뷰를 돌리고, 문제가 보이면 멈추지 못하게 막아요. README는 오래 반복될 수 있고 사용 한도가 빠르게 닳을 수 있다고 경고하니, 지켜보고 있을 때만 켜세요.
단계별로: worktree, 공용 지침, 리뷰 루프
가장 흔한 구성이에요. Claude Code와 Codex가 같은 AGENTS.md를 바탕으로 각자의 worktree에서 만들고, 머지하기 전에 서로의 브랜치를 리뷰해요. 모든 명령은 Claude Code 문서, Codex CLI 레퍼런스, 플러그인 README에 있는 것이고, 리뷰 프롬프트는 예시예요.
AGENTS.md 하나를 쓰고 CLAUDE.md에서 가져오기
공용 규칙을 저장소 루트의 AGENTS.md에 넣으세요. Codex는 이 파일을 바로 읽어요. CLAUDE.md도 있다면 맨 위에 import를 넣어서 Claude Code가 같은 파일을 읽게 하세요.
# CLAUDE.md: Claude Code는 AGENTS.md를 먼저 읽고, 그다음에 나머지를 읽어요 @AGENTS.md ## Claude Code Use plan mode for changes under src/billing/.Claude Code를 자기만의 worktree에서 시작하기
Claude Code가 worktree와 그 브랜치를 만들어 줘요. 새 체크아웃이니 worktree 안에서 의존성을 설치하세요.
# Claude Code를 자기만의 worktree에서 실행: .claude/worktrees/feature-auth, 브랜치 worktree-feature-auth claude --worktree feature-auth # worktree가 git status에 나오지 않게 하기 echo ".claude/worktrees/" >> .gitignoreCodex를 두 번째 worktree에서 시작하기
git으로 worktree를 만들고 --cd로 Codex가 거기를 보게 하거나, --worktree로 Codex가 관리형 worktree를 만들게 하세요.
# Codex를 두 번째 worktree에서, 자기만의 브랜치로 실행 git worktree add ../project-feature-a -b feature-a codex --cd ../project-feature-a # 또는 일회성 작업이면 Codex가 관리형 worktree를 만들게 하기 codex exec --worktree "implement the next step"Codex가 Claude의 브랜치를 리뷰하게 하기
Claude Code가 끝나면 Claude의 worktree에서 main 대비 Codex 리뷰를 돌리세요. 플러그인을 설치했다면 Claude Code 안에서 해도 돼요. 결과는 Claude Code에 붙여 넣어 고치게 하세요.
# Codex가 Claude의 브랜치를 리뷰 (Claude의 worktree 안에서 실행) codex review --base main # 또는 Claude Code 안에서 OpenAI의 플러그인으로 /codex:review --base mainClaude Code가 Codex의 브랜치를 리뷰하게 하기
Codex의 diff를 Claude Code의 비대화형 모드에 파이프로 넘기고, 결과는 Codex에게 돌려주세요.
# Claude Code가 Codex의 브랜치를 리뷰 (Codex의 worktree 안에서 실행) git diff main | claude -p "Review this diff for bugs and missing tests. List each issue with file:line."머지한 뒤 worktree 지우기
브랜치를 평소처럼 머지하거나 PR을 연 다음, 더 필요 없는 worktree를 지우세요. Claude Code는 세션을 종료할 때 자기 worktree를 정리할지 물어봐요.
git worktree list git worktree remove ../project-feature-a
Claude Code와 Codex가 서로 대화할 수 있을까요?
채팅처럼 직접 주고받지는 못해요. 어느 에이전트도 다른 회사의 에이전트로 가는 내장 채널이 없어서, 둘 다 닿을 수 있는 무언가를 거쳐 대화해요. 저장소의 파일과 git 히스토리, 한쪽이 다른 쪽의 CLI에서 실행하는 명령, 둘 다 읽는 보드 같은 것들이에요.
- CLI로: Claude Code는
codex exec나codex review를 셸 명령으로 실행할 수 있고, Codex는claude -p를 실행할 수 있어요. 각자 상대의 답을 명령 출력으로 받아요. - 플러그인으로: Claude Code에서
/codex:rescue와/codex:review가 작업을 Codex에 보내고 결과를 대화로 가져와요. 플러그인은 OpenAI가 관리해요. - MCP로: 이 길은 대부분 닫혔어요. Codex는 예전에
codex mcp-server로 MCP 서버처럼 돌 수 있었지만, OpenAI가 Codex rust-v0.154.0에서 이를 없애고 개발자에게 실험적인 Codex app server를 안내해요. 이쪽은 자체 JSON-RPC 프로토콜을 써요. 반대로claude mcp serve는 Claude Code를 MCP 서버로 만들지만, 노출하는 건 Claude Code의 도구(읽기, 편집, 셸)이지 두 번째 Claude 에이전트가 아니에요. - 공유 보드로: 오케스트레이터나 이슈 보드가 작업, 댓글, 상태를 갖고 있고, 에이전트마다 거기서 읽고 써요.
- 회사 경계를 넘지 못하는 것: Claude Code의 agent teams와 세션 간 메시지는 Claude Code 세션끼리만 이어져요. Codex 세션은 팀원이 될 수 없어요.
Claude Code와 Codex를 동시에 돌릴 수 있을까요?
네. 둘은 별개의 프로그램이고 로그인도 따로라서, 한 컴퓨터의 한 저장소에서 동시에 돌릴 수 있어요. Claude Code는 Claude 요금제나 API 키를, Codex는 ChatGPT 요금제나 OpenAI API 키를 써요. 관리할 건 파일과 사용량이에요.
- 파일: 에이전트마다 자기 worktree를 주세요. 체크아웃 하나에 에이전트 둘이 있으면 같은 파일을 고치다 서로 덮어써요.
- 사용량: 에이전트마다 각자의 한도를 써요. Claude Code 플러그인으로 Codex에 보낸 작업은 Codex 사용 한도에서 차감돼요.
- 루프: 자동 리뷰 루프(플러그인의 리뷰 게이트 같은)는 두 에이전트를 오래 붙잡고 한도를 빠르게 소모할 수 있어요. 지켜보면서 돌리세요.
- Claude 쪽 병렬 실행은 비용이 더 들어요. Anthropic은 agent teams가 단일 세션보다 토큰을 훨씬 많이 쓰고, 팀원이 늘수록 비용도 늘어난다고 밝혀요.
Claude Code와 Codex를 오케스트레이션하는 도구
하루에 에이전트를 여러 개 시작한다면, worktree를 만들고 터미널을 열고 diff를 보여 주는 도구가 전환 수고를 많이 덜어 줘요. 아래 도구는 모두 Claude Code와 Codex를 돌려요. 더 넓은 비교는 Vibe Kanban 대안을 보세요.
| 도구 | 하는 일 | 격리 방식 | 실행 환경 | 라이선스 / 상태 |
|---|---|---|---|---|
| Claude Squad | Claude Code, Codex, OpenCode, Amp 등 여러 에이전트를 관리하는 터미널 앱. Codex는 cs -p "codex"로 실행 | 에이전트마다 tmux 세션과 git worktree | 터미널(Homebrew로 설치) | 오픈 소스, AGPL-3.0 |
| Conductor | Claude Code, Codex, Cursor, OpenCode를 병렬로 실행. diff 리뷰, PR 열기, 머지 | 작업마다 워크스페이스와 브랜치 | Mac | 데스크톱 앱 |
| Orca | Claude Code와 Codex를 포함한 터미널 에이전트 무리를 내 구독으로 실행 | 에이전트마다 git worktree | macOS, Windows, Linux | 오픈 소스, MIT |
| Vibe Kanban | 이슈마다 Claude Code, Codex, Gemini CLI 등으로 워크스페이스를 시작하는 칸반 보드 | 워크스페이스마다 git worktree | npx vibe-kanban으로 브라우저 또는 데스크톱 앱 | 오픈 소스, Apache-2.0. bloop이 2026년 4월 서비스를 종료한 뒤 커뮤니티가 관리 |
| Crewmark | Claude Code와 Codex를 직무가 있는 장기 실행 AI 직원으로, 공유 이슈 보드에서 | 직원마다 내 컴퓨터의 독립된 세션 | 내 컴퓨터 | 아래 참고 |
Crewmark: Claude Code와 Codex를 한 보드의 팀으로
위의 도구들은 한 번에 작업 하나를 중심으로 만들어졌어요. 에이전트를 시작하고, diff를 리뷰하고, 머지하죠. Claude Code와 Codex가 며칠에 걸쳐 각자 직무를 맡아 계속 함께 일하게 하고 싶다면, Crewmark도 하나의 선택지예요.
Crewmark에서 에이전트는 AI 직원이에요. 직무를 가지고 내 컴퓨터에서 도는 장기 실행 세션이죠. Claude Code와 Codex 직원은 네이티브로 돌아가고, OpenCode, DeepSeek Harness, Gemini 같은 다른 에이전트는 ACP(acpx)로 연결해요. 작업은 공유 이슈 보드를 따라 움직여요. 사람과 직원이 이슈를 배정하고, 댓글을 달고, 서로 @멘션하고, 상태를 바꿔요. Claude Code 직원이 Codex 직원에게 리뷰를 넘기는 방식도 이슈에서 @멘션하는 거예요. 직원은 일정에 따라(하트비트) 그리고 멘션될 때마다 깨어나서, 사람이 전달하지 않아도 리뷰가 시작돼요.
위의 worktree나 리뷰 명령을 대체하지는 않아요. 직원들이 여전히 그걸 써요. 그 주변에 직무, 보드, 깨우기를 더해 줄 뿐이에요. 바탕이 되는 생각은 멀티 에이전트 harness를 보세요.
FAQ
Claude Code와 Codex를 함께 쓸 수 있나요?
네. 흔한 구성은 공용 AGENTS.md 하나, 에이전트마다 별도의 git worktree, 그리고 한쪽이 쓰면 다른 쪽이 리뷰를 돌리는 루프예요. OpenAI는 Claude Code가 Codex를 부를 수 있게 해 주는 공식 Claude Code 플러그인 codex-plugin-cc도 공개했어요.
Claude Code와 Codex를 함께 쓰는 가장 좋은 방법은 뭔가요?
한쪽이 쓰고 다른 쪽이 리뷰하게 하세요. Claude Code로 자기 worktree에서 만든 다음 codex review --base main(Claude Code 안에서는 /codex:review)을 돌리고 결과를 돌려보내세요. Codex가 쓸 때는 역할을 바꾸면 돼요.
Claude Code와 Codex가 서로 대화할 수 있나요?
간접적으로요. 각자 상대의 CLI(codex exec, codex review, claude -p)를 실행해 출력을 읽을 수 있고, Codex 플러그인이 Claude Code 안에서 작업과 결과를 전달하고, 공유 보드가 대화를 담을 수 있어요. Claude Code의 agent teams와 세션 간 메시지는 Claude Code 세션끼리만 이어져요.
Claude Code와 Codex를 동시에 돌려도 되나요?
네, 같은 컴퓨터와 같은 저장소에서요. 서로의 파일을 덮어쓰지 않도록 각자 worktree를 주세요. 각자 자기 요금제나 API 키를 쓰고, 플러그인으로 Codex에 보낸 작업은 Codex 한도에서 차감돼요.
Claude Code에서 Codex를 MCP 서버로 쓸 수 있나요?
이제는 안 돼요. codex mcp-server는 Codex rust-v0.154.0에서 없어졌고, OpenAI는 지금 MCP가 아닌 Codex app server를 안내해요. Claude Code에서 Codex를 쓰려면 OpenAI의 codex-plugin-cc를 설치하세요.
Claude Code와 Codex가 AGENTS.md를 공유하나요?
공유할 수 있어요. Codex는 기본으로 AGENTS.md를 읽어요. Claude Code는 저장소에 CLAUDE.md가 없을 때 읽어요(v2.1.277 이상). CLAUDE.md가 있다면 @AGENTS.md로 시작해서 두 에이전트가 같은 파일을 따르게 하세요.
Codex가 Claude Code agent teams의 팀원이 될 수 있나요?
안 돼요. Agent teams는 Claude Code 인스턴스로 이루어져 있어요. 작업 목록과 메일함을 공유하는 리드와 팀원이죠. Codex를 같은 작업에 넣으려면 Codex 플러그인, 리뷰 루프, 또는 둘을 함께 돌리는 보드를 쓰세요.
Claude Code와 Codex를 나란히 돌려 주는 도구는 뭔가요?
Claude Squad, Conductor, Orca, Vibe Kanban은 두 에이전트를 격리된 worktree나 워크스페이스에서 시작해요. Crewmark는 둘을 공유 이슈 보드의 장기 실행 AI 직원으로 돌려요.
2026년 11월 20일에 Claude Code 문서, Codex 문서와 CLI 레퍼런스, codex-plugin-cc README와 대조해 명령과 기능을 확인했습니다.