ChatGPT로 설치가장 빠른 방법
각 펫 상세 페이지에서 정확한 ID와 설치 방법을 제공합니다.
1. 펫 선택
상세 페이지에서 전체 애니메이션을 확인합니다.
2. 설치 방법 선택
ChatGPT, Bash, PowerShell 또는 로컬 설치기를 사용합니다.
3. 펫 활성화
Codex를 재시작하고 설정 → 펫에서 선택합니다.
시스템에 맞는 설치 방법
설치기는 pet.json과 spritesheet.webp만 Codex 홈에 복사합니다.
macOS / Linux
curl과 bash가 필요합니다.
curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- <pet-slug--author-slug>Confirm the pet id
Use the complete pet-slug--author-slug value. The author suffix lets different versions of the same character coexist.
Run as your own user
No sudo or administrator shell is needed. A custom CODEX_HOME is supported when your setup uses another location.
Verify the two runtime files
A successful install contains pet.json and spritesheet.webp under pets/<pet-id>/.
Enable the pet in Codex
Installation places the files; Codex still needs to load and select the pet.
- 1
Restart Codex
If Codex was open during installation, quit and reopen it so the custom pet catalog refreshes.
- 2
Open Settings → Pets
Find the custom-pet section and confirm that the new id appears without an error badge.
- 3
Select the pet
Activate it, return to your workspace, and check idle, work, review, and movement states.
V1 and V2 install the same way
V1 pets contain nine standard action rows. V2 keeps those actions and adds 16 look directions. The atlas size and spriteVersionNumber differ, but the installer and destination do not.
Manage an installation
- Default location
- Pets are stored in ~/.codex/pets/<pet-id>/ on macOS and Linux, or %USERPROFILE%\.codex\pets\<pet-id> on Windows.
- Custom Codex home
- Set CODEX_HOME before the command, or pass --codex-home to the Bash and local Node.js installers.
- Update or reinstall
- Run the same command again with the same id. The two runtime files are replaced; other pet folders are left alone.
- Uninstall
- Quit Codex, remove only that pet's folder, then reopen Codex. No registry or system files are created.
- Anonymous install count
- Successful scripts send one anonymous install event. Set AWESOME_CODEX_PET_NO_STATS=1 to disable it.
FAQ
갤러리 열기 →Where are pets installed?
Each pet lands in your Codex home (default ~/.codex) under pets/<pet-id>/.
Can I uninstall a pet?
Delete the pet folder. Nothing else is touched.
Is sudo required?
No. Installs are scoped to your user directory.
The pet does not appear after installation. What should I check?
Confirm both runtime files exist, verify that pet.json.id matches the folder name, restart Codex, then look under Settings → Pets again.
Can V1 and V2 pets coexist?
Yes. Version belongs to each pet package. Different pet ids can coexist, and reinstalling one id updates only that folder.