Clawd on Desktop 캐릭터를 농담곰으로 바꾸기

Clawd on Desktop 앱의 기본 캐릭터는 claude 캐릭터이다.
그런데 이 캐릭터를 귀여운 캐릭터로 변경하는 방법이 있다. 바로 Petdex 라는 사이트!

간단하게 zip 파일을 다운로드 받아서 반영하는 방법 및 오류가 났을 때 원인을 파악하고 해결하는 방법 알아보자.
캐릭터를 바꾸기 전에 Clawd on desktop 이 설치되어있어야 한다.

Pet 테마 설치 방법

: Petdex 사이트 접속 → 캐릭터 다운로드 (share - Download ZIP) → Clawd on desktop 에서 Import Codex Pet package 클릭하여 반영

import 오류가 발생 했을 때

Petdex에서 마음에 드는 캐릭터를 하나 받았는데 Clawd on Desktop에 적용하려고 zip 파일을 넣었는데 오류가 뜰 때.
파일 형식이 서로 다른지 확인할 것. 어떤 캐릭터는 바로 잘 적용되는데 어떤 캐릭터는 적용이 되지 않는다.
그 이유는 zip 파일 안에 있는 폴더의 구조가 다르기 때문일 수 있다.

(예시)

• 다운로드 된 Petdex의 Codex Pet 패키지

pet.json
spritesheet.webp

• Clawd의 테마 가져오기는 다른 구조를 요구

theme.json
assets/

import 한 zip은 "펫 패키지" 이고, Clawd가 필요한 zip 파일은 "테마 패키지"일 때 발생하는 오류.
겉으로 보기엔 둘 다 캐릭터 zip이지만 안쪽 규칙은 완전히 다르다. 그래서 아래와 같은 오류가 떴다.

AI에게 맡긴 일

이 파일을 보고, Windows에서 Clawd Desktop에 적용할 수 있게 해줄 수 있어?

AI는 먼저 zip 내부를 확인하고, Clawd가 실제로 쓰는 설정 폴더와 테마 폴더를 찾아냈다. 확인한 핵심은 이랬다.

• Petdex 파일은 pet.json 기반

• Clawd 테마는 theme.json 기반

• Clawd는 사용자 테마를 별도 폴더에서 읽음

• 단순 복사로는 안 되고, 테마 구조로 변환해야 함

AI가 한 일

1. 원본 zip 구조 확인

2. Clawd용 theme.json 생성

3. spritesheet.webp를 애니메이션 gif들로 잘라 테마 assets로 변환

오류 해결 과정

처음 변환한 버전은 이상했다. 농담곰이 전신으로 나와야 하는데, 머리만 둥둥 떠 있거나 위아래가 나뉘어 보였다. 원인은 spritesheet 해석 오류 — AI가 프레임 높이를 잘못 잡았다.

처음 추정: 192 × 143
실제 프레임: 192 × 208

프레임 높이를 작게 자르니 몸통 아래쪽이 잘려 캐릭터가 분리된 것처럼 보인 것이다. 프레임 기준을 다시 잡고 변환했다.

8열 × 11행
프레임 1개 = 192 × 208

최종 결과

Clawd on Desktop의 User Themes에 농담곰 전신이 정상적으로 들어갔다.
Petdex용 Codex Pet을 Clawd on Desktop용 User Theme로 변환한 셈이다

JokeBear-CodexPet
Animated Idle
Direct Sleep
Active

AI가 실제로 파일을 열어보고, 구조를 비교하고, 앱이 읽는 설정 위치를 찾고, 이미지를 프레임 단위로 잘라보고, 잘못 잘린 결과를 다시 수정했다.
사람이 한 일은 계속 결과를 보고 말해주는 것이었다.

• "오류가 떠"

• "Windows에서 할 거야"

• "농담곰이 잘리는 것 같아"

• "머리만 둥둥 떠 있어"

• "이제 잘 보여"

AI 활용 포인트

서로 다른 앱의 파일 규격 차이를 AI가 확인하고, 원본 리소스를 새 앱이 읽을 수 있는 구조로 변환

초보자 입장에서 이런 작업은 꽤 막막하다. zip 안에 뭐가 들었는지 봐야 하고, 앱 설정 폴더도 찾아야 하고, 스프라이트 구조도 이해해야 한다. 그런데 AI와 같이 하면 나는 "화면에서 어떻게 보이는지"만 판단해도 된다. 기술적인 확인과 반복 수정은 AI가, 최종 감각과 선택은 사람이 맡았다.

써먹을 수 있는 프롬프트

이 zip 파일을 이 앱에 적용하려고 했는데 오류가 납니다.
파일 내부 구조를 확인하고,
앱이 요구하는 형식과 비교해서
필요하면 변환 파일까지 만들어주세요.

중간 결과는 실제 파일 기준으로 검증해주고,
적용 후 화면에서 이상하게 보이면
이미지 크롭이나 설정값도 다시 조정해주세요.

조금 더 구체적으로는:

이 캐릭터 패키지를 Clawd on Desktop에서 쓸 수 있는 User Theme 형식으로 변환해주세요.
원본 zip 안의 json과 이미지 파일을 확인하고,
theme.json과 assets 구조로 다시 만들어주세요.
캐릭터가 잘리거나 비율이 이상하면 spritesheet 프레임 크기도 다시 추정해주세요.