Skip to content

codex-plugin-cc: Claude Code 안에서 OpenAI Codex로 코드 리뷰하기 (2026)

OpenAI가 경쟁사인 Anthropic의 개발 도구 Claude Code 안에서 직접 동작하는 공식 플러그인을 출시했습니다. codex-plugin-cc는 Claude Code 세션을 떠나지 않고도 OpenAI Codex를 호출해 코드 리뷰, 적대적 리뷰, 백그라운드 작업 위임까지 처리할 수 있게 해줍니다. 2026-03-30 v1.0.0 릴리스 이후 GitHub 스타 20,748개를 기록하며 개발자 커뮤니티의 빠른 관심을 받았습니다.

목차

  • codex-plugin-cc가 정확히 뭔가요?
  • 설치 방법 (4단계)
  • 왜 "크로스 모델" 리뷰여야 할까요?
  • 쓰기 전에 알아둘 주의점
  • 자주 묻는 질문

codex-plugin-cc가 정확히 뭔가요?

openai/codex-plugin-cc는 OpenAI가 공식 제공하는 Claude Code 플러그인입니다. /codex: 네임스페이스 아래 7개의 슬래시 커맨드를 추가하고, 별도의 codex:codex-rescue 서브에이전트도 함께 등록합니다.

커맨드역할
/codex:review일반 read-only 코드 리뷰. --base <ref>로 브랜치 비교 가능
/codex:adversarial-review적대적 리뷰 (steerable). 구현 가정·설계 트레이드오프·실패 모드를 집중 검증
/codex:rescueCodex 서브에이전트로 작업 위임. 버그 조사·수정·이전 작업 이어가기 지원
/codex:status현재 repo의 실행 중·최근 Codex 작업 조회
/codex:result완료된 작업의 최종 출력 표시
/codex:cancel활성 백그라운드 Codex 작업 취소
/codex:setupCodex 설치·인증 확인 및 review gate 관리

Apache 2.0 라이선스이고 주 언어는 JavaScript, 런타임은 Node.js 18.18 이상이 필요합니다.

설치 방법 (4단계)

Claude Code가 열린 상태에서 순서대로 실행하면 됩니다.

1단계 — 마켓플레이스에 저장소 추가:

/plugin marketplace add openai/codex-plugin-cc

2단계 — 플러그인 설치:

/plugin install codex@openai-codex

3단계 — 플러그인 리로드:

/reload-plugins

4단계 — Codex 준비 상태 점검:

/codex:setup

/codex:setup이 로컬 머신에서 Codex를 찾지 못하면 npm install -g @openai/codex로 설치를 제안합니다. Codex에 로그인하지 않은 상태라면 !codex login으로 ChatGPT 계정(Free 포함) 또는 OpenAI API 키로 인증할 수 있습니다. 별도 Codex 전용 계정은 필요하지 않으며, 이미 로컬에 Codex CLI가 설치·로그인되어 있다면 설정이 즉시 완료됩니다.

모델은 ~/.codex/config.toml의 설정을 그대로 따르고, 커맨드 실행 시 --model·--effort 플래그로 개별 오버라이드할 수 있습니다.

왜 "크로스 모델" 리뷰여야 할까요?

자가 리뷰의 사각지대(self-review blind spot): Claude가 생성한 코드를 Claude가 다시 리뷰하면 두 단계가 동일한 학습 데이터·아키텍처·실패 패턴을 공유합니다. 같은 모델이 범한 실수를 같은 모델이 발견하지 못하는 구조적 한계입니다. 다른 학습 계보를 가진 Codex로 리뷰를 라우팅하면 이 사이클을 끊을 수 있습니다.

/codex:adversarial-review는 단순한 코드 스타일 검사가 아닙니다. 구현 가정이 맞는지, 설계 트레이드오프가 적절한지, 어떤 조건에서 실패하는지를 압박해서 검증합니다. 포커스 텍스트를 커맨드 뒤에 추가해 "보안 측면만 집중적으로" 같은 방향 지시도 가능합니다.

OpenAI가 경쟁사 도구에 직접 플러그인을 올린 이유도 여기에 있습니다. 개발자가 Claude Code에서 Codex로 갈아타길 기다리는 대신, 이미 쓰는 워크플로우 안으로 Codex를 가져오는 전략입니다.

쓰기 전에 알아둘 주의점

review gate 기능(/codex:setup --enable-review-gate)을 켜면 Claude의 모든 응답에 대해 Stop hook이 Codex 리뷰를 자동으로 실행합니다. 이슈가 발견되면 Claude가 먼저 수정하도록 응답을 차단합니다. 강력한 기능이지만 README는 이렇게 경고합니다.

"Claude와 Codex 사이에 장기 루프가 형성되어 usage limit를 빠르게 소진할 수 있습니다. 세션을 능동적으로 모니터링할 때만 review gate를 활성화하세요."

사용량은 별도 과금 체계 없이 기존 Codex usage limit에 합산됩니다. 장시간 자리를 비우는 야간 작업 등에는 --disable-review-gate로 꺼두는 편이 안전합니다.

자주 묻는 질문

Q: codex-plugin-cc는 무료로 사용할 수 있나요?

플러그인 자체는 Apache 2.0 오픈소스로 무료입니다. 다만 내부에서 Codex API를 호출하므로 사용량은 Codex usage limit에 합산됩니다. ChatGPT Free 플랜도 인증 수단으로 사용할 수 있지만, Codex 호출 횟수 한도는 플랜마다 다를 수 있습니다.

Q: 별도 Codex 계정이 필요한가요?

필요하지 않습니다. 플러그인은 로컬에 설치된 Codex CLI의 인증 상태를 그대로 재사용합니다. ChatGPT 계정(Free 포함)이나 OpenAI API 키로 codex login만 완료되어 있으면 즉시 동작합니다.

Q: 어떤 Codex 모델을 사용하나요?

플러그인은 특정 모델을 강제하지 않습니다. ~/.codex/config.toml에 설정된 모델을 기본으로 따르며, 커맨드 실행 시 --model gpt-5.4-mini처럼 개별 지정도 가능합니다. README에 예시로 등장하는 모델은 gpt-5.4-minigpt-5.3-codex-spark(별칭 spark)입니다.

마무리

codex-plugin-cc는 AI 개발 도구 생태계가 경쟁에서 상호 운용으로 진화하고 있다는 신호입니다. Claude Code를 메인 환경으로 쓰면서도 리뷰 단계에서 다른 모델의 시각을 빌리는 크로스 모델 워크플로우가 점점 현실적인 선택지가 되고 있습니다. 프로젝트에 적용해보고 어떻게 느껴지는지 댓글로 알려주세요.

관련 글: AI 자동화와 Claude Code 활용법은 QJC 블로그에서 더 확인할 수 있습니다.


참고 자료