[Codex]커스텀 펫 만들기 : 분홍 고양이 Ruby

Codex Desktop에 작업 중 화면 위에 띄워둘 수 있는 작은 pet 기능이 추가되었다.

기본 pet도 있지만, hatch-pet 스킬을 이용하면 직접 만든 캐릭터를 Codex pet으로 등록할 수 있다. 내 경우에는 연분홍색과 흰색 조합의 호기심 많은 고양이 Ruby를 만들었다.

• 이름: Ruby
• 캐릭터: 귀여운 연분홍색 고양이
• 색상: 연핑크와 화이트
• 성격: 호기심 많음
• 포인트: 빨간 리본, 똘망똘망한 눈

만든 방법

Codex에서 hatch-pet 스킬을 사용해 다음 프롬프트로 생성했다.

Use hatch-pet to make a custom Codex pet: Ruby, a cute pale pink and white cat with bright sparkling eyes, curious personality, and a red ribbon.

작업 흐름은 대략 이렇게 진행된다.

1. 기본 캐릭터 이미지를 만든다.
2. 그 이미지를 기준으로 각 애니메이션 포즈를 만든다.
3. 포즈별 이미지를 Codex pet 규격의 프레임으로 자른다.
4. 1536x1872 크기의 spritesheet.webp로 묶는다.
5. pet.json과 함께 ~/.codex/pets/<pet-name>/에 설치한다.
6. Codex 설정에서 custom pet을 선택한다.

여기서 중요한 점은 마지막 단계다. 파일만 넣었다고 바로 바뀌지 않을 수 있다. 공식적으로는 Codex 앱 안에서 직접 선택해야 한다.

적용하는 방법

https://mir.so/wp-content/uploads/2026/05/ruby-codex-pet.zip

Ruby를 다른 사람이 쓰려면 pet.json과 spritesheet.webp 두 파일을 같은 폴더에 넣으면 된다.

Windows 기준:

mkdir $env:USERPROFILE\.codex\pets\ruby
copy pet.json $env:USERPROFILE\.codex\pets\ruby\pet.json
copy spritesheet.webp $env:USERPROFILE\.codex\pets\ruby\spritesheet.webp

macOS 또는 Linux 기준:

mkdir -p ~/.codex/pets/ruby
cp pet.json ~/.codex/pets/ruby/pet.json
cp spritesheet.webp ~/.codex/pets/ruby/spritesheet.webp

그다음 Codex Desktop을 재시작하고 아래 메뉴로 들어간다.

Settings > Appearance > Pets

목록에서 Ruby를 선택한 뒤 /pet 명령을 실행하면 화면에 Ruby가 나타난다. 목록에 바로 보이지 않으면 같은 화면의 refresh 버튼을 눌러 custom pets를 다시 읽으면 된다.

정상 동작 확인

적용 후에는 세 가지를 확인하면 된다.

1. Settings > Appearance > Pets에서 Ruby가 선택되어 있는지 확인한다.
2. Codex 입력창에서 /pet을 실행했을 때 기본 pet이 아니라 Ruby가 뜨는지 확인한다.
3. 대기, 달리기, 점프 같은 애니메이션이 깨지지 않고 자연스럽게 나오는지 확인한다.

이번 Ruby 패키지는 생성 후 검증 파일에서 오류 없이 통과했다.

validation.json: errors: [], warnings: []
review.json: errors: [], warnings: []

정리

Codex custom pet은 결국 두 파일로 구성된다.

• pet.json: pet 정보
• spritesheet.webp: 애니메이션 스프라이트시트

이 두 파일을 ~/.codex/pets/<pet-name>/ 아래에 넣고, Codex의 Settings > Appearance > Pets에서 선택하면 된다. Ruby처럼 간단한 캐릭터 설정만 있어도 hatch-pet 스킬을 이용하면 Codex에서 실제로 움직이는 custom pet으로 만들 수 있다.