메뉴
OpenAI Codex CLI에 작업을 위임할 때 적용 — Claude가 막힌 뒤의 rescue 디버깅(three-turn 상한), cross-provider/보안 민감 리뷰, 최신 docs 웹 리서치, 또는 범위가 정해진/무인 구현. 모드와 플래그 선택, reasoning effort, rescue protocol, plan-stage review, 실행 메커니즘을 다룬다. Codex CLI가 PATH에 있을 때만 트리거할 것.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
executor(메인 세션 vs subagent vs team), 모델(Opus/Sonnet/Haiku), effort 레벨 중 무엇이 작업에 맞는지 정할 때 적용 — 즉 사소하지 않은 작업을 위임하기 전에. 다운그레이드 엄격 조건(plan 정밀도 + 검증 루프), 에스컬레이션 트리거, blast-radius 오버라이드, subagent 브리핑 기준을 다룬다.
Apply when deciding which executor (main session vs subagent vs team), which model (Opus/Sonnet/Haiku), and what effort level fits a task — i.e. before delegating non-trivial work. Covers strict downgrade conditions (plan precision + verification loop), escalation triggers, blast-radius override, and the subagent briefing standard.
장시간 작업이 백그라운드에서 돌고 사용자가 완료나 진행 상황을 봐야 할 때 적용 — 완료 알림만(기본), Monitor를 통한 이벤트 스트림, ScheduleWakeup을 통한 인터벌 폴링 중 선택. 서브프로세스를 tmux split pane, sentinel 문자열, foreground tail/grep 루프로 감시하고 싶어질 때도 적용 — 그 패턴은 실패했고 post-mortem이 여기 있다. 결정 사다리, 안티패턴, tee 기반 사용자 가시 스트리밍을 다룬다.
웹을 둘러보거나, 페이지 내용을 추출하거나, 데이터를 긁거나, 사이트에서 수치를 가져올 때 적용하세요 — agent-browser(기본 lightpanda, 무겁거나 상호작용이 필요한 페이지는 chrome), 발견용 WebSearch, 차단 본문 회수용 insane-search 스킬 중에서 고릅니다. agent-browser가 차단/빈/동적 콘텐츠를 돌려줘서 다른 엔진으로 재시도하거나 형제 URL을 추측하고 싶어지는 순간에도 적용 — 브라우저 에스컬레이션을 멈추고 검색 기반 도구로 전환하세요. Codex --search는 교차검증 전용 GPT 의존 최후 수단입니다.
Apply when a long-running task runs in the background and the user needs visibility into its completion or progress — choosing between completion-notification-only (default), streamed events via Monitor, and interval polling via ScheduleWakeup. Also apply when tempted to monitor a subprocess via tmux split panes, sentinel strings, or a foreground tail/grep loop — that pattern failed and its post-mortem lives here. Covers the decision ladder, anti-patterns, and tee-based user-visible streaming.
Apply when browsing the web, extracting page content, scraping data, or fetching figures from sites — choosing between agent-browser (lightpanda default, chrome for heavy/interactive pages), WebSearch for discovery, and the insane-search skill for retrieving blocked content. Also apply the moment agent-browser returns blocked/empty/dynamic content and you are tempted to retry with another engine or guess sibling URLs — stop escalating the browser and switch to a search-based tool. Codex --search is the GPT-dependent last resort for cross-provider verification only.
| name | codex-delegation |
| description | OpenAI Codex CLI에 작업을 위임할 때 적용 — Claude가 막힌 뒤의 rescue 디버깅(three-turn 상한), cross-provider/보안 민감 리뷰, 최신 docs 웹 리서치, 또는 범위가 정해진/무인 구현. 모드와 플래그 선택, reasoning effort, rescue protocol, plan-stage review, 실행 메커니즘을 다룬다. Codex CLI가 PATH에 있을 때만 트리거할 것. |
Applicability — 이 규칙은 OpenAI Codex CLI가 Claude Code와 함께 PATH에 있을 때 적용된다. Codex가 없으면
/review스킬은 단일 평가자 리뷰(Claude subagent만)로 fallback한다 — cross-provider generator-vs-evaluator 분리는 약해지지만, 아래 rules 측 정책은 여전히 Claude 측 작업에 적용된다.
Cross-provider 위임은 세 가지 목적에 쓰인다:
앞의 둘은 reliability routing을, 셋째는 capability routing을 동기 부여한다.
Codex 작업은 두 갈래로 들어온다. 요청된 방식에 맞춰 진입점을 고른다.
리뷰 → 항상 /review 스킬. 리뷰 부류 작업은 모두 /review(skills/review/SKILL.md)를 쓴다: 하나의 공유 산출물을 결정한 뒤 Claude subagent와 Codex 실행을 그 산출물에 병렬로 띄우고 evaluation-integrity.md §Multi-advisor synthesis에 따라 종합한다. 리뷰의 단일 진입점이다 — codex review나 /codex:review를 직접 부르지 마라.
그 외 → "이거 codex로 해줘" 자연어 위임. intent에 맞춰 신뢰 가능한 호출로 매핑한다. 세 경로 모두 codex-cli 0.128에서 검증됨:
/codex:rescue, 또는 Agent 도구의 subagent_type: "codex:codex-rescue". read-only, companion 런타임에서 돌고 완료 신호가 하네스에 배선되어 있다.codex exec. timeout을 하드닝하면 깨끗하게 exit한다(Codex 실행 메커니즘 참고).Footgun — Skill(codex:rescue)로 절대 부르지 마라. 스킬로 부르면 slash 커맨드가 재진입해서 세션이 hang된다. rescue는 /codex:rescue 커맨드 또는 Agent 도구의 subagent_type: "codex:codex-rescue"로만 호출한다. "Codex 위임이 멈췄다"의 통상적 원인은 망가진 런타임이 아니라 잘못된 진입점이다.
항상 xhigh. 모든 호출에 -c model_reasoning_effort=xhigh를 넘긴다.
--search, -a/--ask-for-approval, --dangerously-bypass-approvals-and-sandbox는 top-level 플래그이고 subcommand 앞에 온다. --sandbox, --full-auto, -c key=value는 exec subcommand 플래그이고 exec 뒤에 온다. 위치를 잘못 두면 error: unexpected argument '--ask-for-approval' found로 실패한다. codex --help와 codex exec --help로 확인하라.
codex [TOP-LEVEL FLAGS] exec [EXEC FLAGS] -- - < prompt
codex review [REVIEW FLAGS] # 설계상 read-only; --sandbox / -a 를 받지 않음
/review(리뷰)와 /codex:rescue(진단)가 아래 해당 행을 대체한다. 나머지 행 — 쓰기, 리서치, 범위가 정해진/무인 구현 — 은 그 intent의 정상 수동 codex exec 호출이다.
| Need | Invocation |
|---|---|
| 독립적 + 보안 민감 리뷰 | /review 스킬 |
| 세 번 실패 후 막힘 | codex exec --sandbox read-only -m gpt-5.5 -c model_reasoning_effort=xhigh |
| 최신 docs 또는 웹 리서치 | codex --search -a never exec --sandbox read-only -c model_reasoning_effort=xhigh |
| 범위가 정해진 구현(workspace 편집) | codex exec --full-auto -m gpt-5.5 -c model_reasoning_effort=xhigh |
| 무인 장시간 구현(workspace + 리서치) | codex --search -a never exec --sandbox workspace-write -c model_reasoning_effort=xhigh |
| 명시적 no-sandbox 실행(사용자가 명시적으로 요청할 때만) | codex --search --dangerously-bypass-approvals-and-sandbox exec -c model_reasoning_effort=xhigh |
편의를 위해 더 넓은 모드를 고르지 마라. 리서치에는 쓰기 권한이 필요 없다. 이미지 생성에는 ecosystem capability가 필요하지, no-sandbox 접근이 필요한 게 아니다. 의존성 설치, 외부 CLI, 사설 네트워크 호출은 별개의 요구사항이고 brief에 명시해야 한다.
막힌 문제에는 three-turn 상한. 같은 가설로 4번째 인라인 턴을 시도하지 마라. ruled-out 가설을 모두 포함해서 /codex:rescue(read-only)에 위임하라 — Three-Turn Rescue 프로토콜 참고.
보안 민감 변경에는 adversarial 리뷰. authentication, authorization, 데이터베이스 쓰기, 네트워크 경계, secret 처리, trust 경계를 건드리는 모든 동작 변경 뒤에는 /review를 호출한다. read-only 읽기나 순수 내부 리팩터링은 트리거하지 않는다. 리뷰어 페르소나 — 회의적, 보안 우선, 발견을 P0–P3로 분류, 높은 커버리지에서 critical 이슈가 없을 때만 VERDICT: SAFE를 반환 — 는 agents/adversarial-reviewer.md(~/.claude/agents/에 설치됨)에 있고, 스킬이 stdin으로 codex exec --json --sandbox read-only에 파이프한다(--json 이벤트 스트림 덕에 Claude가 codex 진행을 실시간으로 본다; /review 스킬 참조).
Capability routing은 첫 턴에 발동한다. 이미지 생성, TTS, 그 외 OpenAI 전용 도구 필요는 즉시 Codex로 라우팅한다. 결과물이 이미지나 오디오 산출물일 때 텍스트 기반 우회(ASCII 아트, 손으로 짠 SVG)에 턴을 낭비하지 마라.
/codex:rescue(또는 Agent 도구의 subagent_type: "codex:codex-rescue")에 넘긴다: 원래 작업, 시도한 각 가설과 실패 이유, 최소 재현 케이스, ruled-out 파일. companion 플러그인이 없으면 같은 내용을 stdin으로 넣어 codex exec --sandbox read-only ...로 fallback한다."turn"은 메시지 하나가 아니라 실질적 시도 하나다. 셋을 넘기면 한계 정보가 무너지고 anchoring bias가 굳어진다.
이 메커니즘은 수동 codex exec 경로(쓰기 / 리서치 / 범위가 정해진 구현, 그리고 companion 플러그인이 없을 때의 모든 실행)에 적용된다. /codex:rescue와 /review는 아래 관심사를 자체적으로 처리한다.
따로 관리할 관심사 세 가지:
run_in_background: true Bash를 쓴다; 하네스의 완료 알림이 Claude를 깨운다.tail -f 하게 둔다. 실시간 뷰를 Claude 쪽에서 스크립트로 짜지 마라.timeout <secs> codex …, 또는 coreutils 없는 macOS에서는 gtimeout; 둘 다 없으면 우아하게 degrade). 만료되면 codex는 124로 exit한다 — exit status를 읽고 timeout을 깨끗한 결과가 아니라 codex 사용 불가로 다룬다. 그냥 timeout은 직계 자식에게만 신호를 보낸다; codex(node)가 pipe를 쥔 손자 프로세스를 남기면 | tee가 EOF를 못 받아, codex가 죽은 뒤에도 백그라운드 작업이 hang된다. 완료 시점에 멈추면 kill-after grace(gtimeout -k 10 <secs> …)를 쓰고 | tee 대신 파일로 리다이렉트(> "$LOG" 2>&1)하라.LOG="/tmp/codex-$(date +%Y%m%d-%H%M%S).log"
Bash(
run_in_background: true,
command: "<codex invocation> 2>&1 | tee '$LOG'"
)
# 백그라운드 작업이 끝나면 "$LOG"를 Read 한다.
sentinel 없이, Claude 쪽 tail -f 없이, split pane 없이. 이전 래퍼가 왜 실패했는지는 background-task-monitoring 스킬(§"교훈 — tmux sentinel wrapper는 실패했다") 참고.
Stdin-piping 호출(exec, review)은 프롬프트를 stdin으로 받는다. 먼저 temp 파일에 쓰고 리다이렉트하라:
PROMPT="$(mktemp)"
command cat > "$PROMPT" <<'EOF'
<reviewer prompt or task brief>
EOF
Bash(run_in_background: true, command: "codex exec ... -- - < '$PROMPT' 2>&1 | tee '$LOG'")
두 리뷰어 리뷰는 코드를 쓰기 전에도 가치 있다. 산출물이 diff가 아니라 plan일 때다. 구현이 시작되면 되돌리기 비싼 설계 결정을 잡아낸다.
효과를 보는 경우: plan이 여러 파일 / 새 모듈 / 새 추상화를 건드릴 때; planner가 직접 검증하지 않은 프레임워크나 라이브러리 API에 의존할 때; 구현이 충분히 커서 중간에 버리는 비용이 클 때(≥ 1 PR 또는 ≥ 수백 줄).
건너뛸 경우: 모양이 뻔한 한두 파일 편집, 또는 탐색적("X 해보고 어떻게 되나 보자")인 경우.
포맷: VERDICT: PLAN_APPROVED | REVISE_PLAN (SAFE | NEEDS_CHANGES가 아님 — 그건 diff 리뷰 verdict다). 발견은 P0–P3로 분류한다.
Plan 리뷰는 권고이지 차단이 아니다. PR 단계 리뷰는 여전히 필수다. 수정할지 진행할지는 사용자가 정한다.
Anti-patterns: stale-revision 리뷰(아래 Cross-Provider Rules 참고); ~3을 넘는 라운드 부풀리기(plan 주인이 수렴 못한 것 — 대신 사용자와 목표를 명확히 하라); 권고를 차단으로 다루기.
/review를 건너뛰지 마라.file head -1, git HEAD short SHA, 또는 고유한 헤더 줄)를 echo하게 하라. 이미 바뀐 파일의 stale 줄 번호를 재현하는 verdict는 신뢰하지 않는다; fresh 세션으로 재시도하라(codex resume 아님).