codex-fleet — Codex 워커를 함대처럼 양산하는 Claude Code 스킬

스킬 2종

골격은 같다. codex exec를 워커 풀로 묶어 PARALLEL 하나로 처리량을 정한다. 차이는 결과를 어떻게 회수하느냐다.

/codex-imagegen

gpt-image-2로 이미지를 대량생성한다. codex가 세션 폴더에 떨군 PNG를 회수하는데, 병렬일 때 워커끼리 결과를 채가는 레이스가 있어 claimed 락으로 1:1을 보장한다.

회수: ~/.codex/generated_images → 락 기반 회수 · 250 IPM

/codex-spawn

코드 수정·분석·요약·리뷰 등 임의 작업을 나눠 돌린다. 결과를 -o로 작업별 파일에 직접 받으므로 회수 레이스가 없다. --output-schema로 구조화 출력도 받는다.

회수: -o output-last-message → 파일 직행 · 격리 디렉토리/worktree

빠른 시작

Codex CLI 로그인 상태면 바로 된다. 스폰 수는 3~6에서 시작해 머신 부하와 429를 보며 올린다.

# 임의 작업 — tasks.jsonl = 한 줄당 {id, prompt, cwd?, schema?}
PARALLEL=4 TASKS=examples/tasks.jsonl SANDBOX=read-only \
  python3 runners/codex_spawn_runner.py

# 이미지 — manifest.jsonl = 한 줄당 {id, prompt, ar, size, output_path}
PARALLEL=3 PROMPTS=examples/manifest.jsonl OUTDIR=./out \
  python3 runners/codex_imagegen_runner.py

함정 모음

전부 한 번씩 밟아보고 정리한 것들이다.

회수 레이스 — 이미지 병렬에서 워커 A의 회수가 워커 B의 PNG를 채간다. claimed 집합 + 락으로 막는다.
자살 pkill — pkill -f codex_spawn_runner는 그 명령을 실행한 셸 자신을 죽인다. 프로세스를 한정해서 죽인다.
모더레이션 거부 — 우회하지 말고 표현을 톤다운하면 대개 통과한다.
파일 충돌 — 수정 작업을 격리 없이 같은 repo에 병렬로 돌리지 않는다. 디렉토리나 worktree로 나눈다.