ChatGPT Images for Claude
Claude가 프롬프트를 작성하고, Codex가 픽셀을 만들며, 스크립트가 사양에 맞게 가공하고, Claude가 확인한 후, 최종 파일은 사용자가 선택한 폴더에 저장됩니다. 사용자는 모든 프롬프트를 HTML 미리보기에서 승인한 후에야 생성이 시작되며, 채팅을 통해 변경을 요청할 수 있습니다. 네 개의 스크립트가 기계적인 작업을 수행합니다. 이 스크립트들은 이 파일과 같은 디렉토리의 scripts/ 폴더에 있습니다. 아래에서 $SKILL_DIR은 이 SKILL.md가 포함된 폴더를 의미합니다.
| 스크립트 | 역할 |
|---|---|
scripts/codex_generate.sh | codex exec 호출 한 번으로 내장 image_gen 도구를 사용해 원시 PNG를 폴더에 생성합니다. 이미지당 약 1~2.5분 소요. |
scripts/finish_image.py | 크기, DPI, 여백, 맞춤, 배경, 업스케일, 형식을 결정적으로 적용합니다. 절대 덮어쓰지 않습니다. |
scripts/make_preview.py | 매니페스트 기반의 읽기 전용 HTML 승인 페이지를 만듭니다. 실행 중에는 실시간 결과 페이지가 됩니다. file:// 프로토콜로 열리며 서버가 필요 없습니다. |
scripts/batch_generate.py | 승인된 매니페스트(1개 또는 여러 작업)를 실행합니다. 생성+보정을 2개씩 병렬로 처리하며, 중단 후 재개 가능합니다. |
분할한 이유: 내장 image_gen 도구는 자체 픽셀 크기(약 1.5MP, 예: 4:5 비율에서 1122x1402)를 선택하며 정확한 여백을 유지하지 않습니다(2인치 하단 여백 요청 시 약 1.25인치로 생성됨). 따라서 프롬프트는 종횡비와 구도만 설정합니다. 모든 정확한 수치(크기, DPI, 여백, 형식)는 finish_image.py가 강제합니다.
요구 사항
- Codex CLI가 ChatGPT 계정으로 로그인되어 있어야 하며, 이미지 생성을 지원하는 요금제(Free 요금제 제외)에 가입되어 있어야 합니다. 스크립트는 다음 순서로 Codex를 찾습니다:
$CODEX_BIN,PATH상의codex, ChatGPT 데스크톱 앱에 번들된 버전(macOS:/Applications/ChatGPT.app/Contents/Resources/codex-cli/bin/codex, 이전 앱 버전:Resources/codex). 찾을 수 없으면 종료 코드 3과 함께 메시지를 출력합니다. 사용자에게 ChatGPT 앱 또는 Codex CLI 설치를 안내하거나CODEX_BIN을 설정하도록 하세요. - Python 3와 Pillow 라이브러리(
python3 -m pip install Pillow). - Codex에 포함된
imagegen시스템 스킬 (${CODEX_HOME:-$HOME/.codex}/skills/.system/imagegen/).
수집할 입력
요청에서 가져옵니다. 작업을 막는 항목만 질문하고 나머지는 기본값을 사용하며 그렇게 알립니다.
| 입력 | 기본값 |
|---|---|
| 만들 내용 / 프롬프트 | 필수. |
| 기본 폴더 | 필수. 주어지지 않으면 질문 ("파일 저장 위치" 참조). |
| 이미지 위 텍스트 | 없음. 모든 텍스트는 글자 단위로 확인됩니다(8단계). |
| 크기 | references/output-options.md의 프리셋, 또는 WxH px, 또는 WxHin/WxHmm (인쇄용). 없음 = 원본 크기 유지. |
| 해상도 | 인쇄 크기는 300dpi, 화면 크기는 72dpi. |
| 여백 | 0. px, in, mm, 짧은 변 기준 % 를 허용하며 CSS 순서(상 우 하 좌)로 1~4개 값 사용. |
| 맞춤 | contain (전체 이미지 표시, 여백 채움). cover는 채우고 자름. |
| 배경(여백 색상) | auto (이미지 모서리에서 샘플링). 또는 hex, white, transparent. |
| 형식 | PNG. 소셜용 사진은 JPG, 인쇄용 핸드오프는 PDF, 웹용은 WebP. |
| 변형 | 1개. 각 변형은 별도 생성(1~2.5분 소요, ChatGPT 요금제 할당량 차감). |
| 참조 / 편집 이미지 | 없음. 모든 이미지 파일 사용 가능("소스 이미지" 참조). |
배치 크기: 모든 이미지 수가 가능합니다. 4개를 초과하면 미리보기 전달 시 개수와 예상 시간을 알립니다. ChatGPT 요금제의 이미지 생성 한도는 공개되지 않았으며 변동될 수 있습니다.
소스 이미지
모든 이미지 파일은 프롬프트와 함께 두 가지 역할 중 하나로 전송될 수 있습니다: 참조(초상, 로고, 스타일; 여러 개 허용, 매니페스트에서 refs) 또는 편집 대상(요청된 부분만 변경, 나머지는 유지; edit).
사용자가 이름을 지정했거나, 사용자가 가리키는 프롬프트 문서가 이름을 지정한 이미지만 사용하세요. 폴더를 검색하여 직접 이미지를 선택하지 마십시오. 프롬프트에 "첨부", "참조 사진", "정확한 초상", "로고 재현" 등과 같은 표현이 있지만 파일이 지정되지 않은 경우, 미리보기를 만들기 전에 어떤 파일인지 물어보세요. 지정된 경로에 파일이 존재하지 않으면 그렇게 말하고 물어보세요. 유사한 이미지를 대체하지 마십시오. 미리보기에는 전송되는 모든 이미지의 썸네일이 표시되므로 사용자가 프롬프트와 함께 확인할 수 있습니다. refs와 edit에는 절대 경로를 사용하세요.
파일 저장 위치
기본 출력 폴더는 없습니다. 사용자가 기본 폴더를 선택합니다. 사용자가 이름을 지정하지 않았고, 가리키는 프롬프트 문서에도 명시되지 않은 경우, 미리보기를 작성하기 전에 질문하세요(AskUserQuestion 사용 가능). 현재 프로젝트에서 2~3개의 예상 폴더(기존 exports, assets, images 또는 print 폴더)를 제안하고 사용자가 선택하거나 다른 폴더를 입력하도록 하세요. 절대 자동으로 선택하지 마십시오.
기본 폴더 내부의 레이아웃은 다음과 같이 고정됩니다:
<base folder>/
<name>-<preset>.jpg ... 완성된 파일
codex-raw/
<set>.json 매니페스트 (생성할 항목)
<set>.preview.html 승인 페이지
<set>.status.json 배치 진행 상황
<name>.png ChatGPT에서 받은 원본 (보관)
<name>.prompt.txt 전송된 정확한 프롬프트
<name>.codex/ Codex 명령어, JSON 로그, 마지막 메시지
파일 이름은 케밥 케이스로 <project-slug>-<subject> 형식으로 지정합니다(예: acme-bakery-spring-poster). 어떤 파일도 덮어쓰지 않습니다. 중복 시 -v2, -v3가 추가됩니다.
Codex는 또한 각 이미지의 자체 복사본을 ${CODEX_HOME:-$HOME/.codex}/generated_images/에 보관합니다. ChatGPT 앱에 자체 작업 공간 폴더가 있는 경우(테스트된 설정에서는 ~/Documents/Codex/) 그대로 둡니다.
워크플로우
모든 실행(단일 이미지 포함)은 매니페스트 → 미리보기 → 승인 → 생성 순서로 진행됩니다. 사용자가 승인하기 전까지는 Codex로 전송되지 않습니다.
-
컨텍스트 로드. 기본 폴더를 결정합니다(위 설명대로 질문). 프로젝트에 브랜드 문서(브랜드 가이드라인, 스타일 가이드, 디자인 토큰)가 있으면 프롬프트를 작성하기 전에 색상, 글꼴 및 음성을 읽습니다. 프로젝트나 사용자가 이미지 내 텍스트에 대해 설정한 작성 규칙을 따릅니다.
-
프롬프트 작성.
${CODEX_HOME:-$HOME/.codex}/skills/.system/imagegen/SKILL.md의 레이블이 지정된 스키마(사용 사례, 자산 유형, 주제, 스타일, 구성, 조명, 팔레트, 텍스트(그대로), 제약 사항, 피해야 할 사항)와references/prompting.md를 따릅니다. 규칙:- 종횡비와 방향을 단어로 명시합니다("세로 4:5").
- 여백이나 인쇄 여백의 경우 넉넉한 균일한 여유 공간을 요청하고, 절대 인치나 픽셀을 요청하지 마십시오. 정확한 여백은 나중에
trim+padding으로 적용됩니다. - 모든 이미지 내 단어를 인용하고 "다른 단어, 문자, 로고 또는 워터마크 없음"이라고 말합니다.
- 사진 + 텍스트 오버레이: 두 레이어(전체 프레임 사진과 텍스트를 담은 삽입 그래픽 레이어)를 설명합니다. "중앙 70% 내에 맞추기"라고 쓰지 마십시오. 이미지 모델이 전체 그림을 축소하기 때문입니다.
- 참조 이미지가 첨부된 경우, 각 이미지의 용도(일치시킬 초상, 정확히 재현할 로고, 스타일만 참조)를 프롬프트 시작 부분에 명시합니다.
- 사용자의 상세 프롬프트는 정규화하고 꾸미지 마십시오.
-
매니페스트 작성을
<base>/codex-raw/<project-slug>-<set>-<YYYY-MM-DD>.json에 합니다. 형식은scripts/batch_generate.py의 독스트링에 있습니다:defaults(종횡비, finish 목록) +jobs(이름, 프롬프트, 선택적 종횡비, refs, edit, transparent, finish). Finish 항목은 모든finish_image.py플래그(프리셋, 크기, dpi, fit, padding, trim, bg, upscale, format, quality)를 받습니다. 전체 목록은references/output-options.md에 있습니다. 작업당 여러 개의 finish 항목이 있으면 하나의 생성에서 여러 파일이 나옵니다. 프리셋 이름이 파일 접미사가 됩니다(suffix설정 가능). 하나의 아이디어에 대한 변형은 별도 작업(-a,-b이름)입니다. -
미리보기를 만들고 전달합니다.
python3 "$SKILL_DIR/scripts/make_preview.py" "<manifest>" --raw-dir "<base>/codex-raw" --final-dir "<base>" --title "<Project name>"그런 다음 인쇄된
.preview.html을 사용자의 브라우저에서 엽니다(macOS는open, Linux는xdg-open). 페이지는 읽기 전용입니다: 모든 프롬프트, 출력물, 참조 썸네일 및 두 폴더. 사용자에게 전체 경로, 이미지 수 및 예상 시간(이미지당 약 1.5분, 동시성 2에서 절반)을 알리고 멈춥니다. 4개 초과 이미지: 개수와 시간을 명시적으로 말합니다. 미리보기 승인이 옵트인입니다. 미리보기를 편집 가능하게 만들지 마십시오. -
"go" 또는 변경 요청을 기다립니다. 변경 사항은 채팅으로 옵니다("텍스트를 흰색으로"): 매니페스트를 업데이트하고, 미리보기를 다시 빌드하고(같은 명령어, 페이지 덮어쓰기), 다시 열고, 다시 기다립니다. "go"(또는 명확한 동등 표현)만 생성이 시작됩니다.
-
생성 및 보정.
python3 "$SKILL_DIR/scripts/batch_generate.py" "<manifest>" --raw-dir "<base>/codex-raw" --final-dir "<base>" --concurrency 2한두 개 이미지: 포그라운드에서 긴 타임아웃(10분)으로 실행합니다. 더 많은 이미지: 백그라운드에서 실행합니다. 동시성 2 초과는 사용자가 요청한 경우에만 허용하며 최대 4입니다. 진행 상황은
<manifest-stem>.status.json에 저장됩니다. 동일한 명령어를 다시 실행하면 완료된 작업을 건너뛰고 재개됩니다.--dry-run은 매니페스트의 유효성을 검사하고 작업을 나열하기만 하고 생성하지 않습니다.실시간 결과: 배치가 작업을 시작하거나 완료할 때마다 미리보기 페이지를 다시 빌드합니다. 각 카드에는 상태 배지, 생성된 원본, 완성된 파일(이미지는 썸네일, PDF/TIFF는 링크) 및 모든 경고가 표시되며, 작업이 대기 중이거나 실행 중인 동안 페이지는 15초마다 자동 새로고침됩니다. 사용자가 승인한 복사본에는 자동 새로고침이 없으므로 배치를 시작한 직후 미리보기 페이지를 다시 열어 실시간 버전을 확인할 수 있도록 하세요. 각 카드는 위에서 아래로 읽습니다: 프롬프트, 출력(이미지, 각 파일의 유형, 크기, 해상도 및 파일 크기), 그리고 파일 및 링크. 모든 파일과 폴더(참조, 계획된 파일 및 완성된 파일, 원본, Codex 로그, 배치 폴더, 매니페스트 및 페이지)에는 경로 복사 버튼이 있습니다. 전체 경로는 로드 시 "전체 경로" 스위치 뒤에 숨겨집니다. Finder에서 열기 링크는 없습니다. 브라우저는 file:// 링크만 열 수 있습니다.
- 종료 코드 4(
IMAGEGEN_UNAVAILABLE: 요금제 한도, 중단, 또는 내장 도구 누락)는 배치를 중단합니다. 유료 API 대체(scripts/image_gen.pyin Codex imagegen skill)는OPENAI_API_KEY가 필요하며 비용이 발생합니다. 사용자에게 질문하고 절대 스스로 전환하지 마십시오. - 종료 코드 3: Codex CLI를 찾을 수 없음. 사용자에게 알립니다(요구 사항 참조).
- 종료 코드 4(
-
모든 원시 이미지를 Read로 확인합니다.
-
텍스트를 요청한 문구와 글자 단위로 확인합니다: 철자, 추가 또는 누락된 단어, 잘못된 문자, 가짜 레이블 또는 서명. 또한 참조 이미지와의 초상 일치도, 로고 충실도, 구도, 피해야 할 목록을 확인합니다. 오류가 있으면 매니페스트에서 해당 작업의 프롬프트를 수정(예: 단어를 문자별로 철자)하고
--redo <name>으로 다시 실행합니다. 2회 재시도 후에도 틀리면 중지하고 사용자에게 보여줍니다. 디자인 도구에서 더 빨리 수정할 수 있는 사소한 결함(예: 제품 레이블의 가짜 텍스트): 보고하고 재생성하지 마십시오. -
완성된 파일 확인(Read로 이미지 확인; PDF의 경우
pdfinfo로 페이지 크기 확인 가능). 여백이 올바르게 적용되었는지,cover가 중요한 부분을 자르지 않았는지 확인합니다. 배치 보고서를 읽습니다:WARNING: source enlarged는 세부 정보가 보간되었음을 의미합니다. 인쇄용으로 1.5배 초과 업스케일이거나 사용자가 선명하게 원하는 경우, AI 업스케일을 제공하고(사용자가 사용하는 도구 사용)finish_image.py를 업스케일된 파일에 대해 실행합니다.- 인쇄 출력이 유효 ppi 약 150 미만인 경우 언급합니다.
-
보고: 완성된 파일의 전체 경로, 크기/형식, 텍스트 확인 결과, 모든 경고(업스케일, ppi, 재시도, 사소한 결함). 여러 이미지의 경우 표: 이름, 텍스트 확인, 파일, 메모. 한 줄로 다음 변형 또는 형식을 제안합니다.
scripts/codex_generate.sh와 scripts/finish_image.py는 기존 원시 이미지의 빠른 재보정을 위해 직접 호출할 수도 있습니다(새로운 크기나 형식은 새 생성이 필요 없으므로 미리보기가 필요 없음). Codex를 호출하는 모든 것은 미리보기를 거쳐야 합니다.
알려진 한계
image_gen호출당 이미지 하나; 변형은 별도 호출.- 기본 출력은 약 1.5MP. 그보다 큰 것은 업스케일.
- 이미지 모델은 정확한 인치/픽셀 여백 요청을 무시합니다. 여백은 보정 도구의 작업입니다.
- 편집(
edit)은 첨부 이미지에서 작동합니다. 마스크 및 API 전용 제어는 유료 대체가 필요하며 사용자의 동의가 필요합니다.
테스트 환경
macOS에서 codex-cli 0.155.0-alpha(2026-09-25 ~ 2026-09-28)로 관찰됨. 이는 테스트 노트이며 보장이 아닙니다. Codex와 ChatGPT는 자주 변경됩니다.
image_gen은 ChatGPT 앱이 닫힌 상태에서codex exec로 작동합니다.-s workspace-write -C <dir>로 홈 폴더 외부에 쓸 수 있습니다.- 기본 크기 약 1.5MP(예: 4:5에서 1122x1402); 이미지당 55~150초.
- 두 개의 병렬 실행이 작동했습니다.
- 프롬프트에 명시된 종횡비는 준수되지만 정확한 여백은 준수되지 않습니다.
- 모델은 GPT Image(Codex 문서에서 gpt-image-2로 지칭; 도구는 정확한 버전을 보고하지 않음).