왜 이 셋업이 필요한가

Anthropic이 하네스 설계 문서에서 못박은 원칙이 있습니다.

"AI한테 자기 작업을 평가시키면 결과물이 별로여도 자신있게 잘 만들었다고 한다." "만든 AI와 확인하는 AI를 분리하는 게 가장 강력한 레버다."

즉, Claude Code 혼자 만들고 검수하면 안 됩니다. 만드는 AI(Claude Code)와 평가하는 AI(Codex)를 물리적으로 분리해야 빈틈이 잡힙니다.

이 가이드는 그 셋업을 Claude Code에 프롬프트만 붙여넣으면 끝나도록 정리했습니다. 명령어 직접 칠 필요 없습니다.

💡 Codex 사용량은 ChatGPT 구독 한도에 같이 잡힙니다.

이 문서는 두 파트로 나뉩니다.

• Part 1. 기본: 설치 + 딱 두 가지 사용법(review, rescue). 처음 시작하면 여기까지만 따라하세요.
• Part 2. 더 쓰고 싶을 때: 옵션, 백그라운드, 강도 높은 리뷰, 자동 검증, 트러블슈팅.

Part 1. 기본: 이것만 하면 됩니다

Step 1. codex-plugin-cc 설치

📦 Reference: github.com/openai/codex-plugin-cc

Claude Code 세션을 열고 아래 프롬프트를 그대로 붙여넣으세요.

openai/codex-plugin-cc 플러그인을 설치해줘.

순서:
1. /plugin marketplace add openai/codex-plugin-cc 실행
2. /plugin install codex@openai-codex 실행
3. /reload-plugins 실행
4. /codex:setup 실행

설치 끝나면 Codex 본체도 같이 확인하고,
빠진 게 있으면 마저 설치해줘.
로그인까지 필요하면 어떻게 하면 되는지 알려줘.

Claude Code가 알아서 플러그인 설치, Codex CLI 점검, 누락 시 추가 설치까지 진행합니다. 로그인 단계에서 멈추면 안내가 뜨니 그대로 따라가면 됩니다.

Step 2. claude-dashboard 설치 (사용량 가시화)

📦 Reference: github.com/uppinote20/claude-dashboard

Codex 사용량을 Claude Code 하단 상태창에서 실시간으로 보려면 claude-dashboard도 같이 설치합니다.

uppinote20/claude-dashboard 플러그인을 설치하고 셋업해줘.

순서:
1. /plugin marketplace add uppinote20/claude-dashboard 실행
2. /plugin install claude-dashboard 실행
3. /claude-dashboard:setup 실행

설치 후 하단 상태창에 Codex 사용량이 보이게 해줘.
안 보이면 detailed 모드로 바꿔서 켜줘.

Step 3. 코드 리뷰받기 (/codex:review)

기능을 다 만들었으면, 합치기 전에 Codex한테 한 번 봐달라고 합니다.

지금까지 작업한 변경사항을 Codex한테 리뷰받고 싶어.
/codex:review 실행해줘.

Codex가 변경된 부분을 훑고 문제를 지적해줍니다. Claude Code 혼자 만들고 끝낸 코드와 비교했을 때 잡히는 빈틈이 확연히 다릅니다.

Step 4. 막혔을 때 통째로 넘기기 (/codex:rescue)

버그가 안 잡히거나, Claude Code가 같은 자리를 계속 맴돌 때 Codex한테 통째로 맡깁니다.

이 버그 못 잡고 있어. Codex한테 맡길게.
/codex:rescue 실행해서 다음 작업 시켜줘:
"테스트가 왜 깨지는지 조사하고, 가장 안전한 수정안 제안해."

Codex가 다른 시각으로 다시 들여다봅니다. 같은 모델끼리 막힌 문제를 풀어내는 경우가 많습니다.

여기까지가 기본입니다

설치 2개 + 명령 2개(/codex:review, /codex:rescue). 이것만으로도 "만드는 AI와 확인하는 AI가 분리된" 상태가 됩니다. 더 필요하면 아래 Part 2를 보세요.

Part 2. 더 쓰고 싶을 때

백그라운드로 돌리기

리뷰나 rescue가 오래 걸릴 것 같으면 백그라운드로 돌리고 다른 작업을 이어가세요.

이번 브랜치를 main과 비교해서 Codex 리뷰받고 싶어.
/codex:review --base main --background 실행해줘.

결과 확인:

방금 백그라운드로 돌린 Codex 리뷰 결과 보여줘.

이전 rescue 작업 이어가기

지난번에 Codex한테 맡겼던 작업 이어서 진행시켜줘.
/codex:rescue --resume 실행해서
"이전 분석에서 제안한 수정안 중 가장 안전한 거 적용해"
이렇게 시켜줘.

작은 모델로 빠르게

간단한 건 작은 모델로 처리하면 사용량을 아낄 수 있습니다.

이 버그는 작은 모델로 빨리 봐도 돼.
/codex:rescue --model spark 실행해서
"~~~ 빨리 고쳐줘" 이렇게 시켜줘.

사용량 확인

여러 AI 중 어느 쪽이 여유 있는지 한 번에 확인:

지금 Claude, Codex, Gemini 중 어느 쪽이 가장 여유 있어?
/claude-dashboard:check-usage 실행해줘.

Adversarial Review: 설계 자체를 의심할 때

코드 디테일이 아니라 선택한 접근 방식 자체가 맞는지 의심될 때. 일반 review보다 강도 높습니다.

이번에 캐싱 + 재시도 설계 잡았는데, 이게 맞는 방향인지 의심돼.
/codex:adversarial-review 실행해서
"이 캐싱과 재시도 설계가 맞는 선택인지 압박해서 검증해"
이렇게 시켜줘.

⚠️ 인증, 데이터 손실, 롤백, 경쟁 조건 같은 risk area에 적합.

Review Gate: 응답마다 자동 검증

Claude Code가 응답을 마칠 때마다 Codex가 자동으로 리뷰합니다. 강력하지만 사용량이 빠르게 빠지니까 켤 때 주의.

codex-plugin-cc의 review gate 기능 켜고 싶어.
/codex:setup --enable-review-gate 실행해줘.
세션 끝나면 끄는 거 잊지 말아줘.

끄기:

review gate 꺼줘. /codex:setup --disable-review-gate 실행.

자주 쓰는 패턴 매핑

트러블슈팅

Codex 본체가 설치 안 됨

Codex CLI가 설치 안 됐다고 나오는데, 직접 깔아줘.

Codex 로그인 안 됨

Codex 로그인이 안 된 상태야. 어떻게 로그인하면 되는지
지금 세션에서 바로 실행할 수 있게 안내해줘.

하단 상태창에 Codex 사용량이 안 보임

하단 상태창에 Codex 사용량이 안 보여.
detailed 모드로 바꾸거나, 명시적으로 켜줘.

백그라운드 작업이 너무 오래 걸림

지금 돌고 있는 Codex 백그라운드 작업 상태 확인해주고,
너무 오래 걸리면 취소할지 물어봐줘.

핵심 요약

1. Generator/Evaluator 분리가 본질: Claude Code는 만들고, Codex는 깬다
2. 두 도구만 깔면 끝: codex-plugin-cc + claude-dashboard
3. 명령은 두 개로 시작: /codex:review, /codex:rescue
4. 모든 설치는 프롬프트로: Claude Code에 시키면 알아서 함

추가 학습 자료

• codex-plugin-cc 공식 저장소: github.com/openai/codex-plugin-cc
• claude-dashboard 공식 저장소: github.com/uppinote20/claude-dashboard
• Anthropic 하네스 설계 문서: "Harness design for long-running application development"