Codex를 통한 이미지 생성
Claude가 아트 디렉션을 작성합니다. gpt-6.1-sol이 내장 이미지 도구로 이를 문자 그대로 실행합니다. 브리프가 품질의 전부입니다. Sol은 누락된 세부 사항을 잘 채워넣지 못하며, 열린 질문에 대해 '판단'하지 않습니다. 모든 것을 먼저 결정하고, 그 다음에 기록하세요.
엔진 및 역할 프로필
이미지는 Codex의 내장 image_gen 도구(ChatGPT Pro 로그인 필요 — API 없음, 이미지당 비용 없음)
에서 생성됩니다. 이 도구는 프롬프트, 참조 이미지 및 transparent_background만 입력받으며, 서버가
이미지 모델을 선택하므로 특정 모델(GPT Image 2.6 Sunburst / Flare 등)을 여기서 선택할 수 없습니다.
API 키나 Codex의 이미지 CLI 대체 기능으로 절대 전환하지 마세요.
역할별 제어는 ~/.claude/skills/codex/image-profiles.json의 프로필을 통해 이루어지며,
-ImageProfile <name>으로 전달됩니다. 프로필은 브리프에 역할 스타일 노트를 추가하고 투명도를 강제할 수 있습니다.
| 프로필 | 사용처 | 참고사항 |
|---|---|---|
default | 기타 모든 경우 | 브리프만 사용 |
photoreal | 제품 사진, 히어로 배너, 편집 사진 | 사실적인 사진 규칙 |
illustration | 마케팅/블로그/온보딩 아트 | 일관된 일러스트레이션 규칙 |
icon | 앱/UI 아이콘, 마크, 스티커, 스프라이트 | 투명, 패딩, 32px 가독성 |
ui-asset | 목업, 대시보드 비주얼, 빈 상태 | 선명한 기하학, 가짜 마이크로텍스트 없음 |
text-heavy | 포스터, 표지, 인포그래픽 | 정확한 타이포그래피 우선 |
-Transparent는 모든 프로필과 함께 사용할 수 있습니다. JSON에 (transparent, roles,
style_notes) 항목을 추가하여 새 역할을 추가하세요. 브리프가 여전히 주요 품질 레버입니다: 프로필은
추가할 뿐 대체하지 않습니다.
워크플로우
- 진정으로 막히는 부분만 명확히 하세요 (용도, 사용 위치, 크기/비율, 이미지 내 텍스트, 브랜드 색상). 그 외에는 합리적인 기본값을 선택하고 브리프에 명시하세요.
- 브리프를 스크래치패드에 파일로 작성하세요 (예:
brief-hero.md). 아래 템플릿을 사용하고 모든 섹션을 채우세요. 섹션을 생략하지 말고 "없음"이라고 작성하세요. - 실행:
pwsh -NoProfile -File "$HOME\.claude\skills\codex\scripts\codex.ps1" -Mode image ` -PromptFile <brief.md> -Out <project>\assets\<name>.png [-ImageProfile icon] [-Transparent] ` [-Count 3] [-Images ref1.png,ref2.png]timeout: 600000을 사용하세요. 여러 개의 다른 이미지 → 이미지당 하나의 백그라운드 실행(플릿)입니다. - 직접 검증하세요: 각
CODEX_IMAGE=파일을 읽고 승인 체크리스트와 비교하세요. Codex의 자체 점검은 주장일 뿐 증거가 아닙니다. - 반복은
-Session <CODEX_THREAD_ID>와 짧은 델타 브리프("모든 것을 유지하되, 다음만 변경: ...")를 사용하거나, 이전 출력을-Images로 전달하고 편집 브리프를 사용하여 타겟 편집을 수행하세요. - 전달: 이미지를 사용자에게 보여주고(읽기/SendUserFile), 경로를 알려주며, 추가 반복을 위해 스레드 ID를 사용할 수 있음을 언급하세요.
브리프 템플릿 (복사, 모든 필드 채우기)
# 목적 및 용도
<이 이미지의 용도, 표시 위치(히어로 배너, 앱 아이콘, 슬라이드, 인쇄), 대상 청중>
# 출력
- 종횡비 / 크기: <예: 16:9 가로, 1:1 정사각형, 9:16 세로; 알려진 경우 대상 px>
- 형식/배경: <불투명 | 투명 배경 | 단색 #FFFFFF>
- 변형: <1 | N, 변형 간 차이점>
# 주제
<주요 주제를 구체적으로: 누구/무엇, 개수, 포즈, 표정, 동작, 의상/소재,
연령/인종은 사용자가 지정한 경우에만 관련>
# 구성 및 카메라
- 프레이밍: <클로즈업 | 미디엄 | 와이드 | 탑다운 | 아이소메트릭 | 평면 직교>
- 배치: <주제 위치(3분할 법칙, 중앙), 텍스트용 네거티브 공간(어느 쪽)>
- 카메라/렌즈(사진 스타일): <예: 50mm, f/2.8 얕은 심도, 눈높이>
- 전경 / 중경 / 배경: <각각 설명>
# 스타일
- 매체: <포토리얼 | 3D 렌더 | 플랫 벡터 | 라인 아트 | 수채화 | 픽셀 아트 | 클레이 | 아이소메트릭 ...>
- 참조를 단어로: <시대, 운동, 텍스처, 선 두께, 디테일 수준>(생존 작가 이름 금지)
- 렌더링 디테일: <최소한의 형태 | 보통 | 고도로 디테일>
# 색상 및 조명
- 팔레트: <역할과 함께 16진수 코드, 예: 기본 #1E6FFF, 강조 #FFC233, 배경 #F5F5F7>
- 조명: <왼쪽에서 부드러운 일광 | 스튜디오 3점 조명 | 골든 아워 | 네온 림 라이트>
- 분위기: <차분함, 활기참, 프리미엄, 장난기 ...>
# 이미지 내 텍스트
<"없음" 또는 각 문자열을 따옴표로 묶어 원문 그대로, 글꼴 느낌(굵은 기하학적 산세리프), 색상, 위치,
이미지 기준 크기. 문자열을 짧게 유지하세요. 정확한 철자와 대소문자가 중요합니다.>
# 반드시 포함
- <타협할 수 없는 요소>
# 절대 포함 금지
- <워터마크, 추가 텍스트, 추가 손가락, 실제 브랜드 로고, 혼잡, 특정 색상 ...>
# 편집 지침(첨부 이미지 편집 시에만)
- 이미지 1: <편집할 이미지 | 스타일 참조 | 주제 참조>
- 변경: <정확히 무엇을>
- 유지: <동일하게 유지되어야 하는 기타 모든 것: 레이아웃, 얼굴, 색상, 텍스트>
# 승인 체크리스트
- [ ] <Claude가 검증할 객관적 확인 사항: 종횡비, 주제 존재, 텍스트 정확, 팔레트, X 없음>
강력한 결과를 위한 제작 노트
- 구체적인 명사와 측정 가능한 속성이 형용사보다 낫습니다("세라믹 머그 3개, 무광 세이지 그린 #9CAF88, 호두나무 테이블 위" ≫ "멋지고 아늑한 머그").
- 하나의 명확한 초점을 정하고, 나중에 텍스트가 오버레이될 경우 빈 공간이 어디에 있는지 말하세요.
- 아이콘/로고의 경우: 평면, 적은 색상, 중앙 정렬, 넉넉한 패딩, 요청하지 않는 한 텍스트 없음, 작은 크기로 테스트.
- UI/마케팅 에셋의 경우: 정확한 카피를 명시하고 이미지 내 텍스트를 최소화하세요. 실제 UI 텍스트는 코드에서 추가하는 것이 좋습니다.
- 시리즈/세트(스프라이트, 아이콘 팩, 스토리보드)의 경우: 공유 "스타일 바이블" 섹션을 작성하고 각
브리프에서 그대로 재사용하여 세트의 일관성을 유지하세요. 먼저 히어로 하나를 생성하고 승인받은 후,
나머지의 스타일 참조로
-Images와 함께 전달하세요. - 실제 인물의 초상, 저작권이 있는 캐릭터 또는 실제 브랜드 로고를 요청하지 마세요.