Codex Plugin for Claude Code

OpenAI 공식 (github.com/openai)

왜 필요한가?

코드를 한 모델 위에서 작성하다 보면 그 모델 특유의 사각지대가 생기기 쉽습니다. 다른 벤더의 모델로 같은 코드를 다시 한번 검토받거나 어려운 작업을 잠깐 위임할 수 있다면, 컨텍스트 전환 비용 없이 결과 품질을 끌어올릴 수 있습니다.

이 플러그인은 그 흐름을 Claude Code 안으로 끌어들입니다 — Claude Code 세션을 떠나지 않고 슬래시 명령 한 줄로 OpenAI Codex에 코드 리뷰·적대적 리뷰·작업 위임을 보낼 수 있습니다.

주요 기능

• 슬래시 명령 7종

  표준 리뷰(/codex:review)와 설계 결정을 도전적으로 검증하는 적대적 리뷰(/codex:adversarial-review)가 분리되어 있습니다. 작업 위임은 /codex:rescue로 호출하고, 백그라운드로 돌아가는 잡은 /codex:status(진행 상황) → /codex:result(완료 결과) → /codex:cancel(중단)으로 관리합니다. 설치 직후 /codex:setup으로 인증·설정을 점검합니다.

• codex:codex-rescue 서브에이전트

  단발성 명령 호출이 아니라 서브에이전트 형태로도 위임할 수 있어, 메인 세션과 분리된 모델·노력 수준으로 작업을 진행시키고 결과만 회수하는 구성이 가능합니다.

• 백그라운드 잡 + 진행 추적

  /codex:rescue로 던진 작업은 백그라운드에서 실행되며 메인 세션은 막히지 않습니다. 잡 상태와 출력은 슬래시 명령 셋(status/result/cancel)으로 추적·회수합니다.

• Stop hook 기반 review gate (옵션)

  Claude Code의 Stop hook을 활용해 작업 종료 직전 자동 리뷰를 끼우는 흐름을 옵션으로 제공합니다. PR 직전 자동 검증 단계를 만들고 싶을 때 활용할 수 있습니다.

• 브랜치 비교 — --base 플래그

  현재 변경 분만 리뷰받을 수 있도록 베이스 브랜치를 지정하는 --base 플래그를 지원합니다. PR 단위 리뷰에 적합한 옵션.

• 로컬 Codex CLI 위임 방식

  플러그인은 별도 런타임을 띄우지 않고 로컬 Codex CLI와 Codex 앱 서버에 위임합니다. 인증·설정·환경·MCP 셋업이 모두 기존 로컬 Codex 설정에서 그대로 재사용됩니다.

설치 방법

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

/codex:setup은 Codex CLI 인증 상태와 설정을 점검합니다. 설치 후 한 번 실행해 정상 연결을 확인한 뒤 사용을 시작합니다.

사전 요구

• Node.js 18.18 이상
• 로컬에 설치된 Codex CLI
• ChatGPT 구독(Free 플랜 포함) 또는 OpenAI API 키 — 인증·설정은 Codex CLI의 것을 그대로 재사용

알아두면 좋은 점

• OpenAI 공식 — Anthropic 공식 아님 — 발표 주체는 OpenAI(github.com/openai). claude.com/plugins 마켓플레이스에는 미등록이며, 자체 마켓플레이스(openai/codex-plugin-cc)로 배포됩니다.
• Apache-2.0 라이선스 — 영리 사용 포함 자유롭게 활용 가능.
• 이중 벤더 컨텍스트 — Claude Code(Anthropic)와 Codex(OpenAI)를 동시에 운영하므로 토큰·요금이 양쪽으로 분산됩니다. 비용 추적이 중요한 환경이라면 두 플랫폼의 사용량을 별도로 모니터링해야 합니다.
• Codex CLI 인증 그대로 재사용 — 별도 API 키 입력 절차 없이 로컬 Codex CLI에 이미 들어 있는 인증·설정·MCP 서버 구성이 그대로 활용됩니다.
• 활발한 갱신 — 2026년 3월 30일 출시 후 거의 매일 갱신되고 있어 명령 셋·플래그가 더 늘어날 수 있습니다.