Codex Plugin for Claude Code – Claude Code 안에서 Codex에 리뷰와 작업을 위임하는 플러그인

제공 기능
설치
실전 흐름
배포 전 리뷰
작업 위임
세션 이전
주의할 점
누구에게 적합한가
관련 문서
참고 자료

Codex Plugin for Claude Code는 Claude Code 사용자가 현재 워크플로를 떠나지 않고 OpenAI Codex를 코드 리뷰어 또는 보조 작업자로 호출하게 해주는 플러그인이다. OpenAI가 공개한 openai/codex-plugin-cc 저장소로 설치하며, Claude Code slash command와 subagent를 통해 Codex를 실행한다.

제공 기능

명령	역할
`/codex:review`	현재 변경사항 또는 기준 브랜치 대비 일반 코드 리뷰
`/codex:adversarial-review`	특정 설계·위험 가정을 공격적으로 검토하는 리뷰
`/codex:rescue`	디버깅·수정·장기 작업을 Codex subagent에 위임
`/codex:transfer`	Claude Code 대화 컨텍스트를 Codex 세션으로 이전
`/codex:status`	백그라운드 Codex 작업 상태 확인
`/codex:result`	완료된 Codex 작업 결과 조회
`/codex:cancel`	실행 중인 작업 취소
`/codex:setup`	Codex 설치와 인증 상태 점검

이 플러그인은 Claude Code를 Codex로 대체하기보다, 두 도구의 관점을 섞는 용도에 가깝다. Claude Code가 주 작업 환경이면 Codex를 리뷰어, 반대 검토자, 별도 조사자, 장기 작업자 역할로 붙일 수 있다.

설치

필요 조건은 ChatGPT 구독 또는 OpenAI API 키, Node.js 18.18 이상이다. Claude Code에서 marketplace를 추가한 뒤 플러그인을 설치한다.

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

Codex CLI가 없으면 /codex:setup이 설치를 안내한다. 직접 설치하려면 다음 명령을 쓴다.

npm install -g @openai/codex
codex login

실전 흐름

배포 전 리뷰

/codex:review --background
/codex:status
/codex:result

일반 리뷰는 구현 버그와 회귀 위험을 찾는 데 쓴다. 설계 선택 자체를 압박하고 싶다면 adversarial review가 더 맞다.

/codex:adversarial-review --base main challenge whether this caching design handles rollback

작업 위임

/codex:rescue investigate why the integration test is flaky
/codex:rescue --model gpt-5.4-mini --effort medium fix the issue

rescue는 Claude Code 안에서 Codex subagent를 띄워 별도 작업을 맡기는 흐름이다. 긴 작업은 백그라운드 실행을 권장한다.

세션 이전

/codex:transfer는 Claude Code에서 시작한 디버깅·구현 대화를 Codex 앱이나 TUI에서 이어갈 수 있는 세션으로 변환한다. 기존 Claude transcript가 ~/.claude/projects 아래 있어야 하고, Codex 쪽 session import 기능이 필요하다.

주의할 점

Codex 사용량은 별도 한도나 API 과금에 반영된다.
review gate를 켜면 Claude와 Codex가 긴 루프로 이어질 수 있으므로 사람이 모니터링할 때만 쓰는 편이 안전하다.
플러그인은 로컬 Codex CLI와 같은 설정을 사용하므로, config.toml의 모델·추론 설정이 결과에 영향을 준다.

누구에게 적합한가

Claude Code 주 사용자: 다른 모델 관점의 리뷰를 같은 세션에서 받고 싶을 때
코드 리뷰 문화가 약한 개인·소규모 팀: 배포 전 자동 second opinion을 붙이고 싶을 때
장기 디버깅 사용자: 한 에이전트가 막힌 문제를 Codex에 넘겨 병렬로 조사할 때
도구 비교 사용자: Claude Code와 Codex의 작업 성향을 같은 저장소에서 비교하고 싶을 때

참고 자료

openai/codex-plugin-cc — GitHub 공식 저장소

Like?

AI Sparkup