>_

Claude Code 설치

Claude Code용 Agent Skills를 설치하고 설정하는 방법을 알아보세요.

사전 요구사항

스킬을 설치하기 전에 다음을 확인하세요:

  • Claude Code CLI 설치됨 (npm install -g @anthropic-ai/claude-code)
  • Claude Code가 초기화된 프로젝트 디렉토리
  • Node.js 18 이상

설치 방법

방법 1: CLI 명령어 (권장)

스킬을 추가하는 가장 쉬운 방법:

bash
claude skill add owner/skill-repo

예시:

bash
claude skill add anthropic/brand-guidelines

방법 2: 수동 설정

프로젝트의 .claude/settings.local.json에 직접 스킬을 추가하세요:

json
{
  "skills": [
    "https://github.com/owner/skill-repo"
  ]
}

방법 3: 로컬 스킬

로컬 개발 또는 비공개 스킬용:

json
{
  "skills": [
    "./local-skills/my-skill"
  ]
}

설정 옵션

스킬 우선순위

여러 스킬이 설치된 경우 우선순위를 설정할 수 있습니다:

json
{
  "skills": [
    {
      "url": "https://github.com/owner/skill-1",
      "priority": 1
    },
    {
      "url": "https://github.com/owner/skill-2",
      "priority": 2
    }
  ]
}

숫자가 낮을수록 우선순위가 높습니다.

조건부 스킬

특정 파일 유형에서만 스킬을 활성화:

json
{
  "skills": [
    {
      "url": "https://github.com/owner/react-skill",
      "match": ["**/*.tsx", "**/*.jsx"]
    }
  ]
}

설치 확인

스킬이 설치되었는지 확인하세요:

bash
claude skill list

출력에서 스킬을 확인할 수 있습니다:

Installed Skills: - anthropic/brand-guidelines (v1.0.0) - my-org/custom-skill (local)

스킬 업데이트

모든 스킬을 최신 버전으로 업데이트:

bash
claude skill update

특정 스킬만 업데이트:

bash
claude skill update owner/skill-repo

스킬 제거

프로젝트에서 스킬 제거:

bash
claude skill remove owner/skill-repo

문제 해결

스킬이 로드되지 않음

  1. 스킬 URL이 올바른지 확인
  2. 저장소에 유효한 SKILL.md 파일이 있는지 확인
  3. 인터넷 연결 확인
  4. claude skill validate owner/skill-repo를 실행하여 오류 확인

스킬 간 충돌

스킬들이 충돌하는 지시사항을 가진 경우:

  1. 우선순위를 조정하여 어느 것이 우선하는지 결정
  2. 조건부 매칭을 사용하여 스킬 범위 제한
  3. 관련 스킬들을 하나로 병합 고려

권한 문제

권한 오류가 발생하면:

bash
# npm 권한 수정
sudo chown -R $(whoami) ~/.claude

다음 단계

GitHub에서 이 페이지 편집