前言：

最近使用 Codex 时，我发现了一个特别好玩的小功能：桌面宠物。

它藏得比较深，入口在 Settings / 设置 -> Appearance / 外观，一直往下拉就能看到 Pets
或头像相关区域。选中之后，桌面上会出现一个像素风小伙伴。Codex
工作时，它会跟着进入忙碌、等待、审核等状态；任务完成时，也会用动画提醒你回来看看结果。

更有意思的是，这个宠物不只能用官方内置的。你可以自己用 Hatch Pet 技能孵化一个专属宠物，也可以从 Petdex
社区直接下载别人做好的宠物。

这篇文章就把两种玩法合在一起讲清楚：

• 第一种：用 Skill Installer 安装 hatch-pet，让 Codex 帮我做一个洛克王国迪莫宠物
• 第二种：用 Petdex 一条命令下载社区宠物
• 最后：如何在 Codex 里启用、切换和分享自己的宠物

一、Codex 桌面宠物是什么

Codex 桌面宠物可以理解成一个会动的状态提示器。

它不是单纯的装饰，而是会根据 Codex 当前工作状态切换不同动画，比如：

• 空闲时待机、眨眼
• 执行任务时进入工作动画
• 等待输入时显示等待状态
• 任务失败时显示失败反馈
• 等你 review 时进入审核状态

宠物包本质上由两类文件组成：

~/.codex/pets/<pet-name>/
  pet.json
  spritesheet.webp

其中 pet.json 负责描述宠物名称、动画状态、帧数、播放速度等信息；spritesheet.webp 是一整张动画图集。

常见 Codex 宠物图集是 9 个状态，每个状态一行，整体大约是 1536 x 1872。典型状态包括：

idle
running-right
running-left
waving
jumping
failed
waiting
running
review

简单说：pet.json 告诉 Codex 怎么播放，spritesheet.webp 提供真正的像素动画素材。

二、先打开 Codex 的宠物入口

启用宠物的入口在 Codex 设置里：

Codex -> Settings / 设置 -> Appearance / 外观 -> 往下拉 -> Pets

如果是内置宠物，直接选择一个，然后点击显示或选择即可。

如果是自己生成或通过 Petdex 下载的宠物，一般会出现在 Custom pets 里。生成或安装完成后，如果没有立刻看到，建议重启一下 Codex。

三、方式一：用 Hatch Pet 自己孵化一只宠物

Codex 支持通过 Skill 扩展能力。想自己做宠物，可以先安装 Hatch Pet 技能。

1. 用 Skill Installer 安装 Hatch Pet

在 Codex 的 Skills 里搜索并安装：

Skill Installer hatch-pet  

也可以理解为：先用 Skill Installer 把 hatch-pet 这个技能装进 Codex。

安装完成后，建议重启 Codex，让新技能生效。

2. 让 Codex 帮我做一个洛克王国迪莫宠物

接下来就可以直接在 Codex 里描述你想要的宠物，例如：

使用 hatch-pet，帮我做一个洛克王国迪莫宠物。
要求：
1. 保留迪莫的蓝白色系、可爱、灵动、光系宠物感觉
2. 做成 Codex 桌面宠物风格：小体积、像素风、轮廓清晰
3. 需要包含 idle、running、waiting、review、failed 等状态动画
4. 生成后帮我放到 ~/.codex/pets/ 目录下，方便在 Codex 里选择

如果想让效果更稳定，可以把描述写得更具体一点：

帮我做一只 Codex 桌面宠物，灵感来自洛克王国迪莫：
- 蓝白色小宠物
- 大眼睛，表情活泼
- 小翅膀或光系精灵感
- 不要复杂背景
- 像素风、Q 版、适合 192x208 的小尺寸动画格
- 动作要清楚，轮廓不要糊

Hatch Pet 的大致流程是：

1. 先生成宠物基础形象
2. 再生成 9 行状态动画
3. 合成最终 spritesheet
4. 生成 pet.json
5. 输出到 ~/.codex/pets/<pet-name>/
6. 做一次预览和校验

生成完成后，目录通常类似：

~/.codex/pets/dimo/
  pet.json
  spritesheet.webp

Windows 用户可以理解为：

C:\Users\<你的用户名>\.codex\pets\dimo\

然后重启 Codex，进入：

Settings -> Appearance -> Pets -> Custom pets

找到刚刚生成的宠物，点击 Select 即可。

3. 自定义宠物时的提示词建议

宠物生成不是普通头像生成，它要能动、能在小尺寸里看清，所以提示词里最好强调这些点：

• 像素风或 pixel-adjacent digital pet
• Q 版、小体积、轮廓清晰
• 颜色不要太复杂
• 不要背景、不要阴影、不要光效乱飞
• 动作要简单明确
• 每个状态都要保持同一个角色身份

不太建议只写一句：

帮我做一个迪莫

更推荐写成：

帮我做一个适合 Codex 桌面宠物的迪莫风格像素小精灵，蓝白配色，大眼睛，小巧可爱，轮廓清晰，不要复杂背景，需要生成完整 9 状态动画和 pet.json。

这样 Codex 更容易理解：你不是要一张插画，而是要一个能在桌面上跑起来的动画宠物包。

四、方式二：用 Petdex 下载社区宠物

在自己使用 Hatch Pet 孵化宠物之外，还有一个更轻量的玩法：直接去 Petdex 下载社区已经做好的 companion。

Petdex 是一个面向 Codex 的动态宠物图鉴网站，支持浏览、预览、安装和提交各种像素风 companion。你可以把它理解成 Codex 宠物生态里的公共图鉴：想快速换一只桌面宠物，就进去挑一个喜欢的，然后复制安装命令。

一句话定位

Petdex 是一个面向 Codex 的动态宠物图鉴网站：你可以在里面浏览、预览和安装各种像素风 companion，让本地 Codex 使用体验多一点陪伴感。

基础信息卡片

项目	信息
官网	https://petdex.crafter.run/
GitHub	https://github.com/crafter-station/petdex
项目定位	Codex-compatible animated pets public gallery
当前规模	截至 2026-05-08，首页显示 1347+ 个 open-source companions，GitHub 仓库约 1k Stars
快速安装示例	npx petdex install boba

Petdex 解决什么问题

Codex 这类命令行工具通常很高效，但也很“冷”：窗口里只有文本、任务、日志和结果。

Petdex 做的事情很简单：把各种动态 companion 做成一个公开图鉴，让用户可以像逛头像库、贴纸库一样，为自己的 Codex 环境挑一个宠物。

它主要解决三个小问题：

• 资源集中展示：不用到处找宠物包，直接在 Petdex 里浏览。
• 效果可以预览：每个 companion 不只是一个名字，而是带有图像、状态和描述。
• 安装路径明确：网站直接给出安装命令，降低尝试成本。

这不是一个提高模型能力的工具，而是一个让开发环境更有个性、更有仪式感的小组件。

核心功能 1：浏览宠物图鉴

Petdex 首页展示了大量 companion 卡片，每个卡片通常包含编号、名称、分类、简介、标签、作者和安装数据。

比如首页中的 Boba，是一只喝珍珠奶茶的小水獭；Doraemon、Noir Webling 等角色也都以像素风或 chibi 风格呈现。

这种设计让 Petdex 更像一个“宠物图鉴”，而不只是一个文件列表。

核心功能 2：一条命令安装

Petdex 首页直接给出安装命令：

npx petdex install boba

对用户来说，这个体验很直接：看到喜欢的 companion，复制命令安装即可。

安装后，它会把宠物包放到：

~/.codex/pets/boba/

然后打开 Codex：

Settings -> Appearance -> Pets -> Custom pets

选择刚安装的宠物即可。

Windows 用户可以直接打开 PowerShell 执行：

npx petdex install boba

如果提示没有 npx，说明本机可能还没有安装 Node.js。先安装 Node.js，再重新执行命令即可。装完后，如果 Codex 没刷新出来，就重启 Codex。

核心功能 3：精选合集

Petdex 有 Collections 页面，首页也会展示精选合集，例如：

• GRAYCRAFT：原创机甲风角色合集
• Meme Lords：Pepe、Wojak、Doodlebob 等 meme 风格角色
• Anime Heroes：动漫角色风格 companion

合集让浏览更有主题感，也方便创作者把一组相关设计放在一起展示。

核心功能 4：社区提交

Petdex 提供 Submit 入口，README 里也提到支持在浏览器中校验并提交社区宠物包。

这意味着它不是一个只读图库，而是希望让更多人参与补充 companion。

如果你已经通过 Hatch Pet 生成了一个完整宠物包，目录里有：

pet.json
spritesheet.webp

后续就可以考虑提交到 Petdex，让别人也能安装和使用。

核心功能 5：开源维护

Petdex 的 GitHub 仓库是公开的。README 中说明它是一个 Codex-compatible animated pets gallery，并列出了几个核心能力：

• 浏览已审核的宠物包
• 预览每个动画状态
• 下载单个 ZIP 包
• 下载完整图库包
• 在浏览器中校验和提交社区宠物包

从仓库结构看，宠物资源放在 public/pets，可下载包生成在 public/packs。

适合谁

Petdex 适合几类人：

• 经常使用 Codex，想让本地环境更有个性的人
• 喜欢像素风、chibi 风、桌面宠物这类轻量视觉元素的人
• 想给自己的工具链加一点“陪伴感”的开发者
• 想创作并分享 Codex companion 的设计者

如果你只关心模型效果、任务成功率或工程自动化，Petdex 不是必需品；但如果你已经每天都在终端里和 Codex 打交道，它能让这个过程更轻松一点。

快速上手

打开官网：

https://petdex.crafter.run/

选择一个喜欢的 companion，比如 Boba，然后执行：

npx petdex install boba

Petdex 每个宠物都有自己的 slug。命令格式基本是：

npx petdex install <pet-slug>

具体 slug 以 Petdex 页面显示为准。进入某个宠物详情页后，复制页面给出的安装命令即可。

如果想了解项目本身，可以查看 GitHub 仓库：

https://github.com/crafter-station/petdex

小结

Petdex 不是一个复杂的大工具，它更像 Codex 生态里的一个趣味入口：把 companion 做成可浏览、可预览、可安装、可提交的公共图鉴。

它的价值不在于让 Codex 变得更聪明，而在于让使用 Codex 的过程更有个性、更轻松，也更像一个可以被社区一起装饰的工作空间。

五、自己做好的宠物能不能分享到 Petdex

可以。前面已经提到，Petdex 本身提供了社区提交入口。这里再把从 Hatch Pet 到 Petdex 的路径单独拎出来说一下。

如果你已经通过 Hatch Pet 生成了一个完整宠物包，目录里有：

pet.json
spritesheet.webp

就可以把这个文件夹或 zip 包提交到 Petdex。

Petdex 的提交入口在：

https://petdex.crafter.run/submit

提交后一般需要等待审核，通过后其他人就可以用类似下面的命令安装：

npx petdex install your-pet-name

这里要注意一点：如果宠物明显来自某个已有 IP，比如洛克王国迪莫、动漫角色、游戏角色，个人学习和自用问题不大，但公开上传到社区时要注意版权和下架风险。更稳妥的方式是做“灵感来自某种风格”的原创宠物，而不是完全复刻。

六、Hatch Pet 和 Petdex 怎么选

两种方式适合不同场景。

如果你只是想快速换一个好看的宠物：

优先用 Petdex

因为它最快，一条命令就能装好，还能先在网页里预览动画。

如果你想要一个真正属于自己的宠物：

优先用 Hatch Pet

比如：

• 做一只自己的头像宠物
• 做一只项目吉祥物
• 做一只公司内部工具 mascot
• 做一只迪莫风格的小伙伴
• 做一只陪你写代码的专属桌面搭子

我自己的建议是：

1. 先去 Petdex 找几个喜欢的宠物，观察它们的风格和动作
2. 再用 Hatch Pet 生成自己的宠物
3. 如果效果满意，再考虑提交到 Petdex

七、常见问题

1. 为什么我安装后在 Codex 里看不到？

优先检查三件事：

1. 宠物是否安装到了 ~/.codex/pets/<name>/
2. 目录里是否有 pet.json 和 spritesheet.webp
3. 是否重启过 Codex

很多时候只是 Codex 还没重新加载自定义宠物。

2. 为什么自己生成的宠物动作很怪？

常见原因是提示词太像“插画生成”，不够像“动画精灵图生成”。

可以在提示词里强调：

Codex desktop pet, pixel style, tiny chibi mascot, clean outline, no background, consistent character across all states

中文也可以：

Codex 桌面宠物风格，像素风，小尺寸 Q 版，轮廓清晰，不要背景，所有动作都保持同一个角色。

3. 能不能直接改 spritesheet？

可以，但不太建议新手手动改。

因为宠物动画对每一行、每一帧的位置都有要求。手动改图很容易出现错位、裁切、透明背景异常等问题。更推荐用 Hatch Pet 生成完整包，再根据预览结果迭代。

总结

Codex 桌面宠物是一个很有意思的小功能：它既提供情绪价值，也能把 Codex 当前状态可视化。

想快速体验，可以直接用 Petdex：

npx petdex install boba

想要专属宠物，就用 Skill Installer 安装 hatch-pet，然后让 Codex 帮你孵化：

使用 hatch-pet，帮我做一个洛克王国迪莫宠物。

生成后到：

Settings -> Appearance -> Pets -> Custom pets

选择它，你的桌面上就会多一个陪你写代码的小伙伴。

对我来说，这个功能最有意思的地方不是“宠物很可爱”，而是它把 AI 编程工具从一个冷冰冰的窗口，变成了一个有状态、有反馈、甚至有一点陪伴感的工作伙伴。

参考链接

• Petdex 官网：https://petdex.crafter.run/
• Petdex 创建宠物说明：https://petdex.crafter.run/zh/create
• Petdex 关于页面：https://petdex.crafter.run/about
• 参考文章：https://silenceper.com/article/2026-05-06-petdex-codex-pets/