OpenAI의 Claude Code용 Codex 플러그인
(github.com/openai)- 이제 클로드 코드안에서 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에서 직접 이어받기 가능
인증 및 계정
- 이미 해당 머신에서 Codex에 로그인된 경우 별도 설정 없이 즉시 사용 가능
- Codex 미사용자는 ChatGPT 계정 또는 API 키로
!codex login실행 필요 - 기존 API 키·base URL 설정은 그대로 유지되며, 다른 엔드포인트 사용 시
openai_base_url을 Codex 설정에 지정 가능
OpenAI 직원이 직접 만들어서 공개했어요. "We love an open ecosystem!"
https://x.com/dkundel/status/2038670330257109461
진짜 웃긴건, 클로드 코드한테 이 플러그인 리뷰해 달라고 했더니 "really well-engineered plugin"이라고 칭찬해줬다고..