Codex Plugin for Claude Code
Claude Code 안에서 OpenAI Codex로 교차 리뷰·작업 위임하는 공식 플러그인
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codexOpenAI가 직접 낸 Claude Code 플러그인입니다. Claude Code 세션 안에서 슬래시 명령으로 Codex를 불러 코드 리뷰를 받거나 작업을 통째로 위임합니다. 경쟁 모델인 GPT 계열로 같은 diff를 한 번 더 검수받는 교차 공급자 검토를 한 흐름에서 처리합니다.
판단
이럴 때 씁니다
- Claude Code를 주력으로 쓰면서 GPT 계열로 같은 코드를 한 번 더 검수받고 싶을 때.
- 설계 결정 자체에 반론을 듣고 싶을 때. /codex:adversarial-review가 결정을 흔들어 봅니다.
- 버그 조사나 수정을 다른 모델에 통째로 맡기고 싶을 때(/codex:rescue).
- 중요한 변경은 Codex 검토를 통과해야만 마무리되게 강제하고 싶을 때(리뷰 게이트).
이럴 땐 쓰지 마세요
- 모델을 GPT 계열로 갈아타는 게 목적이라면 이 플러그인이 아니라 Codex CLI 자체가 맞습니다. 이건 어디까지나 보조 검수 역할입니다.
- 리뷰 게이트를 켠 채 방치하면 두 모델이 맞물려 돌며 사용량을 빠르게 태웁니다. 공식 문서도 이를 직접 경고합니다.
- ChatGPT 구독이나 OpenAI 키가 없으면 쓸 수 없습니다. Anthropic 계정만으로는 동작하지 않습니다.
차별점
- OpenAI 공식 플러그인입니다. 경쟁사 Anthropic의 Claude Code 안에서 OpenAI Codex를 바로 부르는, 보기 드문 교차 공급자 통합입니다.
- 같은 diff를 GPT 계열로 한 번 더 검수받습니다. /codex:review로 표준 리뷰를, /codex:adversarial-review로 설계 결정에 반론을 거는 리뷰를 받습니다.
- /codex:rescue로 버그 조사나 수정 작업을 Codex에 통째로 위임합니다. 나머지 명령은 전부 읽기 전용이라 코드를 건드리지 않습니다.
- 리뷰 게이트를 켜면 Codex 검토를 통과하기 전까지 변경을 마무리하지 못하게 막습니다.
워크플로
- 01/plugin marketplace add openai/codex-plugin-cc로 마켓플레이스를 등록합니다.
- 02/plugin install codex@openai-codex로 설치하고 /reload-plugins로 반영합니다.
- 03/codex:setup으로 Codex 설치를 확인하고 필요하면 리뷰 게이트를 설정합니다.
- 04작업 후 /codex:review나 /codex:adversarial-review로 검수를 받습니다. 오래 걸리면 백그라운드로 돌립니다.
- 05작업 위임이 필요하면 /codex:rescue로 맡기고 /codex:status·/codex:result로 추적합니다.
주요 명령
| 명령 | 설명 |
|---|---|
/plugin install codex@openai-codex | 마켓플레이스 등록 후 플러그인을 설치합니다 |
/codex:review | 현재 작업을 Codex로 표준 코드 리뷰합니다(읽기 전용) |
/codex:rescue | 버그 조사·수정 작업을 Codex에 위임합니다 |
/codex:setup | Codex 설치를 확인하고 리뷰 게이트를 관리합니다 |
함정
설치 전에 확인하세요
- 리뷰 게이트는 Claude와 Codex가 서로 오래 주고받는 루프를 만들어 사용량 한도를 빠르게 소진할 수 있습니다. 직접 지켜보는 동안에만 켜는 게 안전합니다.
- 리뷰와 /codex:rescue는 시간이 걸릴 수 있어 백그라운드 실행이 권장됩니다.
- ChatGPT 구독(무료 포함) 또는 OpenAI API 키, 그리고 Node.js 18.18 이상이 필요합니다.
직접 써본 메모
가치는 '한 모델을 다른 모델로 검수한다'는 한 가지에 모입니다. Claude Code로 짠 코드를 같은 Claude로 리뷰하면 사각이 겹치기 쉬운데, GPT 계열 Codex가 같은 diff를 보면 서로 다른 약점을 짚습니다. 경쟁사인 OpenAI가 Anthropic 도구 안에 직접 들어왔다는 조합 자체도 드뭅니다.
다만 주력을 바꾸는 도구가 아니라는 점은 분명히 해야 합니다. 모델을 GPT로 옮겨 작업하고 싶다면 Codex CLI를 직접 쓰는 게 맞고, 이 플러그인은 어디까지나 Claude Code 곁에서 두 번째 의견을 더하는 역할입니다.
리뷰 게이트는 양날입니다. 검토를 통과해야 변경이 마무리되니 품질 안전망이 되지만, 켜 둔 채 방치하면 Claude와 Codex가 서로 주고받으며 도는 루프가 생겨 사용량 한도를 빠르게 태운다고 공식 문서가 직접 경고합니다.
비교
같은 Codex라도 터미널 단독 도구인 Codex CLI는 그 자체가 작업 주체입니다. 이 플러그인은 Claude Code를 주력으로 쓰면서 Codex를 '두 번째 의견'으로만 끌어오는 쪽이라, 모델을 갈아타지 않고 한 모델의 결과를 다른 모델로 검수하는 구성을 만듭니다. gstack의 /codex 명령이 같은 교차 리뷰를 자체 워크플로에 넣는다면, 이쪽은 OpenAI 공식이 직접 관리하는 단일 플러그인입니다.
최근 변경
v1.0.6에서 Git 명령의 셸 확장을 제거해 명령 실행 경계를 강화했다.