“클로드 코드(Claude Code) 안에서 OpenAI Codex를 같이 쓸 수 있다”는 말, 한 번쯤 들으셨을 겁니다. 처음 들으면 “경쟁사 모델인데 정말 가능하냐”는 의문이 먼저 드는데, 사실입니다. OpenAI가 직접 만든 클로드 코드용 공식 플러그인이 마켓플레이스에 올라와 있어, 클로드 코드 세션 안에서 슬래시 명령 한 줄로 Codex에 작업을 위임할 수 있습니다. 이 글에서는 그 플러그인이 정확히 무엇인지, 어떻게 설치하는지, 어떤 시나리오에서 강점이 있는지를 한 번에 정리해 드립니다.
목차
이 플러그인이 정확히 뭔가요
이름은 codex-plugin-cc이고, OpenAI가 직접 운영하는 마켓플레이스 openai/codex-plugin-cc에서 배포됩니다. 클로드 코드 안에 깔리지만 동작은 본인의 로컬 Codex CLI를 호출하는 방식입니다. 즉 별도 클라우드 서비스가 끼어드는 게 아니라, 본인이 이미 설치·로그인해 둔 Codex 환경을 클로드 코드가 그대로 사용합니다.
설계 의도도 명확합니다. 클로드는 긴 문맥 추론, 복잡한 지시 따르기, 신중한 분석에 강점이 있고, Codex는 빠른 코드 생성과 패턴 인식, 구현 스프린트에 강점이 있습니다. 둘을 같이 쓰면 클로드가 메인 오케스트레이터로 계획·문맥을 관리하고, 필요한 순간에 Codex에 구현·리뷰·디버깅을 위임하는 구도가 만들어집니다.
설치 전 준비물
설치는 간단하지만 사전 조건을 먼저 맞춰 두셔야 합니다.
- 클로드 코드가 정상 설치되어 동작 중일 것
- Node.js v18 이상이 설치되어 있고
npm이 PATH에 잡혀 있을 것 - OpenAI 계정 인증: ChatGPT 계정 로그인 또는 OpenAI API 키 둘 중 하나
Codex CLI 자체가 미설치 상태여도 괜찮습니다. 이후 단계에서 클로드 코드가 설치를 제안해 줍니다. 공식 안내는 openai/codex-plugin-cc에서 확인하실 수 있습니다.
설치 5단계
아래 명령은 모두 클로드 코드 세션 안에서 입력합니다. 한 줄씩 순서대로 따라가시면 됩니다.
- 1. 마켓플레이스 추가:
/plugin marketplace add openai/codex-plugin-cc - 2. 플러그인 설치:
/plugin install codex@openai-codex - 3. 플러그인 재로드:
/reload-plugins - 4. 설정 확인:
/codex:setup— Codex CLI가 없으면 설치(npm install -g @openai/codex)를 제안합니다. - 5. 로그인(필요 시):
!codex login— ChatGPT 계정(무료 티어 포함) 또는 OpenAI API 키로 로그인
여기까지 마치면 클로드 코드 세션 안에서 /codex:로 시작하는 명령들이 자동완성에 뜨기 시작합니다. 보이지 않으면 세션을 한 번 재시작하시면 됩니다.
제공되는 슬래시 명령 한눈에 보기
플러그인이 추가하는 핵심 명령은 다음과 같습니다. 각자 용도와 동작 방식이 분명하게 구분되어 있습니다.
| 명령 | 역할 | 대표 사용 시점 |
|---|---|---|
| /codex:review | 현재 변경분에 대한 표준 read-only 코드 리뷰 | 커밋 전 빠른 점검 |
| /codex:adversarial-review | 설계 결정과 가정 자체를 의심하는 비판적 리뷰 | 중요한 PR, 아키텍처 변경 |
| /codex:rescue | 특정 작업을 Codex에 통째로 위임 | 막힌 디버깅, 두 번째 구현 시도 |
| /codex:status | 위임한 백그라운드 작업의 진행 상황 확인 | 장시간 작업 중간 점검 |
| /codex:result | 위임 작업의 최종 결과 회수 | 완료된 작업 결과 받기 |
| /codex:cancel | 진행 중인 위임 작업 취소 | 방향 잘못 잡힌 작업 중단 |
정리하시면, review 계열은 검증·평가, rescue는 위임 실행, status·result·cancel은 위임 작업 관리입니다.
가장 자주 쓰게 되는 두 패턴
1. 코드 리뷰의 두 번째 의견
클로드가 짠 코드를 그대로 받아들이기 전에 Codex의 시각으로 한 번 더 점검받는 패턴입니다. 가벼운 점검은 /codex:review로 충분하고, 중요한 PR이나 아키텍처 변경처럼 “정말 이렇게 가도 되나”를 묻고 싶을 때는 /codex:adversarial-review를 쓰십시오. 후자는 일부러 가정 자체를 의심하도록 설계되어 있어 클로드가 놓친 함정을 잡아 주는 경우가 많습니다.
2. 막힌 디버깅을 통째로 위임
같은 버그를 클로드가 두세 번 시도해도 풀리지 않을 때, /codex:rescue로 작업을 통째로 Codex에 넘길 수 있습니다. 클로드는 메인 컨텍스트와 분리된 별도 에이전트로 Codex를 호출하므로, 본 세션의 컨텍스트가 오염되지 않습니다. 클로드가 복잡한 디버깅 상황을 인식하면 본인이 알아서 codex-rescue 에이전트를 띄우는 경우도 있습니다.
비용은 어떻게 발생하나
두 갈래로 청구됩니다.
- 클로드 측: 평소처럼 본인 클로드 요금제(Pro·Max 또는 API)에서 차감됩니다. 위임 호출도 클로드 세션 안에서 일어나므로 클로드 토큰을 소모합니다.
- Codex 측: ChatGPT Plus·Pro·Business·Edu·Enterprise 같은 ChatGPT 구독에 포함된 분량을 사용하거나, OpenAI API 키로 결제됩니다.
요약하면 한 작업에 두 회사 비용이 함께 들어갈 수 있다는 점만 기억하시면 됩니다. 그래서 가벼운 코드 리뷰까지 매번 Codex로 돌리시기보다는, 진짜 막혔을 때나 정말 이중 검증이 필요한 변경에 한해 호출하시는 것이 합리적입니다.
잘 안 될 때 점검 순서
설치 직후 자주 마주치는 함정과 빠른 해결 방법입니다.
- 1.
/codex:명령이 자동완성에 안 보임 → 클로드 코드 세션 재시작 - 2.
/codex:setup이 Codex CLI를 못 찾는다고 함 →npm install -g @openai/codex직접 실행 후 다시 시도 - 3. 인증 오류가 뜸 →
!codex login으로 다시 로그인하거나OPENAI_API_KEY환경변수 확인 - 4.
/codex:rescue가 응답 없이 멈춤 →/codex:status로 진행 상태 확인, 필요하면/codex:cancel로 중단 후 재시도 - 5. 기업 환경에서 외부 마켓플레이스 차단됨 → 사내에
codex-plugin-cc미러 저장소를 두고 그 경로를 마켓으로 추가
자주 묻는 질문
OpenAI 모델인데 정말 Anthropic 도구 안에서 동작하나요?
네. 플러그인 자체는 클로드 코드 위에서 동작하지만, 실제 모델 호출은 본인 컴퓨터에 깔린 Codex CLI가 OpenAI 서버에 직접 보냅니다. 두 회사가 협업한 결과라기보다는, OpenAI가 클로드 코드의 플러그인 표준을 활용해 만든 통합입니다.
ChatGPT 무료 계정으로도 쓸 수 있나요?
로그인 자체는 가능합니다. 다만 ChatGPT 무료 계정의 Codex CLI 사용량은 제한이 작은 편이라 본격 사용 시 한도를 빨리 만나실 수 있습니다. 자주 쓰실 거라면 ChatGPT 유료 구독이나 OpenAI API 키 결제를 권해 드립니다.
클로드만으로도 충분하지 않나요?
대부분의 작업은 그렇습니다. 그러나 같은 모델이 같은 가정으로 같은 코드를 보는 것은 놓치는 부분이 생기기 마련입니다. 다른 모델의 시각으로 한 번 더 검증받는 것은 어려운 PR, 보안에 민감한 변경, 막힌 디버깅에서 분명한 가치가 있습니다.
회사 보안 정책상 외부 마켓플레이스를 못 씁니다.
플러그인 저장소를 사내 GitHub로 미러링하시고 같은 형식의 마켓플레이스로 등록하시면 외부 노출 없이 동일하게 운영하실 수 있습니다. OpenAI API 키도 사내 보안 보관소를 통해 환경변수로 주입하시는 것이 안전합니다.
정리
OpenAI의 codex-plugin-cc는 클로드 코드 안에서 슬래시 명령 한 줄로 OpenAI Codex를 부를 수 있게 해 주는 공식 플러그인입니다. 설치는 마켓플레이스 추가 → 플러그인 설치 → 재로드 → setup → 로그인 5단계면 끝나고, /codex:review·/codex:rescue 두 가지가 가장 자주 쓰이는 명령입니다. 모든 작업을 두 모델로 굴릴 필요는 없지만, 어려운 PR이나 막힌 디버깅처럼 두 번째 시각이 절실한 순간에는 같은 클로드 세션 안에서 자연스럽게 다른 모델의 도움을 받으실 수 있습니다.