Codex宠物自定义是 OpenAI 为 Codex 桌面端与终端提供的趣味功能，让你在写代码的同时养一只会动的陪伴宠物。
它分成两条路线：一条是直接使用内置宠物，另一条是上传自己的透明图片生成专属宠物。本文按桌面端、终端、技能生成三条路径，把 Codex宠物自定义 的入口、上传规格、设置方式与常见限制一次说清，并附上避坑要点。
Codex宠物自定义是什么
Codex宠物自定义指的是在 Codex 运行界面里加入一只动画陪伴宠物。它最早出现在 Codex 桌面应用，后来终端也支持了同类能力。宠物不改变代码逻辑，也不占用任务额度，只是把工作界面变得更有人情味。从实现上看，它分成两块：其一是官方预置的几只内置宠物，打开就能用；其二是用户自己准备的透明素材，按指定规格上传后变成独一无二的形象。
理解这两块的区别很重要，因为它们的操作入口、文件要求和适用环境并不完全一样。内置宠物偏即开即用，自定义上传偏个性表达。下文先说内置阵容，再说上传规格，最后补上终端与技能两条容易被忽略的路径。只要先分清自己要走哪条线，后面的操作都不复杂。
从产品定位看，宠物属于桌面端与终端的装饰层，和代码生成、命令执行完全分离。你让它待在角落，它不会影响任何一次任务的输入输出。也正因如此，自定义宠物成了很多人第一次认真玩 Codex 的入口，先被那只鸭子吸引，才慢慢发现背后的智能体能力。
Codex内置宠物有哪些
桌面端首次进入时，右下角就会出现一只默认宠物。官方预置的阵容里，有一只叫 Dewey 的鸭子形象，有受经典蓝屏启发的丧气风格，还有一款蓝色的默认款。它们不需要任何配置，随应用启动自动出现。不同版本看到的预置宠物可能有差异，具体以你当前客户端为准。
如果你只想轻量体验，内置宠物已经足够，不必急着做自定义上传。下面这张表列出常见内置宠物的特征与出现方式，方便你快速认出自己桌面上那只小伙伴。
内置宠物的位置固定在桌面应用窗口的右下角，不会挡住代码区，也不会抢输入框焦点。在同一个设置入口里，通常还能在几只预置形象之间切换，挑一只最合眼缘的常驻。预置阵容会随客户端版本变化，新版本可能增加或替换某些形象，旧版本看到的不一定和新版本一致。
Codex自定义宠物上传规格
想做真正属于自己的宠物，要走上传路线。官方对素材有明确要求，缺一项都可能上传失败。第一，图片必须是透明背景的 PNG 或 WebP；带底色的方块会被直接显示出来，破坏观感。第二，像素尺寸必须恰好是 1536 乘 1872，比例不对会被拉伸或拒收。第三，单文件大小不能超过 20 MiB，过大同样会失败。这些数字不是建议值，而是硬门槛。
很多上传报错，根因都出在这三条上：底色没抠干净、尺寸只差几个像素、或者文件压得不够小。准备素材时，最好先用图像工具把画布设成精确尺寸再导出。下面这张表把每一项要求和超限后的表现列清楚，照着核对能省掉大部分返工。
为什么是 1536 乘 1872 这个尺寸，官方没有公开解释细节，但从业者普遍认为它对应精灵图表的固定帧布局，便于客户端按格子切出连续动作。这个尺寸看来不是随便定的，上传前照它出图最稳。透明背景则要靠 PNG 的 alpha 通道或 WebP 的透明层实现，用工具导出时务必勾选保留透明区域。
桌面端与终端怎么设置Codex宠物
桌面端的宠物在应用右下角常驻，通常在设置里能找到相关开关与外观选项，启动即显示，基本不用额外配置。终端则走另一套机制：在支持的终端里输入斜杠命令 /pets 或 /pet 即可唤起宠物，输入 /pets off 可以关闭。要注意，终端宠物对运行环境有要求，并非所有终端都能渲染。
把两条路径对照着看会更清楚：桌面端是图形界面里的常驻形象，终端端是命令行里的轻量陪伴。下面的表整理了不同形态的唤起方式与适用环境，方便你对照自己的客户端，少做无用尝试。
桌面端的宠物设置通常集中在应用的设置里的 Pets 分区，里面能看到当前形象、切换开关与少量外观选项。终端这边没有图形开关，全靠斜杠命令控制，好处是远程会话里也能用。如果你的终端是普通系统自带终端，可能不在支持列表，这时先确认自己用的是 iTerm2 还是支持 Sixel 的终端模拟器。
| | |
|---|
| | Codex 桌面应用，支持 macOS 与 Windows |
| 输入 /pets 或 /pet 唤起，/pets off 关闭 | iTerm2 3.6 以上或支持 Kitty、Sixel 的终端 |
| | |
用Hatch Pet技能生成自定义宠物
如果你不想手动抠图，可以用官方 Hatch Pet 技能来生成。它会产出一份 pet.json 描述文件，外加一张精灵图表，描述宠物的动作与帧序列。生成结果默认存放在用户目录下的 ~/.codex/pets 文件夹里。也就是说，自定义宠物本质上是一组本地文件，你完全可以复制、备份，甚至在不同机器间迁移。
技能生成的宠物和普通上传宠物在终端与桌面端的表现一致，区别只在于素材来源一个是手工，一个是程序化产出。对手工抠图有困难的用户，这条路径更省心。需要提醒的是，既然文件落在本地，清理客户端缓存或重装系统时记得先备份这个目录，否则辛苦生成的宠物会一起消失。
Hatch Pet 技能的工作方式和手动上传不同，它根据一段描述自动画出多帧动作，再打包成宠物能识别的格式。对不会画图的人来说，这条路比抠 PNG 轻松很多。生成结束后，技能会把文件写进 ~/.codex/pets，你在该目录里能看到 pet.json 与那张精灵图表并排存放。
IDE扩展与移动端的Codex宠物支持
需要提醒的是，宠物并非无处不在。官方 IDE 扩展（如 VS Code、Cursor、Windsurf 等侧边栏版本）目前没有提供宠物选择器，你在编辑器里看不到那只鸭子。移动端同样不在支持范围。宠物的主场是桌面应用与特定终端。明白这个边界能省掉很多无效寻找：如果在 IDE 或手机里死活找不到宠物入口，那不是你操作错了，而是那个环境本来就没有。
把宠物相关操作集中在桌面端和终端，体验最完整。编辑器里该做的事仍然是写代码、跑任务、看改动，宠物就让它留在它该待的地方。这样既能享受陪伴，又不会打乱正常的工作流。
之所以 IDE 和移动端不支持，和它们的渲染方式有关。编辑器侧边栏以文本与按钮为主，没有为动画宠物预留位置；手机屏幕本就小，再塞一只宠物反而碍事。这不是疏忽，是产品取舍。桌面和终端才是它的主场，把注意力放回这两处就好。
Codex宠物自定义之外还能自定义什么
宠物只是 Codex 自定义能力的一块。另一个常被一起提到的维度是人格与指令自定义。在应用设置里，你可以选择 Friendly、Pragmatic 或 None 三种沟通风格，也能写自定义指令。这些偏好最终会落到 AGENTS.md 这类指令文件里，分为全局层与项目层，越靠近当前目录优先级越高。
不过人格自定义影响的是 Codex 说话和做事的方式，和宠物的视觉陪伴是两回事。想让界面更顺手，可以两条线一起调；只想好玩，专注宠物就够了。两者互不冲突，也不会因为改了其中一项就影响另一项。理清这个关系，自定义起来会更从容。
顺带一提，人格自定义也有自己的文件落点。全局指令写在 ~/.codex/AGENTS.md，或用 AGENTS.override.md 覆盖，二者取第一个非空文件；项目层从仓库根目录逐层向上读取，每个目录最多一份，总大小上限 32 KiB。应用设置里的 Friendly、Pragmatic、None 只是快捷入口，本质上都在改这份指令文件。
宠物自定义的避坑要点
- 只走官方客户端：自定义宠物素材请通过 Codex 官方应用上传，不要从第三方下载所谓宠物包，里面可能夹带不明脚本。
- 透明背景是硬要求：上传图片务必去掉底色，否则宠物周围会出现难看的方块边缘。
- 尺寸必须精确：素材要正好是 1536 乘 1872 像素，差一点都可能被拉伸或拒收。
- 文件别超过 20 MiB：单张过大上传会直接失败，先用工具压缩到限额以内。
- 终端要看运行环境：终端宠物依赖 iTerm2 3.6 以上或支持 Kitty、Sixel 的终端，tmux 与 Zellij 暂不支持。
- IDE 与移动端没有入口：官方编辑器扩展和手机端不提供宠物选择器，别在这些环境里找。
- 本地文件记得备份：自定义宠物存在 ~/.codex/pets 目录，重装或清理缓存会丢失，重要形象先备份。
- 宠物只是装饰：它不影响代码、额度与权限，不要为了宠物给客户端开过高的系统权限。
- 以官方文档为准：宠物功能与上传规格会随版本调整，遇到不一致时以 OpenAI 官方文档当期说明为准。
常见问题
问：Codex宠物自定义要另外付费吗？ 答：不需要。宠物是 Codex 客户端自带的趣味功能，包含在常规使用里，没有单独的价格档位。
问：自定义宠物支持哪些图片格式？ 答：官方要求透明背景的 PNG 或 WebP，且像素必须恰好 1536 乘 1872，单文件不超过 20 MiB。
问：终端里怎么呼出 Codex 宠物？ 答：在支持的终端输入斜杠命令 /pets 或 /pet 即可唤起，输入 /pets off 可以关闭。
问：为什么我的终端看不到宠物？ 答：终端宠物需要 iTerm2 3.6 以上或支持 Kitty、Sixel 的终端，tmux 与 Zellij 等环境暂不渲染。
问：手机端能用 Codex 宠物吗？ 答：目前宠物主要在桌面应用与特定终端运行，移动端没有宠物选择器，手机里看不到。
问：Hatch Pet 技能生成的文件存在哪？ 答：技能会产出 pet.json 与精灵图表，默认存放在用户目录的 ~/.codex/pets 文件夹里。
问：自定义宠物有数量或大小限制吗？ 答：单文件上限是 20 MiB，像素要精确 1536 乘 1872；能同时放几只以客户端当期支持为准。
问：自定义宠物会被官方审核吗，安全吗？ 答：宠物素材是你本地的图片与文件，存储在 ~/.codex/pets，由你自己管理，不涉及官方审核。
问：新手先试哪种 Codex宠物自定义？ 答：建议先从内置宠物体验，熟悉后再用一张透明 PNG 上传，循序渐进最省心。
总体来看，Codex宠物自定义 是一条低门槛、高趣味的陪伴路线。只是让你的工作界面多一只会动的小伙伴。无论你选内置宠物还是自己上传素材，只要守住透明背景、精确尺寸与文件大小这三条，基本都能一次成功。把宠物放在桌面端与支持的终端里使用，体验最完整。希望这篇能帮你少走点弯路，轻松玩转 Codex宠物自定义。
AI 速览
