Menu
Claude + OpenAI Codex 협업 스킬. MCP 서버 설정 시에만 사용 가능.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
세션 핸드오프. 컨텍스트가 차기 전에 중요 맥락을 progress.md에 문서화하고 새 세션 킥오프 프롬프트를 클립보드에 복사한다. "핸드오프", "세션 정리하고 넘기자", "컨텍스트 정리", "이어갈 준비" 등의 요청에 사용.
MD 파일 또는 텍스트로 작업을 정의하면, 분석 → 디자인 확인 → 구현 → 검증 → 커밋 → PR까지 전체 플로우를 수행한다. "이거 만들어줘", "기능 구현해줘", "작업 시작하자", "이 티켓 진행해줘" 등 코드 작업 착수 발화에 사용.
code-forge 상태 대시보드. REFLECT flag, quality 이벤트, notepad/decisions, usage 집계를 한 번에. forge-glow 같은 외부 도구는 --json으로 파싱.
교차 모델 토론. Agent Teams / Codex CLI / self-debate 모드 선택. 설계 결정, 아키텍처 선택 시 활용. "어느 쪽이 나을까", "설계 비교해줘", "토론시켜줘", "교차 검증해줘" 등의 요청에 사용.
화면 단위 E2E 테스트 자동화. Figma/코드 기반 테스트 케이스 도출 → Playwright 코드 생성 → Forge Loop(에스컬레이션 기반 자율 실행). "E2E 돌려줘", "화면 테스트 만들어줘", "이 페이지 자동 테스트" 등의 요청에 사용.
테스트 통합 진입점. 변경 파일을 분석하여 유닛/E2E/세팅을 자동 라우팅. "테스트 돌려줘", "TC 작성해줘", "테스트 추가해줘", "이 파일 테스트 해줘" 등의 요청에 사용.
| name | codex |
| description | Claude + OpenAI Codex 협업 스킬. MCP 서버 설정 시에만 사용 가능. |
| category | utility |
Claude + OpenAI Codex 협업 스킬. MCP 서버 설정 시에만 사용 가능. OpenAI 공식 codex 플러그인(
/codex:review등)과의 역할 분리:docs/codex-coexistence.md
이 스킬은 codex MCP 서버가 설정된 경우에만 사용 가능합니다.
스킬 실행 시 아래 순서로 확인한다:
mcp__codex__codex 도구가 사용 가능한가? → MCP 모드로 진행which codex 실행 가능한가? → CLI Headless 모드로 진행Codex가 설정되어 있지 않습니다.
설정 방법은 docs/codex-mcp-setup-guide.md 를 참조하세요.
빠른 설정:
1. codex CLI 설치: brew install openai-codex
2. 인증: codex login
3. .mcp.json에 MCP 서버 등록
4. Claude Code 재시작
설정 가이드: @${CLAUDE_PLUGIN_ROOT}/docs/codex-mcp-setup-guide.md
설정 미완료 시 → 위 안내를 표시하고 스킬을 종료한다. 자동으로 설치를 강요하지 않는다.
| 도구 | 용도 | 주요 파라미터 |
|---|---|---|
codex | 새 작업 시작 | dir, session_id, model, reasoning_effort |
codex_reply | 기존 세션 이어서 작업 | session_id, 이전 컨텍스트 유지 |
codex_review | 코드 리뷰 | uncommitted 변경, 브랜치, 특정 커밋 |
list_sessions | 활성 세션 목록 | - |
ping | 서버 상태 확인 | - |
Claude가 구현하고, Codex가 리뷰한다. 1-2개 파일 변경에 적합.
Claude: 코드 구현
↓
Codex (codex_review): 코드 리뷰, 엣지케이스 검증
↓
Claude: 피드백 반영
적합한 경우:
Claude가 설계하고, Codex가 구현 + 테스트한다.
Claude: 아키텍처 설계, 인터페이스 정의
↓
Codex (codex): 구현 + 테스트 작성
↓
Claude: 결과 검증, 통합
적합한 경우:
Claude와 Codex가 서로 다른 파일을 동시에 작업한다.
Claude: 창의적/아키텍처 작업 (컴포넌트 설계, 상태 관리)
Codex (codex): 정밀 작업 (유틸 함수, 타입 정의, 테스트)
적합한 경우:
| 역할 | Claude | Codex |
|---|---|---|
| 아키텍처 설계 | O | - |
| 창의적 문제 해결 | O | - |
| 꼼꼼한 구현 | - | O |
| 엣지케이스 검증 | - | O |
| 코드 리뷰 | O | O |
| 테스트 작성 | O | O |
| 금지 | 이유 |
|---|---|
| MCP 미설정 상태에서 사용 | 도구 없이 시뮬레이션 금지 |
| 동일 파일 동시 수정 | 충돌 방지 |
| Codex 출력 무검증 수용 | 반드시 결과 확인 후 반영 |
| MCP 미설정 사용자에게 설치 강요 | opt-in 원칙 |
| 필수 | 기준 |
|---|---|
| MCP 상태 확인 | 작업 전 ping으로 연결 확인 |
| 세션 관리 | 작업 완료 시 세션 정리 |
| 결과 검증 | Codex 출력은 반드시 검토 후 반영 |
| 파일 충돌 방지 | 동시 수정 파일 명확히 분리 |
1. Claude: 컴포넌트 구현
2. codex_review: 변경사항 리뷰 요청
3. Claude: 리뷰 피드백 반영
4. 완료
1. Claude: 인터페이스/타입 설계, 파일 구조 결정
2. codex: "다음 인터페이스에 맞게 구현해줘" + 설계 내용 전달
3. codex_reply: 추가 요구사항 전달 (필요 시)
4. Claude: 결과 검증, lint/build 확인
5. 완료
| 에러 | 원인 | 해결 |
|---|---|---|
| 401 Unauthorized | 인증 만료 | codex login 재실행 |
| 세션 실패 | 세션 손상 | 새 세션으로 시작 |
| MCP 연결 실패 | 서버 미실행 | MCP 서버 재시작 |
| 도구 미발견 | MCP 미등록 | .claude/settings.json 확인 |
general-purpose 타입으로 spawn 후 이 스킬을 읽도록 프롬프트에 지시agents/codex.md (Team Lead 역할 포함)| 문서 | 용도 |
|---|---|
agents/codex.md | Codex 에이전트 정의 (Team Lead 역할) |
@${CLAUDE_PLUGIN_ROOT}/instructions/multi-agent/coordination-guide.md | 역할별 필수 참조 파일, 팀 템플릿 |
@${CLAUDE_PLUGIN_ROOT}/instructions/multi-agent/teammate-done-process.md | Agent Teams 팀원 완료 프로세스 |