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)。すべてのセクションを埋めます。省略する代わりに「none」と記述します。 - 実行:
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を使用します。複数の異なる画像がある場合は、画像ごとにバックグラウンド実行を1つ行います(フリート)。 - 自分で確認: 各
CODEX_IMAGE=ファイルを読み、受け入れチェックリストと照合します。Codex の自己チェックは主張であり、証拠ではありません。 - 反復:
-Session <CODEX_THREAD_ID>と短いデルタブリーフ(「すべて維持、次のみ変更:...」)を使用するか、以前の出力を-Imagesと編集ブリーフとともに渡してターゲット編集を行います。 - 納品: 画像をユーザーに表示(Read / SendUserFileを使用)し、パスを伝え、さらなる反復のためにスレッドIDが利用可能であることを伝えます。
ブリーフテンプレート(コピーしてすべてのフィールドを埋める)
# Purpose & usage
<この画像の目的、表示場所(ヒーローバナー、アプリアイコン、スライド、印刷)、対象者>
# Output
- アスペクト比/サイズ: <例:16:9 横長、1:1 正方形、9:16 縦長。既知の場合は目標ピクセル数>
- 形式/背景: <不透明 | 透明背景 | 単色 #FFFFFF>
- バリエーション: <1 | N、およびバリエーションの違い方>
# Subject
<具体的な主被写体:誰/何、数、ポーズ、表情、アクション、服装/素材、年齢/民族性はユーザー指定があり関連する場合のみ>
# Composition & camera
- フレーミング: <クローズアップ | ミディアム | ワイド | 真上 | アイソメトリック | フラットな正投影>
- 配置: <被写体の位置(三分割法、中央)、テキスト用のネガティブスペースの位置>
- カメラ/レンズ(写真スタイル): <例:50mm、f/2.8 浅い被写界深度、アイレベル>
- 前景 / 中景 / 背景: <それぞれ説明>
# Style
- メディア: <フォトリアル | 3Dレンダリング | フラットベクター | ラインアート | 水彩 | ピクセルアート | クレイ | アイソメトリック ...>
- 言葉による参考: <時代、ムーブメント、テクスチャ、線の太さ、詳細度>(存命のアーティスト名は不可)
- レンダリングの詳細度: <最小限の形状 | 中程度 | 非常に詳細>
# Color & light
- パレット: <役割付きの16進コード、例:プライマリ #1E6FFF、アクセント #FFC233、背景 #F5F5F7>
- 照明: <左からの柔らかい昼光 | スタジオスリーポイント | ゴールデンアワー | ネオンリムライト>
- ムード: <落ち着いた、エネルギッシュ、プレミアム、遊び心 ...>
# Text in image
<"なし" または各文字列を引用符で囲んで、フォントの雰囲気(太字の幾何学的サンセリフ)、色、位置、画像全体に対するサイズを記載。文字列は短く保ち、スペルと大文字小文字は正確に。>
# Must include
- <譲れない要素>
# Must NOT include
- <透かし、余分なテキスト、余分な指、実際のブランドのロゴ、乱雑さ、特定の色 ...>
# Edit instructions(画像を編集する場合のみ)
- 画像1の役割: <編集対象の画像 | スタイル参考 | 被写体参考>
- 変更内容: <正確に何を>
- 保持内容: <同一に保つ必要があるすべて:レイアウト、顔、色、テキスト>
# Acceptance checklist
- [ ] <Claudeが確認する客観的なチェック項目:アスペクト比、被写体の存在、テキストの正確さ、パレット、Xがないこと>
強力な結果を得るための作成ノート
- 具体的な名詞と測定可能な属性が形容詞よりも優れています(「クルミのテーブルの上にある、3つのセラミックマグ、マットセージグリーン #9CAF88」≫「素敵で居心地の良いマグ」)。
- 明確な焦点を1つ設定し、後でテキストを重ねる場合は空きスペースの位置を指定します。
- アイコン/ロゴの場合:フラット、少ない色数、中央揃え、十分なパディング、特に要求がない限りテキストなし、小さいサイズでテストします。
- UI/マーケティングアセットの場合:正確なコピーを指定し、画像内のテキストは最小限にします。実際のUIテキストはコードで追加する方が適切です。
- シリーズ/セット(スプライト、アイコンパック、ストーリーボード)の場合:共有の「スタイルバイブル」セクションを作成し、各レーンのブリーフでそのまま再利用してセットの一貫性を保ちます。最初にヒーロー画像を1つ生成して承認を得てから、それを
-Imagesでスタイルリファレンスとして残りの生成に渡します。 - 実在の人物の肖像、著作権で保護されたキャラクター、実際のブランドロゴをリクエストしないでください。