Codex Pet

Codex 宠物安装教程

如何安装 Codex 小宠物

最短答案：先在 Awesome Codex Pet 画廊选择一只宠物，打开详情页复制完整安装命令；运行后彻底重启 Codex，再到“设置 → 宠物”中启用。整个过程不需要克隆素材仓库。

选择 Codex 宠物查看安装命令

两分钟完成

安装 Codex 宠物的三个步骤

  1. 01

    在画廊选择宠物

    查看动作预览、作者、许可证和 V1/V2 版本，进入详情页后复制完整 pet id。

  2. 02

    运行详情页提供的命令

    macOS 与 Linux 使用 Bash；Windows 使用 PowerShell。详情页中的命令已经替换好宠物标识符。

  3. 03

    重启 Codex 并启用

    安装完成后彻底退出 Codex，重新打开“设置 → 宠物”，选择刚安装的自定义宠物。

官方远程安装器

macOS、Linux 与 Windows 安装命令

下面展示命令格式。请把 <pet-slug--author-slug> 替换为详情页显示的完整宠物标识符；最稳妥的方式是直接复制详情页已经替换好的命令。

macOS / Linux（Bash）

curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- <pet-slug--author-slug>

Windows（PowerShell）

powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -UseB https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.ps1 | iex; Install-CodexPet <pet-slug--author-slug>"

安装验证

如何确认安装成功

  1. 在 ~/.codex/pets/<pet-id>/ 中确认同时存在 pet.json 和 spritesheet.webp。
  2. 确认 pet.json.id 与宠物目录名称完全一致。
  3. 彻底退出并重新启动 Codex，让自定义宠物目录重新载入。
  4. 打开“设置 → 宠物”，选择新安装的宠物。

故障排查

Codex 宠物安装常见问题

Codex 小宠物会安装到哪里？

默认安装到 Codex 主目录下的 pets/<pet-id>/。macOS 和 Linux 的默认主目录是 ~/.codex，Windows 通常是 %USERPROFILE%\.codex。

为什么命令里的宠物标识符不能直接运行？

命令中的 <pet-slug--author-slug> 是占位符。请先打开宠物详情页，复制该宠物显示的完整标识符或已经替换好的安装命令。

安装后为什么看不到 Codex 宠物？

确认宠物目录中同时存在 pet.json 和 spritesheet.webp，检查 pet.json.id 与文件夹名完全一致，然后彻底退出并重启 Codex，再打开“设置 → 宠物”。

安装脚本会覆盖其他宠物吗？

不会。安装器只写入目标宠物自己的目录；不同 id 的 V1、V2 宠物可以同时存在。