나만의 Codex 데스크톱 펫 만들기 튜토리얼

2026-07-16 업데이트 · 공식 사용법 검증판

Codex App의 데스크톱 펫은 내장된 몇 마리만 쓸 수 있는 게 아닙니다. 공식적으로 커스텀 입구가 완전히 열려 있습니다. 규격에 맞춰 스프라이트시트 한 장과 pet.json 하나만 준비해 로컬 디렉터리에 넣으면, 당신이 그린 어떤 캐릭터든 바탕화면에 살 수 있습니다. 더 편한 건, 공식적으로 hatch-pet이라는 스킬까지 나와 있다는 점입니다. 참고 이미지 몇 장만 던져주면 애니메이션 한 세트를 대신 그려줍니다. 이 글에서는 두 가지 길을 모두 짚고, 마지막엔 실제 사례로 마무리합니다. 카피바라 짤 두 장이 어떻게 돌아가는 데스크톱 펫이 되었는지.

이게 공식 사용법인가요

맞습니다. hatch-pet은 OpenAI의 공식 스킬 저장소 openai/skills의 curated(엄선) 디렉터리에 수록되어 있고, 펫의 캔버스 규격, 9행 애니메이션 상태, 행별 프레임 수와 길이는 전부 공식 컨트랙트 파일에 고정되어 있습니다. 한 가지 유의할 점은, 이 저장소가 현재 이전 예정으로 표시되어 있고 새로운 스킬 생태계는 openai/plugins에 있다는 것입니다. 다만 hatch-pet 자체는 여전히 원래 자리에서 설치하고 사용할 수 있습니다.

펫의 본체는 대부분의 예상보다 훨씬 단순합니다. 파일 딱 두 개입니다.

~/.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은 먼저 기준 이미지 한 장을 생성해 확인을 받은 뒤, 9가지 애니메이션(대기, 좌우 달리기, 인사, 점프, 실패, 대기, 작업, 리뷰)을 행별로 생성하고, 자동으로 1536×1872 대형 이미지로 합치고, 배경을 투명하게 따내고, 검증 스크립트를 돌립니다.
4. 활성화: 결과물이 곧바로 ~/.codex/pets/에 떨어지니, 펫 설정에서 선택하기만 하면 됩니다.

참고 이미지를 줄 때의 실용적인 팁: 한 번에 1~3장, 캐릭터 전신이 다 나오고 배경이 깔끔한 이미지가 가장 효과적입니다. 그리고 모든 동작 행에서 「같은 얼굴, 같은 배색」을 유지하라고 요구하세요. 공식 QA 기준에서 가중치가 가장 높은 항목입니다.

루트 2: 코드로 한 프레임씩 그리기

뽑기 운에 맡기기 싫고 100% 통제하고 싶은 사람은 이 길로 가세요. 이 사이트의 펫 91마리는 전부 Python + Pillow로 프로그래밍해서 생성했습니다. 작은 격자 위에 색 블록으로 몸을 조립하고, 상태별로 프레임마다 파라미터를 씌운 뒤, 마지막에 규격에 맞는 대형 이미지로 합칩니다. 드로잉 엔진을 한 번 잘 짜두면 새 펫을 하나 추가하는 데 설정 열 줄이면 됩니다. 전체 접근법과 프레임 설계는 사용 가이드의 직접 만들기 챕터에 적어 뒀습니다.

실전: 짤 두 장으로 데스크톱 펫 한 마리

어떤 독자가 카피바라 짤 두 장을 보내며 「이런 것도 만들 수 있나요」라고 물었습니다. 됩니다. 그리고 이게 바로 사진 기반 커스텀의 표준 프로세스입니다. 저희 방식은 세 단계입니다.

1. 따라 그리는 게 아니라 특징 뽑기: 참고 이미지에서 뽑아낸 건 특징 목록입니다. 밀크티색 둥근 몸, 얼굴 절반을 차지하는 짙은 타원형 주둥이, 작고 동그란 귀, 볼터치, 전반적으로 나른하게 늘어진 자세, 따뜻한 갈색 외곽선.
2. 특징에 따라 새로 그리기: 이 목록을 들고 픽셀 격자 위에 오리지널 카피바라 한 마리를 9행 애니메이션으로 그립니다(늘어진 계열이지만 점프도 성실하게 뛰었습니다).
3. 공식 검증 통과하기: 공식 저장소의 validate_atlas.py로 크기, 프레임 수, 투명도를 검사해 전부 초록불이 떠야 등록합니다.

완성품의 이름은 Paka 늘어진 카피바라입니다. 페이지에서 9가지 상태를 바로 미리 보고 무료로 받을 수 있습니다.

가장 많이 넘어지는 다섯 지점

• 행마다 프레임 수가 다릅니다: 대기 6프레임, 인사 4프레임, 점프 5프레임, 달리기와 실패 8프레임, 나머지 6프레임. 더 그린 칸은 반드시 칸 전체가 투명해야 하며, 그렇지 않으면 검증을 통과하지 못합니다.
• 점프가 칸을 뚫고 나가면 안 됩니다: 펫 전체(귀와 모자 포함)가 어느 프레임에서도 192×208 안에 완전히 들어가야 합니다.
• 투명은 깨끗하게: 반투명 그림자, 바닥 그림자, 속도선을 남길 수 없고, 투명 픽셀 안에 RGB 잔여값이 숨어 있어도 안 됩니다.
• 디렉터리 계층: pet.json은 반드시 pets/펫 id/ 바로 아래에 있어야 합니다. 압축을 풀 때 폴더가 한 겹 더 생기는 것이 「펫이 안 나타나는」 가장 흔한 원인입니다.
• working 행은 달리기가 아닙니다: 공식적으로 이 행은 「집중해서 일하는 모습」을 표현한다고 명시되어 있어서, 다리를 내딛으며 달리는 그림으로 그리면 부적합 판정을 받습니다.

더 완전한 규격표(공식 행별 재생 길이 포함)는 여기에 있습니다.

직접 만들기 싫다면?

이 사이트에 이미 91마리가 준비돼 있습니다. 오리지널 도감 50마리 + 인스퍼레이션 시리즈 41마리, 전부 공식 검증 스크립트를 통과했고, 무료로 받아 마음껏 고칠 수 있습니다. 펫마다 상세 페이지에 PowerShell 한 줄 설치 명령이 있어서, 30초면 카피바라나 사이버 고양이를 당신 바탕화면에 들일 수 있습니다.