用途：借助 Codex 内置的 $imagegen 技能生成图片，并把成品放入项目目录，避免 ~/.codex/generated_images/ 目录无声增长（每次生成约累积 10MB，Codex 自身不会清理）。全部逻辑由一个随附脚本驱动，可跨插件版本升级使用，在没有 codex 插件的机器上回退到 codex exec。
前置条件（脚本自动检测其一）：Claude Code 中的 Codex 插件，先执行 /plugin marketplace add openai/codex-plugin-cc，再执行 /plugin install codex@openai-codex；或任意智能体中的 Codex CLI，执行 npm i -g @openai/codex 后 codex login。认证基于 OpenAI/ChatGPT 账号，两者都缺失时脚本以退出码 3 结束并打印安装步骤。
使用方式：先确定目标目录，用户未指定时默认项目根目录下的 .codex-image/；若目标位置已存在同名文件，需先询问用户，不得静默覆盖。然后编写纯提示文本，不要包含 $imagegen 标记（脚本会安全地前置该标记；在双引号 shell 字符串中手写 $imagegen 会被展开为空串导致技能不触发）。提示中应写明图像描述（主体、风格、氛围、颜色）、尺寸或宽高比（原始输出约 1254px 方形，Codex 会按需缩放裁剪，例如特色图写“1200x630 landscape”）、确切输出文件名，以及需要的变体数量。随后运行：bash <skill-dir>/scripts/codex-imagegen.sh --dest "<destination-dir>" "<prompt text>"。脚本需要网络访问；在 Claude Code 中需以 dangerouslyDisableSandbox: true 运行以免 Bash 沙箱拦截，其他环境正常执行。建议超时设为 600000 毫秒（10 分钟），单次生成约 2–5 分钟，模型与 effort 保持默认。
输出与清理：脚本会打印 RUNTIME=（所用路径）、GENERATED_FILES:（目标目录中的新文件路径，若 Codex 忘记复制脚本会自行移动）、CLEANUP=（本次 ~/.codex/generated_images/<thread-id>/ 是否删除，仅在确认目标文件存在后删除，否则保留原件）、LEFTOVER_THREAD_FOLDERS= 与 LEFTOVER_TOTAL_SIZE=（历史遗留线程文件夹，脚本不会触碰）。当遗留文件夹较多或体积较大时，向用户报告数量与大小并征得确认后，才可执行 bash <skill-dir>/scripts/codex-imagegen.sh --sweep；切勿未经提示就清理，旧文件夹可能存有用户尚未取出的 TUI 会话原件。
失败处理：认证错误（refresh token was revoked 等）需交互式重新登录，请用户执行 ! codex logout && codex login；目标无图片且无新线程文件夹，说明生成前已失败，应重读脚本输出中的 Codex 错误并报告，也可能是提示被内容策略拒绝，可改写后重试一次；退出码 3 表示本机无可用运行时，转达脚本给出的安装步骤。
适用场景：生成特色图、插图、图表、测试图片、博客视觉素材等。限制：依赖 OpenAI/ChatGPT 账号认证与网络，生成耗时较长，需注意沙箱与超时设置，清理操作必须经用户确认。