Claude Code에서 Codex 플러그인으로 코드 리뷰 맡기기: codex-plugin-cc 완벽 가이드

코드 리뷰, 좋아하는 개발자는 별로 없다. 리뷰를 받는 쪽도, 하는 쪽도 은근히 스트레스를 받는 작업이다. 그런데 요즘은 AI에게 이 작업을 맡길 수 있는 방법이 점점 늘어나고 있다. 특히 Claude Code 사용자라면 OpenAI가 공식으로 만들어서 공개한 codex-plugin-cc를 통해, Claude Code 안에서 바로 OpenAI Codex에게 코드 리뷰를 위임할 수 있다. 경쟁사 도구끼리 협업이라니, 시대가 참 많이 변했다.

이 글에서는 codex-plugin-cc의 설치부터 실전 사용법, 주요 명령어, 그리고 Claude Code나 Codex 자체 리뷰 기능과의 차이점까지 하나하나 짚어본다.

codex-plugin-cc란 무엇인가

codex-plugin-cc는 OpenAI가 GitHub에 공개한 오픈소스 플러그인으로, Claude Code 내부에서 슬래시 명령어를 통해 OpenAI Codex의 코드 리뷰와 작업 위임 기능을 사용할 수 있게 해준다. 쉽게 말해, Claude Code라는 작업 환경을 떠나지 않고도 Codex의 리뷰 능력을 빌려 쓸 수 있는 다리 역할을 하는 도구다.

라이선스는 Apache-2.0이며, 내부적으로는 로컬에 설치된 Codex CLI와 Codex App Server를 통해 동작한다. 별도의 런타임을 띄우는 것이 아니라, 이미 설치된 Codex 환경을 그대로 활용하는 구조다.

설치 전 준비 사항

본격적인 설치에 앞서 다음 세 가지를 확인해야 한다.

 

첫째, ChatGPT 구독 또는 OpenAI API 키가 필요하다. 무료 플랜 포함이므로 ChatGPT 계정이 있다면 된다. 다만 Codex 사용량은 해당 계정의 사용 한도에 반영된다.

 

둘째, Node.js 18.18 이상이 설치되어 있어야 한다. 플러그인 자체가 Node.js 기반으로 동작하기 때문이다.

 

셋째, 당연하지만 Claude Code가 설치되어 있어야 한다. Claude Code의 플러그인 마켓플레이스 기능을 통해 설치하는 구조이므로, Claude Code 환경이 먼저 갖춰져 있어야 한다.

Step-by-Step 설치 방법

Step 1: 마켓플레이스 추가

Claude Code 터미널에서 다음 명령어로 마켓플레이스를 등록한다.

/plugin marketplace add openai/codex-plugin-cc

Step 2: 플러그인 설치

마켓플레이스가 등록되면 실제 플러그인을 설치한다.

/plugin install codex@openai-codex

Step 3: 플러그인 리로드

설치 후 플러그인이 인식되도록 리로드한다.

/reload-plugins

Step 4: 셋업 확인

다음 명령어로 Codex가 정상적으로 인식되는지 확인한다.

/codex:setup

이 명령어는 Codex CLI가 설치되어 있는지, 인증이 완료되었는지를 자동으로 점검해준다. 만약 Codex CLI가 아직 설치되지 않았다면, npm이 있는 환경에서 자동 설치를 제안해주기도 한다.

Step 5: Codex CLI가 없는 경우

Codex CLI를 직접 설치하려면 다음과 같이 글로벌 패키지로 설치할 수 있다.

npm install -g @openai/codex

Step 6: Codex 로그인

Codex에 아직 로그인하지 않았다면 Claude Code 안에서 셸 명령어로 로그인한다.

!codex login

ChatGPT 계정 또는 API 키로 인증할 수 있다. 로그인 상태는 로컬 머신에 저장되므로 한 번만 하면 된다.

설치가 정상적으로 완료되면 /agents 목록에 codex:codex-rescue 서브에이전트가 나타나고, 아래에서 설명할 슬래시 명령어들을 사용할 수 있게 된다.

주요 명령어 완전 정리

/codex:review -- 기본 코드 리뷰

가장 핵심적인 명령어다. 현재 작업 중인 변경 사항에 대해 Codex가 읽기 전용으로 코드 리뷰를 수행한다. Codex 내부에서 /review를 직접 실행한 것과 동일한 수준의 리뷰를 받을 수 있다.

# 현재 uncommitted 변경 사항 리뷰
/codex:review

# 특정 브랜치와 비교 리뷰
/codex:review --base main

# 백그라운드에서 실행
/codex:review --background

멀티 파일 변경의 경우 시간이 꽤 걸릴 수 있으므로 --background 옵션을 권장한다. 이 명령어는 코드를 수정하지 않는 읽기 전용 명령어다.

 

언제 쓰면 좋은가: PR을 올리기 직전, 혹은 커밋 전에 한 번 전체적으로 점검받고 싶을 때. 팀 리뷰어에게 넘기기 전 사전 검수 용도로 활용하기 좋다.

 

/codex:adversarial-review -- 도전적 리뷰

일반 리뷰와 다르게, 구현 자체의 방향성과 설계 결정을 의문시하는 공격적인 리뷰를 수행한다. 단순히 코드 품질만 보는 것이 아니라 설계 트레이드오프, 숨겨진 가정, 실패 모드 등을 집중적으로 파고든다.

# 기본 adversarial 리뷰
/codex:adversarial-review

# 특정 관점으로 리뷰 포커싱
/codex:adversarial-review --base main challenge whether this was the right caching and retry design

# 백그라운드에서 경합 조건 분석
/codex:adversarial-review --background look for race conditions and question the chosen approach

일반 /codex:review와 달리, 플래그 뒤에 자유 텍스트를 붙여서 리뷰 방향을 지정할 수 있다는 것이 핵심적인 차이점이다.

언제 쓰면 좋은가: 인증(auth) 로직, 데이터 유실 가능성, 롤백 전략, 동시성 처리 등 고위험 영역의 코드를 배포하기 전에 적합하다. 설계 리뷰를 별도로 받기 어려운 소규모 팀에서 특히 유용하다.

/codex:rescue -- 작업 위임

코드 리뷰가 아니라, 실제 작업을 Codex에 맡기는 명령어다. 버그 조사, 수정 시도, 이전 작업 이어서 하기 등에 사용한다.

# 버그 조사 위임
/codex:rescue investigate why the tests started failing

# 최소한의 패치로 수정 요청
/codex:rescue fix the failing test with the smallest safe patch

# 이전 작업 이어서
/codex:rescue --resume apply the top fix from the last run

# 모델과 effort 지정
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky integration test

# 경량 모델로 빠르게
/codex:rescue --model spark fix the issue quickly

spark을 지정하면 내부적으로 gpt-5.3-codex-spark으로 매핑되어 빠르고 가벼운 처리가 가능하다. --resume 옵션으로 이전 rescue 세션을 이어갈 수 있고, --fresh로 새 세션을 강제할 수도 있다.

자연어로 요청하는 것도 가능하다. Claude Code 대화 중에 다음과 같이 입력하면 Codex 서브에이전트가 작업을 받아 처리한다.

Ask Codex to redesign the database connection to be more resilient.

/codex:status -- 작업 상태 확인

백그라운드에서 돌리고 있는 Codex 작업의 진행 상태를 확인한다.

/codex:status
/codex:status task-abc123

/codex:result -- 결과 확인

완료된 작업의 최종 결과를 조회한다. Codex 세션 ID도 함께 보여주므로, 해당 세션을 Codex에서 직접 codex resume <session-id>로 이어서 작업할 수 있다.

/codex:result
/codex:result task-abc123

/codex:cancel -- 작업 취소

실행 중인 백그라운드 작업을 취소한다.

/codex:cancel
/codex:cancel task-abc123

/codex:setup -- 환경 점검 및 설정

Codex 설치 상태와 인증 상태를 확인한다. 리뷰 게이트 기능도 이 명령어로 관리한다.

# 리뷰 게이트 활성화
/codex:setup --enable-review-gate

# 리뷰 게이트 비활성화
/codex:setup --disable-review-gate

리뷰 게이트란, Claude Code가 응답을 생성할 때마다 자동으로 Codex 리뷰를 돌려서 문제가 발견되면 Claude가 먼저 수정하도록 만드는 기능이다. 다만 이 기능은 Claude와 Codex가 반복적으로 호출되는 루프를 만들 수 있어 사용량이 빠르게 소모될 수 있으니, 세션을 직접 모니터링할 수 있는 상황에서만 켜는 것이 좋다.

실전 워크플로우 예시

예시 1: PR 전 사전 리뷰

feature 브랜치에서 작업을 마치고 PR을 올리기 전에 전체 변경분에 대한 리뷰를 받는 시나리오다.

# 1. main 브랜치 대비 변경 사항을 백그라운드로 리뷰
/codex:review --base main --background

# 2. 리뷰 진행 상태 확인
/codex:status

# 3. 리뷰 결과 확인
/codex:result

예시 2: 위험 영역에 대한 깊은 리뷰

인증 로직이나 결제 관련 코드를 수정했을 때, 보안 관점에서 한번 더 검증받는 시나리오다.

/codex:adversarial-review --base main look for auth bypass, token leakage, and session fixation risks

예시 3: CI 실패 원인을 Codex에 넘기기

CI가 깨졌는데 원인을 찾기 귀찮을 때, Codex에게 조사를 위임하고 나는 다른 일을 한다.

# 1. 조사 위임
/codex:rescue --background investigate why the build is failing in CI

# 2. 잠시 후 상태 확인
/codex:status

# 3. 결과 확인 후, 필요하면 Codex에서 이어서 작업
/codex:result

결과에 포함된 세션 ID로 Codex CLI에서 직접 codex resume <session-id>를 실행하면 해당 작업을 이어갈 수 있다.

Codex 설정 커스터마이징

플러그인은 로컬 Codex CLI 설정을 그대로 사용하므로, Codex의 기본 모델이나 reasoning effort를 변경하고 싶다면 config.toml 파일을 수정하면 된다.

프로젝트 루트에 .codex/config.toml 파일을 만들어 다음과 같이 설정할 수 있다.

model = "gpt-5.4-mini"
model_reasoning_effort = "high"

설정 우선순위는 다음과 같다.

우선순위	설정 위치	설명
1	.codex/config.toml (프로젝트)	해당 프로젝트에만 적용되는 설정. 프로젝트가 trust 상태여야 로드됨
2	~/.codex/config.toml (사용자)	사용자 전역 기본 설정

codex-plugin-cc vs 자체 리뷰 기능 비교

Claude Code와 Codex는 각각 자체적으로 코드 리뷰 기능을 제공한다. 그렇다면 이 플러그인을 쓰는 이유는 무엇이고, 각 방식은 어떤 차이가 있을까.

Claude Code 자체 리뷰

Claude Code에서 직접 리뷰를 요청하는 방식이다. 예를 들어 Claude Code에서 현재 diff를 보여주고 리뷰를 해달라고 자연어로 요청하면 된다.

 

장점으로는, 별도 설치가 필요 없고 Claude의 컨텍스트 안에서 바로 대화형으로 후속 질문이 가능하다. 프로젝트의 CLAUDE.md나 대화 이력 등 이미 쌓인 맥락을 활용할 수 있다는 것도 큰 이점이다.

 

단점으로는, Claude의 컨텍스트 윈도우 제약을 받으므로 변경 파일이 많으면 전체를 한 번에 보기 어렵다. 또한 코드 리뷰에 특화된 구조화된 출력 형식이 별도로 있는 것은 아니다.

Codex 자체 리뷰 (/review)

Codex CLI에서 직접 /review를 실행하는 방식이다.

장점은, 코드 리뷰에 최적화된 전용 기능이라는 점이다. 멀티 파일 변경을 체계적으로 분석하고 구조화된 결과를 돌려준다.

단점은, Codex CLI 환경으로 전환해야 한다는 점이다. Claude Code에서 작업하다가 터미널을 바꿔야 하므로 워크플로우가 끊긴다.

codex-plugin-cc를 통한 리뷰

이 플러그인의 가치는 바로 위 두 가지의 장점을 결합한다는 점에 있다.

 

첫째, Claude Code라는 하나의 환경에서 벗어나지 않으면서 Codex의 전문적인 코드 리뷰 기능을 사용할 수 있다. 워크플로우의 단절이 없다.

 

둘째, adversarial-review라는 독자적인 기능으로 설계 수준의 도전적 리뷰를 받을 수 있다. 이건 Claude Code나 Codex 자체 리뷰에서 기본으로 제공하지 않는 방식이다.

 

셋째, 백그라운드 실행과 상태 관리 명령어가 체계적으로 갖춰져 있어, 리뷰를 돌려놓고 다른 작업을 하다가 결과를 확인하는 비동기 워크플로우가 자연스럽다.

 

넷째, rescue 명령어를 통해 리뷰를 넘어 실제 작업 위임까지 가능하다. 디버깅이나 수정 작업을 Codex에 맡기고 그 결과를 Claude Code에서 받아볼 수 있다.

 

다만 고려할 점도 있다. ChatGPT 구독 또는 OpenAI API 키가 별도로 필요하며, Codex 사용량 한도가 적용된다. 또한 두 AI 서비스를 동시에 사용하게 되므로, 사용량 관리에 주의가 필요하다. 리뷰 게이트를 켜면 Claude-Codex 간 반복 루프가 발생할 수 있어 비용이 빠르게 증가할 수 있다.

이런 팀에게 추천한다

소규모 팀에서 전담 리뷰어를 두기 어려울 때, 코드 리뷰의 1차 필터로 활용하면 좋다. 리뷰 요청을 보내기 전에 기본적인 품질 문제를 미리 잡아낼 수 있다.

 

Claude Code를 주 개발 환경으로 쓰면서 Codex의 리뷰 능력도 함께 쓰고 싶은 경우에 특히 적합하다. 도구를 왔다갔다 하지 않아도 되니 생산성 면에서 확실히 이점이 있다.

 

고위험 코드 변경(보안, 결제, 데이터 마이그레이션 등) 전에 adversarial-review로 한 번 더 검증받는 습관을 들이면, 운영 사고를 사전에 막는 데 도움이 된다.

마무리

codex-plugin-cc는 서로 다른 AI 코딩 도구 간의 경계를 허무는 흥미로운 시도다. Claude Code 사용자 입장에서는 환경을 바꾸지 않고도 Codex의 리뷰 전문성을 빌려 쓸 수 있고, OpenAI 입장에서는 Codex의 사용 범위를 넓히는 전략적 선택이기도 하다.

설치도 어렵지 않고, 슬래시 명령어 몇 개만 기억하면 바로 실전에 투입할 수 있다. 이미 Claude Code로 작업하고 있다면 한 번 시도해볼 만한 가치가 충분하다.

---

출처

• https://github.com/openai/codex-plugin-cc
• https://developers.openai.com/codex/pricing
• https://developers.openai.com/codex/cli
• https://developers.openai.com/codex/app-server
• https://developers.openai.com/codex/config-reference
• https://discuss.pytorch.kr/t/codex-plugin-for-claude-code-claude-code-openai-codex/9569/1