claudekit / tools / codex-plugin-cc
[ Plugin · Development ]

Codex Plugin for Claude Code

Claude Code 안에서 OpenAI Codex로 코드 리뷰를 받거나 작업을 위임하는 OpenAI 공식 플러그인. 표준 리뷰·적대적 리뷰·작업 위임을 슬래시 명령으로 호출하고, 백그라운드 잡과 Codex 서브에이전트를 함께 제공.

openai/codex-plugin-cc ·updated
$ /plugin install codex@openai-codex copy

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일 출시 후 거의 매일 갱신되고 있어 명령 셋·플래그가 더 늘어날 수 있습니다.
§ 5

See also

same category · curated
[01]
[Plugin] Andrej Karpathy Skills · Karpathy의 LLM 코딩 관찰에서 끌어낸 네 가지 원칙을 `CLAUDE.md` 한 장에 담은 플러그인 — 과잉설계, 주변부 리팩터링, 조용한 추측을 억제.
tool · claudekit.io / tools / andrej-karpathy-skills
[02]
[MCP] Chrome DevTools MCP · AI 에이전트가 Chrome 브라우저를 실시간으로 제어하고 검사할 수 있게 해주는 MCP 서버. 성능 분석, 디버깅, 브라우저 자동화 지원.
tool · claudekit.io / tools / chrome-devtools
[03]
[Plugin] Code Review · 코드 변경 사항을 시니어 개발자 수준으로 리뷰하는 플러그인.
tool · claudekit.io / tools / code-review
§ 6

자주 묻는 질문

자주 묻는 질문
§ 6.1
Codex Plugin for Claude Code는 무엇인가요?
OpenAI가 직접 운영하는 GitHub org에서 배포한 Claude Code 플러그인으로, Claude Code 안에서 OpenAI Codex에 코드 리뷰를 요청하거나 작업을 위임할 수 있게 합니다. 발표는 2026년 3월 30일.
§ 6.2
어떤 환경에서 동작하나요?
Claude Code에서 동작합니다. 내부적으로 로컬 Codex CLI와 Codex 앱 서버를 호출하므로 Codex CLI가 같은 머신에 설치되어 있어야 합니다(Node.js 18.18 이상).
§ 6.3
어떻게 설치하나요?
마켓플레이스를 추가한 뒤 설치합니다 — `/plugin marketplace add openai/codex-plugin-cc` 후 `/plugin install codex@openai-codex`, 이어서 `/reload-plugins` → `/codex:setup`으로 설정을 마무리합니다.
§ 6.4
어떤 슬래시 명령이 추가되나요?
`/codex:review`(표준 리뷰), `/codex:adversarial-review`(적대적 리뷰), `/codex:rescue`(작업 위임), `/codex:status`·`/codex:result`·`/codex:cancel`(백그라운드 잡 관리), `/codex:setup`(설치 점검) 7종이 추가됩니다.
§ 6.5
사용하려면 OpenAI 계정이 필요한가요?
예. ChatGPT 구독(Free 플랜 포함) 또는 OpenAI API 키 중 하나가 필요합니다. 인증·설정은 로컬 Codex CLI의 것을 그대로 재사용합니다.
§ 6.6
라이선스는 어떻게 되나요?
Apache-2.0 라이선스로 공개되어 있습니다.