이미지 생성
OpenAI GPT Image 2를 통해 이미지를 생성합니다. 인증은 Codex CLI가 ChatGPT 계정으로 로그인된 상태에서 이루어지므로 생성 비용은 사용자의 Plus 구독에 포함됩니다. OpenAI API 키가 필요 없으며 이미지당 별도 API 요금이 부과되지 않습니다.
시작하기 전에
이 스킬은 OpenAI에 직접 연결되지 않습니다. Codex CLI를 통해 실행되며, 해당 CLI가 이미 이 머신에 설치되어 있고 ChatGPT 계정(활성 Plus 구독 필요)으로 로그인되어 있어야 합니다. codex --version으로 확인하고, 로그인되어 있지 않다면 codex login을 실행하세요. 붙여넣을 API 키는 없으며 이미지당 별도 요금도 없습니다. 모든 이미지는 해당 구독으로 청구됩니다.
Codex CLI가 로그인되어 있지 않으면 아무것도 작동하지 않으며, 스크립트는 파일을 생성하지 않고 첫 번째 호출에서 실패합니다.
빠른 시작
# 이 스킬의 디렉토리(에이전트가 설치한 위치)에서 실행
./scripts/generate-image.sh "선글라스를 낀 시바견, 스튜디오 사진"
결정된 출력 폴더(아래 참조)에 슬러그화된 PNG로 저장됩니다. 예: assets/images/선글라스를-낀-시바견-스튜디오-사진.png.
워크플로우
- 사용자의 요청을 강력한 영어 프롬프트로 변환합니다. 반드시 PROMPTING.md의 구성 순서와 조정 항목을 따르세요(장면 → 주제 → 세부사항 → 불변 조건 → 활용). 에셋이 중요한 경우 모호한 요청은 호출 전에 구체화하세요. 한 줄짜리 프롬프트를 그대로 전달하지 마세요.
- 프롬프트와 함께 스크립트를 실행합니다. 선택적으로
--out과--name을 전달할 수 있습니다. - 저장된 경로를 사용자에게 알려줍니다. 변경이 필요한 경우 작은 단일 변수 단계로 반복하고 불변 조건을 다시 명시합니다(PROMPTING.md 참조).
출력 위치
--out이 지정되지 않으면 스크립트가 자동으로 폴더를 결정합니다:
| 조건 | 대상 폴더 |
|---|---|
./public/ 존재 (웹/앱 프로젝트) | ./public/images/ |
| 그 외 | ./assets/images/ (없으면 생성) |
이렇게 하면 웹 프로젝트(이미지가 제공되려면 public/ 아래에 있어야 함)를 존중하면서 프로젝트 전반에 걸쳐 일관된 assets/images/ 규칙이 설정됩니다.
옵션
| 플래그 | 효과 |
|---|---|
--out <dir> | 자동 결정된 기본값 대신 이 디렉토리에 쓰기 |
--out <file>.png | 이 정확한 파일 경로에 쓰기 |
--name <basename> | 프롬프트를 슬러그화하는 대신 이 기본 이름 사용 |
기존 파일은 절대 덮어쓰지 않습니다. 대신 -2, -3, ...을 추가합니다.
결과물 이름 지정
이 출력물은 작업 에셋이므로 기본적으로 짧은 기능적 이름을 갖습니다. 이미지가 이해관계자에게 전달되는 산출물인 경우 파일 이름 규칙을 따라 명시적으로 --name을 전달하세요. 예: --name "20260612_Hero Banner_v1".
요구 사항
codexCLI 설치 (brew install --cask codex)- ChatGPT 계정으로 로그인:
codex login(Plus 이상; 이미지 생성은 Free 플랜에서 사용 불가)
스크립트는 두 가지를 모두 확인하고 누락된 경우 명확한 메시지와 함께 실패합니다.