用途:为当前项目生成或编辑位图图像,例如网站素材、游戏素材、UI 样机、产品样机、线框图、Logo、写实图片或信息图。
主要能力:支持生成新图、以参考图控制风格/构图/氛围、编辑已有图像(局部重绘、光照或天气变换、换背景、移除物体、合成、透明背景),以及为同一任务批量产出素材或变体。
使用方式:先做宿主路由判断。Codex 在暴露内置 image_gen 时使用内置工作流;Claude Code(含 GLM Coding Plan)仅在活动工具列表出现图像生成 MCP 或工具时使用,否则需用户明确同意并配置 OPENAI_API_KEY 后才可用捆绑的 OpenAI CLI 回退;GitHub Copilot 使用宿主暴露的图像工具或经批准的 CLI 回退。默认使用内置 image_gen,普通质量、尺寸或路径控制不切换到 CLI。CLI 回退脚本为 scripts/image_gen.py,含 generate、edit、generate-batch 三个子命令,需 OPENAI_API_KEY。透明图默认先用内置工具生成纯色色键背景,再用 $CODEX_HOME/skills/.system/imagegen/scripts/remove_chroma_key.py 本地去背;真正原生透明需 CLI gpt-image-1.5 --background transparent --output-format png,且须用户确认。
适用场景:概念图、产品图、封面、网站主视觉、图标以外的位图素材、多素材批量生成等。
限制:不适合扩展或匹配仓库内已有 SVG/矢量图标、Logo 系统或插画库;不适合用 SVG、HTML/CSS 或 canvas 更合适的简单形状、图表、线框或图标;不适合源文件已是可编辑原生格式的小改动;也不适合用户明确要求确定性代码原生输出的任务。内置编辑仅针对对话上下文中可见的图像,本地文件需先用 view_image 载入。不得静默从内置或 gpt-image-2 降级到 gpt-image-1.5。不得修改 scripts/image_gen.py。项目引用的素材不能只留在默认 $CODEX_HOME 路径下。具体模型、质量、尺寸、掩码、输出格式与网络配置等细节见回退专用文档,资料未提供更多内容。