TL;DR

이 저장소는 Claude Code 워크플로에서 로컬 Codex CLI와 Codex app server를 연동해 Claude Code 내부에서 바로 코드 리뷰·대항 리뷰·작업 위임·세션 전송을 수행하도록 하는 플러그인이다. 플러그인은 사용자의 기존 `codex` 바이너리와 인증·설정을 재사용하여 별도 계정 이전 없이 동일한 리포지토 컨텍스트에서 작업을 위임하고 백그라운드 작업을 관리한다. 설치는 Claude Code 마켓플레이스에 플러그인을 추가하고 `/codex:setup`으로 상태를 확인하며 Node.js 18.18 이상과 ChatGPT 구독 또는 OpenAI API 키가 필요하다. 리뷰 게이트는 Stop 훅으로 자동 검증을 수행해 문제가 있으면 응답을 차단할 수 있으나 README는 이 기능이 루프와 사용량 위험을 초래할 수 있음을 경고했다.

핵심 포인트

• 로컬 Codex 환경을 그대로 재사용한다. 플러그인은 사용자의 existing `codex` 바이너리와 설정 파일을 호출하므로 별도 원격 인증이나 추가 계정 연동이 필요하지 않다. 이로 인해 Claude Code 내에서 Codex를 직접 호출하는 것과 동일한 인증·설정 일관성이 확보된다.
• 세션 전송과 서브에이전트를 통해 작업 연속성을 유지한다. `/codex:transfer`와 외부-agent 세션 임포터를 통해 Claude Code 대화를 Codex 세션으로 변환해 이어서 작업할 수 있으며 `/codex:rescue`는 전용 서브에이전트를 생성해 장기 작업을 처리한다. 이 흐름은 대화형 세션을 끊지 않고 전문 도구로 이관하는 실무적 이점을 제공한다.
• 리뷰 게이트와 Stop 훅으로 자동 검증 경로를 통합할 수 있다. `/codex:setup --enable-review-gate`로 설정하면 Claude의 응답 흐름에 목표지향 Codex 리뷰를 삽입해 문제가 감지되면 멈춤을 적용한다. 다만 README는 이 기능이 사용량과 루프 위험을 동반한다고 명시해 관리 필요성을 드러냈다.
• 코드 리뷰를 실행한다. `/codex:review` 명령으로 현재 변경사항이나 브랜치를 읽기 전용으로 검토하고 결과를 `/codex:result`로 확인할 수 있다. 백그라운드 실행과 `/codex:status`, `/codex:cancel`로 장시간 작업의 진행과 취소를 관리할 수 있다.