Codex 的 Image Gen skill
Image Gen 就是 $imagegen 背后的 skill。它告诉 Codex 什么时候该生成图片、而不是用代码画,把你的需求整理成结构化的提示词,并确保项目用的图片最终放进你的工作区。它内置在 Codex 里。
更新于 2026年11月12日 · 阅读约 3 分钟
速览
| Skill 名称 | imagegen |
| 来自 | Codex 本身,是一个系统 skill |
| 安装 | 内置在 Codex 里(系统 skill),无需安装 |
| Codex 何时使用 | 任务需要新的或修改过的位图时:照片、插画、精灵图、样机图、抠图;SVG 或 CSS 做的视觉效果不用它 |
| 源码 | GitHub 上的 openai/skills |
它能做什么
这个 skill 有两种模式。默认用 Codex 内置的 image_gen 工具,不需要 API key。备用的 CLI scripts/image_gen.py 只在你明确要求时运行,需要 OPENAI_API_KEY。Codex 永远不会自己切换过去。
生成之前,它会先给需求分类:是新图还是改图,是一张还是很多张。多张图时,每张图单独调用一次。然后它把你的提示词改写成一份简短、分项标注的说明,包括用途、素材类型、风格、构图、光线、需要出现的准确文字,以及要避免的内容。只有当你的提示词比较含糊时,它才会补充细节;改图时会列出哪些地方必须保持不变。
它还有文件方面的规则:
- 内置工具生成的图片默认存到
$CODEX_HOME/generated_images/下。 - 给项目用的图片,会在 Codex 收尾之前移动或复制到工作区里。
- 除非你要求,它不会覆盖已有素材,而是另存一个带版本号的副本,比如
hero-v2.png。
如果用代码做更合适,它就不生成图片:比如扩展一套 SVG 图标、做 logo 体系,或者画简单的图形和示意图。
什么时候用
适合用来做首屏大图、产品图、游戏精灵图、UI 样机图、透明背景抠图,或者修改对话里已有的图片。
试一试
给落地页做一张首屏大图
$imagegen 为我们的咖啡订阅落地页做一张宽幅首屏大图:浅色木桌上放着一只陶瓷杯,清晨柔和的光线,左侧留出放标题的空白。不要文字,不要 logo。保存到 public/images/hero.png。
Claude Code 里能用吗?
只能用一部分。默认路径依赖 Codex 内置的 image_gen 和 view_image 工具,Claude Code 没有这两个工具。如果把文件夹复制到 ~/.claude/skills,唯一能运行的是备用的 CLI 脚本,而且需要你自己的 OPENAI_API_KEY。