Codex OAuth로 시작하기 (가장 먼저 읽을 것)

이 스킬의 핵심 아이디어: OpenAI API 키 없이, ChatGPT 구독(Plus/Pro)만으로 돌아간다.

내부적으로  codex responses  서브커맨드를 통해 당신의 OAuth 세션을 재사용합니다. 결과적으로:

• 키 관리 안 함 · 별도 billing 없음 · ChatGPT 쿼터 안에서 돌아감
• gpt-5.5  멀티모달 분석 +  image_generation  툴 5회 병렬 호출 → 13섹션 자동 생성 (rollout 중인 ChatGPT 티어라면  SANGPYE_MODEL=gpt-5.4 로 폴백)
• 보통 5~10분 소요 (한가할 땐 ~5분, ChatGPT 서버가 혼잡하면 최대 15분). 재시도 로직이  server overloaded / rate_limit 를 자동으로 흡수합니다.

# 1. codex CLI 최신 버전 (>= 0.121.0)
npm install -g @openai/codex@latest
codex --version   # codex-cli 0.123.0 또는 이상

# 2. ChatGPT OAuth 로그인 (API 키 아님!)
codex login       # 프롬프트에서 "Sign in with ChatGPT" 선택

# 3. CODEX_API_KEY 미설정 (OAuth를 덮어씀)
echo "${CODEX_API_KEY:-<unset>}"     # <unset> 이어야 함

OPENAI_API_KEY 는  codex responses 가 런타임에서 무시합니다. 쉘에 있어도 상관없음. 오직  CODEX_API_KEY 만 OAuth를 덮어씁니다.

macOS / Linux / WSL

curl -fsSL https://raw.githubusercontent.com/NewTurn2017/codex-sangpye-skill/main/install.sh | bash

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/NewTurn2017/codex-sangpye-skill/main/install.ps1 | iex

스크립트가 하는 일:

1. uv ,  codex >= 0.121.0 , OAuth 로그인 상태 검증
2. uv tool install  로  sangpye  CLI 글로벌 설치
3. SKILL.md 를  ~/.claude/skills/codex-sangpye/ 에 드롭 (Claude Code 스킬 자동 인식)
4. smoke check

스크립트를 먼저 읽고 싶으면 install.sh / install.ps1를 확인하세요. 재실행 안전 (idempotent).

sangpye \
  --image ./your_product.jpg \
  --prompt "무선 이어폰, ANC 탑재, 30시간 배터리, IPX5 방수" \
  --category electronics \
  --output ./out