사용 가이드

100+ 하네스

하네스를 설치하고 Claude Code에서 에이전트 팀을 실행하는 방법을 안내합니다.

카탈로그 탐색 직접 만들기

하네스란?

하네스(Harness)는 4~5명의 전문 AI 에이전트와 오케스트레이터 스킬로 구성된 워크플로우 패키지입니다. Claude Code의 에이전트 팀 기능을 활용하여 일상 업무에 즉시 적용할 수 있습니다.

핵심 개념

하네스는 세 가지 핵심 구성요소로 이루어져 있습니다. 각 요소의 역할과 관계를 이해하면 더 효과적으로 활용할 수 있습니다.

에이전트

에이전트 — 작업자

에이전트는 하네스의 실제 작업 수행자입니다. 각 에이전트는 고유한 역할(role), 사용 도구(tools), 의존성(dependencies), 산출물 템플릿(outputTemplate)을 가집니다.

스킬

스킬 — 오케스트레이터

스킬은 에이전트 팀의 지휘자입니다. 실행 순서(executionOrder)를 DAG로 정의하고, 실행 모드(modes)로 부분 실행 경로를 제공하며, 트리거 조건(triggerConditions)으로 자동 감지됩니다.

확장 스킬

확장 스킬 — 플러그인

확장 스킬은 특정 에이전트 1명을 대상으로 도메인 전문 지식을 주입하는 플러그인입니다. 예를 들어, '라이선스 호환성 가이드' 확장 스킬이 '라이선스 전문가' 에이전트를 강화합니다.

하네스

스킬

executionOrder · modes · triggers

조율

Agent A

Agent B

Agent C

강화

Ext. Skill 1

Ext. Skill 2

요약: 하네스 = 컨테이너 / 스킬이 에이전트를 조율 / 확장 스킬이 특정 에이전트를 강화

설치 방법

방법 1: 세팅 (권장)

권장

Chrome 또는 Edge 브라우저에서 [세팅 →] 버튼을 클릭하면 프로젝트 폴더에 바로 설치됩니다.

1하네스 카드에서 [세팅 →] 클릭
2프로젝트 폴더 선택
3.claude/ 폴더가 자동 생성됩니다

방법 2: ZIP 다운로드

모든 브라우저에서 사용 가능합니다.

1[ZIP ↓] 클릭하여 다운로드
2ZIP 파일 압축 해제
3.claude/ 폴더를 프로젝트 루트에 복사

방법 3: CLI

cp -r {NN}-{harness-name}/.claude/ /path/to/my-project/.claude/
cd /path/to/my-project
claude

사용 방법

하네스를 설치한 프로젝트 폴더에서 Claude Code를 실행하세요. 스킬에 등록된 트리거 조건에 맞는 프롬프트를 입력하면 에이전트가 자동으로 실행됩니다.

1프로젝트 폴더에서 claude 명령어 실행

2트리거 프롬프트 입력 (예: "유튜브 영상 기획해줘")

3스킬이 자동 감지되어 에이전트가 순서대로 실행됨

cd /path/to/my-project
claude

💡 각 하네스의 상세 페이지에서 트리거 조건과 실행 모드를 확인할 수 있습니다.

실행 모드

하네스마다 여러 실행 모드를 제공합니다. 전체 파이프라인을 실행하거나, 특정 작업만 수행하는 부분 모드를 선택할 수 있습니다.

풀 프로덕션

풀 파이프라인 모드 — 전체 에이전트 실행

대본 모드

일부 에이전트만 실행하는 부분 모드

리뷰 모드

리뷰어 에이전트만 실행하는 단일 모드

내 하네스 만들기

카탈로그에 원하는 하네스가 없다면 직접 만들 수 있습니다. 4단계 빌더로 에이전트 팀을 구성하고 즉시 사용하세요.

1기본 정보

하네스 이름, 설명, 카테고리를 입력합니다. AI가 설명을 자동 생성해줄 수도 있습니다.

2에이전트 구성

에이전트를 추가하고 역할, 도구, 의존성을 설정합니다. AI 팀 생성으로 한 번에 3~5명의 에이전트를 만들 수 있습니다.

3스킬 설정

트리거 조건과 에이전트 실행 순서를 정의합니다. 스킬 마크다운을 직접 편집할 수도 있습니다.

4검토 & 저장

전체 구성을 확인하고 저장합니다. ZIP 다운로드나 프로젝트에 직접 세팅할 수 있습니다.

💡 각 단계에서 AI 어시스트를 활용하면 설명 생성, 팀 구성, 스킬 설정을 자동화할 수 있습니다.

💡 카탈로그의 하네스 상세 페이지에서 "이 하네스로 내 하네스 만들기"를 클릭하면 기존 하네스를 복제하여 커스터마이징할 수 있습니다.

내 하네스 만들러 가기 →

설치 후 파일 구조

설치하면 프로젝트 루트에 .claude/ 폴더가 생성됩니다.

my-project/
└── .claude/
    ├── agents/        # agent-name.md × 4-5
    ├── skills/        # skill-name/skill.md
    └── CLAUDE.md

agents/

.claude/agents/ — 에이전트 역할과 지시사항이 담긴 마크다운 파일

skills/

.claude/skills/ — 에이전트 실행 순서를 조율하는 스킬 파일

CLAUDE.md

.claude/CLAUDE.md — 하네스 메타데이터 및 프로젝트 설정

💡 에이전트 파일을 직접 편집하여 역할, 지시사항, 산출물 형식을 커스터마이즈할 수 있습니다.

문제 해결

Claude Code를 재시작하세요. 터미널에서 /exit 입력 후 다시 claude를 실행합니다.

프로젝트 루트에 .claude/agents/ 와 .claude/skills/ 폴더가 있는지 확인하세요.

.claude/agents/ 폴더의 마크다운 파일을 직접 편집하세요. 변경사항은 다음 실행부터 반영됩니다.

브라우저 호환성

기능	Chrome/Edge	Safari	Firefox
카탈로그 탐색	✅	✅	✅
즐겨찾기	✅	✅	✅
ZIP 다운로드	✅	✅	✅
로컬 세팅	✅	❌ (ZIP 폴백)	❌ (ZIP 폴백)

FAQ

기존 파일은 유지하고 새 파일만 추가합니다 (병합 모드). 같은 이름의 파일이 있으면 덮어쓸지 확인합니다.

네, 즐겨찾기에 추가한 뒤 [즐겨찾기 전체 세팅 →]으로 한 번에 병합 설치할 수 있습니다.

아니요. 로그인, 회원가입, 결제 없이 모든 기능을 사용할 수 있습니다.