hatch pet Codexの使い方｜自作ペットの作成と表示設定

hatch pet Codexとは何か、現在の公式案内を確認する

「hatch pet codex」は検索用の語句ですが、実際の機能を理解するときは、現在の公式ページがどのアプリを説明しているかを確認する必要があります。2026年10月28日に確認したところ、従来のCodex配下にあるPetsのURLは、ChatGPT LearnのPetsページへ移動しました。移動先には対象としてChatGPTデスクトップアプリが表示され、macOSとWindowsでペットを他のアプリの上に表示できると説明されています。

なぜ今確認する意味があるのかというと、検索結果に残っている製品名と、実際に操作する画面の名称が一致するとは限らないためです。古い説明をそのままなぞるより、公式文書の現在の入口を基準にすると、CLIへ不要な文字列を入力したり、違う設定画面を探し続けたりする時間を減らせます。本記事も現在の表示に合わせて説明します。

公式の作成手順では、Create petを選ぶと同梱のhatch-petスキルが導入され、スキルを読み直した後に新しい会話が開くとされています。ここで利用者が行うのは、作りたいペットの希望をその会話へ送ることです。一般のターミナルで「hatch pet codex」という語句を実行する手順ではありません。出典はOpenAI公式Pets文書です。従来のCodex側の案内URLからも移動先を確認できます。

作成前に決めておくと伝わりやすいこと

自作ペットの依頼では、最初に見た目の中心となる特徴を絞ると確認が楽になります。これは公式が必須の入力項目として定めたものではなく、希望を伝えるための実用上の工夫です。「かわいいもの」とだけ書くより、動物の種類、主な色、体の形、表情、動きの雰囲気を短い文章にまとめると、完成後の比較対象ができます。

デスクトップ上では小さく表示されるため、細い文字や小さな装飾を大量に入れると、自分の目でも違いを判断しにくくなります。最初の一体では輪郭と配色を優先し、装飾は一つ程度にするとよいでしょう。たとえば「丸い白猫で、耳だけ青く、眠そうな表情。待っているときは穏やかに動く」と伝えれば、色、形、表情について具体的な確認ができます。

依頼文の例は「丸い体の白猫を作ってください。青い耳と短いしっぽを特徴にし、小さく表示しても輪郭が分かる姿にしてください。待機中は落ち着いた動きがよく、細かい文字や大きな持ち物は不要です」です。この文章は本記事の例であり、公式の定型文ではありません。最初から多数の条件を積み重ねず、譲れない特徴を先に決めるための参考にしてください。

完成後に直したい点が出た場合も、「もっとよくして」より「耳の青を少し暗く」「しっぽを短く」と対象を特定すると希望を伝えやすくなります。ただし、文章で希望した内容がすべてそのまま反映されると保証されるわけではないため、実際の姿と動きを見て判断します。

自作ペットを作成して選択する手順

公式文書が示す作成の入口はSettingsのPetsです。まずアプリ本体を開き、該当する設定があるかを確認します。画面に機能が見当たらないときは、作成用の会話を探す前に、アプリの更新状態や所属先でPetsの利用が認められているかを確認してください。公式には、操作部分が利用できない場合にアプリの更新と組織側の許可を確認する案内があります。

ここでは作成、依頼、一覧の更新、選択を別の操作として扱います。画像らしいものが会話に表示された時点と、設定一覧から選べる状態になった時点を混同しないことが大切です。途中で別の設定をまとめて変えるより、どこまで進んだかを一つずつ確認すると、完成後に見つからない場合も原因を絞りやすくなります。

Step 1: SettingsのPetsから作成を始める

Settingsを開いてPetsへ進み、Create petを選びます。公式説明では、この操作によって必要なスキルの導入と再読み込みが行われ、新しい会話が開きます。会話が開いたら、自分が今から送る依頼がペット作成用のものかを画面で確かめてください。CLIに別の導入コマンドを入力したり、独自の保存先を準備したりする操作は、公式のこの手順には含まれていません。

Step 2: 希望する姿を文章で送る

開いた会話に、事前に決めた形、配色、表情などを文章で送ります。作成中に追加の確認を求められた場合は、その内容に沿って希望を補足します。最初の依頼を送った後に、相反する条件を何度も重ねると自分でも完成の基準が分かりにくくなるため、まずは主要な特徴が表現されたかを確認する方針にすると扱いやすくなります。

Step 3: 完了後にRefreshで一覧を更新する

作成が終わったらSettingsのPetsに戻り、Refreshを選びます。その後、新しく作ったペットを一覧から選択します。公式はこの更新操作を明示しているため、会話の完了だけで一覧の表示まで済んだと考えないことがポイントです。選択した姿が期待したものかを確認し、複数の候補がある場合は見た目を見比べてから決めます。作成から選択までの根拠は公式のCreate a custom petの説明にあります。

表示サイズと動きを作業環境に合わせる

ペットを選んだ後は、作業中に文字やボタンを隠さない位置と大きさに調整します。公式では、ペットをドラッグして移動でき、SettingsのPetsにあるCustomizeからPet sizeを変更できると説明しています。大きさを調整しすぎた場合はResetで標準のサイズに戻せます。見た目の好みだけでなく、エディタや会話画面を読む邪魔にならないかも基準になります。

表示と非表示の切り替えには、アプリの会話入力で使う/petや、コマンドメニューのShow petなどが案内されています。これはペット作成を始めるCreate petとは役割が異なります。姿を作り直すための操作と、すでに選んだ姿を見せるための操作を区別すると、一覧に存在するのに画面に出ていない場合にも確認しやすくなります。

公式文書ではmacOSの標準ショートカットをOption+Space、WindowsをWindows+Alt+Pとし、SettingsのKeyboard shortcutsからShow petを変更できるとしています。別のアプリと操作が重なる場合は設定を見直し、自分が覚えやすい方法にそろえます。ここで挙げたキーは公式の標準値なので、すでに変更した端末では現在の設定表示を優先してください。

動きが気になるときは、OSの「視差効果を減らす」など、動きを抑える設定も確認します。PetsはOS側の動きを減らす設定に従い、有効な場合はアニメーションの代わりに静止したフレームを表示すると公式に説明されています。動いていないことだけで作成失敗と決めず、設定による表示なのかも確かめましょう。表示方法の根拠は公式Pets文書の表示とReduce animationの説明です。

ペットから会話を始めるときの注意点

ペットの下に表示される操作部分からは、入力や音声によって会話を始められます。公式には、鉛筆のアイコンから依頼を入力し、ベルのアイコンから進行中の会話を確認する使い方が案内されています。コードを読んでいる途中に短い相談を始めたいときなど、メイン画面を探す入口として利用できます。ただし、どの文脈で始まる会話なのかは事前に理解しておく必要があります。

特に重要なのは、ここから開始した会話がプロジェクトの外で作られることです。公式文書は、プロジェクトの文脈を使いたい場合には、メインアプリの該当プロジェクトから会話を始めるよう説明しています。開発中のコードについて相談する際、ペットを出しただけで対象のプロジェクト情報も付くと思い込むと、必要な前提を欠いた依頼になります。

たとえば、設計方針を登録したプロジェクトでコード修正を相談したいなら、そのプロジェクトを開いて依頼する方が意図に合います。一方、一般的な構文の質問や文章の言い換えなど、特定のプロジェクトを必要としない短い相談は、ペットの入口から始める使い方も考えられます。これは使い分けの例であり、質問内容に応じて必要な情報を自分で添えることが前提です。

状態表示を読み、必要な会話を開く

公式のPets文書では、作業中のRunning、回答や判断を求めるNeeds input、完了後に未読の動きがあるReady、失敗やシステム上の問題を示すBlockedという状態が説明されています。表示は会話を確認するための目印として使い、変更内容の正しさやテスト結果は会話本体で読みます。Readyになったことと、利用者による成果の確認が済んだことは別です。

複数の会話に動きがある場合は、入力を必要とするものが優先され、その後にBlocked、Ready、Runningの順で扱われると説明されています。ひとつの姿だけを見て、すべての会話が同じ状態だと判断しないようにしてください。ベルから会話の一覧を開き、対象の会話を選ぶことで、具体的に何が必要なのかを確認できます。

AIコーディング作業なら、確認を求められた変更範囲、追加の質問、失敗の内容をそれぞれ会話で読み、必要な判断を行います。ペットの外見を変えても作業の進め方は変わらないと公式に明記されているため、うまくいかない作業を直す目的で別の姿へ替える必要はありません。依頼の内容や返ってきた結果を確かめることが、問題を解くための次の行動になります。

作ったペットが見つからない場合の確認手順

作成したはずのペットを選べない場合は、作成した端末と現在見ている端末が同じかを確認します。公式には、デスクトップアプリで作った自作ペットはそのコンピューターに保存され、ChatGPTのWeb版にはそのまま同期されないと書かれています。会話の履歴が見えるからといって、ペットの保存状態も同じだと判断しないことが大切です。

調べる順序は、作成の完了、一覧の更新、選択、表示の順にそろえると分かりやすくなります。画像ファイルの内部構造などを先に調べるより、公式が案内する画面操作でどこまで進んだかを確認してください。以下はその切り分けのために、本記事で整理した確認順です。

1. 作成用の会話を開き、完了したことを確認します。まだ質問への回答待ちなら、内容を読んで返答します。
2. 作成した端末のSettingsでPetsを開き、Refreshを選んで一覧を更新します。
3. 一覧に新しい姿があれば選択し、表示を切り替える操作で画面に出るかを確認します。
4. 操作部分自体が利用できなければ、アプリの更新状態と組織側でPetsが許可されているかを確認します。
5. 表示はあるが動かない場合は、OSで動きを減らす設定が有効になっていないかを確認します。

それでも状況が変わらない場合は、使用中のOS、アプリの版、作成した端末、どの操作まで進めたかを控えます。会話が終わらないのか、一覧に出ないのか、選択後に表示できないのかを言い分けると、問題の説明が具体的になります。根拠となる保存先と利用条件はOpenAI公式Pets文書で確認できます。