Portdan 文档中心

10 分钟桌宠领养课

让咕咚陪你跑 Codex

装好一只会跟随任务状态变换动作的兔子国王，再用一个只读小任务看懂它的四种工作表情。

一键领养咕咚先逛宠物画廊
  • 334 Star专项仓热度
  • 153 只画廊收录
  • 2026-07-20本站核验
READY
原创桌宠咕咚戴着王冠和酒红色披风眨眼待命原创桌宠咕咚戴着王冠和酒红色披风静止待命
咕咚 · 作者 Rank · CC BY 4.0

先给它找个住处 ​

桌面 App · 完整支持

可以显示浮动宠物、活动托盘，并在多个任务之间提示状态。

Codex CLI · 支持

输入 /pets 或 /pet 打开选择器；终端需支持 Kitty、Sixel 或 iTerm2 3.6+。

IDE 扩展 · 暂不支持

VS Code、Cursor 等 IDE 扩展没有宠物选择器和浮动层，请换桌面 App 或 CLI。

终端里看不到宠物？

CLI 宠物在 tmux 和 Zellij 中不可用。先退出这两类复用器，再在受支持的终端运行 /pets。

在画廊锁定咕咚 ​

打开 Awesome Codex Pet 画廊可以逐只查看动作。本课使用 gudong--rank。

领养编号
gudong--rank
角色名
咕咚
作者
Rank
创作类型
原创角色
精灵格式
Sprite v2
素材许可
CC BY 4.0
许可可用于本站咕咚明确采用 CC BY 4.0，允许在保留署名的前提下展示和改编。

一键领养 ​

下面的主按钮使用 OpenAI 官方 Pets 深链。

咕咚已经收好行李精灵图固定到 d5e1b936735e，Sprite v2，来源可复查。
打开 Codex 领养

如果按钮没有反应，先确认桌面 App 已安装并更新到支持 Pets 的版本。账号或工作区尚未开放 Pets 时，Settings 中也不会出现对应入口。

macOS / Linux 备用命令固定提交并关闭匿名统计

运行前可先打开固定版本脚本检查内容。

curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/d5e1b936735e8bc68df906b80a5e3c6955400047/scripts/install-pet.sh \
  | AWESOME_CODEX_PET_NO_STATS=1 \
    AWESOME_CODEX_PET_RAW_BASE=https://raw.githubusercontent.com/legeling/awesome-codex-pet/d5e1b936735e8bc68df906b80a5e3c6955400047 \
    bash -s -- gudong--rank
Windows PowerShell 备用命令固定提交并关闭匿名统计

三行需在同一个 PowerShell 窗口依次执行。

$env:AWESOME_CODEX_PET_NO_STATS = "1"
$env:AWESOME_CODEX_PET_RAW_BASE = "https://raw.githubusercontent.com/legeling/awesome-codex-pet/d5e1b936735e8bc68df906b80a5e3c6955400047"
iwr -UseB "$env:AWESOME_CODEX_PET_RAW_BASE/scripts/install-pet.ps1" | iex
Install-CodexPet gudong--rank

备用脚本会写入本机

上游脚本会把文件写到 .codex/pets，并在未设置 AWESOME_CODEX_PET_NO_STATS=1 时上报一次匿名安装计数。不熟悉 Shell 时优先使用上面的官方深链。

把它叫醒 ​

  1. 完全退出并重新打开 Codex。
  2. 打开 Settings，进入 Pets。
  3. 选择 咕咚。使用备用脚本时，列表中的标识是 gudong--rank。
  4. 输入 /pet，或从命令菜单选择 Wake Pet。

再输入一次 /pet，或在 Settings > Pets 选择 Tuck Away Pet，咕咚就会回窝。宠物选择和浮窗位置会在重启后保留。

领养完成看到咕咚浮在桌面，或者 CLI 中出现宠物动画，就可以开始体验任务。

用一个只读任务看懂表情 ​

选择一个带 README 的本地项目，在新任务中发送：

text
请只读检查当前项目的 README，用一句话告诉我这个项目是做什么的。不要修改文件。

发送后观察咕咚的动作变化，再把它与下面四种状态对上。

Running · 正在忙

当前任务仍在处理。

Needs input · 等你回应

任务需要批准、回答或其他决定。

Ready · 有新结果

任务已完成，但你还没看过最新活动。

Blocked · 遇到阻碍

任务失败，或碰到了系统错误。

多个任务同时活动时，宠物依次优先显示 Needs input、Blocked、Ready、Running。点击宠物可返回 App，打开活动托盘则能选择对应任务。

喂养、更新与告别 ​

通过官方深链安装的宠物可在 Settings > Pets 中管理。使用本课备用脚本时，咕咚位于下面的固定目录：

  • macOS / Linux：~/.codex/pets/gudong--rank/
  • Windows：%USERPROFILE%\.codex\pets\gudong--rank\

更新时重新运行领养流程即可覆盖同名宠物。卸载前完全退出 Codex，只删除 gudong--rank 这个目录，再重新打开 App 并在 Pets 中选择其他宠物。不要删除整个 .codex，其中还有配置、登录状态和会话数据。

备用脚本的文件清单pet.jsonspritesheet.webp

彩蛋：孵一只自己的宠物 ​

想把咕咚换成自己的角色，可以在 Settings > Pets 选择 Create your own pet。Codex 会安装内置 hatch-pet Skill、重新加载 Skills 并打开新任务；描述角色并完成生成后，回到 Pets 选择 Refresh，再选中它。

现在可以先查看上游的 Create your own pet 指南和投稿规范，了解精灵图网格、元数据和 PR 检查。

来源与许可 ​

  • 项目源码：legeling/awesome-codex-pet@d5e1b936735e，代码、脚本和站点基础设施采用 MIT。
  • 默认宠物素材：仓库默认采用 CC BY-NC 4.0，仅限非商业使用；每只宠物声明的单独许可优先。
  • 本课咕咚素材：作者 Rank，原创角色，CC BY 4.0；原始 spritesheet.webp 的 SHA-256 为 9a2cf19c6b2a24ac5e5950576d65ae957890938a416b5e177f0f93e48555c0f3。
  • 本站处理：只从原始精灵图裁切待机动作，生成 384 × 416 动态 GIF 和首帧 WebP；没有复制仓库封面、默认宠物预览或完整源码。
  • 署名记录：咕咚 CC BY 4.0 与衍生预览说明。
  • 产品行为：以 OpenAI Pets 官方文档和 Pets 深链参数为准。

Portdan API 接入、配置与排查指南。

Copyright © 2026 Portdan