功能定位与准备工作
Codex 提供了一个非常有趣的小宠物功能，它能在智能体执行任务时陪伴用户，并直观展示智能体的工作状态。虽然这个功能纯粹是外观美化，并不能提升 Codex 写代码的能力或智能水平，但它能显著增加使用过程中的愉悦感。博主最近创建了两个基于中文互联网热门卡通形象的自定义宠物：一个是“刀盾”小狗，另一个是“月薪喵”小布偶猫。掌握这一功能后，用户可以将喜爱的动漫、游戏角色（如宝可梦、火影忍者、海贼王）甚至明星的 Q 版形象制作成 Codex 宠物。整个过程完全在 Codex 内部完成，步骤简单，且博主已将具体的步骤提示词和命令行命令整理为知识笔记供分享。
“小宠物的功能仅仅是陪着你而已，它并不能让 Codex 写代码写得更好，也不能让 Codex 变得更厉害更聪明。”
在开始制作之前，建议先熟悉基础操作。用户应进入 Codex 左下角的设置菜单，选择宠物选项，先尝试选择一个 Codex 自带的宠物以了解效果。在宠物界面最下方，可以找到自定义宠物按钮。点击后打开的文件夹即为存放自定义宠物文件的位置。自定义宠物仅包含两个核心文件：一个是 pet.json，用于描述宠物的名字和信息；另一个是 .webp 动图文件，包含宠物的 9 种不同动作状态。理解这一文件结构是后续自定义的基础。
“宠物只有两个文件，一个 pet.json 描述的是宠物的名字和信息，一个 .webp 动图文件描述宠物的 9 个不同的动作。”
安装 Skill 与素材准备
制作自定义宠物的第一步是安装专用的 Skill。用户需要在 Codex 中创建一个新项目，并在对话框中发送以下命令来安装创建宠物的 Skill：
$skill-installer hatch-pet
安装完成后，需要准备两份关键素材：参考图和文字描述。参考图是制作宠物的视觉基础，可以是任何清晰的卡通形象，如宝可梦、玲娜贝儿、火影忍者角色等。如果选择 AI 生成的形象（如博主制作的“刀盾”），可以直接使用豆包等工具生成图片。文字描述的作用则是明确宠物的核心特征，告诉 AI 哪些外观元素（如名称、颜色、体型、关键特征）必须保持稳定，哪些部分可以自由发挥。博主提供了一段通用的文字描述案例，用户可根据所选形象自行调整，确保 AI 能准确理解宠物的视觉设定。
“文字描述的作用是告诉 AI 哪些特征必须稳定，哪些特征可以自由发挥。”
准备好素材后，即可进入生成阶段。首先发送提示词，要求 Codex 调用刚才安装的 Skill，根据参考图生成一张Base 基准图片。这张基准图片将作为后续所有动作生成的基础模板。生成后，用户需仔细检查基准图片是否符合预期。如果不符合要求，应直接发送指令让 Codex 进行修改，直到满意为止。这一步至关重要，因为后续的所有动作动图都将基于这张基准图片进行扩展和变形。
动作状态解析与生成策略
Codex 宠物需要支持 9 种不同的状态，以对应不同的工作场景。这些状态包括：待机、处理任务、搜索、审查等。为了高效生成，博主建议先让 Codex 生成待机状态和向右跑状态的动图，以便快速预览效果。生成后同样需要检查，若不满意则继续修改。待这两个基础动作确定后，再让 Codex 一次性生成剩余的动图。用户可以直接将动作列表表格发送给 Codex，要求其调用 Skill 批量生成。
“Codex宠物需要有9种状态，那分别对应了待机、处理任务、搜索、审查等不同状态下的宠物动作。”
在生成动作时，有两个关键的技术限制需要注意。首先，Codex 宠物动图的帧数较低，通常只有 6-8 帧。如果用户手头有高分辨率或高帧数的动图（如网络上流行的 40 帧舞蹈动图），必须让 Codex 将其降帧改造以匹配 Codex 的标准。其次，Codex 不支持自由修改动作快慢，且待机状态下的动作会被自动放慢 6 倍。因此，像跳舞这样复杂的动作不适合用作待机状态，否则会出现严重的卡顿感。博主的“月薪喵”宠物在待机时采用了趴下的动作，因为该动作简单且无明显违和感，避免了因帧率低和速度放慢导致的视觉不适。
“Codex的每个动作的动图帧数都比较低……Codex的宠物动作一般都只有6-8帧。”
打包部署与最终测试
当 9 个动作动图全部生成并确认无误后，最后一步是让 Codex 将生成的文件进行打包和部署。用户需将打包好的文件放置到之前提到的 Codex 宠物文件夹内。随后，返回 Codex 设置界面的宠物选项，点击刷新按钮。此时，用户创建的自定义宠物应该会出现在列表中。
为了验证宠物是否正常工作，可以进行简单的交互测试。将鼠标悬停在宠物身上，它会显示跳跃动作；当让 Codex 执行一项具体任务时，宠物会切换为运行状态的动作，并弹出文字提示框，实时告知用户任务执行的当前步骤。至此，自定义宠物的创建流程全部完成。整个过程概括为：准备参考图和文字描述 -> 安装 Skill -> 调用 Skill 生成形象和动作 -> 打包发布。虽然这是一个“不务正业”的外观美化功能，但它确实能让使用 Codex 的过程更加开心和个性化。
“把打包好的文件放置到 Codex 的宠物文件夹内，然后我们点开设置界面，进入到宠物界面，点击刷新，就可以看到我们刚才创建的宠物了。”
常见问题与注意事项
在制作过程中，用户可能会遇到动图不匹配或显示异常的问题。首先，参考图的质量直接决定最终效果。务必选择最清晰、标准的图片作为参考，避免使用模糊或角度怪异的图片。其次，文字描述的准确性至关重要。如果描述中遗漏了关键特征（如颜色或配饰），AI 生成的宠物可能会偏离预期。建议用户在描述中详细列出所有不可变特征。
“那如果你学会了自己创建宠物，那么你就可以把你喜欢的动漫或者游戏形象做成 Codex 宠物陪着你干活。”
另外，关于动图的帧数处理，这是最容易出错的地方。如果用户直接上传高帧数动图，Codex 可能无法正确解析或显示异常。务必在提示词中明确要求 Codex 将动图转换为 6-8 帧的 .webp 格式。对于待机动作，应避免使用复杂或高频变化的动作，选择静态或微动作为佳，以适配 6 倍慢放的效果。最后，确保所有文件命名和路径正确，特别是 pet.json 中的文件引用路径，否则宠物可能无法加载。
“那这个过程非常简单，全部都在 Codex 内完成。”
总结与展望
通过本教程，用户已经掌握了从 0 到 1 制作 Codex 自定义宠物的完整流程。这一功能虽然不影响 Codex 的核心性能，但极大地丰富了用户体验。用户可以充分发挥创意，将任何喜欢的 IP 形象转化为专属宠物。随着 Codex 功能的不断更新，未来可能会支持更多自定义选项，如声音、特效等。目前，用户只需关注视觉层面的定制，即可实现个性化的陪伴体验。建议用户在制作完成后，多尝试不同的动作组合和参考图，以找到最佳的视觉效果。如有任何问题，可随时在评论区留言交流。
“那以上就是今天视频的全部内容，那这是一期非常不务正业的视频，因为它是一个纯粹的外观美化功能。”