기준으로 공식 문서를 확인해 적었어요.
클로드 코드(Claude Code)와 코덱스(Codex)는 서로 독립된 도구라서 같은 프로젝트에서 둘 다 실행하면 바로 같이 쓸 수 있어요. 잘 쓰려면 세 가지만 챙기면 돼요. git 워크트리로 작업 폴더를 나눠 같은 파일을 동시에 고치지 않게 하고, AGENTS.md 하나로 두 도구의 지침을 맞추고, 사용량과 승인 요청과 완료 여부를 한 화면에서 볼 방법을 정하는 거예요. 클로드코드와 코덱스의 명령이 어떻게 대응되는지도 표로 정리했어요.
클로드 코드와 코덱스를 왜 같이 쓰나요?
많이 드는 이유는 세 가지예요.
- 한도가 따로예요. 클로드 코드는 클로드 플랜의 한도에서, 코덱스는 ChatGPT 플랜의 한도에서 나가요. 한쪽이 한도에 닿아도 다른 쪽으로 일을 이어 갈 수 있어요.
- 서로의 결과를 검토시킬 수 있어요. 한 에이전트가 만든 변경을 다른 에이전트에게 읽히고 문제를 찾게 하는 식이에요.
- 일을 나눠 동시에 돌릴 수 있어요. 한쪽이 기능을 만드는 동안 다른 쪽이 테스트나 문서를 맡아요.
어느 쪽이 더 낫다는 이야기는 이 글에서 하지 않아요. 둘을 나란히 쓸 때 걸리는 것들을 정리했어요.
같은 프로젝트에서 둘을 돌릴 때 무엇을 조심해야 하나요?
작업 폴더를 나누세요. 두 에이전트가 같은 폴더에서 같은 파일을 고치면 서로 덮어써요. git 워크트리로 폴더를 하나 더 만들고 한쪽씩 실행하면 돼요.
git worktree add ../project-feature-a -b feature-a
cd ../project-feature-a
codex
지침 파일을 하나로 맞추세요. 코덱스는 AGENTS.md를 읽어요. 클로드 코드는 CLAUDE.md를 읽고, 저장소에 CLAUDE.md 없이 AGENTS.md만 있으면 그것을 프로젝트 지침으로 읽어요(Claude Code 2.1.277 이상). 둘 다 두고 싶다면 CLAUDE.md에 아래 한 줄을 넣어 같은 파일을 함께 쓰게 해요(클로드 코드 문서, Codex 문서).
@AGENTS.md
승인 방식이 다르다는 점을 기억하세요. 클로드 코드는 권한 모드와 허용 규칙으로, 코덱스는 승인 정책과 샌드박스로 무엇을 물어볼지 정해요. 한쪽에서 풀어 둔 설정이 다른 쪽에 적용되지는 않아요.
두 도구의 명령은 어떻게 대응되나요?
2026년 11월 기준이에요. 왼쪽에 익숙하면 오른쪽에서 같은 일을 찾을 수 있어요.
| 하고 싶은 일 | 클로드 코드 | 코덱스 |
|---|---|---|
| 남은 사용량 보기 | /usage |
/status |
| 웹에서 사용량 보기 | claude.ai의 Settings > Usage | Codex 사용량 대시보드 |
| 지난 세션 이어 가기 | claude --continue, claude --resume |
codex resume |
| 프로젝트 지침 | CLAUDE.md (또는 AGENTS.md) |
AGENTS.md |
| 무엇을 물어볼지 정하기 | 권한 모드(Shift+Tab), /permissions의 허용 규칙 |
approval_policy(on-request, never)와 샌드박스, /permissions |
| 끝났을 때 알림 | Notification·Stop 훅 | tui.notifications, notify |
한 화면에서 둘 다 챙기려면 어떻게 하나요?
둘을 같이 쓰면 확인할 곳이 늘어나요. 사용량도 두 군데, 승인 요청도 두 터미널, 끝났는지도 두 군데서 봐야 해요. 방법은 세 가지예요.
- 터미널을 나눠 나란히 두기. 가장 단순해요. 창 둘이 늘 보이는 화면이라면 충분해요.
- 각 도구의 화면 쓰기. 클로드 코드의 에이전트 뷰(
claude agents)는 클로드 코드의 백그라운드 세션만 다뤄요. 코덱스는 자기 터미널이나 앱에서 봐요. - 에이전트를 가리지 않는 앱 쓰기. Devalley에서는 클로드 코드 세션과 코덱스 세션이 같은 마을의 주민으로 나와요.
Devalley에서 둘을 같이 쓰면 이렇게 보여요. 세션마다 주민 한 명이 일하는 중인지, 나를 기다리는지, 끝났는지 보여 줘요. 승인 요청은 주민이 「허락해 주세요」 말풍선으로 들고 오고, 클로드 코드든 코덱스든 그 자리에서 허용하거나 거부해요(클로드 코드는 「항상 허용」과 객관식 질문도 답해요). 사용량 카드에는 클로드 코드와 코덱스의 한도가 한 줄씩 나와요. Codex 데스크톱 앱의 세션도 주민으로 들어와서 일하는 중인지 끝났는지 보여 주고, 카드를 누르면 Codex 앱이 앞으로 와요. Windows와 macOS에서 무료예요.
Devalley가 하지 않는 것도 있어요. 한 에이전트의 일을 다른 에이전트에게 넘겨 주거나 둘의 대화를 이어 붙여 주지 않아요. 누구에게 무엇을 시킬지는 내가 정하고, Devalley는 그 세션들을 한 화면에서 보고 답하게 해 줘요.
자주 묻는 질문
클로드코드 코덱스 같이쓰는법, 한도는 합쳐지나요?
아니요. 클로드 코드는 클로드 플랜의 한도, 코덱스는 ChatGPT 플랜의 한도를 따로 써요. 그래서 한쪽이 한도에 닿으면 다른 쪽으로 이어 갈 수 있어요.
코덱스와 클로드 코드를 같은 저장소에서 동시 사용해도 되나요?
네. 다만 같은 폴더에서 같은 파일을 고치면 서로 덮어쓰니, git worktree add로 폴더를 하나 더 만들어 한쪽씩 실행하세요.
CLAUDE.md와 AGENTS.md를 둘 다 관리해야 하나요?
아니요. AGENTS.md 하나에 지침을 적고, CLAUDE.md에는 @AGENTS.md 한 줄만 두면 두 도구가 같은 지침을 읽어요.
클로드 코드와 코덱스의 사용량을 한 번에 볼 수 있나요?
네. macOS에서는 CodexBar 같은 메뉴 막대 앱이, Windows와 macOS에서는 Devalley 사용량 카드가 두 도구의 한도를 함께 보여 줘요.
코덱스의 승인 요청도 터미널로 가지 않고 답할 수 있나요?
Devalley에서는 코덱스의 승인 요청을 주민이 들고 오고, 그 자리에서 허용하거나 거부해요. 누르지 않은 것은 아무것도 허용되지 않아요.