새소식

300x250
AI/Claude

openai/codex-plugin-cc(Claude Code용 공식 Codex 플러그인) : Claude가 코딩하고 Codex가 리뷰한다

  • -
728x90

안녕하세요! 갓대희 입니다.

 
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 메커니즘, 소스코드 아키텍처, 제한사항을 증거 기반으로 분석하고, 크로스벤더 에이전트 협업이 개발 생태계에 미치는 의미를 짚어 보려 한다.

 

목차

  1. 소개 + 왜 주목하는가
  2. 설치 및 시작하기
  3. 주요 명령어 상세 (7개)
  4. 기술 아키텍처 분석
  5. 소스코드 핵심 분석
  6. 활용법 / 통합 방법
  7. 사용 예시
  8. 제한사항 및 주의사항
  9. 트러블슈팅 Q&A
  10. 결론 — 도입 결정 매트릭스 + 크로스벤더 에이전트 협업의 의미

 

1. 소개 + 왜 주목하는가

OpenAI가 자사 Codex를 경쟁사 플랫폼인 Claude Code 위에서 동작하도록 공식 플러그인을 만들었다는 사실 자체가 이례적이다.

openai 조직 하의 공식 리포지토리이며, marketplace.json에 owner가 "OpenAI"로 명시되어 있고 버전은 1.0.0이다.

 

핵심 가치는 두 가지다.

  1. 코드 리뷰 위임 — Claude Code에서 작업하면서 Codex에 리뷰를 맡긴다. reviewadversarial-review 두 가지 모드를 제공한다. review는 표준 코드 리뷰(버그·스타일 점검)를, adversarial-review는 설계 결정을 도전적으로 질문하는 심층 리뷰를 수행한다.
  2. 작업 위임(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)이 프롬프트에 정의되어 있다:

  1. 인증, 권한, 테넌트 격리, 신뢰 경계 (Authentication, permissions, tenant isolation, trust boundaries)
  2. 데이터 손실, 오염, 중복, 비가역 상태 변경 (Data loss, corruption, duplication, irreversible state changes)
  3. 롤백 안전성, 재시도, 부분 실패, 멱등성 갭 (Rollback safety, retries, partial failure, idempotency gaps)
  4. 레이스 컨디션, 순서 가정, 스테일 상태, 재진입 (Race conditions, ordering assumptions, stale state, re-entrancy)
  5. 빈 상태, null, 타임아웃, 의존성 저하 동작 (Empty-state, null, timeout, degraded dependency behavior)
  6. 버전 스큐, 스키마 드리프트, 마이그레이션 위험, 호환성 회귀 (Version skew, schema drift, migration hazards, compatibility regressions)
  7. 관찰성 갭 (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> — 모델 선택. sparkgpt-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 sparkgpt-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의 사용자 레벨 또는 프로젝트 레벨 설정을 따른다. sparkgpt-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들을 조합하느냐"가 개발 워크플로우의 핵심 질문이 될 가능성이 있다.

 

도입 플레이북

  1. 오늘: /codex:setup으로 설치 + 인증 확인. 개인 사이드 프로젝트에서 /codex:review 시험.
  2. 이번 주: adversarial-review와 rescue를 병행 테스트. --effort 옵션별 비용/품질 체감 비교.
  3. 운영 반영 판단: 오픈 이슈 해결 추이와 커밋 히스토리를 모니터링한 후 결정. 극초기 프로젝트(2커밋, 10여 이슈 — 2026-03-31 GitHub API 기준, 변동 가능)이므로 안정성이 검증된 뒤 반영하는 것이 권장된다.

 

마무리

300x250
Contents

포스팅 주소를 복사했습니다

이 글이 도움이 되었다면 공감 부탁드립니다.

💡 AI 관련 질문이 있나요? 눌러보세요!