코딩 보조도구 Clawd on Desktop, 농담곰 캐릭터로 변경하기
2026.08.08

소개
clawd on desktop 앱에 캐릭터를 기본이 아니라 다른 것으로 적용하기
AI에게 “캐릭터 적용”을 맡겼더니, zip 파일을 뜯고 오류나던 테마를 변환해줬다
진행 방법
Petdex에서 마음에 드는 캐릭터를 하나 받았다.
농담곰 캐릭터였다.
Clawd on Desktop에 적용하려고 zip 파일을 넣었는데, 오류가 떴다.
처음 봤을 때는 “파일이 잘못됐나?” 싶었다.
하지만 문제는 파일 자체가 아니라, 파일 형식이 서로 달랐다는 것이었다.
시작은 import 오류였다
내가 받은 파일은 Petdex의 Codex Pet 패키지였다.
안에는 이런 파일이 들어 있었다.
pet.json
spritesheet.webp
그런데 Clawd on Desk의 테마 가져오기는 다른 구조를 원했다.
theme.json
assets/
즉, 내가 넣은 zip은 “펫 패키지”였고, Clawd가 기다리고 있던 건 “테마 패키지”였다.
겉으로 보기엔 둘 다 캐릭터 zip 파일처럼 보이지만, 안쪽 규칙은 완전히 달랐다.
AI에게 맡긴 일
이번에 AI에게 시킨 건 단순히 “설치 방법 알려줘”가 아니었다.
이 파일을 보고, Windows에서 Clawd Desktop에 적용할 수 있게 해줄 수 있어?
AI는 먼저 zip 파일 내부를 확인했다.
그다음 Clawd가 실제로 쓰는 설정 폴더와 테마 폴더를 찾아냈다.
확인한 핵심은 이거였다.
Petdex 파일은
pet.json기반Clawd 테마는
theme.json기반Clawd는 사용자 테마를 별도 폴더에서 읽음
단순 복사만으로는 안 되고, 테마 구조로 변환해야 함
그래서 AI가 한 일은 크게 세 가지였다.
원본 zip 구조 확인
Clawd용
theme.json생성spritesheet.webp를 애니메이션 gif 파일들로 잘라서 테마 assets로 변환
한 번에 끝나진 않았다
처음 변환한 버전은 이상했다.
농담곰이 전신으로 나와야 하는데,
머리만 둥둥 떠 있거나 위아래가 나뉘어 보였다.

이때 원인은 spritesheet 해석 오류였다.
AI가 처음엔 프레임 높이를 잘못 잡았다.
처음 추정: 192 × 143
실제 프레임: 192 × 208
프레임 높이를 작게 잘라버리니,
몸통 아래쪽이 잘려서 캐릭터가 분리된 것처럼 보인 것이다.
이걸 다시 확인하고, 프레임 기준을 수정했다.
8열 × 11행
프레임 1개 = 192 × 208
그리고 다시 Clawd용 테마로 변환했다.
최종 결과
마지막에는 Clawd on Desk의 User Themes에 농담곰이 정상적으로 들어갔다.
테마 목록에는 이렇게 보였다. (드디어 전신이 보인다!)

JokeBear-CodexPet
Animated Idle
Direct Sleep
Active
이제 농담곰은 머리만 떠 있는 상태가 아니라,
원래처럼 전신이 보이는 캐릭터로 적용됐다.
결과적으로 만든 건 단순한 복사본이 아니라,
Petdex용 Codex Pet을 Clawd on Desk용 User Theme로 변환한 버전이었다.
이번 작업에서 인상적이었던 점
이 작업이 흥미로웠던 건, AI가 단순히 “어디를 클릭하세요”라고 안내한 게 아니라는 점이다.
중간에 실제로 파일을 열어보고, 구조를 비교하고, 앱이 읽는 설정 위치를 찾고,
이미지를 프레임 단위로 잘라보고, 잘못 잘린 결과를 다시 수정했다.
사람이 한 일은 계속 결과를 보고 말해주는 것이었다.
“오류가 떠”
“Windows에서 할 거야”
“농담곰이 잘리는 것 같아”
“머리만 둥둥 떠 있어”
“이제 잘 보여”
AI는 그 피드백을 받아서 계속 조정했다.
AI 활용 포인트
이번 사례는 “AI가 대신 설치해줬다”보다 조금 더 정확히 말하면 이렇다.
서로 다른 앱의 파일 규격 차이를 AI가 확인하고,
원본 리소스를 새 앱이 읽을 수 있는 구조로 변환했다.
이런 작업은 초보자 입장에서는 꽤 막막하다.
zip 파일 안에 뭐가 들어 있는지 봐야 하고,
앱 설정 폴더도 찾아야 하고,
이미지 스프라이트 구조도 이해해야 한다.
게다가 한 번에 잘 안 되면 어디가 문제인지 다시 추적해야 한다.
그런데 AI와 같이 하면,
나는 “화면에서 어떻게 보이는지”만 판단해도 된다.
기술적인 확인과 반복 수정은 AI가 맡고,
최종 감각과 선택은 사람이 맡는 방식이다.
써먹을 수 있는 프롬프트
비슷한 상황에서 이렇게 물어보면 된다.
이 zip 파일을 이 앱에 적용하려고 했는데 오류가 납니다.
파일 내부 구조를 확인하고,
앱이 요구하는 형식과 비교해서
필요하면 변환 파일까지 만들어주세요.
중간 결과는 실제 파일 기준으로 검증해주고,
적용 후 화면에서 이상하게 보이면
이미지 크롭이나 설정값도 다시 조정해주세요.
조금 더 구체적으로는 이렇게 말할 수 있다.
이 캐릭터 패키지를 Clawd on Desk에서 쓸 수 있는 User Theme 형식으로 변환해주세요.
원본 zip 안의 json과 이미지 파일을 확인하고,
theme.json과 assets 구조로 다시 만들어주세요.
캐릭터가 잘리거나 비율이 이상하면 spritesheet 프레임 크기도 다시 추정해주세요.
남은 생각
처음엔 import 오류였고,
다음엔 캐릭터가 잘렸고,
그다음엔 머리만 떠 있었다.
처음에 캐릭터가 잘못 나왔지만 덕분에 사이즈 조절이 가능하다는 것을 알 수 있게 되어서 좋았다.
앞으로 농담곰 캐릭터와 코딩 고고 해야겠다!
도움을 주신 분
리히토님😄😄
https://ssidit.com/read/work/clawd-desktop-custom-character-theme
로그인하고 댓글을 남겨 주세요
머리만 둥둥 떠 있던 농담곰이 전신으로 서기까지가 이 글의 재미네요. 파일이 잘못된 줄 아셨다가, 두 앱이 요구하는 규격이 아예 달랐다는 걸 찾아내셨고요. 거기서 안 접으셨네요.
설치 방법을 물어보는 대신 이 파일을 이 앱에서 쓸 수 있게 바꿔달라고 하신 게 갈림길이었던 것 같습니다. 그래서 zip 안을 열어보고, 설정 폴더를 찾고, 그림을 프레임 단위로 잘라내는 데까지 갔고요. 잘린 결과를 보고 프레임 기준을 다시 잡은 것도 그 안에서 돌았네요. 그 한마디가 컸어요.
화면에서 어떻게 보이는지만 판단하면 된다고 정리하신 대목이 오래 남습니다. 확인과 반복 수정은 맡기고 최종 감각은 사람이 쥐는 쪽이요. 저도 눈으로만 봅니다. 처음에 잘못 나온 덕에 크기 조절을 알게 됐다는 마무리도 반가웠어요.
쓰신 프롬프트를 그대로 적어두셔서 따라 하기도 쉽겠어요. 저도 해보겠습니다. 농담곰과 코딩 고고 하시길 바랍니다.
코딩 고고하겠습니다! 확실히 귀여운걸로 바꾸니까 너무 좋아요. 볼 때마다 기분이 좋습니당
import 오류에서 멈추지 않고 pet.json과 theme.json의 구조 차이를 AI가 직접 파악해서 변환한 과정이 잘 정리돼 있어요.
처음 변환했을 때 농담곰이 머리만 둥둥 떠 있었던 이유가 프레임 높이를 192×143으로 잘못 잡았기 때문이었다는 것 — 수치까지 남겨주셔서 왜 그렇게 보였는지 바로 이해가 됐어요. 8열×11행에 프레임 1개가 192×208이라는 걸 다시 추정하고 재변환한 과정이 핵심이었네요.
"나는 화면에서 어떻게 보이는지만 판단하면 됐다"는 역할 구분도 실용적이에요. 오류가 떠 → 농담곰이 잘려 → 머리만 떠 있어 → 이제 잘 보여, 이 피드백 루프가 짧고 명확해서 AI도 빠르게 수정할 수 있었던 것 같아요.
농담곰과 코딩 파이팅이에요 🐈⬛
고마워 뽀짝아 안그래도 오늘 사례글 발표하는데 너무 귀여워서 우리 스터디 사람들에게도 알려주려궁



농담곰의 머리만 둥둥 뜨던 화면에서 출발해, `pet.json`·`spritesheet.webp` 묶음을 Clawd on Desktop이 읽는 `theme.json`·`assets/` 구조로 바꾼 흐름이 눈에 잡혀요. ‘설치법을 알려달라’가 아니라 원본 패키지와 대상 앱의 규칙을 대조하고 실제 변환 파일까지 만들게 한 요청이 작업의 성격을 바꿨습니다.
첫 변환의 `192×143` 자르기가 전신을 끊어 놓자 원본 시트를 다시 보고 `192×208`, `8열×11행`으로 고친 장면도 좋습니다. 오류 화면을 버리지 않고 가설을 수정하는 근거로 썼기 때문에, 마지막 `JokeBear-CodexPet`의 `Animated Idle`·`Direct Sleep`·`Active` 표시는 운 좋게 불러온 결과가 아니라 수치와 화면을 왕복해 얻은 결과예요.
여기서 변환 완료는 세 층으로 나눠 남길 수 있습니다. `theme.json`이 열리고 자산 경로가 모두 존재하는지는 구조 확인, 원본의 어느 행과 구간이 각 상태에 연결됐는지는 의미 확인, 실제로 순서·반복·기준점이 유지되는지는 재생 확인으로 갈라 적는 방식이에요. 모든 이미지가 `192×208`이라는 사실만으로 잠자기와 활동 상태가 뒤바뀌지 않았다고 말할 수는 없으니까요.
새 캐릭터를 하나 더 만드는 대신 농담곰의 상태를 하나씩 강제로 실행해 한 주기만 기록해도 충분합니다. 첫·중간·끝 장면, 투명 영역의 경계, 발바닥 기준점, 반복 뒤 복귀 위치를 상태별 자산과 맞춰 보면 전신 복구 이후의 동작 의미까지 같은 자리에서 확인할 수 있어요.
사람은 화면의 이상을 구체적인 말로 돌려주고, AI는 파일 구조와 프레임 수치를 추적한 역할 분담이 이 작업 안에 선명하게 남았습니다. 실패한 zip과 잘린 화면을 모두 다음 판단의 재료로 바꾼 과정이 농담곰의 전신보다 더 오래 기억에 남아요.
농담곰 처음에 반쪽만 보여서 너무 아쉬웠지 뭐에용 그래도 지금은 완벽한 담곰이가 되어서 아주 만족스럽습니다.