블로그 · 코딩 에이전트

Claude Code와 Codex를 함께 쓰는 법

네, Claude Code와 Codex는 함께 쓰기 좋아요. 같은 저장소의 git worktree를 각각 하나씩 주고, 둘에게 같은 AGENTS.md를 읽히고, 한쪽이 코드를 쓰면 다른 쪽이 리뷰하게 하세요. 더 긴밀하게 연결하고 싶다면 OpenAI가 공식 플러그인을 내놨어요. Claude Code가 Codex를 불러 리뷰를 맡기거나 작업을 넘길 수 있어요. 이 글에서는 두 에이전트를 조합하는 다섯 가지 방법, 공식 문서의 명령으로 따라 하는 단계별 설정, 에이전트끼리 대화하는 방법, 둘을 동시에 돌릴 때 주의할 점, 둘을 오케스트레이션하는 도구를 정리해요. 2026년 11월 20일에 업데이트했어요.

Claude Code와 Codex를 함께 쓰는 다섯 가지 방법

대부분은 이 중 두세 가지를 함께 써요. 아직 어느 에이전트를 쓸지 고민 중이라면 Claude Code vs Codex부터 보세요.

방법동작 방식이럴 때 쓰세요
1. 공용 지침두 에이전트가 읽는 AGENTS.md 하나, CLAUDE.md가 이를 가져와요항상요. 가장 싸게 할 수 있고, 두 에이전트가 서로 다른 규칙을 따르는 일을 막아 줘요
2. worktree 분리에이전트마다 같은 저장소의 자기만의 git worktree와 브랜치에서 작업해요두 에이전트가 동시에 코드를 고칠 때
3. 한쪽은 쓰고, 다른 쪽은 리뷰Claude Code가 쓰고 codex review가 브랜치를 점검해요. 반대도 가능해요첫 번째 모델이 놓친 걸 두 번째 모델이 잡아 주길 원할 때
4. Claude Code 안의 CodexOpenAI의 codex-plugin-cc가 Claude Code에 /codex:review, /codex:rescue 등을 추가해요Claude Code에서 작업하면서 Codex를 명령 하나로 부르고 싶을 때
5. 오케스트레이터보드나 앱(Claude Squad, Conductor, Orca, Vibe Kanban, Crewmark)이 둘을 시작하고 추적해요매일 여러 에이전트를 돌려서 터미널을 놓치기 일쑤일 때

1. 두 에이전트에게 같은 지침 주기

Codex는 AGENTS.md를 읽어요. ~/.codex의 전역 파일 하나를 읽고, 프로젝트 루트부터 지금 있는 폴더까지 내려오며 만나는 모든 AGENTS.md를 읽어요. 같은 디렉터리에 AGENTS.override.md가 있으면 그쪽이 우선해요. 기본값으로는 32 KiB(project_doc_max_bytes)에서 파일 추가를 멈춰요. 자세한 내용은 Codex AGENTS.md 가이드에 있어요.

Claude Code도 v2.1.277부터 AGENTS.md를 읽을 수 있지만, 기본값으로는 그 폴더나 상위 폴더에 CLAUDE.md, .claude/CLAUDE.md, CLAUDE.local.md가 없을 때만 읽어요. 저장소에 CLAUDE.md가 있다면 맨 위에 @AGENTS.md를 넣어 Claude가 공용 파일을 먼저 읽게 하고, Claude 전용 규칙은 그 아래에 추가하세요. 심볼릭 링크(ln -s AGENTS.md CLAUDE.md)도 되지만, 팀에 Windows를 쓰는 사람이 있다면 문서는 import를 권해요. 나머지는 CLAUDE.md를 참고하세요.

  • 빌드, 테스트, 린트 명령과 코드 스타일, "건드리지 말 것" 규칙은 AGENTS.md에 넣어서 두 에이전트가 같은 검사를 돌리게 하세요.
  • 에이전트 전용 메모는 빼 두세요. Claude 전용 규칙은 CLAUDE.md의 import 아래에, Codex 전용 설정은 ~/.codex/config.toml에 두면 돼요.
  • Claude Code는 AGENTS.override.md와 AGENTS.local.md를 무시하니, 공용 규칙을 거기 넣지 마세요.

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에 있는 것이고, 리뷰 프롬프트는 예시예요.

  1. 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/.
  2. 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/" >> .gitignore
  3. Codex를 두 번째 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"
  4. 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 main
  5. Claude 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."
  6. 머지한 뒤 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 SquadClaude Code, Codex, OpenCode, Amp 등 여러 에이전트를 관리하는 터미널 앱. Codex는 cs -p "codex"로 실행에이전트마다 tmux 세션과 git worktree터미널(Homebrew로 설치)오픈 소스, AGPL-3.0
ConductorClaude Code, Codex, Cursor, OpenCode를 병렬로 실행. diff 리뷰, PR 열기, 머지작업마다 워크스페이스와 브랜치Mac데스크톱 앱
OrcaClaude Code와 Codex를 포함한 터미널 에이전트 무리를 내 구독으로 실행에이전트마다 git worktreemacOS, Windows, Linux오픈 소스, MIT
Vibe Kanban이슈마다 Claude Code, Codex, Gemini CLI 등으로 워크스페이스를 시작하는 칸반 보드워크스페이스마다 git worktreenpx vibe-kanban으로 브라우저 또는 데스크톱 앱오픈 소스, Apache-2.0. bloop이 2026년 4월 서비스를 종료한 뒤 커뮤니티가 관리
CrewmarkClaude 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와 대조해 명령과 기능을 확인했습니다.

Claude Code와 Codex를 한 팀에 두세요.

Crewmark는 에이전트마다 직무, 공유 이슈 보드, 예약된 깨우기를 줘서, 터미널 사이로 일을 옮겨 줄 필요 없이 서로에게 일을 넘기게 해요.

Crewmark는 오픈 소스입니다: GitHub에서 Star를 눌러 주세요