openai/codex-plugin-cc(Claude Code용 공식 Codex 플러그인) : Claude가 코딩하고 Codex가 리뷰한다
- -
안녕하세요! 갓대희 입니다.

2026년 3월 30일, OpenAI가 경쟁사 Anthropic의 Claude Code에 공식 Codex 플러그인을 출시했다 (GitHub).
리포지토리 이름은 openai/codex-plugin-cc, 설명은 "Use Codex from Claude Code to review code or delegate tasks."이다.
공개 하루 만에 GitHub stars 800+개 (2026-03-31 GitHub API 기준, 지속 변동 중)를 기록했고, 오픈 이슈 10여 개, 커밋 2개로 아직 초기 단계이다 (2026-03-31 GitHub API 기준, 변동 가능). 라이선스는 Apache-2.0이다
이 글에서는 codex-plugin-cc 플러그인의 설치법, 7개 주요 명령어, Review Gate 메커니즘, 소스코드 아키텍처, 제한사항을 증거 기반으로 분석하고, 크로스벤더 에이전트 협업이 개발 생태계에 미치는 의미를 짚어 보려 한다.
목차
- 소개 + 왜 주목하는가
- 설치 및 시작하기
- 주요 명령어 상세 (7개)
- 기술 아키텍처 분석
- 소스코드 핵심 분석
- 활용법 / 통합 방법
- 사용 예시
- 제한사항 및 주의사항
- 트러블슈팅 Q&A
- 결론 — 도입 결정 매트릭스 + 크로스벤더 에이전트 협업의 의미
1. 소개 + 왜 주목하는가
OpenAI가 자사 Codex를 경쟁사 플랫폼인 Claude Code 위에서 동작하도록 공식 플러그인을 만들었다는 사실 자체가 이례적이다.

openai 조직 하의 공식 리포지토리이며, marketplace.json에 owner가 "OpenAI"로 명시되어 있고 버전은 1.0.0이다.
핵심 가치는 두 가지다.
- 코드 리뷰 위임 — Claude Code에서 작업하면서 Codex에 리뷰를 맡긴다. review와 adversarial-review 두 가지 모드를 제공한다. review는 표준 코드 리뷰(버그·스타일 점검)를, adversarial-review는 설계 결정을 도전적으로 질문하는 심층 리뷰를 수행한다.
- 작업 위임(rescue) — 버그 조사, 수정, 후속 작업을 Codex 서브에이전트에 위임한다.
크로스벤더 에이전트 협업이란? — 서로 다른 벤더의 AI 에이전트가 하나의 워크플로우에서 협력하는 패턴이다. Claude가 코딩하고, Codex가 리뷰하는 식이다. 싱글 에이전트 시대에서 멀티 에이전트 시대로의 전환점이라 할 수 있다.

| 항목 | codex-plugin-cc | 기존 Codex MCP 접근 |
|---|---|---|
| 통합 방식 | Claude Code 네이티브 Plugin System (marketplace.json → plugin.json → commands/hooks/agents/skills) | MCP 서버 연동 |
| 명령어 | /codex:review, /codex:rescue 등 슬래시 명령어 7개 |
MCP 도구 호출 |
| 라이프사이클 훅 | SessionStart/SessionEnd/Stop 훅 내장 | 해당 없음 |
| Review Gate | Stop 훅 기반 자동 리뷰 게이트 | 해당 없음 |
| 배포 | marketplace add 한 줄 |
MCP 서버 설정 필요 |
한 줄 요약: codex-plugin-cc는 MCP 프로토콜이 아닌 Claude Code의 네이티브 Plugin System을 사용하여, 명령어·훅·에이전트·스킬을 선언적으로 정의하는 방식이다. MCP 접근보다 Claude Code 생태계에 깊이 통합된다.
2. 설치 및 시작하기

설치 플로우는 4단계다.
# 1) 마켓플레이스에 리포지토리 추가
/plugin marketplace add openai/codex-plugin-cc
# 2) codex 플러그인 설치
/plugin install codex@openai-codex
# 3) 플러그인 리로드
/reload-plugins
# 4) 셋업 실행 (Codex CLI 설치 + 인증 확인)
/codex:setup
ex) 마지막에 나오는 선택사항을 설정시 Stop 훅 기반 Review Gate가 활성화되면 Claude Code가 멈출 때마다 Codex 리뷰가 트리거된다.


사전 요구사항
- Node.js 18.18 이상 — package.json에
"engines": {"node": ">=18.18.0"}으로 명시되어 있다. - ChatGPT 구독 또는 OpenAI API 키 — 사용량은 Codex 한도에 포함된다. Claude Code 구독과는 별도이므로, Anthropic + OpenAI 이중 비용이 발생한다.
- Codex CLI —
/codex:setup을 실행하면 Codex가 미설치 시npm install -g @openai/codex설치를 제안하고, 미인증 시!codex login(Claude Code 셸 이스케이프)을 안내한다.
이중 구독 비용 주의 — 이 플러그인을 사용하려면 Claude Code 구독(Anthropic)과 ChatGPT/OpenAI API 구독을 모두 유지해야 한다. 비용 관리에 유의하자.
3. 주요 명령어 상세 (7개)
플러그인은 7개 슬래시 명령어를 제공한다. 각각의 동작과 옵션을 정리한다.


3-1. /codex:review — 코드 리뷰
Codex 내장 리뷰어를 사용하여 커밋되지 않은 변경이나 브랜치 비교에 대해 코드 리뷰를 실행한다. read-only로 동작하며, 코드를 직접 수정하지 않는다.
--wait/--background— 동기/비동기 실행. 리뷰 크기를 추정하여 1~2개 파일의 작은 리뷰를 제외하면 background 실행을 권장한다.--base <ref>— 비교 기준 브랜치/커밋 지정.- 포커스 텍스트를 지원하지 않는다. 특정 영역을 집중 검토하거나 커스텀 지시가 필요하면
/codex:adversarial-review를 사용한다. (review.md소스 검증 완료)
ex) Codex 코드 리뷰 : read-only로 함부로 소스 수정까지 하지 않는다.


3-2. /codex:adversarial-review — 도전적 리뷰
구현 방식과 설계 결정을 도전적으로 질문하는 리뷰를 수행한다. review와 마찬가지로 read-only이다. /codex:review와 달리 플래그 뒤에 포커스 텍스트를 자유롭게 추가할 수 있다. 포커스 텍스트를 지정하면 해당 영역에 가중치를 두고, 나머지 공격 면도 함께 검토한다. (adversarial-review.md 소스 검증 완료)
# 포커스 텍스트 없이 — 7개 공격 면 전체를 균등하게 검토
/codex:adversarial-review --base HEAD~2
# 특정 기능 흐름 집중 — 해당 영역에 가중치, 나머지도 함께 검토
/codex:adversarial-review --base HEAD~2 Cohort 등록/수정 모달의 상태 관리와 API 호출 흐름
# 보안/권한 집중
/codex:adversarial-review 인증 미들웨어와 API 권한 처리 누락 여부
# 대규모 변경은 백그라운드로
/codex:adversarial-review --background 타입 정의와 실제 API 스펙 일치 여부
ex) /codex:adversarial-review --base HEAD~2

- 이후 2개의 이력기준으로 분석하고 내용을 알려준다.

adversarial-review 프롬프트가 질문하는 핵심 축:
- 현재 접근 방식이 올바른지
- 어떤 가정에 의존하는지
- 실제 조건에서 설계가 어디서 실패할 수 있는지

7개 공격 면(attack surface)이 프롬프트에 정의되어 있다:
- 인증, 권한, 테넌트 격리, 신뢰 경계 (Authentication, permissions, tenant isolation, trust boundaries)
- 데이터 손실, 오염, 중복, 비가역 상태 변경 (Data loss, corruption, duplication, irreversible state changes)
- 롤백 안전성, 재시도, 부분 실패, 멱등성 갭 (Rollback safety, retries, partial failure, idempotency gaps)
- 레이스 컨디션, 순서 가정, 스테일 상태, 재진입 (Race conditions, ordering assumptions, stale state, re-entrancy)
- 빈 상태, null, 타임아웃, 의존성 저하 동작 (Empty-state, null, timeout, degraded dependency behavior)
- 버전 스큐, 스키마 드리프트, 마이그레이션 위험, 호환성 회귀 (Version skew, schema drift, migration hazards, compatibility regressions)
- 관찰성 갭 (Observability gaps)
인사이트 ①: 어떤 리뷰 종류를 선택할까? (review vs adversarial-review)
| 상황 | 권장 명령어 | 이유 |
|---|---|---|
| PR 머지 전 일반 리뷰 | /codex:review |
표준 코드 품질 점검에 적합 |
| 아키텍처 변경 리뷰 | /codex:adversarial-review |
설계 가정을 공격적으로 질문 |
| 보안 민감 코드 | /codex:adversarial-review |
7개 공격 면 기반 심층 분석 |
review는 "이 코드에 문제가 있는가?"에 집중하고, adversarial-review는 "이 설계가 실패할 수 있는 곳은 어디인가?"에 집중한다. 일반 리뷰에는 review, 설계 결정을 검증해야 할 때는 adversarial-review가 적합하다.
인사이트 ②: 실행 모드 선택 (두 명령어 공통 적용)
| 상황 | 플래그 | 이유 |
|---|---|---|
| 빠른 확인 (1~2 파일) | --wait |
동기 실행으로 즉시 결과 확인 |
| 대규모 변경 | --background |
비동기 실행 권장, /codex:status로 결과 확인 |
--wait / --background 플래그는 review와 adversarial-review 모두에 동일하게 적용된다. 예: /codex:adversarial-review --wait도 유효하다.

3-3. /codex:rescue — 작업 위임
조사, 수정, 후속 작업을 Codex 서브에이전트에 위임한다. review와 달리 기본 write 모드로 실행된다.
--background/--wait— 비동기/동기 실행--resume/--fresh— 이전 작업 이어하기 또는 새로 시작--model <model|spark>— 모델 선택.spark은gpt-5.3-codex-spark으로 매핑된다--effort <none|minimal|low|medium|high|xhigh>— reasoning effort 6단계 설정
3-4. /codex:status — 작업 현황
현재 및 완료된 Codex 작업을 표시한다. review-gate 상태도 포함한다.
3-5. /codex:result — 결과 확인
완료된 작업의 최종 출력을 축약 없이 전부 표시한다. verdict, summary, findings, details, artifacts, next steps 등 모든 페이로드를 보존한다.
3-6. /codex:cancel — 작업 취소
활성 백그라운드 Codex 작업을 종료한다.
3-7. /codex:setup — 초기 설정
Codex CLI 상태를 확인하고 Review Gate를 제어한다.

--enable-review-gate— Review Gate 활성화--disable-review-gate— Review Gate 비활성화- Codex 미설치 시
npm install -g @openai/codex설치를 제안한다. - 미인증 시
!codex login(Claude Code 셸 이스케이프)을 안내한다.
4. 기술 아키텍처 분석
Claude Code Plugin System 구조
이 플러그인은 Claude Code의 네이티브 Plugin System을 사용한다. 전체 구조는 다음과 같다:
marketplace.json (마켓플레이스 등록)
└→ plugin.json (플러그인 메타데이터)
├→ commands/ (7개 슬래시 명령어 정의 — .md)
├→ hooks/ (hooks.json — SessionStart/SessionEnd/Stop)
├→ agents/ (codex-rescue 서브에이전트 — .md)
├→ skills/ (3개 스킬 — SKILL.md)
├→ prompts/ (adversarial-review 전용 프롬프트 — .md, review는 commands/review.md에 인라인 정의)
├→ schemas/ (review-output.schema.json)
└→ scripts/ (codex-companion.mjs + lib/ 모듈 14개)
명령어와 에이전트는 .md 파일로 선언적 정의하고, 실제 실행 로직은 scripts/ 하위의 JavaScript 모듈이 담당한다.
Codex App Server 연동
플러그인은 로컬에 설치된 Codex CLI(codex app-server)를 래핑하여 JSON-RPC 프로토콜로 통신한다. 별도 런타임이 아닌 사용자의 로컬 Codex CLI를 사용하는 구조다.
연결 전략은 두 가지다:
- SpawnedCodexAppServerClient — 직접 프로세스 스폰 (
transport: "direct") - BrokerCodexAppServerClient — 브로커 소켓 연결 (
transport: "broker")
초기화 시 initialize / initialized 핸드셰이크를 수행한다.
Hook 시스템
hooks.json은 3가지 훅을 정의한다:
| 훅 | 스크립트 | 타임아웃 | 역할 |
|---|---|---|---|
| SessionStart | session-lifecycle-hook.mjs | 5초 | 환경 변수 설정 (세션 ID) |
| SessionEnd | session-lifecycle-hook.mjs | 5초 | 브로커 셧다운, 세션 작업 정리 |
| Stop | stop-review-gate-hook.mjs | 900초 (15분) | Review Gate 실행 |
SessionStart에서 환경 변수를 설정하고, SessionEnd에서 브로커 셧다운과 세션 작업 정리를 수행한다.
Stop 훅은 Review Gate 전용으로 15분의 넉넉한 타임아웃을 가진다.
5. 소스코드 분석
파일 트리 구조
openai/codex-plugin-cc/
├── .claude-plugin/
│ └── marketplace.json # 마켓플레이스 등록 정보
├── plugins/codex/
│ ├── .claude-plugin/
│ │ └── plugin.json # 플러그인 메타데이터
│ ├── commands/ # 7개 슬래시 명령어 (.md)
│ │ ├── review.md
│ │ ├── adversarial-review.md
│ │ ├── rescue.md
│ │ ├── status.md
│ │ ├── result.md
│ │ ├── cancel.md
│ │ └── setup.md
│ ├── agents/
│ │ └── codex-rescue.md # rescue 서브에이전트
│ ├── hooks/
│ │ └── hooks.json # 3개 라이프사이클 훅
│ ├── skills/
│ │ ├── codex-cli-runtime/SKILL.md
│ │ ├── codex-result-handling/SKILL.md
│ │ └── gpt-5-4-prompting/SKILL.md
│ ├── prompts/ # adversarial-review 전용 (review 프롬프트는 commands/review.md에 인라인)
│ │ └── adversarial-review.md
│ ├── schemas/
│ │ └── review-output.schema.json
│ └── scripts/
│ ├── codex-companion.mjs # 메인 CLI 엔트리포인트
│ ├── session-lifecycle-hook.mjs
│ ├── stop-review-gate-hook.mjs
│ └── lib/ # 14개 유틸리티 모듈
│ ├── app-server.mjs
│ ├── args.mjs
│ ├── broker-endpoint.mjs
│ ├── broker-lifecycle.mjs
│ ├── codex.mjs
│ ├── fs.mjs
│ ├── git.mjs
│ ├── job-control.mjs
│ ├── process.mjs
│ ├── prompts.mjs
│ ├── render.mjs
│ ├── state.mjs
│ ├── tracked-jobs.mjs
│ └── workspace.mjs
└── package.json # @openai/codex-plugin-cc v1.0.0
codex-companion.mjs — 메인 엔트리포인트
메인 CLI 엔트리포인트로 9개 서브커맨드를 처리한다:
setup, review, adversarial-review, task, task-worker, status, result, task-resume-candidate, cancel.
review/adversarial-review는 sandbox: "read-only"로 실행되고,
task(rescue)는 sandbox: request.write ? "workspace-write" : "read-only"로 실행된다.
기본적으로 rescue는 write 모드이다.
background 작업은 detached child process로 실행되며, task-worker 서브커맨드가 실제 작업을 처리한다.
// codex-companion.mjs — 모델 별칭과 reasoning effort 검증
const MODEL_ALIASES = new Map([["spark", "gpt-5.3-codex-spark"]]);
const VALID_REASONING_EFFORTS = new Set([
"none", "minimal", "low", "medium", "high", "xhigh"
]);
lib/ 주요 모듈 역할
| 모듈 | 역할 |
|---|---|
| app-server.mjs | CodexAppServerClient — 직접 스폰(Spawned)과 브로커 소켓(Broker) 두 전략으로 JSON-RPC 통신 |
| broker-lifecycle.mjs | 브로커 프로세스 생성, 연결 검증, 종료, 세션 상태 관리 |
| state.mjs | 파일 시스템 기반 작업 상태 관리 (MAX_JOBS=50, 워크스페이스별 SHA-256 해시 디렉토리) |
| job-control.mjs | 작업 조회, 정렬, 상태 스냅샷, 진행 미리보기, 취소 대상 해석 |
| args.mjs | CLI 인자 파싱 |
| broker-endpoint.mjs | 브로커 엔드포인트 URL 관리 및 연결 주소 해석 |
| codex.mjs | Codex CLI 래핑 및 호출 인터페이스 |
| fs.mjs | 파일 시스템 유틸리티 (경로 해석, 파일 읽기/쓰기) |
| git.mjs | Git 관련 유틸리티 |
| process.mjs | 자식 프로세스 생성 및 생명주기 관리 |
| render.mjs | 출력 렌더링 |
| prompts.mjs | 프롬프트 구성 |
| tracked-jobs.mjs | 작업 추적 및 이력 관리 |
| workspace.mjs | 워크스페이스 경로 해석 및 디렉토리 관리 |
codex-rescue 서브에이전트
rescue 에이전트는 Codex companion task 런타임의 포워딩 래퍼다.
에이전트의 역할은 "사용자의 rescue 요청을 Codex companion 스크립트에 전달하는 것"이다.
기본적으로 --write 모드로 실행되며, 사용자가 read-only를 명시적으로 요청한 경우에만 제외한다.
리뷰 출력 스키마 (review-output.schema.json)

{
"verdict": "approve | needs-attention",
"summary": "...",
"findings": [
{
"severity": "...",
"title": "...",
"body": "...",
"file": "...",
"line_start": 0,
"line_end": 0,
"confidence": "...",
"recommendation": "..."
}
],
"next_steps": ["..."]
}
verdict는 approve 또는 needs-attention 두 값이며,
각 finding에는 severity, title, body, file, line_start, line_end, confidence, recommendation이 포함된다.
스킬 3개
- codex-cli-runtime — Codex CLI 런타임 통합
- codex-result-handling — Codex 출력의 표시 규칙 정의. 리뷰 결과 후 자동 코드 수정을 금지한다. ("After presenting review findings, STOP. Do not make any code changes.")
- gpt-5-4-prompting — Codex/GPT-5.4에 최적화된 프롬프트 작성 가이드라인. Codex를 "협업자가 아닌 오퍼레이터처럼" 다루고, XML 태그를 사용한 블록 구조의 컴팩트 프롬프트를 권장한다
6. 활용법 / 통합 방법
Codex config.toml 연동
기본 모델과 reasoning effort는 Codex의 사용자 레벨 또는 프로젝트 레벨 config.toml에서 커스터마이징할 수 있다.
명령어에서 --model이나 --effort로 오버라이드하는 것도 가능하다.
모델 선택
- 기본 모델: config.toml 설정에 따름
--model spark→gpt-5.3-codex-spark으로 매핑 (가벼운 작업에 적합)--model gpt-5.4-mini→ 직접 지정 예시. 비용을 절감하면서 중간 수준의 리뷰 품질이 필요할 때 적합하다. 예:/codex:review --model gpt-5.4-mini --base main--model <모델명>→ 직접 지정.MODEL_ALIASES에 등록되지 않은 모델명은 그대로 Codex API에 전달된다 —MODEL_ALIASES.get(model) ?? model로직).
--effort 옵션 (reasoning effort)
6단계 설정이 가능하다: none, minimal, low, medium, high, xhigh. 간단한 작업에는 낮은 effort, 복잡한 분석에는 높은 effort를 지정하여 비용과 품질을 조절한다.
background vs foreground 실행 전략

- foreground (
--wait) — 1~2개 파일의 작은 리뷰에 적합. 결과를 즉시 확인할 수 있다. - background (기본 또는
--background) — 대규모 변경에 적합. detached child process로 실행되며,/codex:status로 진행 상황을 확인하고/codex:result로 결과를 조회한다.
7. 사용 예시
시나리오 1: PR 머지 전 코드 리뷰
# main 브랜치 대비 리뷰 (background)
/codex:review --base main --background
# 잠시 후 상태 확인
/codex:status
# 결과 확인
/codex:result
review는 read-only이므로 코드를 수정하지 않는다. 리뷰 결과의 verdict가 needs-attention이면 findings를 확인하고 직접 수정한다.
시나리오 2: 버그 조사 및 수정 위임
# Codex에 버그 조사 + 수정 위임 (write 모드 기본)
/codex:rescue "auth 모듈에서 토큰 갱신 실패 원인 조사 후 수정"
# 결과 확인
/codex:result
rescue는 기본 write 모드이므로 Codex가 직접 코드를 수정한다. --resume 옵션으로 이전 작업에 이어서 추가 작업을 위임할 수도 있다.
시나리오 3: adversarial-review로 아키텍처 검증 (포커스 텍스트 활용)
# 특정 기능 흐름을 포커스 텍스트로 지정하여 집중 검증
# 포커스 영역에 가중치를 두되 7개 공격 면 전체도 함께 검토함
/codex:adversarial-review --base HEAD~2 Cohort 등록/수정 모달의 상태 관리와 API 호출 흐름
# 포커스 없이 전체 균등 검토 (대규모 변경은 --background 권장)
/codex:adversarial-review --background
adversarial-review는 인증/권한, 데이터 손실, 롤백 안전성, 레이스 컨디션, 빈 상태/타임아웃, 버전 스큐, 관찰성 갭 등 7개 공격 면을 기준으로 설계를 공격적으로 질문한다. 아키텍처 변경이나 보안 민감 코드에 특히 유용하다.
포커스 텍스트를 지정하면 Codex가 해당 영역의 파일을 우선 탐색한다. 실제 테스트 결과, --base HEAD~2 Cohort 등록/수정 모달의 상태 관리와 API 호출 흐름을 지정했을 때 Codex는 CohortRegistModal.tsx, cohort.api.ts, cohortRegMng/index.tsx를 집중 분석하여 수정 경로 dead code, manager 스코프 누락, mock 저장 후 false success 등 high 3건 + medium 1건을 검출했다.
시나리오 4: rescue → resume 연속 작업
# 1차 위임
/codex:rescue "DB 마이그레이션 스크립트 작성"
# 결과 확인 후 추가 작업 이어하기
/codex:rescue --resume "인덱스 추가도 포함해서 마무리"
--resume을 사용하면 이전 Codex 세션의 컨텍스트를 유지하면서 후속 작업을 위임한다. --fresh는 반대로 새 세션으로 시작한다.
8. 제한사항 및 주의사항

이중 구독 비용
ChatGPT 구독 또는 OpenAI API 키가 필요하며, 사용량은 Codex 한도에 포함된다. Claude Code 구독(Anthropic)과 별도이므로 두 벤더에 이중 비용이 발생한다.
초기 단계 프로젝트
커밋 2개, 오픈 이슈 10여 개 (2026-03-31 GitHub API 기준, 변동 가능), 리포지토리 생성일 2026-03-30이다. 아직 극초기 단계이므로 프로덕션 의존은 신중해야 한다.
Review Gate 사용량 경고
Stop 훅 기반 Review Gate가 활성화되면 Claude Code가 멈출 때마다 Codex 리뷰가 트리거된다 . 이는 추가 Codex 사용량을 발생시킨다.
불필요하면 /codex:setup --disable-review-gate로 비활성화한다.
Node.js 18.18+ 요구
package.json에 "engines": {"node": ">=18.18.0"}으로 명시되어 있다. 이전 버전의 Node.js에서는 동작하지 않는다.
read-only 제한
review와 adversarial-review는 read-only(sandbox: "read-only")로 실행된다. 리뷰 결과를 바탕으로 코드를 자동 수정하지 않으며, codex-result-handling 스킬이 "After presenting review findings, STOP. Do not make any code changes."를 명시한다.
패키지 특성
패키지는 private: true로 설정되어 있어 npm에 공개 배포되지 않는다. Claude Code 플러그인 마켓플레이스를 통해서만 설치한다.
9. 트러블슈팅 Q&A
Q1. /codex:setup 실행 시 Codex CLI가 없다고 나온다.
A. Codex CLI가 미설치 상태이다. setup이 npm install -g @openai/codex 설치를 제안한다. Node.js 18.18 이상이 필요하다.
Q2. Codex 인증에 실패한다.
A. ChatGPT 구독 또는 OpenAI API 키가 필요하다. /codex:setup이 미인증 시 !codex login(Claude Code 셸 이스케이프)을 안내한다. 로그인 후 다시 시도한다.
Q3. Review Gate가 계속 트리거되어 사용량이 급증한다.
A. Stop 훅 기반이므로 Claude Code가 멈출 때마다 실행된다. /codex:setup --disable-review-gate로 비활성화한다. config에서 stopReviewGate가 활성화되어 있어야 동작하므로, 설정 상태를 /codex:status로 확인한다.
Q4. 모델과 effort를 어떻게 설정하나?
A. 명령어에서 --model <모델명|spark>, --effort <none|minimal|low|medium|high|xhigh>로 지정한다. 기본값은 Codex config.toml의 사용자 레벨 또는 프로젝트 레벨 설정을 따른다. spark은 gpt-5.3-codex-spark으로 매핑된다. gpt-5.4-mini 등 별칭에 없는 모델도 직접 지정 가능하다.
Q5. 기존 Codex 설정(config.toml)이 호환되나?
A. 기본 모델과 reasoning effort는 기존 Codex config.toml에서 커스터마이징할 수 있다. 플러그인은 로컬 Codex CLI를 래핑하는 구조이므로 기존 설정이 그대로 적용된다.
Q6. background 작업 진행 상태를 어떻게 확인하나?
A. /codex:status로 활성 및 완료 작업을 확인하고, /codex:result로 완료된 작업의 전체 결과를 조회한다. 취소가 필요하면 /codex:cancel을 사용한다.
10. 결론 — 도입 결정 매트릭스 + 크로스벤더 에이전트 협업의 의미
도입 결정 매트릭스: 언제 쓰고, 언제 쓰지 않는가
| 상황 | 판단 | 이유 |
|---|---|---|
| Claude Code로 코딩 + 별도 리뷰어가 필요 | 도입 고려 | Codex의 독립적 관점으로 크로스 리뷰 가능 |
| 이미 OpenAI API 구독이 있다 | 도입 유리 | 추가 비용이 Codex 사용량뿐 |
| 비용에 민감하다 | 신중 검토 | Anthropic + OpenAI 이중 구독 필요 |
| 프로덕션 워크플로우에 즉시 적용 | 보류 권장 | 2커밋, 10여 이슈의 극초기 프로젝트 (2026-03-31 GitHub API 기준, 변동 가능) |
| 보안 민감 코드를 다룬다 | adversarial-review 활용 | 7개 공격 면 기반 심층 리뷰 |
| 리뷰 없이 작업 위임만 필요 | rescue 활용 | write 모드로 직접 수정까지 가능 |
커뮤니티 반응과 업계 의미
- "자존심이고뭐고 다 버렸구나" — OpenAI가 경쟁사 플랫폼에 플러그인을 출시한 것에 대한 놀라움이 주된 반응이었다. 이는 AI 에이전트 시장에서 도달 범위(reach)가 자존심보다 중요해졌다는 신호로 읽을 수 있다.
- Google/Firefox 검색 딜 비유 — Google이 Firefox에 기본 검색 엔진 비용을 지불하듯, OpenAI가 Claude Code라는 경쟁사 플랫폼에 진입하는 전략이라는 분석이다. 시장 점유 경쟁에서 플랫폼 진입 전략이 벤더 충성도를 넘어서는 사례다.
- "코드래빗 어짜냐" — CodeRabbit 등 기존 코드 리뷰 도구의 입지에 대한 우려가 있었다. Codex가 Claude Code에 직접 통합되면, 별도 코드 리뷰 SaaS의 가치 제안이 압박받을 수 있다.
- Claude Code 플랫폼화 — Claude Code가 단순 에이전트 IDE에서 서드파티 플러그인을 수용하는 플랫폼으로 진화하고 있다는 평가다. 이는 싱글 에이전트 시대의 종언을 의미한다.
- 이중 구독 비용 우려 — Anthropic + OpenAI 양쪽 구독이 필요하다는 점에서 비용 부담에 대한 실질적 우려가 있었다.
이 반응들을 종합하면, codex-plugin-cc는 기술적 완성도보다 생태계 전략의 전환점으로서 의미가 크다. 경쟁사 간 에이전트 협업이 현실화되었고, 앞으로 "어떤 AI를 쓰느냐"보다 "어떤 AI들을 조합하느냐"가 개발 워크플로우의 핵심 질문이 될 가능성이 있다.
도입 플레이북
- 오늘:
/codex:setup으로 설치 + 인증 확인. 개인 사이드 프로젝트에서/codex:review시험. - 이번 주: adversarial-review와 rescue를 병행 테스트.
--effort옵션별 비용/품질 체감 비교. - 운영 반영 판단: 오픈 이슈 해결 추이와 커밋 히스토리를 모니터링한 후 결정. 극초기 프로젝트(2커밋, 10여 이슈 — 2026-03-31 GitHub API 기준, 변동 가능)이므로 안정성이 검증된 뒤 반영하는 것이 권장된다.
마무리


'AI > Claude' 카테고리의 다른 글
당신이 좋아할만한 콘텐츠
-
Claude Code 신기능 'Ultraplan' 리뷰 - 터미널 멈춤 없는 클라우드 플래닝(로컬 Plan Mode vs 클라우드 플래닝) 2026.04.09
-
Claude Code NO_FLICKER(깜빡임 없는 풀스크린 렌더링 모드) 리뷰 : 화면 깜빡임과 스크롤 점프가 정말 사라질까 2026.04.02
-
Claude Code 3월 폭풍 업데이트(v2.1.59~87 업데이트) 정리 - 한 달간 20개 릴리스, Auto Memory부터 1M 컨텍스트까지 2026.03.30
-
Claude Code 신기능 'claude code Scheduled Tasks' 리뷰 : 알아서 일하는 동료 AI: Claude Code /schedule로 업무 자동화 하기(Cowork 예약 vs Claude Code) 2026.03.27
소중한 공감 감사합니다