이 문서는 OpenAI의 codex-plugin-cc에 대한 README 파일로, Claude Code 환경 내에서 Codex를 활용할 수 있게 하는 플러그인에 대해 상세히 설명합니다. 이 플러그인은 Claude Code 사용자가 기존 워크플로우에서 벗어나지 않고도 Codex의 코드 리뷰 기능과 작업 위임 기능을 쉽게 사용할 수 있도록 돕는 것을 목표로 합니다.

핵심 기능 및 명령어:

• /codex:review: 현재 작업에 대한 일반적인 Codex 코드 리뷰를 수행합니다. 이 기능은 읽기 전용이며, --base <ref> 옵션을 통해 특정 브랜치(main 등)와의 비교 리뷰도 가능합니다. --background 옵션을 사용하여 백그라운드에서 실행할 수 있습니다.
• /codex:adversarial-review: 선택된 구현 및 디자인에 대해 의문을 제기하는 steerable한 리뷰를 실행합니다. 가정, 트레이드오프, 실패 모드, 대안적 접근 방식 등을 질문하여 압력 테스트를 수행하는 데 사용됩니다. 이 또한 읽기 전용이며, --base <ref>와 --background 옵션을 지원하고 추가적인 focus text를 받을 수 있습니다.
• /codex:rescue: codex:codex-rescue subagent를 통해 Codex에 작업을 위임합니다. 버그 조사, 수정 시도, 이전 Codex 작업 계속하기, 더 작은 모델로 빠른 패스 수행 등 다양한 작업을 맡길 수 있습니다. --background, --wait, --resume, --fresh 옵션을 지원하며, --model과 --effort를 지정하여 Codex의 동작을 제어할 수 있습니다 (예: gpt-5.4-mini, spark, medium 등).
• /codex:status: 현재 저장소에서 실행 중이거나 최근에 완료된 Codex 작업을 표시합니다.
• /codex:result: 완료된 작업의 최종 저장된 Codex 결과물을 보여줍니다. Codex session ID를 제공하여 $codex resume <session-id>$ 명령으로 Codex에서 직접 작업을 재개할 수 있습니다.
• /codex:cancel: 활성 백그라운드 Codex 작업을 취소합니다.
• /codex:setup: Codex 설치 및 인증 상태를 확인합니다. npm이 사용 가능한 경우 Codex 설치를 제안할 수 있습니다. 또한 선택적 review gate를 관리 (--enable-review-gate, --disable-review-gate)하는 데 사용됩니다.

코어 방법론 및 기술적 세부 사항:

이 플러그인은 Codex app server를 감싸는 래퍼로 작동하며, 사용자의 로컬 환경에 설치된 글로벌 codex 바이너리 및 Codex CLI를 통해 작업을 위임합니다. 이는 플러그인이 Codex의 기존 설치, 로컬 인증 상태, 저장소 체크아웃 및 머신 로컬 환경을 직접 활용한다는 것을 의미합니다.

• 인증 및 설정: 사용자의 ChatGPT 구독 또는 OpenAI API key를 요구하며, Codex 사용량 한도에 기여합니다. Codex의 config.toml 파일(사용자 레벨의 ~/.codex/config.toml 또는 프로젝트 레벨의 .codex/config.toml)에 정의된 설정을 따르며, 기본 추론 노력 (model_reasoning_effort)이나 기본 모델 (model)과 같은 Codex의 동작을 플러그인을 통해 변경할 수 있습니다.
• 작업 위임: /codex:rescue 명령을 통해 codex:codex-rescue subagent에게 특정 작업을 전달합니다. 이 subagent는 Codex의 지능을 활용하여 버그 수정이나 코드 조사와 같은 복잡한 작업을 수행합니다.
• Review Gate: review gate가 활성화되면, 플러그인은 Claude의 응답을 기반으로 Stop hook을 사용하여 목표화된 Codex 리뷰를 실행합니다. 만약 리뷰에서 문제가 발견되면 Claude가 먼저 문제를 해결할 수 있도록 stop이 차단됩니다. 이 기능은 Claude/Codex 루프를 장기화하고 사용량 제한을 빠르게 소모할 수 있으므로 주의가 필요합니다.
• 백그라운드 처리 및 연속성: 많은 명령어가 --background 옵션을 지원하여 장시간이 소요될 수 있는 작업을 백그라운드에서 실행할 수 있도록 합니다. 또한 Codex session ID를 통해 Claude Code에서 시작된 작업을 Codex CLI에서 codex resume 명령으로 직접 이어서 진행할 수 있습니다.

요구 사항 및 설치:

• 요구 사항: Node.js 18.18 이상, ChatGPT 구독 또는 OpenAI API key.
• 설치: Claude Code 내에서 /plugin marketplace add openai/codex-plugin-cc 명령을 사용하여 마켓플레이스를 추가하고, /plugin install codex@openai-codex로 플러그인을 설치합니다. 이후 /reload-plugins와 /codex:setup을 실행하고, 필요한 경우 !codex login을 통해 Codex에 로그인해야 합니다.

이 플러그인은 Claude Code 환경에서 Codex의 강력한 코드 분석 및 수정 기능을 통합하여 개발자의 생산성과 코드 품질 향상에 기여합니다.