OpenAI의 Claude Code용 Codex 플러그인

2 days ago 2

이제 클로드 코드안에서 OpenAI Codex를 직접 호출해 코드 리뷰 및 작업 위임 가능
/codex:review, /codex:adversarial-review 등 슬래시 커맨드 기반으로 호출
백그라운드 작업 관리 기능(/codex:rescue, /codex:status, /codex:result, /codex:cancel)으로 장시간 실행 태스크를 비동기 처리 가능
별도 런타임 없이 로컬 Codex CLI 및 앱 서버를 그대로 활용해 동일한 인증·설정·레포지터리 환경 유지
ChatGPT 구독(무료 포함) 또는 OpenAI API 키만 있으면 사용 가능(사용량은 Codex 사용 한도에 합산)
Apache-2.0 라이선스로 공개된 공개 오픈소스 플러그인

제공 기능 상세 (슬래시 커맨드)

/codex:review: 현재 작업에 대한 일반 읽기 전용 Codex 리뷰 실행
- 미커밋 변경사항 리뷰 또는 --base <ref>로 브랜치 비교 리뷰 가능
- --background, --wait 옵션 지원, 멀티파일 변경 시 백그라운드 실행 권장
- 커스텀 포커스 텍스트 입력 불가, 코드 수정 미수행
/codex:adversarial-review: 구현·설계 결정을 의문 제기하는 조종 가능한(steerable) 리뷰 실행
- 가정, 트레이드오프, 장애 모드, 대안 접근 방식을 압박 테스트
- 인증, 데이터 손실, 롤백, 레이스 컨디션, 안정성 등 특정 위험 영역에 포커스 가능
- 커맨드 뒤에 추가 포커스 텍스트 입력 지원, 코드 수정 미수행
/codex:rescue: codex:codex-rescue 서브에이전트를 통해 Codex에 태스크 위임
- 버그 조사, 수정 시도, 이전 Codex 태스크 이어받기, 소형 모델로 빠른 패스 실행 가능
- --background, --wait, --resume, --fresh 옵션 지원
- --model, --effort 미지정 시 Codex가 자체 기본값 선택
- spark 입력 시 gpt-5.3-codex-spark로 자동 매핑
- 자연어로 위임 요청도 가능 (예: "Ask Codex to redesign...")
/codex:status: 현재 레포지터리의 실행 중·최근 Codex 작업 현황 조회
/codex:result: 완료된 작업의 최종 출력 조회, Codex 세션 ID 포함 시 codex resume <session-id>로 직접 재개 가능
/codex:cancel: 활성 백그라운드 Codex 작업 취소
/codex:setup: Codex 설치 및 인증 상태 확인, 미설치 시 npm으로 설치 제안

리뷰 게이트(Review Gate) 기능

/codex:setup --enable-review-gate로 활성화
활성화 시 Claude 응답 기반으로 타겟 Codex 리뷰를 자동 실행하는 Stop 훅 사용
리뷰에서 문제 발견 시 Claude가 먼저 해결하도록 stop을 차단
주의: 장시간 Claude/Codex 루프가 생성되어 사용 한도를 빠르게 소진할 수 있으므로, 세션을 적극 모니터링할 때만 활성화 권장

일반 사용 흐름

출시 전 리뷰: /codex:review 단독 실행
문제를 Codex에 위임: /codex:rescue investigate why the build is failing in CI
장시간 작업 시작 후 확인: --background로 실행 → /codex:status → /codex:result

Codex 통합 구조

플러그인은 Codex 앱 서버를 래핑하며, 환경에 설치된 전역 codex 바이너리를 활용
별도 런타임 없이 동일한 Codex 설치·인증·레포지터리·로컬 환경 공유
기본 모델 및 추론 노력(reasoning effort)은 ~/.codex/config.toml(사용자 레벨) 또는 .codex/config.toml(프로젝트 레벨)로 설정 가능
- 예시: model = "gpt-5.4-mini", model_reasoning_effort = "xhigh"
- 프로젝트 레벨 설정은 해당 프로젝트가 신뢰됨(trusted) 상태일 때만 적용
완료된 위임 작업은 codex resume <session-id>로 Codex에서 직접 이어받기 가능