Codex デスクトップペットを自作する DIY チュートリアル

2026-07-16 更新 · 公式の手順を検証済み

Codex App のデスクトップペットは、内蔵のあの数匹しか使えないわけではありません。公式はカスタマイズの入口をきちんと用意しています。仕様どおりのスプライトシート 1 枚と pet.json 1 つを用意してローカルのフォルダに置けば、あなたが描いたどんなキャラクターもデスクトップに住めます。さらに手軽なのは、公式が hatch-pet というスキルを出していること。参考画像を数枚渡せば、アニメーション一式を代わりに描いてくれます。この記事では両方のルートをきっちり説明し、最後に実例で締めます——カピバラのスタンプ 2 枚が、どうやって動くデスクトップペットになったのか。

これは公式のやり方？

はい。hatch-pet は OpenAI の公式スキルリポジトリ openai/skills の curated（厳選）ディレクトリに収録されています。ペットのキャンバス仕様、9 行のアニメーション状態、行ごとのフレーム数と再生時間は、すべて公式のコントラクトファイルで固定されています。ひとつ注意点：このリポジトリは現在、移行済みと表示されており、新しいスキルのエコシステムは openai/plugins にあります。ただし hatch-pet 自体は元の場所のままインストールでき、問題なく使えます。

ペットの実体は、多くの人の予想を超えるほど単純です——ファイルはたった 2 つ：

~/.codex/pets/あなたのペットid/
├── pet.json          # 4 個のフィールドのメタデータ
└── spritesheet.webp  # 1536×1872 スプライトシート(PNG でも可)

仕様の細部（各行のアニメーションが何フレームか、どのマスを透過のまま空けるか）は早見表にまとめました。スプライトシート仕様の詳解をご覧ください。

ルート 1：hatch-pet で AI に描いてもらう

手描きの繊細な質感が欲しくて、すでに Codex App を使っている人向け。前提として Codex に公式の画像生成スキル（$imagegen、新しいバージョンなら通常は標準搭載）が入っていること。

1. インストール：Codex の対話で $skill-installer hatch-pet と入力し、終わったら Codex を再起動；
2. 依頼する：「___ のペットを孵して」と伝えるだけ。文字の説明だけでもよく、参考画像を添えても構いません——自社のマスコット、手描きのラフ、飼っているペットの写真でも。スタイルは pixel（ピクセル）、plush（ぬいぐるみ）、clay（粘土）、sticker（ステッカー）、3d-toy（3D トイ）などから選べ、指定しなければ自動で推測されます；
3. 作業を待つ：hatch-pet はまず基準となる姿を 1 枚生成して確認を求め、それから 9 種類のアニメーション（待機、左右走り、あいさつ、ジャンプ、失敗、待機中、作業、レビュー）を一行ずつ生成し、自動で 1536×1872 に組み立て、背景を透過にし、検証スクリプトを走らせます；
4. 有効化：成果物はそのまま ~/.codex/pets/ に出力されるので、ペット設定で選ぶだけです。

参考画像を渡すときの実用的なコツ：一度に 1〜3 枚、キャラクターが全身写っていて、背景がすっきりした画像がいちばん効きます。そして「同じ顔、同じ配色」をすべての動作行で保つよう指示すること——これは公式の QA 基準でもっとも重視される項目です。

ルート 2：コードで 1 フレームずつ描く

ガチャを回したくない、100% 制御したい人はこちら。当サイトの 91 匹はすべて Python + Pillow によるプログラム生成です。小さなグリッド上に色ブロックで体を組み立て、状態ごとに各フレームへパラメータを当て、最後に規格どおりの大きな画像に組み立てます。描画エンジンを一度作ってしまえば、新しいペットを 1 匹足すのに必要なのは十行の設定だけ。全体の考え方とフレーム数の設計は使い方ガイドの自作の章に書いてあります。

実践：スタンプ 2 枚から、ペット 1 匹へ

ある読者からカピバラのスタンプ 2 枚が届き、「こういうのでも作れますか」と質問がありました。作れます。しかもこれこそ、画像からのカスタム作成の標準フローです。手順は 3 つ：

1. トレースではなく、特徴を抽出する：参考画像から取り出すのは特徴のリストです——ミルクティー色の丸い体、顔の半分を占める濃色の楕円の口元、小さな丸い耳、チーク、全体にけだるいごろ寝の姿勢、暖かい茶色の輪郭線；
2. 特徴に沿って描き直す：このリストをもとにピクセルグリッド上でオリジナルのカピバラを描き、9 行のアニメーションを作ります（ごろ寝系ですがジャンプも真面目に跳びました）；
3. 公式の検証を通す：公式リポジトリの validate_atlas.py でサイズ、フレーム数、透過を一通り検証し、全部グリーンになってから公開します。

完成品は Paka ごろ寝カピバラ。ページ上で 9 種類の状態をそのままプレビューでき、無料でダウンロードできます。

いちばん失敗しやすい 5 点

• 行ごとにフレーム数が違う：待機は 6 フレーム、あいさつは 4 フレーム、ジャンプは 5 フレーム、走りと失敗は 8 フレーム、残りは 6 フレーム——余分に描いたマスはマスまるごと透過でなければ検証を通りません；
• ジャンプでマスをはみ出さない：ペット全体（耳や帽子を含む）が、どのフレームでも 192×208 に完全に収まっていること；
• 透過はきれいに：半透明の影、地面の影、スピード線は残せません。透過ピクセルの中に RGB の残り値を隠すのも NG；
• フォルダの階層：pet.json は pets/ペットid/ の直下に置くこと。展開時にフォルダがもう一段挟まるのが、「ペットが出てこない」原因のダントツ 1 位です；
• working の行は走りではない：公式はこの行を「集中して作業している様子」と明記しています。脚を踏み出して走る絵にすると不合格になります。

より完全な仕様表（公式の行別再生時間つき）はこちら。

手を動かしたくない人へ

当サイトにはすでに 91 匹そろっています：オリジナル図鑑 50 匹 + インスパイア系 41 匹。すべて公式の検証スクリプトを通過済み、無料ダウンロード、改変も自由です。各詳細ページには PowerShell のワンライナーインストールコマンドがあるので、30 秒で カピバラやサイバー猫があなたのデスクトップに引っ越してきます。