클로드 코드 코덱스 플러그인 설치·사용법, GPT한테 검수시키기

1. 설치: 명령 네 줄

한 줄로: 클로드 코드에 코덱스 플러그인을 내려받아 끼우는 과정이에요.

왜 필요해요? 플러그인은 클로드한테 끼우는 부품이에요. 레고 블록 하나 끼우면 새 기능이 생기듯, 끼우고 나면 /codex: 로 시작하는 명령어가 새로 생겨요.

따라 하기: 클로드 코드를 열고, 입력칸에 한 줄씩 넣고 엔터를 누르세요.

1. 플러그인 가게(마켓) 추가

/plugin marketplace add openai/codex-plugin-cc

2. 플러그인 설치

/plugin install codex@openai-codex

3. 플러그인 다시 불러오기

/reload-plugins

4. 셋업 (코덱스가 준비됐는지 확인)

/codex:setup

/codex:setup 이 코덱스가 준비됐는지 알려 줘요. 컴퓨터에 코덱스가 없으면 대신 설치해 줄까 하고 물어봐요.

GPT 계정으로 로그인: 셋업이 "로그인이 안 됐다"고 하면 클로드 코드 입력칸에 이렇게 치세요. 앞의 ! 는 클로드 코드 안에서 터미널 명령을 바로 실행하는 표시예요.

!codex login

안내에 따라 ChatGPT 계정(또는 OpenAI API 키)으로 로그인하면 끝이에요. 이미 이 컴퓨터에서 코덱스에 로그인해 둔 적이 있으면 그 계정을 그대로 써요.

사진: 공식 README의 명령 목록과 필요한 것(Requirements). ChatGPT 구독(무료 포함) 또는 API 키, Node.js 18.18 이상 (2026-10-26)

확인하는 법: 입력칸에 /codex 까지만 쳐 보세요. /codex:review, /codex:adversarial-review 같은 명령이 목록에 뜨면 설치된 거예요. /agents 에 codex:codex-rescue 가 보이는 것도 설치됐다는 표시예요.

막히면

• 셋업이 코덱스를 못 깐다: 코덱스를 직접 설치하세요. Node.js가 없거나 18.18보다 낮으면 nodejs.org에서 LTS 버전을 먼저 까세요.

npm install -g @openai/codex

• 이름이 비슷한 가짜 조심: 공식은 저장소 openai/codex-plugin-cc, 프로그램 @openai/codex 예요. 앞에 openai 가 붙었는지 꼭 보세요.
• 그래도 안 되면 에러를 그대로 복사해서 클로드 코드에 이렇게 말하세요.

코덱스 플러그인(openai/codex-plugin-cc) 설치 중에 아래 에러가 났어. 원인을 찾아서 고쳐 주고, 고친 뒤 /codex:setup 으로 준비됐는지 확인해 줘. 공식 README 안내만 따라 줘.

[에러 메시지 붙여넣기]

2. 검수 명령 모음

한 줄로: 클로드가 만든 걸 GPT가 읽어 보고 문제를 짚어 주는 명령이에요.

왜 필요해요? 쓴 사람이 자기 글을 다시 읽으면 같은 눈으로 보게 돼요. 글을 다른 사람한테 한 번 보여 주듯, 검수는 쓴 AI 말고 다른 회사 AI한테 맡기는 거예요.

그냥 검수: /codex:review

지금 고친 내용을 GPT가 훑어보고 문제를 알려 줘요. 읽기만 하고 파일은 안 고쳐요.

/codex:review

이 명령은 "어디를 봐 줘"라는 말을 받지 않아요. 특정 부분을 집중해서 보게 하려면 아래 '따져 묻는 검수'를 쓰세요.

따져 묻는 검수: /codex:adversarial-review

"이 결정 맞아?" 하고 따져 묻는 검수예요. 코드 한 줄 한 줄보다 방향이 맞는지, 숨은 가정, 실패하는 경우, 더 안전하거나 간단한 방법이 없는지를 봐요. 이것도 읽기만 하고 고치지는 않아요.

명령 뒤에 집중해서 볼 부분을 적을 수 있어요.

/codex:adversarial-review
/codex:adversarial-review --base main 로그인 실패를 처리하는 방식이 맞는지 따져 봐 줘
/codex:adversarial-review --background 결제가 두 번 되는 경우가 없는지 봐 줘

이럴 때 쓰세요: 올리기 직전, 로그인·결제·데이터 삭제처럼 틀리면 큰일 나는 부분을 고쳤을 때.

뒤에서 돌리기: --background

검수는 파일이 많으면 오래 걸려요. 공식 안내도 뒤에서 돌리는 걸 추천해요. 돌려 두고 다른 일을 하다가 결과만 보면 돼요.

/codex:review --background
/codex:status
/codex:result

확인하는 법: /codex:status 에 작업이 보이고, 끝나면 /codex:result 에 검수 내용이 떠요.

덤: 일을 통째로 넘기기

검수 말고 일 자체를 GPT한테 맡길 수도 있어요.

명령 대신 말로 해도 돼요.

코덱스한테 이 버그 원인 찾아 달라고 맡겨 줘. 결과 나오면 같이 보자.

3. 역할 나누기 예시: 초안 클로드 → 검수 GPT → 수정 클로드

한 줄로: 쓰는 건 클로드, 검수는 GPT, 고치는 건 다시 클로드. 세 번을 차례로 하면 돼요.

따라 하기

① 초안: 클로드한테 만들게 하기

[만들 것: 예) 예약 신청 페이지]를 만들어 줘. 다 만들면 멈추고, 바꾼 파일 목록만 알려 줘. 내가 검수 받고 다시 부를게.

② 검수: GPT한테 넘기기

/codex:review --background

중요한 부분이 있으면 따져 묻는 검수로 바꿔요.

/codex:adversarial-review --background [집중할 부분: 예) 같은 시간에 예약이 두 번 잡히는 경우가 없는지]

끝나면 /codex:result 로 결과를 봐요.

③ 수정: 결과를 클로드한테 돌려주기

방금 코덱스 검수 결과(/codex:result)를 읽어 줘. 맞는 지적만 골라서 고치고, 안 고칠 지적은 왜 안 고치는지 한 줄씩 적어 줘. 다 고치면 바꾼 내용을 짧게 정리해 줘.

확인하는 법: 고친 뒤 /codex:review 를 한 번 더 돌려서 같은 지적이 다시 안 나오면 끝이에요.

막히면

• GPT 지적이 다 맞는 건 아니에요. 그래서 ③에서 "맞는 지적만 골라서"라고 시키는 거예요. 판단은 클로드와 내가 해요.
• 검수 결과가 영어로 나오면 ③ 문장 끝에 "정리는 한국어로 해 줘"를 붙이세요.

4. 사용량 아끼기: 매번 말고 넘기기 전에 한 번

• 검수할 때마다 내 코덱스(GPT) 사용 한도가 빠져요. 공식 README에 그대로 적혀 있어요. 한도는 코덱스 요금 안내에서 확인하세요.
• 그래서 고칠 때마다가 아니라, 다 만들고 넘기기 전에 한 번이 좋아요.
• 리뷰 게이트는 켜지 마세요 (처음엔). /codex:setup --enable-review-gate 는 클로드가 답할 때마다 자동으로 검수를 돌리는 기능인데, 공식 안내에 "사용량을 빠르게 쓸 수 있으니 지켜볼 때만 켜라"고 경고가 있어요. 켰다면 /codex:setup --disable-review-gate 로 꺼요.

용어 정리

체크리스트

• 저장소 주소가 openai/codex-plugin-cc 인지 확인했다
• 설치 네 줄을 쳤고 /codex:setup 이 준비됐다고 한다
• /codex 를 치면 검수 명령이 목록에 뜬다
• 다 만든 뒤 /codex:review --background 를 돌렸다
• /codex:result 결과를 클로드한테 주고 맞는 지적만 고치게 했다
• 리뷰 게이트는 꺼져 있다

출처

• openai/codex-plugin-cc README (2026-10-26 확인, Apache-2.0)
• Codex 요금 안내 (OpenAI 공식)
• Node.js 공식 사이트