여러분, Codex를 즐겁게 사용하고 계신가요? 😆

이번 주는 Luna가 80% 할인되기도 하고, Codex 리셋 축제로 분위기가 뜨겁네요.

Codex로 작업하다 보면 다른 관점에서 코드를 봐주었으면 하는 경우가 있습니다. 저는 코드 리뷰나 원인 조사를 Claude Code에 맡기고 싶은 상황이 많아, 이를 위한 MCP 플러그인을 v0.3.0 버전으로 일반 공개했습니다.

Codex에서 Claude Code를 호출하고 싶었다

Codex가 출시된 이후에는 Claude와 Codex를 각각 CLI로 실행하고, 한쪽의 답변을 터미널에서 복사하여 다른 쪽에 붙여넣곤 했습니다. 지금 생각해보면 상당히 수동적인 작업이었습니다.

그 과정을 계속하는 것이 번거로워져서, 2025년부터 스스로 대화를 연결하는 메커니즘을 사용하기 시작한 것이 이 플러그인의 시작입니다.

여러 CLI 에이전트를 연결하거나, 에이전트끼리 대화하게 하거나, 태스크를 워크플로우(Workflow)로 돌리는 연계 방법은 적어도 2025년부터 몇 가지 공개되어 있습니다.

다만, Codex 측에서 Claude Code를 서브 에이전트(Subagent)로 호출하여, 구독(Subscription) 상태 그대로 대화할 수 있는 형태는 언젠가 누군가 최적의 결과물을 만들어 공개할 것이라고 생각했습니다. 그런데 적어도 제가 찾아본 범위 내에서는 아직 발견되지 않았습니다.

최근 한 달 정도, Claude나 Fable을 기점으로 Codex를 조합하는 이야기가 X에서도 화제가 되었습니다. 제가 본 범위 내에서도 Claude / Fable에서 Codex CLI를 서브 에이전트로 사용하는 이야기가 나오고 있었습니다.

제가 필요했던 것은 그 반대였습니다. Codex를 평소의 창구로 삼아, Claude Code를 서브 에이전트로 호출하고 싶었습니다.

이 플러그인은 CLI로 사용하기 시작하여, 2025년 말부터는 Codex 데스크톱 앱(Desktop App)에서 일상적으로 사용하고 있습니다. 조사나 리뷰를 평소 사용하는 Codex 대화 안에서 진행할 수 있어 편리했습니다.

API가 아니라, 평소의 계약 그대로 사용하고 싶다

제가 원했던 것은 API를 별도로 계약하지 않고, Claude Code의 구독 상태 그대로 결과를 보면서 대화를 이어가는 것이었습니다. claude -p와 같은 단발성 실행으로는 추가 확인이나 재리뷰로 이어가기 어렵습니다.

공식 Claude Code MCP 서버도 시도해 보았지만, 도중에 멈추는 등 안정적이지 않아 선택지에서 제외했습니다. 설령 작동한다 하더라도, Claude Code의 툴(Tool)을 공개하는 메커니즘이라 이번에 원하는 대화형 세션(Session)과는 역할이 다릅니다.

무엇을 할 수 있는가

Codex–Claude Subagent는 Codex Desktop App 또는 Codex CLI로부터 로컬에 설치된 Claude Code의 대화 세션을 실행합니다.

Claude API나 claude -p를 사용하는 것이 아니라, 이미 로그인되어 있는 Claude Code를 이용하는 것이 특징입니다. 새로운 API 키나 별도의 접속 경로를 준비할 필요 없이, Claude Code의 구독을 그대로 사용할 수 있습니다.

실행된 세션은 Codex에서 관측할 수 있으며, 저장된 세션 ID를 지정하여 재개할 수 있습니다. 따라서 리뷰 결과를 확인한 후 추가로 확인하거나, 수정 방침을 바꾸어 다시 상담할 수 있습니다.

사용자는 특별한 조작을 의식할 필요가 없습니다. 평소의 Codex 대화와 마찬가지로 의뢰할 수 있으며, 리뷰뿐만 아니라 구현이나 검증까지 Claude Code에 맡길 수 있습니다. Codex의 루프(Loop) 안에서 조사, 판단, 구현, 검증을 필요한 횟수만큼 반복할 수 있습니다.

다운로드

배포물과 소스 코드는 GitHub 리포지토리(Repository)에 공개되어 있습니다. Desktop App용 ZIP 파일은 GitHub Release에서 다운로드할 수 있습니다.

사용법

전제 조건은 macOS, Codex Desktop App 또는 Codex CLI, 그리고 Claude Code입니다. Claude Code 측에서 로그인을 해둡니다.

Desktop App에서는 다운로드한 ZIP 파일을 압축 해제하고, 압축 해제된 폴더의 Install.command를 실행합니다.

Codex CLI에서는 다음 명령어로 설치할 수 있습니다.

codex plugin marketplace add zetsubo-dev/codex-claude-subagent
codex plugin add codex-claude-subagent@codex-claude-subagent

설치 후에는 새로운 Codex 대화를 시작하고, "Claude에게 이 변경 사항을 리뷰해줘"와 같이 자연어 (Natural Language)로 요청합니다.

Codex에서 Claude Code를 사용하고 싶은 분들은 꼭 한번 시도해 보세요. 마음에 드셨다면 GitHub에서 Star를 눌러주시면 큰 힘이 됩니다.

제 환경에서는 이 플러그인을 에이전트 (Agent)나 오케스트레이션 (Orchestration) 하네스 (Harness)에도 통합하여 사용하고 있습니다. 자세한 이야기는 다음에 따로 나누기로 하고, 관련 내용은 평소 X에서 트윗하고 있습니다. 팔로우해 주시면 기쁘겠습니다 😆

그럼, 즐거운 Codex 라이프 되시길!

Discussion