Menü
Claude + OpenAI Codex 협업 스킬. MCP 서버 설정 시에만 사용 가능.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
세션 핸드오프. 컨텍스트가 차기 전에 중요 맥락을 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 팀원 완료 프로세스 |