这篇教程不只讲方法,还展示一只真正做完并装进 Codex 的桌宠。
案例角色叫“雪瞳”:以真实异瞳白猫照片为身份参考,经过角色定稿、动作生成、图集打包和视觉验收,最终安装到 Codex。
- 身份参考
- 4 张原始照片
- 动作状态
- 9 组标准动画
- 最终图集
- 1536 x 2288
- 验收结果
- 结构与视觉 QA 通过


桌宠会跟随 Codex 的工作状态做出反应
任务开始、等待确认、执行失败,都可以显示不同动作。下面 5 组预览全部来自“雪瞳”的最终交付包,呈现真实运行效果。





不做自己的角色,也可以先领养现成宠物
如果只是想马上看到效果,可以先从社区画廊安装一个现成宠物。确认自己喜欢这种交互后,再投入时间做个人 IP。
npx petdex install 宠物名称安装后打开 Codex -> Settings -> Appearance -> Pets,在自定义宠物中选中它,再点击唤醒。
上传你的形象,先把身份特征说清楚
在 Codex 中新建普通对话,上传一张个人头像、宠物照片、品牌吉祥物、产品角色设定图或手绘草图。这里先不生成动画,只确定角色长什么样。
正面或轻微侧面的全身图,比只露半张脸的照片更稳定。
光线正常、背景干净,避免主体和背景混在一起。
明确要保留的主色、五官、毛色、服装或标志性配饰。
先生成基础 IP 图像,再进入动画制作
基础图负责稳定角色设定。桌宠最终显示得很小,按图标的方式设计,轮廓和标志性特征会更清楚。
请以我上传的图片为主要视觉参考,选择画面中最突出、最完整的主体,将它重新设计成一个辨识度高、适合长期使用的小型原创 IP 角色。
请提炼主体最容易被记住的 3-5 个特征,例如轮廓、比例、五官、发型或毛发、主色、服装和标志性配饰。保留它原本的身份与气质,以重新设计的方式提炼、概括和风格化这些特征。你可以自由调整比例、造型、材质和细节表达,让角色更简洁、更有性格,也更容易重复绘制;最终仍要让人一眼看出它来自参考图。
角色整体可爱但不过度幼稚,轮廓完整,缩小后依然容易辨认。默认采用高完成度的二维角色插画,将现代扁平设计与轻微手绘质感结合;如果参考主体更适合其他视觉语言,可以自由发挥。最终形象应便于继续扩展为头像、表情包、贴纸、社交媒体形象和品牌吉祥物。
生成一张完整的 IP 角色设计展示图:画面中央放置一个最大的角色主形象,使用最能体现其性格的招牌动作;旁边展示一个正面小全身、一个侧面小形象,以及三个不同情绪的头部表情。所有形象属于同一个角色,核心特征、比例和配色保持一致。使用暖白色或浅色纯净背景,版式整洁,保留留白,不添加角色名称和大段文字。
如果主体是动物,保留品种、毛色和身体结构;如果是人物,保留脸型、发型、服装和标志性配饰,再转化为非写实角色;如果是物品或产品,可以将关键结构拟人化,身体形态沿用物品本身的结构。
避免套用普通卡通模板、模仿现有 IP 风格、改变主体身份、丢失标志性颜色,或让不同视图出现角色设定漂移。除此之外,请在构图、动作、表情和细节上自由发挥。
在 Codex 中调用 Hatch Pet,生成整套动作
基础 IP 图像确认后,继续在当前普通对话里直接发送下面的要求。如果换了新对话,再把基础 IP 图像上传进去并发送同样的要求。接下来,动作、裁切、对齐、去背景和打包都交给 Hatch Pet 完成。
请以我上传的 IP 图像作为主要身份参考,调用 Hatch Pet 把它制作成 Codex 桌宠。保留角色的核心轮廓、主色和标志性特征,动作与表情可以根据不同工作状态自由设计,要维持角色一致性。- 1直接发送生成要求
让 Hatch Pet 以当前对话中的基础 IP 图像作为身份参考。
- 2生成状态动画
待机、移动、挥手、跳跃、失败、等待、运行中和检查结果。
- 3处理交付文件
统一裁切和对齐,清理背景,再合成 Codex 可读取的图集。
检查整套动作,确认角色身份始终一致
“雪瞳”最终包包含 9 组标准状态、左右移动和方向视线。验收时重点确认角色身份稳定、方向过渡连贯、背景保持透明。


成品处理完成后,进入设置选择并唤醒
Hatch Pet 生成图集、配置文件并完成安装后,打开 设置 -> 宠物 -> 创建,选中新生成的角色并点击唤醒。

下载、备份,也可以分享给别人
生成完成后,宠物通常保存在下面的目录。换电脑时复制完整文件夹,放回相同位置即可。
~/.codex/pets/你的宠物名称/pet.jsonspritesheet.webp如果想公开提交到 Petdex,可以在确认角色版权和分享范围后执行:
npx petdex login
npx petdex submit ~/.codex/pets/你的宠物名称先做一只你愿意每天看到的角色。
角色一旦会待机、会工作、会等你确认,个人 IP 就不再只是一张静态图片。它会成为你每天打开 Codex 时都能看到的工作伙伴。