서론 (Introduction)

"코드를 리뷰하거나 작업을 위임하기 위해 Claude Code에서 Codex를 사용하세요."

이 글은 "하루에 하나의 오픈 소스 프로젝트 (One Open Source Project a Day)" 시리즈의 115번째 기사입니다. 오늘의 프로젝트는 codex-plugin-cc입니다. 이는 OpenAI에서 제공하는 공식 플러그인으로, Claude Code 워크플로우 내에서 OpenAI의 Codex 코딩 에이전트(coding agent)를 직접 호출할 수 있게 해줍니다.

이 플러그인의 존재 자체만으로도 주목할 가치가 있습니다. OpenAI가 Anthropic의 Claude Code를 위한 플러그인을 공식적으로 구축하고 유지 관리하고 있습니다. 모델 계층에서 직접적인 경쟁 관계에 있는 두 회사가 벤더 간 에이전트 협업(cross-vendor agent collaboration)이 구축할 가치가 있는 실제 유스케이스(use case)라고 결정한 것입니다. 이는 AI 코딩 생태계가 어디로 향하고 있는지를 보여주는 신호입니다.

24,582 Stars. 2026년 3월에 생성됨. 생성된 지 4개월 미만.

학습 내용 (What You'll Learn)

• 7가지 핵심 명령어와 각 명령어의 사용 시점
• 왜 /codex:adversarial-review가 가장 독특한 명령어인지
• 리뷰 게이트 (Review Gate, Stop Hook)의 작동 방식 — 그리고 왜 위험한지
• 백그라운드 작업 실행 및 비동기(async) 결과 검색 방법
• 세션 전송 (Session transfer): Claude Code의 컨텍스트(context)를 Codex로 가져오는 방법

사전 요구 사항 (Prerequisites)

• Claude Code 명령어 및 플러그인에 대한 기본적인 경험
• AI 코딩 에이전트(AI coding agents) 개념에 대한 익숙함
• OpenAI Codex CLI에 대한 기본적인 이해

프로젝트 배경 (Project Background)

개요 (Overview)

codex-plugin-cc는 Claude Code와 로컬에 설치된 Codex CLI (@openai/codex)를 연결하는 공식 OpenAI 플러그인입니다. 설치 후에는 활성화된 Claude Code 세션 내에서 /codex:review, /codex:rescue 및 이와 유사한 명령어를 입력할 수 있습니다. 이를 통해 터미널을 벗어나거나, 도구를 전환하거나, 컨텍스트를 복사할 필요 없이 코드 리뷰나 작업 실행을 Codex에 위임할 수 있습니다.

이 플러그인은 Codex 자체와 동일한 로컬 인증(무료 티어를 포함한 ChatGPT 구독 또는 OpenAI API 키)을 사용합니다. 설정은 TOML 파일을 통해 관리됩니다: 사용자 수준 설정은 ~/.codex/config.toml, 프로젝트 수준의 오버라이드(overrides)는 .codex/config.toml을 사용합니다.

저자 / 팀 (Author / Team)

• 저자/조직 (Author/Org): OpenAI
• 언어 (Language): JavaScript
• 라이선스 (License): Apache 2.0
• 버전 (Version): 1.0.5

프로젝트 통계 (Project Stats)

• ⭐ GitHub Stars: 24,582+
• 🍴 Forks: 1,487+
• 📄 라이선스 (License): Apache 2.0
• 📅 생성일 (Created): 2026년 3월 30일

기능 (Features)

설치 (Installation)

# 1단계: 마켓플레이스에서 추가
/plugin marketplace add openai/codex-plugin-cc

...

7가지 핵심 명령어 (7 Core Commands)

/codex:review — 표준 코드 리뷰 (Standard Code Review)

읽기 전용 (Read-only). Codex가 커밋되지 않은 변경 사항 또는 지정된 베이스 브랜치(base branch)와의 차이점(diff)을 리뷰합니다.

/codex:review
/codex:review --base main
/codex:review --background    # 백그라운드에서 실행; Claude를 차단하지 않음

조종 불가능 (Not steerable) — 한 번 트리거되면, Codex는 표준 리뷰 흐름을 실행하고 결과(findings)를 출력합니다.

/codex:adversarial-review — 적대적 리뷰 (Adversarial Review)

이 플러그인에서 가장 독특한 명령어입니다. 버그를 체크하는 것이 아니라, _결정 그 자체_에 의문을 제기합니다:

• 설계 선택(design choices)에 이의 제기
• 트레이드오프(tradeoffs)에 의문 제기
• 기저에 깔린 가정(underlying assumptions)을 조사
• 실패 모드(failure modes) 식별

또한 이는 조종 가능 (steerable) 합니다 — 초점을 직접 지정할 수 있습니다:

/codex:adversarial-review focus on our error handling assumptions
/codex:adversarial-review question whether this abstraction is premature
/codex:adversarial-review --background

일반 리뷰와의 차이점: /codex:review가 "여기에 버그가 있는가?"에 답한다면, /codex:adversarial-review는 "이것이 올바른 방향인가, 그리고 이 설계가 3개월 뒤에 기술 부채 (technical debt)가 되지는 않을 것인가?"에 답합니다.

/codex:rescue — Codex에 작업 위임 (Delegate a Task to Codex)

가장 비중이 큰 명령어입니다. 전체 작업을 Codex에 넘기면, Codex가 독립적으로 조사하고, 코드를 작성하며, 로컬 저장소(local repository)에서 수정을 시도합니다.

/codex:rescue investigate this bug and try a fix
/codex:rescue continue what you were doing last time
/codex:rescue --model spark          # gpt-5.3-codex-spark (빠름) 사용
...

--background는 핵심 플래그입니다: Codex가 백그라운드(background)에서 실행되므로 Claude Code가 차단되지 않으며, 계속해서 작업을 진행할 수 있습니다. 나중에 /codex:result를 통해 결과를 가져올 수 있습니다.

모델 단축어 (Model shortcuts): spark는 gpt-5.3-codex-spark (빠른 모드)로 매핑됩니다. 전체 모델 이름도 사용 가능합니다: gpt-5.4-mini, gpt-5.4.

/codex:transfer — 세션 전송 (Session Transfer)

현재 Claude Code 세션을 지속 가능한 Codex 스레드(thread)로 내보냅니다:

/codex:transfer

출력:

codex resume <session-id>

해당 명령어를 터미널에 입력하면 Codex가 전체 세션 기록을 가지고 작업을 이어갑니다. 다음과 같은 상황에서 유용합니다: Claude Code가 문제를 철저히 조사했고, 다음 단계가 시간이 오래 걸리는 실행 작업이라서 Claude Code의 컨텍스트 윈도우(context window)를 계속 점유하지 않고 독립적인 Codex 작업으로 실행하고 싶을 때.

상태 관리 (Status Management)

/codex:status    # 현재 저장소(repo)에 대해 실행 중이거나 최근에 수행된 Codex 작업 표시
/codex:result    # 완료된 작업의 최종 출력 표시 (재개를 위한 Codex 세션 ID 포함)
/codex:cancel    # 현재 활성화된 백그라운드 작업 취소

심층 분석 (Deep Dive)

리뷰 게이트 (Review Gate): 스톱 훅 (The Stop Hook)

Review Gate는 이 플러그인에서 가장 공격적인 기능이자, 가장 위험성이 높은 기능입니다.

작동 방식:

Claude가 분석을 완료하고 응답을 준비함
    ↓
스톱 훅 (Stop Hook) 실행
...

본질적으로 Review Gate는 Codex를 Claude가 각 응답을 완료하기 전에 반드시 통과해야 하는 필수적인 품질 게이트(quality gate)로 만듭니다. Claude는

1. 무한 루프 (Infinite loops): Codex가 문제를 지적함 → Claude가 코드를 수정함 → Codex가 새 코드를 검토함 → 또 다른 문제를 지적함 → 반복.
2. 사용량 소모 (Usage burn): Claude의 모든 응답이 추가적인 Codex 실행을 유발합니다. 비용이 배로 증가합니다.

Review Gate는 높은 위험도가 따르는 변경 사항(핵심 로직, 보안 민감 코드)의 경우 의미가 있습니다. 일상적인 개발을 위해 이를 계속 켜두는 것은 비용이 많이 듭니다. 활성화하기 전에 자신이 무엇을 수용하게 되는지 파악하십시오.

아키텍처 (Architecture)

사용자 입력: /codex:rescue
    │
    ▼
...

codex:codex-rescue는 /agents 아래의 이름이 지정된 서브 에이전트 (subagent)로 등록됩니다. 세션 임포트 (Session import)는 Codex의 외부 에이전트 세션 임포터를 사용하며, 이는 /codex:transfer가 현재 세션 기록으로부터 지속적인 스레드 (persistent thread)를 생성하는 방식과 동일합니다.

두 에이전트, 두 역할

이 플러그인을 사용하는 가장 일관된 멘탈 모델 (mental model)은 역할 분리입니다:

역할	에이전트	강점
컨텍스트 관리자 (Context manager), 전략가	Claude Code	조사, 계획, 질문, 종합
실행자 (Executor), 독립적 검증자	Codex	백그라운드에서 작업 실행, 현재 컨텍스트에 편향되지 않은 검토

일반적인 워크플로우 (Common workflow):
Claude Code가 버그를 조사하고 근본 원인을 식별함
    ↓
...

에이전트들은 병렬로 작동합니다. 어느 한쪽이 다른 쪽을 기다릴 필요가 없습니다.

명령어 참조 (Command Reference)

명령어	사용 시점
/codex:review	커밋되지 않은 변경 사항에 대한 빠른 무결성 검사 (sanity check)
...

벤더 간의 신호 (The Cross-Vendor Signal)

여기에서의 기술적 구현은 복잡하지 않습니다. 이 플러그인은 Codex CLI 호출을 Claude Code 플러그인으로 래핑 (wrap)한 것입니다. 엔지니어링 공수는 크지 않습니다.

주목할 점은 이것을 구축하고 유지 관리하기로 한 결정 그 자체입니다. OpenAI는 경쟁사의 개발 도구를 위한 공식 플러그인을 출시했고, 유지 관리(활발한 업데이트가 포함된 v1.0.5)에 투자했으며, 세션 전송 (session transfer)이 양방향으로 작동하도록 설계했습니다. 이는 일회성 통합이 아닙니다.

시사점: 도구 계층 (tooling layer)에서 AI 코딩 생태계는 모델 계층 (model layer)보다 더 빠르게 벤더 중립적 (vendor-agnostic)으로 변모하고 있습니다. 사용자들은 각자의 강점에 따라 선택된 여러 에이전트 (agents)를 병렬로 실행하는 경우가 점점 늘어나고 있습니다. 벤더 간 협업은 예외적인 현상이 아니라 하나의 기능 (feature)입니다.

Claude Code의 플러그인 시스템은 경쟁사를 포함한 모든 제3자가 구축할 수 있는 개방형 인터페이스를 제공합니다. 이 플러그인은 caveman (#150)과 같은 커뮤니티 도구와 함께, 에이전트의 경계가 브랜드가 아닌 기능에 따라 나뉘는 멀티 에이전트 (multi-agent) 생태계를 향하고 있습니다.

리소스 (Resources)

공식 링크 (Official Links)

• 🌟 GitHub: openai/codex-plugin-cc
• 📦 Codex CLI: @openai/codex (플러그인 뒤에서 작동하는 로컬 에이전트)

요약 (Summary)

codex-plugin-cc의 핵심 가치는 멀티 에이전트 워크플로 (multi-agent workflows)의 전환 비용을 줄이는 데 있습니다. Claude Code에서 작업하던 중 두 번째 에이전트의 관점이나 실행 능력이 필요할 때, 도구를 전환한다는 것은 컨텍스트 (context)를 재설정하고, 새 창을 열고, 정보를 수동으로 전달해야 함을 의미합니다. 이 플러그인은 그러한 마찰을 제거합니다.

7개의 명령어는 세 가지 뚜렷한 사용 사례를 다룹니다:

• 검토 (Review) (/codex:review, /codex:adversarial-review): 현재 워크플로를 방해하지 않고 두 번째 관점을 도입합니다.
• 위임 (Delegate) (/codex:rescue): 백그라운드 실행과 함께 작업을 완전히 넘깁니다.
• 전송 (Transfer) (/codex:transfer): 전체 컨텍스트를 Codex로 가져가 작업을 이어갑니다.

/codex:adversarial-review는 가장 강력한 차별화된 가치를 지닙니다. 아키텍처 결정에 대해 확신이 서지 않고, 단순히 버그를 찾는 것을 넘어 그 방향이 맞는지 의문을 제기하며 적극적으로 도전할 대상이 필요할 때, 이 명령어는 그 역할을 직접 수행합니다. 이는 검토 워크플로에 내장된 "상대방의 논리를 가장 강력하게 구축하는 (steelman the opposition)" 도구입니다.

Review Gate는 중대한 코드 변경 사항에 대해 강력한 힘을 발휘하지만, README의 경고는 진지하게 받아들여야 합니다. 기본값으로 설정하기보다는 명확한 의도를 가지고 활성화하십시오.

이미 워크플로(workflow)에서 Claude Code와 Codex를 모두 사용하고 있다면, 이 플러그인을 며칠 동안 설치하여 사용해 볼 가치가 있습니다. 진정한 배움은 여러분의 구체적인 업무에 있어 두 에이전트(agent)의 경계가 어디에 위치해야 하는지를 발견하는 데 있습니다.

_ PrimeSkills를 탐색해 보세요 — 실제 기업 워크플로(workflow)를 기준으로 검증된 AI 에이전트(agent) 및 기술(skills) 큐레이션 마켓플레이스입니다. 과장 없이, 실제로 작동하는 것들만 제공합니다. _

_ 더 많은 통찰과 흥미로운 제품을 보려면 저의 개인 사이트를 방문해 주세요. _