Claude Code Skills: AI 코딩 어시스턴트를 위한 커스텀 워크플로우 구축하기

주요 내용

• Claude Code 스킬은 팀 규칙, 관례, 명령어 템플릿을 에이전트의 컨텍스트에 직접 주입하는 Markdown 파일입니다.
• 스킬은 한 문단 정도의 간단한 지침이 될 수도 있고, 예시와 환경 변수 참조가 포함된 다단계 템플릿 워크플로우처럼 복잡할 수도 있습니다.
• 스킬은 기존의 커스텀 명령어 디렉토리를 대체하며, 에이전트에게 한 번 학습시킨 후 여러 세션에서 재사용할 수 있는 통합된 방법을 제공합니다.
• 특정 모델 버전에 스킬을 고정하면 토큰 비용과 출력 품질을 예측할 수 있습니다. 프로덕션 환경에 모델을 선택하기 전에 TokenLab 모델 디렉토리와 Anthropic의 가격 페이지에서 모델을 비교해 보세요.

---

Claude Code 스킬 이해하기

스킬은 프로젝트 내부의 .claude/skills/(또는 전역적으로는 ~/.claude/skills/)에 위치하는 일반 텍스트 Markdown 파일입니다. 스킬을 호출하면 Claude Code는 해당 파일의 내용을 시스템 프롬프트에 직접 주입하여, 에이전트가 해당 지침을 우선적으로 따르도록 합니다.

이러한 주입 방식을 통해 에이전트의 동작을 정밀하게 제어할 수 있습니다. 스킬 파일에는 금지된 패턴, 필수 라이브러리, 출력 형식 또는 전체 아키텍처 체크리스트 등을 나열할 수 있습니다. 지침이 코드와 함께 버전 관리되므로 모든 팀원이 동일한 가이드라인을 자동으로 적용받게 됩니다.

전용 스킬을 활용하면 좋은 일반적인 시나리오는 다음과 같습니다:

• 일반 객체보다 엄격한 TypeScript 타입 강제.
• API 응답 형태 표준화.
• 데이터베이스 마이그레이션 생성 자동화.
• 코드 커밋 전 테스트 스위트 실행.

이러한 워크플로우를 스킬로 정의하면 에이전트가 명령어를 환각(hallucination)하거나 오래된 라이브러리를 사용하는 것을 방지할 수 있습니다. 이는 고급 코딩 모델을 사용할 때 특히 유용합니다. 개발 파이프라인을 위해 여러 LLM 중 고민 중이라면, 2026년 최고의 코딩용 AI 모델 가이드를 읽고 Claude Sonnet 5가 Kimi K2.7 Code나 DeepSeek V4 Pro와 같은 대안과 어떻게 비교되는지 확인해 보세요.

---

커스텀 스킬 구축 방법

스킬을 만드는 과정은 간단합니다. Markdown 파일을 작성하여 올바른 디렉토리에 저장한 다음, Claude Code 세션 중에 참조하기만 하면 됩니다. 클린 아키텍처를 강제하고 테스트 스위트를 실행하는 스킬을 만드는 과정을 살펴보겠습니다.

먼저 프로젝트 루트에 로컬 디렉토리를 생성합니다:

mkdir -p .claude/skills

다음으로 해당 디렉토리 안에 verify-and-test.md라는 파일을 만듭니다. 이 파일은 Claude Sonnet 5에게 코드베이스를 검토하고, Vitest를 사용하여 유닛 테스트를 작성하며, 테스트 스위트를 실행하여 변경 사항을 검증하도록 지시합니다.

# Verify and Test Skill

당신은 전문 소프트웨어 엔지니어입니다. 코드 변경 사항을 검토하고, 포괄적인 유닛 테스트를 작성하며, 테스트 스위트를 실행하는 것이 당신의 임무입니다.

## 지침

1. 코드 검토: 수정된 파일을 분석합니다. 더 이상 사용되지 않는(deprecated) API를 사용하지 않는지 확인합니다.
2. 유닛 테스트 작성: `tests/` 디렉토리에 테스트 파일을 생성합니다. Vitest를 사용하세요.
3. 테스트 실행: `npm run test`를 실행하여 모든 테스트가 통과하는지 확인합니다.
4. 보고: 테스트 결과 요약 및 발견된 문제점을 제공합니다.

## 예시

사용자가 새로운 유틸리티 함수를 검증해달라고 요청할 경우:
- `src/utils/math.ts`를 확인합니다.
- `tests/math.test.ts`를 생성합니다.
- `npm run test`를 실행합니다.

파일을 저장하면 Claude Code가 자동으로 이를 감지합니다. 에이전트에게 "최근 변경 사항에 대해 verify-and-test 스킬을 실행해줘"라고 요청하거나 프롬프트에서 직접 스킬 이름을 참조하여 호출할 수 있습니다.

다양한 모델이 이러한 복잡한 다단계 에이전트 워크플로우를 어떻게 처리하는지 이해하려면, OpenRouter 비교 자료를 확인하여 여러 API 제공업체 간의 지연 시간과 신뢰성을 평가해 보세요.

---

토큰 비용 관리 및 모델 선택

Claude Code를 실행할 때 주입하는 모든 스킬은 입력 토큰 수에 추가됩니다. 스킬은 시스템 프롬프트에 추가되기 때문에, 방대한 예시가 포함된 긴 스킬 파일은 API 비용을 빠르게 증가시킬 수 있습니다.

Anthropic 가격 페이지(2026년 7월 7일 기준)에 따르면, 입력 토큰과 출력 토큰은 서로 다른 비용 구조를 가집니다. 예를 들어, Claude Sonnet 5는 백만 입력 토큰당 특정 요금과 백만 출력 토큰당 더 높은 요금이 책정되어 있습니다. 모든 프롬프트에 스킬을 실행하면 이러한 입력 토큰이 누적됩니다.

개발 비용을 관리하려면 다음 전략을 고려하세요:

• 스킬을 간결하게 유지: 스킬 파일 내에 방대한 코드베이스를 예시로 넣지 마세요. 짧고 대표적인 코드 조각을 사용하세요.
• 전역 vs 로컬 스킬 사용: 프로젝트별 규칙은 .claude/skills/에, 일반적인 환경 설정은 ~/.claude/skills/에 보관하여 컨텍스트가 복잡해지는 것을 방지하세요.
• 대안 모델 비교: Claude Sonnet 5는 복잡한 코딩 작업에 뛰어나지만, 더 간단한 작업은 저비용 모델로 라우팅할 수 있습니다. 가격 비교 가이드를 검토하여 다양한 제공업체가 입력 및 출력 토큰에 어떻게 가격을 책정하는지 확인해 보세요.

---

Claude Code 스킬 모범 사례

커스텀 워크플로우를 최대한 활용하려면 다음 실용적인 가이드라인을 따르세요.

실천 사항	설명	이점
버전 관리	.claude/skills/를 Git 저장소에 커밋합니다.	팀 전체가 동일한 코딩 표준을 사용하도록 보장합니다.
입력 정의	스킬이 기대하는 변수나 파일을 명시합니다.	모호함을 줄이고 에이전트가 추측하는 것을 방지합니다.
부정적 예시 제공	Markdown에 "하지 말아야 할 것" 섹션을 포함합니다.	모델이 과거의 흔한 실수를 반복하는 것을 방지합니다.
점진적 변경 테스트	작은 코드 변경 사항에 먼저 스킬을 실행합니다.	스킬 지침을 디버깅하기가 훨씬 쉬워집니다.

스킬을 작성할 때는 코드로 취급하세요. 스킬이 원하는 결과를 생성하지 못하면 프롬프트를 개선하고, 더 명확한 예시를 추가하거나 지침의 범위를 제한하세요. 만약 코드 외에 UI 목업이나 홍보용 미디어와 같은 자산을 생성해야 하는 워크플로우라면, 2026년 최고의 AI 이미지 모델 API나 2026년 최고의 AI 비디오 모델 API를 탐색하여 해당 작업에 적합한 API를 찾아보세요.

---

자주 묻는 질문

Claude Code 스킬은 어디에 저장해야 하나요?

프로젝트별 규칙은 프로젝트 루트의 .claude/skills/에, 머신 전체의 모든 프로젝트에 적용하고 싶은 규칙은 ~/.claude/skills/에 저장할 수 있습니다.

Claude Code와 함께 다른 모델을 사용할 수 있나요?

Claude Code는 Anthropic이 Claude Sonnet 5와 같은 자사 모델을 위해 설계했습니다. 하지만 TokenLab 모델 디렉토리에서 다양한 모델의 기능과 가격을 비교하여 코딩 벤치마크에서 어떻게 작동하는지 확인할 수 있습니다.

세션 중에 스킬을 비활성화하려면 어떻게 하나요?

Claude Code가 특정 스킬을 사용하지 않게 하려면, Markdown 파일을 .claude/skills/ 디렉토리 밖으로 옮기거나 파일 확장자를 변경하여 에이전트가 활성 스킬로 인식하지 못하게 하면 됩니다.

---

TokenLab 시작하기

AI 개발 워크플로우를 최적화할 준비가 되셨나요? 최상의 가격 대비 성능을 제공하는 올바른 모델을 찾는 것은 애플리케이션 확장에 매우 중요합니다. TokenLab 코드 모델 카테고리를 탐색하여 최신 모델을 비교하고, 토큰 가격을 분석하며, 코딩 에이전트를 위한 완벽한 LLM을 찾아보세요.