TL;DR

Claude Code 本体に画像生成機能はないが、OpenAI 公式の Codex プラグイン（openai/codex-plugin-cc）を入れると imagegen（Images 2.0 / GPT Image 2）に委譲でき、結果として Claude Code から画像生成できる
そのまま丸投げすると 4つの罠（バックグラウンド実行で死ぬ / サンドボックス書き込み制限 / CJK 文字化け / Skill() 経由のセッション hang）にハマる
正解は Skill() ではなく Agent(subagent_type="codex:codex-rescue", ...)。サンドボックス越えの cp・ls -la 検証・目視は 親エージェント（Claude 側）が担う

仕組み

Claude Code 自体は画像を生成できない。だが OpenAI 公式の Codex プラグイン（openai/codex-plugin-cc、2026-03 リリース）を入れると、Codex の imagegen（Images 2.0 / GPT Image 2）に委譲できる。

Claude Code (親エージェント・Anthropic)
   └─ codex:codex-rescue サブエージェントへ委譲 (Agent 経由)
       └─ Codex CLI (子エージェント・OpenAI)
           └─ imagegen スキル → Images 2.0

導入は以下（v1.0.4 以降推奨）。

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/codex:setup   # Codex CLI 本体の認証確認

「呼べる」と「スムーズに使える」は別物 — 4つの罠

罠1: バックグラウンド実行で黙って死ぬ

/codex:rescue に画像生成を素朴に頼むと、imagegen スキルを使います と返ったまま無反応になることがある。通知も来ず、ファイルもできず、TaskList / TaskOutput も Codex 内部の task id を認識しない。

原因: レスキューサブエージェントが状況により --background（fork）で起動し、子プロセスが harness から追跡不能になる。

対策: 委譲プロンプトに「バックグラウンドにせず、フォアグラウンドで完了まで走り切ること」を明示する。

罠2: サンドボックスのパス制限

保存先に ~/Downloads/... を指定すると Operation not permitted。

原因: Codex CLI はデフォルトで workspace-write サンドボックスで動き、書き込めるのは workspace（セッションを開始した作業ディレクトリ）内だけ。ホームディレクトリ直下は範囲外なので弾かれる。

対策: 委譲プロンプトに「書き込めない場合は workspace 内に保存して絶対パスを報告する」と入れ、保存後に親側で cp する。

cp /path/to/workspace/generated/codex-image-xxx.png ~/Downloads/example-image.png

罠3: CJK 文字化け

技術図のラベルに日本語を入れると「複雑」が「霊等」に化ける。Images 2.0 は CJK の長文ラベルが苦手。

対策: 文字が多い技術図は Mermaid を正本（canonical）にして、Codex 画像は見栄え用に回す。文字が少ない 1 枚絵なら Codex 単体で OK。画像に CJK を入れたいなら英語併記か短いラベルに限定する。

罠4（最大）: `Skill(codex:rescue)` で hang する

自作スキルにまとめる段で、委譲をこう書いた。

Skill(skill="codex:rescue", args={prompt: "..."})

実行すると Launching skill: codex:rescue のまま固まり、中断するしかなかった。公式ドキュメント（commands/rescue.md）に呼び出し方の鉄則が明記されていた。

呼び出し方	結果
`Skill(codex:rescue)`	NG — このコマンドに再入してセッションが hang する
`Skill(codex:codex-rescue)`	NG — そんな skill は存在しない
`Agent(subagent_type="codex:codex-rescue", prompt=...)`	OK — 正解

codex:rescue は slash command で、その内部で本物の subagent codex:codex-rescue を Agent ツール経由で起動する。スキルから Skill(codex:rescue) を呼ぶと slash command が再帰的に呼び出されて hang する。codex:rescue（slash command）と codex:codex-rescue（subagent）は 名前空間が別物、というのがポイント。

修正: 委譲を Agent() に書き換える。

# NG
Skill(skill="codex:rescue", args={prompt: "<delegation prompt>"})

# OK
Agent(subagent_type="codex:codex-rescue", prompt="<delegation prompt>")

委譲プロンプトテンプレ（コピペ可）

Agent(subagent_type="codex:codex-rescue") に渡すプロンプト。各行に過去の罠への対策が込めてある。

【タスク】
{用途・描画要素・スタイル・アスペクト比をここに記述}

【保存先】
{絶対パス。例: ~/Downloads/example-image.png}

【手順】
1. Images 2.0 / imagegen で画像を生成する
2. 上記の保存先パスに保存する。書き込めない場合は workspace 内に保存して、その絶対パスを報告する
3. `ls -la {保存先パス}` でファイルの存在とサイズを確認する
4. 完了報告にはファイルの絶対パスとバイト数を含める

【重要・厳守】
- バックグラウンドにせず、フォアグラウンドで完了まで走り切ること
- 保存と ls -la 確認を済ませてから報告すること（途中で止まらない）
- 日本語テキストを入れる場合は正確に描画する。CJK 文字が崩れる懸念があれば英語併記でよい
- imagegen スキルを呼び出した時点で停止せず、最後まで完遂すること

親側（Claude）の後処理は救出・検証・目視の 3 ステップで固定化する。

# 1. サンドボックス越え救出
if (codex の完了報告が workspace 内パスを返した):
    cp {workspace 内パス} {ユーザー希望パス}

# 2. 実体検証（サイズ 0 でない・存在する）
ls -la {ユーザー希望パス}

# 3. 目視点検（CJK 文字化けがあれば再生成 / 英語版 / Mermaid 切り替え）
Read({ユーザー希望パス})

まとめ

Claude Code 単体に画像生成機能はなくても、OpenAI 公式 Codex プラグイン経由で Images 2.0 に委譲すれば生成できる
ただし実用化のキモは、画像生成そのものより 委譲の作法
呼び出し方は公式ドキュメントで確認する（codex:rescue と codex:codex-rescue は別物、スキルからは Agent() 経由）
委譲先の「完了しました」は信用せず、サンドボックス越えの cp と検証（ls -la・Read）は親に集約する。この責務分業は Codex に限らず MCP 経由の委譲全般に効く