이 플러그인을 설치하면 Claude Code 안에서 Codex를 호출할 수 있습니다. 다만 Claude와 Codex가 서로의 답변을 실시간으로 주고받는 구조는 아닙니다. Claude Code가 작업을 진행하다가 코드 리뷰나 별도 처리가 필요할 때 Codex에 일을 넘기는 방식입니다.

그래서 초보자에게는 ‘AI 두 개를 동시에 켠다’보다 ‘작성자와 검토자를 나눈다’고 이해하는 편이 정확합니다. Claude Code는 현재 작업의 맥락을 붙잡고, Codex는 읽기 전용 리뷰나 백그라운드 위임 작업을 맡깁니다.

플러그인만 설치한다고 바로 작동하는 것은 아닙니다. Claude Code에서 사용하는 플러그인이므로 Claude Code가 먼저 실행되어야 하고, Codex CLI가 별도로 준비되어 있어야 합니다.

공식 README 기준으로 Node.js 18.18 이상이 필요합니다. 인증은 ChatGPT 구독 계정이나 OpenAI API 키를 사용할 수 있고, 어떤 방식을 쓰든 Codex 사용량 제한에 반영될 수 있습니다.

• Claude Code가 설치되어 있을 것
• Node.js 18.18 이상일 것
• Codex CLI와 ChatGPT 또는 OpenAI API 인증이 준비되어 있을 것

Claude Code의 명령 입력창에서 마켓플레이스를 추가한 뒤 플러그인을 설치합니다. 설치 후 플러그인을 다시 읽어 오고, 마지막으로 setup 명령으로 Codex CLI와 인증 상태를 확인하면 됩니다.

• /plugin marketplace add openai/codex-plugin-cc
• /plugin install codex@openai-codex
• /reload-plugins
• /codex:setup

코드를 고친 뒤 안전하게 확인하고 싶다면 /codex:review가 가장 단순합니다. 공식 설명상 일반 리뷰는 읽기 전용으로 동작하므로, Codex가 파일을 직접 바꾸게 하기보다 먼저 문제 목록을 받는 용도로 쓰는 편이 좋습니다.

반대로 큰 작업을 넘기고 결과를 나중에 받으려면 /codex:rescue를 사용합니다. /codex:status로 진행 상태를 확인하고 /codex:result로 결과를 가져오며, 필요할 때 /codex:cancel로 취소할 수 있습니다. 더 강한 반론 검토가 필요하면 adversarial-review를 선택하면 됩니다.

• 검토만 요청: /codex:review
• 반론 중심 검토: /codex:adversarial-review
• 백그라운드 위임: /codex:rescue → /codex:status → /codex:result

Claude 앱을 사용하고 있다는 사실만으로 Claude Code 플러그인이 자동으로 작동하는 것은 아닙니다. 이 기능의 대상은 Claude Code 작업 환경이고, setup 과정에서 Codex CLI가 없다고 나오면 CLI를 따로 설치해야 합니다.

Codex CLI 설치가 끝났는데도 준비되지 않았다고 나오면 터미널에서 Codex 인증 상태를 먼저 확인하고, Claude Code를 다시 시작한 뒤 /reload-plugins와 /codex:setup을 순서대로 실행하세요. 플러그인 설치와 Codex 인증은 서로 다른 단계입니다.

처음부터 두 모델에게 같은 일을 동시에 시키기보다 작업 순서를 고정하는 것이 좋습니다. 한 모델이 파일을 수정하는 동안 다른 모델이 같은 파일을 건드리면 충돌 원인을 추적하기 어려워집니다.

• Claude Code에 요구사항과 수정 범위를 전달합니다.
• 작업이 끝나면 Codex에 읽기 전용 리뷰를 요청합니다.
• 리뷰에서 지적된 항목을 Claude Code가 하나씩 수정합니다.
• 마지막으로 테스트 결과와 남은 위험을 다시 확인합니다.

플러그인 자체의 설치 명령과 Codex CLI 설치 명령은 별개입니다. 실제 비용은 어떤 인증 방식과 모델을 쓰는지, 그리고 Codex 사용량 제한이 계정에 어떻게 적용되는지에 따라 달라집니다. 공식 README도 사용량이 Codex 한도에 반영될 수 있다고 안내합니다.

또 하나의 리스크는 코드 문맥을 외부 모델에 전달하는 일입니다. 비밀키, 고객 데이터, 회사 내부 코드가 포함된 저장소라면 리뷰 전에 범위를 줄이고 민감한 파일을 제외하세요. 읽기 전용 리뷰라고 해서 정보가 전송되지 않는다는 뜻은 아닙니다.

이 흐름은 코드 작업뿐 아니라 기록을 남기는 방식에도 그대로 적용할 수 있습니다. 설치 과정에서 막힌 지점, setup 결과, review에서 나온 오류, 수정 후 테스트 결과를 순서대로 저장하면 나중에 같은 문제를 다시 만났을 때 검색 가능한 글이 됩니다.

긴 글을 먼저 완성한 뒤 핵심 명령 네 줄은 카드뉴스로, 앱과 CLI의 차이는 짧은 스레드로, 비용과 주의사항은 체크리스트로 나누면 하나의 작업 기록을 여러 채널에 맞게 재활용할 수 있습니다.