클로드 아나토미 스킬 사용법, 한 줄 설명을 움직이는 기계 그림으로

클로드 아나토미 스킬(anatomy)은 설명하고 싶은 원리를 한 줄로 적으면, 그 원리대로 움직이는 기계 그림을 클로드 코드가 직접 만들어 주는 무료 스킬입니다. 이 글은 설치 명령 한 줄부터 자동차 엔진, 심장 판막 예시 프롬프트까지 9단계로 정리하고, "3D 스킬"이라는 소개가 실제로 무엇을 뜻하는지와 시간이 얼마나 드는지도 함께 알려 드립니다.

클로드 아나토미 스킬은 무엇을 만드나

아나토미는 개발자 라이언(깃허브 wheresryan22)이 만든 MIT 라이선스 오픈소스 스킬입니다. 스킬은 클로드 코드가 특정 작업 요령을 익히도록 넣어 주는 설명서 묶음이고, 아나토미는 앤트로픽 공식 기능이 아니라 개인이 공개한 스킬입니다. 저장소는 github.com/wheresryan22/anatomy, 깃허브 별(관심 표시)은 2026년 10월 17일 기준 약 1만 4천 개, 최신판은 10월 12일에 나온 v1.1.0입니다. 10월 초에 공개된 뒤 빠르게 늘고 있어 별 수는 저장소에서 다시 확인합니다.

설명하고 싶은 것을 한 줄로 치면, 아나토미는 그 원리가 곧 작동 방식인 물건을 먼저 지어냅니다. 예를 들어 "아무것도 안 바뀌면 작업을 건너뛰는 캐시"는 핀이 모두 맞아야만 돌아가는 자물쇠가 됩니다. 그다음 클로드가 작고 단단한 부품 수십 개로 그 물건을 그리고, 제목과 조작 안내, 실시간 수치가 붙은 카드 안에 넣습니다.

그냥 그림이 아니라 움직입니다. 마우스나 키보드로 조작하면 부품이 움직이고, 화면에 보이는 숫자도 부품을 움직이는 같은 계산에서 나옵니다. 터보팬 엔진이라면 추력 레버를 움직일 때 팬 회전 속도와 추력 숫자가 함께 바뀌는 식입니다.

공개된 예시

저장소에 완성본이 들어 있어 내려받아 바로 열어 볼 수 있습니다.

• 랩터 2 로켓 엔진: 마우스를 올리면 11개 부품 묶음으로 분해되고, 불꽃은 WebGL(브라우저에서 그래픽 카드로 그리는 기술)로 그립니다.
• 리플 탱크: 물결이 퍼지는 실험 장치와 물 위 빛 반사
• 다이얼 인디케이터: 가장 작은 예시로, 바늘이 블록 높이를 읽습니다.
• 돌아가는 다이얼: 로봇 손이 돌리는 3D 다이얼(3D 모드 시험판)
• 그 밖에 1984년풍 데스크 컴퓨터, 오락실 게임기 등

"3D 스킬"이라는 말의 실제 뜻

아나토미의 기본 결과물은 비스듬히 내려다본 입체 느낌의 그림(아이소메트릭 SVG)입니다. 불꽃⁠·물⁠·빛처럼 선으로 그리기 어려운 것은 WebGL 층을 더하고, 진짜 3D로 회전하는 부품은 3D 모드로 만듭니다. 이 3D 모드는 2026년 10월 기준 아직 베타입니다. 결과물은 HTML 페이지 하나, SVG 파일 하나, 또는 리액트(React) 컴포넌트로 나오고 브라우저에서 돌아갑니다.

한 줄로 바로 끝나지는 않는다

방법을 익히는 데는 30초면 충분하지만, 결과물이 30초에 나오지는 않습니다. 아나토미는 일부러 느리게 만든 스킬입니다. 실제 수치부터 모으고, 물건을 정하고, 부품 목록을 쓰고, 그림을 짠 뒤, 모든 이음매를 확대해 스스로 검사합니다. 공식 안내 기준으로 랩터 엔진 예시는 빌드에만 몇 분이 걸리고, 3D 회전 검사는 부품 30개 기준 15~20분이 걸립니다. 공개된 작업 기록 중에는 기계식 시계 하나에 약 2시간, 복잡한 엔진은 수정까지 10시간 넘게 걸린 사례도 있습니다.

준비물

• 클로드 코드(코덱스, 오픈코드, 안티그래비티, 미니맥스 코드에서도 됩니다)
• Node.js 20.10 이상. 설치에 쓰는 skills 명령줄 도구 최신판은 Node.js 22.20 이상을 요구하니, 22.20 이상을 깔아 두면 안전합니다. 버전은 터미널에서 node -v로 확인합니다.
• 크롬 또는 크로미움 브라우저(완성된 그림을 스킬이 스스로 검사할 때 씁니다)
• API 키는 따로 필요 없고, 따로 npm install할 것도 없습니다.
• 비용: 스킬 자체는 무료입니다. 클로드 코드 사용료는 따로 들고, 작업 세션이 길어 토큰을 꽤 씁니다.

클로드 아나토미 스킬 따라 하기 9단계

아나토미 스킬 설치하기

1~4단계를 마친 뒤에 사용 단계로 넘어갑니다.

1단계. 설치 명령어를 복사한다

npx skills add wheresryan22/anatomy -g -a claude-code

• 확인: 위 한 줄이 클립보드에 들어 있습니다. -g는 내 계정 전체에 설치한다는 뜻이고, -a claude-code는 클로드 코드용으로만 설치한다는 뜻입니다.
• 대안: 코덱스나 오픈코드에 설치하려면 -a claude-code 대신 -a codex 또는 -a opencode를 씁니다.

2단계. 터미널을 연다

• 맥: Cmd+Space를 누르고 terminal을 입력한 뒤 엔터를 누릅니다.
• 윈도: 시작 메뉴에서 PowerShell이나 터미널을 엽니다.
• 확인: 명령을 입력할 수 있는 창이 뜹니다.

3단계. 복사한 명령어를 터미널에 붙여 넣는다

• 확인: 명령어가 입력줄에 보입니다.
• 참고: npx는 터미널에서 실행하는 명령입니다. 클로드 코드 안에서 실행하려면 입력창 맨 앞에 !를 붙여 !npx skills add ...처럼 입력하면 터미널 명령으로 실행됩니다.

4단계. 엔터를 누른다

• 확인: 설치가 끝나면 ~/.claude/skills/anatomy 폴더가 생깁니다. 예시까지 통째로 받아 약 10MB입니다.
• 참고: 클로드 코드가 켜져 있으면 새 스킬을 바로 읽습니다. 스킬 폴더 자체가 처음 생긴 경우라면 /reload-skills를 입력하거나 클로드 코드를 다시 켭니다.
• 설치 확인: 클로드 코드 입력창에 /skills를 치거나 /anatomy까지 입력했을 때 anatomy가 목록에 보이면 됩니다. 터미널에서는 npx skills list로도 볼 수 있습니다.
• 대안: npx를 쓰지 않으려면 git clone https://github.com/wheresryan22/anatomy.git ~/.claude/skills/anatomy로 받아도 같은 자리에 설치됩니다.

지울 때는 터미널에서 npx skills remove -g anatomy를 실행하거나 ~/.claude/skills/anatomy 폴더를 지웁니다. 메뉴 이름과 명령은 2026년 10월 기준입니다.

사용 예 1. 기계 원리 보기

5단계. 클로드 코드 입력창에 아래 프롬프트를 입력한다

/anatomy 자동차 엔진이 어떻게 움직이는지 보여 줘, 인터랙티브로

• 확인: 입력창에 /anatomy로 시작하는 한 줄이 보입니다. 코덱스에서는 /anatomy 대신 $anatomy로 부릅니다.

6단계. 엔터를 누른다

• 확인: 클로드가 부품 목록을 짜고, 그림을 만들고, 스스로 화면을 확대해 검사하는 과정을 거칩니다. 끝나면 브라우저에서 열 수 있는 HTML 파일이 생기고, 완성된 자동차 엔진이 움직이는 모습을 실시간으로 볼 수 있습니다.
• 주의: 한 줄로 바로 완성되지 않습니다. 중간에 클로드가 권한이나 확인을 물으면 내용을 읽고 답합니다.

사용 예 2. 공부하다 막힌 개념 보기

기계 원리를 보는 데서 끝내지 않고, 공부할 때 그림만으로는 이해가 안 가는 개념을 움직이는 기계로 바꿔 볼 수 있습니다.

7단계. 클로드 코드 입력창에 아래 프롬프트를 입력한다

/anatomy 심장 판막이 피를 한 방향으로만 보내는 원리 보여 줘

• 확인: 입력창에 /anatomy로 시작하는 한 줄이 보입니다.
• 팁: 처음에는 간단한 것부터 시킵니다. 공식 안내도 무엇을 설명할지와 실제 수치(크기, 개수, 속도, 기준값)를 함께 주면 결과가 좋아진다고 권합니다. 원하는 물건이 있으면 이름을 대고("자물쇠로", "에스프레소 머신으로"), 무엇이 움직여야 하는지, HTML·SVG·리액트 중 어떤 형태로, 밝은 테마인지 어두운 테마인지도 적습니다.

8단계. 엔터를 누른다

• 확인: 판막이 열리고 닫히는 모습을 손으로 돌려 보는 기계 그림이 나옵니다. 아나토미는 사람의 몸을 사실적으로 그리는 도구가 아니라서, 판막을 한쪽으로만 열리는 밸브 장치처럼 기계로 바꿔 보여 줍니다.

9단계. 나온 기계를 직접 돌려 본다

• 방법: 그림 위에 마우스를 올리거나 끌고, 카드에 적힌 조작 안내(키보드 화살표 등)를 따라 해 봅니다. 조작 방법은 그림마다 카드의 안내 문구에 적혀 있습니다.
• 확인: 조작하면 판막이 움직이고 수치가 함께 바뀝니다. 그림 한 장을 보는 것과 직접 돌려 보는 것은 이해 속도가 다릅니다.

심장 판막 예시는 학습용 시각화입니다. 의학 정보나 진료 판단에 쓰는 자료는 아니니, 정확한 내용은 교과서와 의료 기관 자료로 확인합니다.

아나토미 스킬이 막힐 때와 한계

한 줄 넣었는데 바로 완성되지 않는 것은 정상입니다. 구조 설계, 코드 작성, 화면을 보며 수정하는 과정을 거치기 때문입니다. 간단한 개념부터 시키고, 마음에 안 드는 부분은 "레버를 더 크게", "어두운 테마로"처럼 이어서 요청합니다.

설치가 안 된다면 Node.js 버전부터 봅니다. 스킬은 20.10 이상에서 돌지만 설치 도구는 22.20 이상을 요구할 수 있습니다. 검사 단계에서 오류가 나면 크롬이 설치돼 있는지 확인합니다. 크롬이 일반 위치에 없으면 CHROME_PATH 환경 변수로 경로를 알려 줍니다.

공식 안내가 밝힌 한계도 알아 둡니다.

• 차트 도구가 아닙니다. 축이나 데이터 그래프는 그리지 않습니다.
• 기계, 계측기, 도구, 가구를 그립니다. 사람이나 정확한 지도는 그리지 않고, 작동 원리가 없는 생각은 결과가 약하게 나옵니다.
• 불꽃⁠·물 같은 효과는 WebGL이 필요합니다. WebGL이 없어도 기본 그림은 보입니다.