하니스(Harness) 완전 공개: Claude Code AI를 내 팀 전담 직원으로!
최근 Claude Code 같은 강력한 AI 도구들이 쏟아져 나오면서, 이걸 어떻게 우리 팀에 딱 맞춰서 쓸 수 있을까 고민하는 분들 많으실 텐데요. 그냥 “알아서 해줘”로는 제대로 된 결과물을 기대하기 어렵잖아요. 마치 뛰어난 신입 개발자를 데려와서 우리 팀의 개발 문화, 규칙, 프로젝트 구조 등을 일일이 설명해야 하는 것처럼요. 바로 이 문제를 해결해 줄 수 있는 도구가 바로 “하니스(Harness)”입니다. 이 영상에서는 메이커 에반님이 하니스를 이용해서 Claude Code를 프로젝트에 특화된 AI 개발자로 만드는 방법을 아주 자세하게 설명해 주시더라고요. 단순히 AI를 사용하는 것을 넘어, AI를 우리 팀의 문화와 프로세스에 완벽하게 통합하는 방법을 제시한다는 점에서 정말 유익했습니다.
하니스(Harness)란 무엇일까요?
영상을 보면서 하니스를 한마디로 정의하자면, **”Claude Code를 우리 팀 전담 AI 개발자로 만들어주는 맞춤형 도구”**라고 할 수 있겠네요. 그냥 Claude Code를 쓰는 것보다 훨씬 효율적이고, 일관성 있는 결과물을 얻을 수 있다는 점이 매력적이었어요.
메이커 에반님은 하니스의 핵심 요소로 세 가지를 꼽았는데요:
- 스킬 (Skills): 특정 분야의 전문 지식을 담은 가이드 문서입니다. Claude Code가 특정 분야의 전문가처럼 행동하게 만들어주는 핵심 요소죠. 예를 들어, “React 베스트 프랙티스 스킬”을 적용하면 Claude Code가 React 코드를 작성할 때 가장 최신의 모범 사례를 따르도록 할 수 있습니다.
- 에이전트 (Agents): 문제를 스스로 해결하는 똑똑한 AI 도우미입니다. 단순히 지시를 따르는 게 아니라, 문제를 분석하고 해결 방안을 찾아서 실행까지 하는 능동적인 역할을 수행합니다. 마치 팀의 숙련된 시니어 개발자 같은 느낌이랄까요?
- 커맨드 (Commands): 자주 사용하는 복잡한 작업을 단축키처럼 실행할 수 있게 해주는 기능입니다. 슬래시(/) 명령어를 사용해서 복잡한 작업들을 간단하게 처리할 수 있도록 도와줍니다.
“하니스는 클로드 코드를 프로젝트 전담 전문가로 만들어 줍니다.”
이 세 가지 요소를 조합해서 사용하면 Claude Code를 단순히 코드를 생성하는 도구가 아니라, 프로젝트의 모든 단계에서 도움을 주는 강력한 AI 동료로 만들 수 있다는 거죠.
스킬(Skills): AI에게 전문 지식을 주입하는 방법
스킬은 Claude Code에게 특정 분야의 전문가이드북을 제공하는 것과 같습니다. 예를 들어, `/패스트 API 백엔드 가이드라인 회원 가입 만들어 줘` 와 같이 명령을 내리면, Claude Code는 “패스트 API 백엔드 가이드라인” 스킬에 정의된 규칙과 지침에 따라 코드를 작성합니다.
영상에서 소개된 스킬 종류는 다음과 같습니다:
- 패스트 API 백엔드 가이드라인 스킬: 서버 코드 작성 시 유용하며, 역할별로 깔끔하게 코드를 만들어 줘서 유지보수성을 높여줍니다.
- 넥스트 JS 프론트엔드 가이드라인 스킬: 웹사이트 화면 제작 시 최신 방식에 맞춰 빠르고 올바른 구조의 화면을 만들어줍니다.
- 멀티플로우 다이어그램 스킬: 복잡한 내용을 그림으로 설명해야 할 때 유용합니다. 기능 흐름도나 서비스 구조를 자동으로 그려줘서 협업에 도움이 됩니다.
- PDF 스킬 & PPTX 스킬: PDF 파일 관련 작업 (글자 추출, 페이지 분할/합치기)이나 PPT 자동 생성에 활용할 수 있습니다.
- 웹 디자인 가이드라인 & 리액트 베스트 프랙티스 스킬: 디자인 리뷰 및 React 코드 리뷰를 수행하여 디자인 퀄리티를 높여줍니다. 색상 대비나 여백 등을 자동으로 체크해주는 기능이 인상적이었습니다.
여기서 짚고 넘어갈 점은, 이 스킬들을 그냥 사용하는 것보다 우리 팀의 규칙에 맞게 커스터마이징하는 것이 훨씬 더 효과적이라는 겁니다. 팀의 코딩 컨벤션이나 디자인 가이드라인을 스킬에 추가하면, Claude Code가 우리 팀 문화에 완벽하게 맞춰진 코드를 생성하도록 할 수 있습니다.
에이전트(Agents): 문제를 스스로 해결하는 AI 조력자
에이전트는 스킬과는 조금 다른 역할을 합니다. 스킬이 특정 분야의 지식을 제공하는 것이라면, 에이전트는 문제를 스스로 해결하는 능동적인 조력자라고 할 수 있습니다.
영상에서 소개된 에이전트 종류는 다음과 같습니다:
- 플래너 에이전트: 새로운 기능을 개발하기 전에 계획을 수립하는 역할을 합니다. 어떤 파일을 어떤 순서로 만들어야 하는지, 파일 간의 관계는 어떻게 되는지 등을 단계별로 정리해줍니다.
- 플랜 리뷰 에이전트: 플래너 에이전트가 짠 계획을 검토하고, 빠진 부분이나 잠재적인 문제점을 지적해줍니다. 마치 숙련된 QA 엔지니어 같은 역할을 하는 거죠.
- 웹 리서치 스페셜리스트 에이전트: 개발 중에 문제가 발생했을 때 해결 방법을 검색해주는 에이전트입니다. 개발자 커뮤니티나 Q&A 사이트에서 관련 정보를 수집하고 정리해줍니다. 구글 검색을 대신 해주는 똑똑한 비서 같은 느낌이랄까요?
에이전트 기능을 보면서 가장 인상적이었던 점은, 단순히 코드를 생성하는 것을 넘어 프로젝트의 전체적인 흐름을 관리하고 문제 해결을 돕는다는 점이었어요. 특히, 플랜 리뷰 에이전트는 개발 초기 단계에서 발생할 수 있는 오류를 사전에 방지하는 데 큰 도움이 될 것 같습니다.
아쉬운 점과 개선 방향
물론 하니스가 완벽한 도구는 아닙니다. 영상에서 다루지 않은 부분도 몇 가지 있었는데요. 예를 들어, 하니스를 사용하는 데 필요한 초기 설정이나 학습 곡선에 대한 설명이 조금 부족했던 것 같습니다. 처음 사용하는 사람들은 어디서부터 시작해야 할지 막막할 수도 있겠다는 생각이 들었어요. 그리고 하니스가 지원하는 프로그래밍 언어나 프레임워크가 제한적일 수 있다는 점도 고려해야 할 것 같습니다.
한 가지 아쉬운 점이 있다면, 하니스가 제공하는 에이전트의 종류가 아직 다양하지 않다는 점입니다. 앞으로 더 많은 종류의 에이전트가 추가된다면, 하니스의 활용도가 더욱 높아질 것 같습니다. 예를 들어, “코드 최적화 에이전트”나 “보안 취약점 분석 에이전트” 같은 기능이 추가된다면 개발 생산성을 획기적으로 향상시킬 수 있을 거라고 생각합니다.
정리
이 영상을 한 줄로 요약하면, **”하니스(Harness)는 Claude Code를 우리 팀의 문화와 프로세스에 완벽하게 통합시켜주는 강력한 도구”**입니다. 초기 설정이 다소 번거로울 수 있지만, Claude Code를 효율적으로 사용하고 싶다면 꼭 한번 사용해볼 만한 가치가 있다고 생각합니다. 다음 강의에서는 하니스를 기반으로 랜딩 페이지를 만드는 과정을 보여준다고 하니, 저도 꼭 챙겨봐야겠어요!