Claude Code v2.1.88 · Codex CLI v0.117.0 기준
Codex 플러그인, 명령어 7개로 Claude Code 안에서 쓴 결과
OpenAI가 경쟁사 Anthropic의 Claude Code에 공식 플러그인을 심었습니다. 설치는 3줄이면 끝나지만, 켜면 안 되는 옵션이 하나 있습니다. GitHub Issues를 직접 열어봤습니다.
출시 배경 — 왜 OpenAI가 경쟁사 도구에 플러그인을 넣었나
2026년 3월 30일, OpenAI가 openai/codex-plugin-cc를 GitHub에 Apache-2.0 라이선스로 공개했습니다. (출처: GitHub 공식 저장소, 2026.03.30) 목적은 하나입니다. Claude Code 안에서 Codex를 호출하는 것입니다.
AI 코딩 도구 시장에서 경쟁사 제품에 공식 플러그인을 직접 배포하는 건 전례가 없었습니다. 업계 분석에 따르면 Claude Code는 2026년 초 기준 연간 환산 매출 약 25억 달러, 공개 GitHub 커밋의 약 4%를 점유하고 있습니다. (출처: SmartScope, 2026.03.31, 원문 링크) Claude Code 사용자가 Codex로 갈아타기를 기다리는 대신, Claude Code 안에 Codex 접점을 만드는 전략입니다.
💡 공식 발표문과 GitHub 이슈를 같이 놓고 보니 이런 차이가 보였습니다. OpenAI 공식 커뮤니티 발표에는 “세 가지 경우에 유용하다”고 나와 있는데, 실제 저장소에는 출시 24시간 만에 72개의 이슈가 열렸습니다. (출처: GitHub Issues, 2026.03.31) 기능보다 호환성 문제가 먼저 터졌습니다.
수익 구조도 이 전략을 뒷받침합니다. Codex는 사용량 기반 과금입니다. (출처: OpenAI Codex 가격 페이지) Claude Code 사용자가 플러그인으로 리뷰를 돌릴 때마다 Codex 한도가 소진되고 OpenAI에 수익이 발생합니다. 사용자 획득 없이 과금이 이뤄지는 구조입니다.
설치 방법 — 명령어 3줄로 끝납니다
사전 조건은 두 가지입니다. Node.js 18.18 이상, 그리고 ChatGPT 구독(무료 포함) 또는 OpenAI API 키가 있어야 합니다. Claude Code 자체는 이미 설치된 상태를 전제합니다. (출처: GitHub README, openai/codex-plugin-cc, 2026.03.30)
# 1. 마켓플레이스에 저장소 추가
/plugin marketplace add openai/codex-plugin-cc
# 2. 플러그인 설치
/plugin install codex@openai-codex
# 3. 플러그인 리로드
/reload-plugins
# 4. 설치 확인 및 Codex CLI 자동 설치 제안
/codex:setup/codex:setup이 Codex CLI가 없다고 판단하면 npm install -g @openai/codex를 제안합니다. Codex CLI가 설치됐어도 로그인이 안 된 상태라면 !codex login을 Claude Code 내에서 실행하면 됩니다.
⚠️ macOS 사용자 주의
GitHub Issue #63에 따르면, macOS의 Claude Code 샌드박스가 Codex CLI의 SCDynamicStore 접근을 차단해 codex login status가 Rust 패닉으로 종료되는 버그가 있습니다. ~/.codex/auth.json에 토큰이 있어도 “Not logged in”으로 표시됩니다. v1.0.1에서 핫픽스가 나와 있으니 최신 버전을 확인하세요. (출처: GitHub Issue #63, 2026.03.31)
명령어 7개 기능 총정리
설치 완료 후 사용 가능한 슬래시 명령어는 7개입니다. 역할별로 두 그룹으로 나뉩니다.
🔍 리뷰 명령어 (읽기 전용, 코드 변경 없음)
| 명령어 | 역할 | 특징 |
|---|---|---|
| /codex:review | 미커밋 변경 또는 브랜치 diff 리뷰 | --base main, --background 지원 |
| /codex:adversarial-review | 설계 트레이드오프·숨겨진 가정 도전 | 커스텀 포커스 텍스트 추가 가능 |
🛠️ 위임 명령어 (Codex에게 작업 넘기기)
| 명령어 | 역할 |
|---|---|
| /codex:rescue | 버그 조사·수정 작업을 Codex에 위임 |
| /codex:status | 백그라운드 작업 진행 상황 확인 |
| /codex:result | 완료된 작업 결과 가져오기 |
| /codex:cancel | 실행 중인 백그라운드 작업 취소 |
| /codex:setup | 설치 확인·Review Gate 관리 |
/codex:rescue는 모델 선택이 가능합니다. --model gpt-5.4-mini나 --model spark(gpt-5.3-codex-spark의 단축 alias)를 쓰면 비용을 조절할 수 있습니다. 기본값을 지정하지 않으면 Codex가 알아서 모델을 선택합니다. gpt-5.4가 자동 선택될 수 있어서 입력 토큰당 $1.25, 출력 토큰당 $10가 청구될 수 있습니다. (출처: OpenAI Codex 가격 페이지) 명시적으로 모델을 지정하는 습관이 필요합니다.
Review Gate — 켜면 안 되는 이유
/codex:setup --enable-review-gate를 실행하면 Claude Code가 응답을 내놓을 때마다 Codex가 자동으로 품질 검사를 합니다. 문제가 발견되면 Claude Code의 출력을 막고 수정을 요구합니다. 자동화된 이중 검증처럼 보입니다.
💡 README를 직접 읽어보니 OpenAI 본인들도 경고를 달아놨습니다. “The review gate can create a long-running Claude/Codex loop and may drain usage limits quickly.” (출처: GitHub README, openai/codex-plugin-cc, 2026.03.30) Claude 한도와 Codex 한도가 동시에 닳습니다.
구체적으로 어떤 일이 벌어지냐면, Claude Code가 코드를 작성하고 → Codex가 리뷰해서 문제를 발견하고 → Claude Code가 수정하고 → Codex가 다시 리뷰하는 루프가 반복됩니다. 멈추는 조건이 명확하지 않으면 세션이 끝날 때까지 돌아갈 수 있습니다. ChatGPT Plus 구독의 Codex 한도와 Claude Max의 한도가 한 작업에 동시에 소진됩니다.
덧붙여 GitHub Issue #59에서 발견된 버그가 하나 더 있습니다. /codex:setup --enable-review-gate가 성공했다고 표시돼도 실제로는 게이트가 활성화되지 않는 경우가 있습니다. 설정이 임시 디렉터리에 저장되고, Stop 훅은 영구 디렉터리를 읽어서 경로가 엇갈리기 때문입니다. (출처: GitHub Issue #59, 2026.03.31) 켜져 있다고 믿고 있는데 안 켜진 상태일 수 있습니다.
결론적으로 Review Gate는 세션을 직접 모니터링할 수 있을 때만 켜는 기능입니다. 자리를 비운 상태에서 활성화하는 건 권장하지 않습니다.
출시 24시간 만에 터진 버그 5가지
2026.03.31 기준 GitHub Issues를 직접 확인한 결과입니다. v1.0.1 기준이며 이후 버전에서 일부 수정됐을 수 있습니다. (출처: GitHub Issue 목록, 2026.03.31)
Bug #53, 67Windows ENOENT 오류
Windows에서 spawn codex ENOENT 오류 발생. npm이 설치한 codex.cmd 파일을 shell:true 없이 직접 호출해서 생기는 문제. 모든 리뷰 명령어가 실행 불가합니다.
Bug #63macOS 샌드박스 패닉
macOS Claude Code 샌드박스가 SCDynamicStore를 차단해 codex login status가 Rust 패닉으로 종료됩니다. 토큰이 있어도 “Not logged in”으로 표시됩니다.
Bug #69adversarial-review EISDIR 크래시
추적되지 않은 디렉터리가 저장소에 있으면 /codex:adversarial-review가 EISDIR 오류로 종료됩니다. 디렉터리를 파일처럼 읽으려 하기 때문입니다. 2차로 입력 크기 초과(최대 1,048,576자)도 발생합니다.
Bug #49백그라운드 작업 무한 hang
/codex:rescue --background로 실행한 작업이 API 응답 생성 중 멈추면 무한정 hanging 상태가 됩니다. 타임아웃이 없고, 작업 상태가 “running”으로 고정돼 cancel도 안 됩니다.
Bug #58Azure OpenAI 인증 오탐
Azure OpenAI로 Codex를 구성했을 때 플러그인이 “not authenticated” 오류를 냅니다. OAuth 인증만 확인하고 API 키 기반 구성을 무시하기 때문입니다. 기업 환경에서 영향이 큽니다.
DIY 방식과 뭐가 다른지 직접 비교
💡 “공식 플러그인이 나왔으니 DIY보다 무조건 낫겠지”라고 생각하기 쉬운데, 실제로 두 방식의 실행 경로와 제어 범위가 다릅니다. SmartScope 분석 자료와 GitHub README를 교차해서 정리해봤습니다.
플러그인 방식은 Codex App Server를 통해 작업을 위임합니다. 세션 관리, 백그라운드 실행, 상태 추적이 플러그인 레이어에서 추상화됩니다. 슬래시 명령어 하나로 시작할 수 있어서 초기 진입 비용이 낮습니다.
반면 DIY 방식은 codex exec를 직접 Bash에서 호출하거나 SKILL.md와 Stop Hook을 조합합니다. 루프 조건, 반복 횟수, 멈추는 시점을 직접 제어합니다. 세밀한 파이프라인이 필요한 경우에는 공식 플러그인으로는 한계가 생깁니다.
| 항목 | codex-plugin-cc (공식) | DIY (직접 실행) |
|---|---|---|
| 실행 경로 | Codex App Server 경유 | codex exec 직접 호출 |
| 세션 관리 | 플러그인이 추상화 | 직접 구현 필요 |
| 루프 제어 | 제어 불가 (README 경고) | 멈춤 조건 자유 설정 |
| 초기 설정 | 슬래시 명령어 3줄 | SKILL.md · Hook 구성 |
| 적합한 용도 | 일상 리뷰, 빠른 도입 | 출시 전 최종 감사 파이프라인 |
두 방식은 상호 배타적이지 않습니다. 일상 리뷰는 /codex:review --background로, 배포 직전 검증은 DIY 파이프라인으로 나눠 쓰는 구성이 현실적입니다. (출처: SmartScope 분석, 2026.03.31)
실무 적용 시 주의할 4가지
SmartScope의 운영 가이드와 GitHub README를 바탕으로 정리했습니다. (출처: SmartScope, 2026.03.31 / GitHub README, 2026.03.30)
①이중 인증 관리
Claude Code에는 Anthropic 계정, Codex에는 ChatGPT 계정 또는 OpenAI API 키가 별도로 필요합니다. 팀 단위 도입 시 계정 관리 복잡도가 올라갑니다. 특히 Azure OpenAI를 쓰는 기업 환경에서는 Issue #58처럼 인증 오탐이 발생합니다.
②한도 이중 소진
Codex 사용량은 ChatGPT 구독 한도에서 차감됩니다. Claude Code 한도와는 별개입니다. 멀티파일 리뷰 한 번에 ChatGPT Plus 한도를 모두 쓰고 $6를 추가 청구당한 사례가 Reddit에 보고됐습니다. (출처: r/codex, 2026.02.27) 팀 도입 전 한도 설정을 먼저 확인해야 합니다.
③백그라운드 실행 지연
README에서 멀티파일 리뷰는 시간이 걸린다고 반복해서 언급합니다. --background 없이 동기 실행하면 Claude Code 세션이 리뷰가 끝날 때까지 블로킹됩니다. 습관적으로 --background를 붙이는 게 좋습니다.
④모델 선택 비용 관리
/codex:rescue에서 --model을 생략하면 Codex가 자동 선택합니다. gpt-5.4(출력 토큰당 $10/MTok)가 선택될 수 있습니다. 간단한 작업에는 --model gpt-5.4-mini 또는 --model spark를 명시하고, 프로젝트 기본값은 .codex/config.toml에 설정해두세요.
Q&A
마치며
솔직히 말하면 이번 플러그인은 아직 초기 단계입니다. 출시 24시간 만에 이슈가 72개 열렸고, Windows와 macOS 모두에서 기본 동작이 깨지는 버그가 있습니다. 지금 바로 팀 프로세스에 올리기에는 이릅니다.
그럼에도 흥미로운 지점이 있습니다. OpenAI가 경쟁사 생태계에 직접 발을 디뎠다는 사실입니다. 플러그인 자체의 완성도보다, AI 코딩 도구 간 경쟁이 이제 “누가 더 좋은 모델을 만드나”에서 “누가 더 많은 생태계를 연결하나”로 옮겨가고 있다는 신호를 이번 출시에서 읽을 수 있습니다.
당장은 /codex:review --background 하나만 써도 충분합니다. Review Gate는 이 글을 쓰는 시점(2026.04.01)에는 켜지 않는 편을 권장합니다. 버그가 잡히고 한도 루프 문제가 해결되면 자동화 가치가 생깁니다. 저장소 이슈를 구독해두고 v1.1 이후 릴리스를 기다리는 것이 현실적입니다.
본 포스팅 참고 자료
- GitHub 공식 저장소: github.com/openai/codex-plugin-cc (2026.03.30)
- OpenAI Developer Community 발표: community.openai.com (2026.03.30)
- OpenAI Codex 가격 페이지: developers.openai.com/codex/pricing
- SmartScope 분석 자료: smartscope.blog (2026.03.31)
- GitHub Issues: github.com/openai/codex-plugin-cc/issues (2026.03.31 기준)
본 포스팅은 2026년 4월 1일 기준으로 작성됐습니다. 본 포스팅 작성 이후 서비스 정책·UI·기능이 변경될 수 있습니다. GitHub Issues의 버그 현황과 플러그인 버전은 빠르게 업데이트되므로, 실제 적용 전 최신 릴리스 노트를 반드시 확인하세요.
댓글 남기기