Claude Code 플러그인, 통째로 깔지 않고 알맹이만 빼왔다

지난 편 → 6편 — 챗GPT랑 클로드, 왜 서로 대화는 못 시킬까 Claude Code로 한동안 일하다 보면, 남이 만들어 둔 도구를 가져다 쓰고 싶어지는 순간이 옵니다. 마켓플레이스에 올라온 플러그인 중 하나가 눈에 들어왔습니다. 코드를 필요 이상으로 부풀리지 않게, "게으른 시니어 개발자"처럼 최소로만 짜도록 붙잡아 주는 도구였습니다. 마음에 들었습니다. 그런데 막상 설치하려니 손이 멈췄습니다. 제가 원한 건 그 안에 담긴 원칙 하나 였는데, 플러그인은 그것 말고도 이런저런 것들을 통째로 데려옵니다. 안 쓸 기능까지 제 환경에 얹히는 게 영 내키지 않았습니다. 그래서 깔지 않고, 열어서 필요한 알맹이만 빼내기로 했습니다. 그러려면 먼저 "플러그인"과 "스킬"이 뭐가 다른지부터 알아야 했습니다. 스킬과 플러그인은 뭐가 다른가 한 줄로 하면 이렇습니다. 스킬은 부품 하나, 플러그인은 부품을 담은 상자. 스킬(Skill) 은 최소 단위입니다. SKILL.md 라는 마크다운 파일 하나가 전부고, 필요하면 옆에 보조 파일(스크립트·데이터)을 둘 수 있습니다. 두는 곳도 단순합니다. 개인용: ~/.claude/skills/<이름>/SKILL.md 프로젝트용: .claude/skills/<이름>/SKILL.md 파일 맨 위 frontmatter에 "이 스킬을 언제 써야 하는지"를 적어두면, Claude가 상황을 보고 알아서 불러 씁니다. 아니면 /스킬이름 으로 직접 부를 수도 있습니다. 말하자면 "이 일은 이렇게 처리해라"라고 적어둔 지침 한 장 입니다. 플러그인(Plugin) 은 그 부품들을 담아 배포하는 상자입니다. .claude-plugin/plugin.json 이라는 매니페스트를 중심으로, 여러 종류의 구성요소를 한 번에 묶습니다. skills/ — 스킬들 agents/ — 커스텀 에이전트(서브에이전트...

음성으로 코딩하기 (10편) — 최신 그래픽카드가 오히려 발목을 잡았다

9편에서 번역용 로컬 AI를 돌리려다 GPU가 말썽이라고 했죠. 사실 성능을 위해 일부러 최신 그래픽카드를 들였는데, 아이러니하게도 너무 최신이라 안 되는 것들이 있었어요.

지난 편 → 9편 — 한국어로 말하면 영어로: 코딩하며 영어 배우기

처음엔 CPU로 버텼어요

초기엔 그래픽카드 없이 CPU만으로 음성 인식(whisper) 을 돌렸어요. 되긴 됐는데, 정확한 큰 모델을 쓰면 느리고 버벅였죠. hands-free로 대화하듯 쓰려는데 인식이 굼뜨면 흐름이 끊겨요.

그래서 "이건 GPU가 있어야겠다" 결론을 내렸어요. 검증부터 했죠 — CPU로 작은 모델을 돌려보며 "GPU만 있으면 큰 모델도 실시간이겠다"를 확인하고, 메인보드·CPU 호환까지 따진 뒤 RTX 5060 Ti(16GB) 를 들였습니다.

그런데 "너무 최신"이 문제였어요

카드를 꽂고 신나서 로컬 AI들을 돌렸는데, 일부가 아예 실행이 안 됐어요. 대표적으로 번역에 쓰려던 Ollama가 그랬죠.

이유는 이랬어요. 이 카드는 너무 최신 세대(Blackwell) 라서, 소프트웨어들이 아직 이 칩에 맞는 코드를 준비 못 한 상태였어요. "가장 좋은 걸 샀는데 생태계가 아직 못 따라온" 상황이었죠.

소프트웨어최신 GPU에서
Ollama (번역용으로 시도)❌ 실행 크래시 (아직 미지원)
LM Studio✅ 정상
faster-whisper (음성 인식)✅ 정상 (GPU 가속)

되는 걸로 갈아타니 날아다녔어요

안 되는 Ollama는 접고, LM Studio로 번역을 돌리니 잘 됐어요. 그리고 정작 핵심인 음성 인식(faster-whisper)은 GPU에서 문제없이 가속돼서, 큰 모델도 실시간으로 착착 인식됐죠. 애초에 GPU를 산 목적은 완벽히 달성한 거예요.

교훈 — 최신 하드웨어는 양날의 검

성능은 최고인데, 소프트웨어 생태계가 따라오는 데 시간이 걸린다 — 이게 최신 하드웨어의 함정이에요. "제일 좋은 걸 사면 다 잘 되겠지"가 항상 맞진 않더라고요. 안 되는 걸 붙잡고 씨름하기보다, 되는 대안으로 빠르게 갈아타는 게 시간을 아꼈어요.

다음 편

이제 거의 다 왔어요. 마지막 삽질은 "어느 창에 넣지?" — 여러 개 열린 창 중에 목소리로 골라 넣는 창 타겟팅 이야기. → 11편 — 어느 창에 넣지? 목소리로 창 고르기


(이전 편: 9편 — 한국어로 말하면 영어로: 코딩하며 영어 배우기)

댓글