Claude Code용 Codex 플러그인 (openai/codex-plugin-cc)
개요
codex-plugin-cc는 공식 OpenAI 플러그인으로, OpenAI Codex CLI를 Claude Code 개발자 워크플로우에 직접 통합합니다. 이를 통해 Claude Code 사용자는 Claude Code 인터페이스를 벗어나지 않고도 Codex 기반 코드 검토, 적대적 설계 과제 및 백그라운드 작업 위임 등을 트리거할 수 있습니다.
이 플러그인은 Anthropic의 Claude Code와 OpenAI의 Codex CLI라는 두 가지 강력한 AI 코딩 에이전트를 연결하여 "두 번째 의견"과 다중 에이전트 협업 워크플로우를 가능하게 합니다.
존재 이유
Claude Code는 훌륭한 에이전트 코딩 도구이지만, Codex를 함께 사용하려면 컨텍스트를 전환하고 별도의 도구를 수동으로 호출해야 했습니다. 이 플러그인은 이러한 마찰을 제거합니다.
- Codex는 상세하고 비판적인 코드 검토에 특히 강합니다.
- 동일한 코드에 대해 두 개의 독립적인 AI 모델을 실행하면 단일 모델보다 더 많은 문제를 발견할 수 있습니다.
- 사용자는 Claude Code를 기본 인터페이스로 유지하면서 특정 작업을 Codex에 위임할 수 있습니다.
요구 사항
| 요구 사항 | 세부 정보 |
|---|---|
| 인증 | ChatGPT 구독 (무료 등급 포함) 또는 OpenAI API 키 |
| Node.js | v18.18 이상 |
| Codex CLI | npm install -g @openai/codex를 통해 전역적으로 설치됨 |
사용량은 기존 Codex 사용량 제한에 포함됩니다.
설치
# 1. Claude Code 내에서 마켓플레이스 소스 추가
/plugin marketplace add openai/codex-plugin-cc
# 2. 플러그인 설치
/plugin install codex@openai-codex
# 3. 플러그인 다시 로드
/reload-plugins
# 4. 설정 확인
/codex:setup
Codex CLI가 설치되어 있지 않으면 /codex:setup은 npm을 통해 자동으로 설치할 수 있습니다.
핵심 명령
/codex:review
현재 커밋되지 않은 변경 사항 또는 브랜치 diff에 대한 표준 읽기 전용 Codex 코드 검토를 실행합니다.
/codex:review # 커밋되지 않은 변경 사항 검토
/codex:review --base main # main 브랜치 대비 검토
/codex:review --background # 백그라운드에서 실행 (대규모 diff에 권장)
사용 사례: 배포 전 무결성 확인, 다중 파일 변경 검토.
/codex:adversarial-review
표면적인 코드 스타일뿐만 아니라 구현 선택에 이의를 제기하는 조정 가능하고 의견이 있는 검토입니다. 가정, 절충, 실패 모드 및 대안적 접근 방식에 대해 질문합니다.
/codex:adversarial-review
/codex:adversarial-review --base main 캐싱 전략이 올바른지 여부에 대해 도전
/codex:adversarial-review --background 경쟁 상태 찾기
사용 사례: 배포 전 검토, 아키텍처 감사, 인증, 데이터 손실, 롤백 및 안정성과 관련된 설계 결정 스트레스 테스트.
/codex:rescue
백그라운드 하위 에이전트(codex:codex-rescue)로 Codex에 작업을 위임합니다. Codex는 버그를 조사하고, 수정 사항을 적용하거나, 이전 세션부터 계속 진행합니다.
/codex:rescue 테스트가 실패하기 시작한 이유 조사
/codex:rescue 가장 안전한 최소 패치로 실패한 테스트 수정
/codex:rescue --model gpt-5.4-mini --effort medium 불안정한 테스트 조사
/codex:rescue --background 회귀 조사
/codex:rescue --resume 마지막 실행에서 상위 수정 사항 적용
자연어를 사용할 수도 있습니다.
Codex에게 데이터베이스 연결을 더 탄력적으로 재설계하도록 요청합니다.
지원되는 플래그: --background, --wait, --resume, --fresh, --model, --effort
/codex:status
현재 리포지토리에 대해 실행 중이거나 최근 완료된 Codex 작업을 나열합니다.
/codex:status
/codex:status task-abc123
/codex:result
완료된 Codex 작업의 출력을 검색합니다. Codex CLI에서 직접 다시 열기 위한 Codex 세션 ID도 반환합니다.
/codex:result
/codex:result task-abc123
/codex:cancel
활성 백그라운드 Codex 작업을 취소합니다.
/codex:cancel
/codex:cancel task-abc123
/codex:setup
Codex 설치 및 인증 상태를 확인합니다. 선택적 검토 게이트도 관리합니다.
/codex:setup --enable-review-gate # 모든 Claude 응답을 Codex Stop 후크를 통해 자동 검토
/codex:setup --disable-review-gate
⚠️ 검토 게이트는 장기 실행 Claude/Codex 피드백 루프를 생성하고 사용량 제한을 빠르게 소진할 수 있습니다. 활성화 시 세션을 적극적으로 모니터링하십시오.
일반적인 워크플로우
1. 배포 전 검토
/codex:review
2. 어려운 문제 위임
/codex:rescue CI에서 빌드가 실패하는 이유 조사
3. 장기 실행 백그라운드 작업
/codex:adversarial-review --background
/codex:rescue --background 불안정한 테스트 조사
# 나중에 확인:
/codex:status
/codex:result
구성
이 플러그인은 ~/.codex/config.toml(사용자 수준) 또는 .codex/config.toml(프로젝트 수준)에서 Codex CLI 구성을 상속받습니다.
항상 xhigh 노력으로 gpt-5.4-mini를 사용하기 위한 예제 프로젝트 수준 구성:
model = "gpt-5.4-mini"
model_reasoning_effort = "xhigh"
사용자 지정 openai_base_url도 사용자 지정 API 엔드포인트에 대해 지원됩니다.
아키텍처
이 플러그인은 Codex 앱 서버를 래핑하고 모든 작업을 동일한 머신에 전역적으로 설치된 Codex CLI 바이너리에 위임합니다. 이는 다음을 의미합니다.
- 별도의 Codex 런타임이 도입되지 않습니다.
- 인증 상태는 기존 Codex 설치와 공유됩니다.
- 리포지토리 체크아웃 및 환경은 직접 Codex 사용과 동일합니다.
/codex:result의 결과에는codex resume <session-id>로 직접 다시 시작할 수 있는 세션 ID가 포함됩니다.
FAQ
Q: 별도의 Codex 계정이 필요합니까?
아니요. 머신에서 이미 Codex CLI에 로그인되어 있으면 플러그인이 해당 인증을 재사용합니다.
Q: 플러그인이 별도의 Codex 런타임을 사용합니까?
아니요. 기존 로컬 Codex CLI 및 앱 서버를 통해 위임합니다.
Q: 기존 API 키 또는 사용자 지정 기본 URL을 사용할 수 있습니까?
예. 플러그인은 openai_base_url을 포함한 Codex CLI 구성을 가져옵니다.
요약
codex-plugin-cc는 AI 코딩 도구 생태계에서 흥미로운 융합을 나타냅니다. 경쟁 제품(Claude Code)을 확장하기 위해 설계된 공식 OpenAI 도구입니다. Claude가 코드를 작성하고 반복하는 동안 Codex가 독립적인 조사를 제공하여 단일 모델이 놓칠 수 있는 문제를 발견하는 강력한 다중 에이전트 검토 워크플로우를 가능하게 합니다.