Claude Code는 Agent Team을 명시적으로 구성하여 작업을 처리할 수 있다. 이미 Claude Code를 설치 활용하는 분들을 위해, Agent Team을 구성하고 기본적인 Harness Engineering방식을 적용하여 다양한 업무를 상당한 고품질로 수행하는 법(코딩이 아닌, 전략 수립이나 조사 보고 등)을 소개한다. 말은 거창하지만 설치/입력은 별로 길지 않다.
1. claude code에 revfactory harness plugin 설치
claude code를 실행하고 아래와 같이 plugin을 설치한다. 아래 2줄을 차례차례 입력하고 엔터를 치며 진행한다.
/plugin marketplace add revfactory/harness
/plugin install harness@harness (오류시 /plugin install harness@harness-marketplace)
revfactory harness plug-in은 agent team 구성 등 agent와 skill 셋팅 등 필요한 md파일들을 예시기반으로 지시에 의해 생성하는 플러그인이다. 설치 이후 사용법을 가이드할 예정이다.
설치 완료후에는 아래와 같이 입력한다. 설치된 plugin을 claude code 재시작 없이 활성화 시키는 명령이다.
/reload-plugins
이후 "/harness "로 claude code에 입력을 시작하면, 아래와 같이 표기된다. 정상적으로 되지 않으면 claude code를 재시작하면, 정상 설치된 경우 /harness 명령이 작동함을 알 수 있다. 가끔 설치 인식이 안되는 경우가 있는데, install을 다시 명령하면 된다 ( /plugin install harness@harness)
2. claude code의 team agent 기능 활성화하기
revfactory harness plugin은 claude code의 team agent기능(claude code ver 2.1.34+에서 작동)이 활성화되어야 한다.
claude code가 실행된 상태에서
"claude code experimental agent teams 기능을 활성화하도록 settings.json에 반영해줘"라고 명령한다.
그리고 claude code를 재시작한다(/exit 입력 후 다시 claude code를 실행)
만약에 수작업으로 한다면, ~/.claude/settings.json에 아래 env 설정을 추가한다. 윈도우의 경우는 /Users/[자신의계정]/.claude/settings.json에 존재하며 파일이 없는 경우 새로 생성한다.기존에 있는 경우, 콤마를 잊지 않고 넣어 json에 추가한다.
a) 파일이 없는 경우 settings.json으로 아래 생성한다. (메모장, 편집기 등을 사용한다)
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
b) 파일이 존재하는 경우는 해당 설정을 추가한다.
{
xxxxxxxx
xxxxxxxx,
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
3. Agent Team을 구성하고 검증과정을 거친 보고서를, 몇줄의 프롬프트로 작성해 보자
플러그인이 설치되고 agent team 기능이 활성되면 이제 준비가 끝났다. 특정 폴더를 하나 생성한 후 거기서 claude code를 실행하고 아래와 같이 입력한다. 폴더를 만드는 이유는 향후 해당 폴더의 agent team 구성 설정파일(마크다운/md)과 여러가지 결과물이 쌓이기 때문이다. 늘 이렇게 새로운 폴더를 만들어 관리해야 섞이지 않는다
$ mkdir aibigtech_survey
$ cd aibigtech_survey
$ claude
실제로 claude 상에서 명령한다.
/harness AI 3대 빅테크인 OpenAI, Anthropic, Gemini의 올해 신기능이나 제품 출시에 대한 로드맵에 대해서 SNS나 다양한 발표를 조사해 정리하는 보고서를 작성하는 하네스를 구성해줘
보고서 작성을 실행해
하네스 체계 구성에 몇 분(agent와 skill 생성), 실제 보고서 작성에 약 30분~1시간 정도 소요된다. 이후에는 최종 보고서 파일이 해당 폴더에 생성된다. 일반 작업대비는 꽤 많은 토큰을 소모하므로, pro 계정의 경우는 하루 한 세션 limit에 1~2개 정도를 처리할 수 있다. 그리고 작업 진행 허가를 계속 묻는 것이 불편한 분들은, max 계정의 경우는 아래와 같이 자동 승인 모드, pro 계정의 경우는 permission skip모드를 줘서 실행한다. 여기서 진행하는 조사작업은, 위험한 작업이 없으므로 이렇게 진행해도 통상 무방하다. (권한 문제는 개인이 주의해서 처리해야 한다. 이 모드를 디폴트로 할지도 결정하라.)
[pro이하 계정 실행법] > claude --dangerously-skip-permissions
[max계정이상 실행법] > claude --permission-mode auto
(야속하게도, max 구독자가 아니면 계속 권한 제어를 해주어야 하는 상황이 많다.)
revfactory의 보고서 작성은, 마크다운인 md파일을 출력물로 내놓는다. 다양한 2차 저작이 가능하기 떄문이다. 아래 예를 들어보자.
제시한 간단한 프롬프트 만으로도 다양한 agent가 협업해서 결과물을 내놓는 장면을 볼 수 있다. 세부 md를 보면 출처 명기나, 검증 등을 기본 수행하도록 하기 때문에 보고서 품질이 좋으며 출처가 명확하고, 검증이 상당부분 된 것을 알 수 있다.
그리고 agent team 구성 직후에도 해당 agent의 md를 추가로 직접 수정하거나 다시 프롬프트로 명령해서 정비하면서, 팀의 업무체계를 조율하는 것도 가능하다. 결과물을 보고 하네스를 수정하라고 지시해서 변경 한 후, 다시 실행하는 것도 가능하다. 이 부분은 여러분이 계속 진화할 필요가 있다. 필요한 md가 업데이트되고, 지시대로 수행되는 구조다.
또한 이 최종 보고서 md만으로는 사람이 보기 힘드니, 명기한대로 2차 저작물을 위한 하네스를 구성하는 것도 가능하다. 이렇게 md로 범용적인 형태로 되어 있기 때문에, pdf 형식이나 웹사이트, 책 등 다양한 형태로 보고서를 만들 수 있다.
4. 만들어진 md보고서를 다양한 형식으로 추가 확장하자.
md보고서는 형식화된 콘텐츠이므로 하네스 구성을 통해 다양한 2차 저작물로 진화가 가능하다. (심지어는 openai나 gemini API를 연결해주고 하네스를 구성하면, 비용이 좀 소모되어도, 데모 영상으로 만들어 달라고 할 수 있다! 물론 이미지 생성 결합도, 연결만 해주면 생성이 가능하다) 여기서는 우선 일반적으로 추가 비용없이 하는 방법을 알아보자.
a) 간단하게는 만들어진 md를 pdf로 만드는 것은 harness도 필요없이 가능하다
이 과정에서 python이 필요할 수도 있으니, python을 설치해주면 좋다.
b) 하지만, 역시 harness 플러그인으로 다양하게 확장할 수 있다. 아래와 같이 명령해서 하네스 체계를 구성하자. 웹페이지로 간단하게 만들되 html 1개로 만들어 다른 사용자에게 배포할 수 있다.
/harness 만들어진 최종 보고서를 웹페이지로 만드는 하네스를 구성해줘. 젊은 직장인 감각으로 모바일/웹 모두 볼 수 있게 간결하게 만들어줘. 만들어진 웹페이지는 메일로도 첨부 전송해서 확인할 수 있게 report.html 하나의 파일로 만들어줘
실제 모든 작업이 끝나면 report.html이 폴더 안에 생성되고 열어보면 아래와 같이 보기 편하게 만들어진 것을 알수 있다.
5. 다양한 조사나 업무 및 추가 2차 저작물 생성이 가능하다.
a) 실제로 하네스를 구성할때는 나에게 맞춤형으로 하기 위해서 정확한 회사 명칭이나 내 위치 상황을 넣으면 좋다
예시1>
/harness 나는 XX에 근무하는 XX담당자인데, XX시장의 영업 매출을 올릴 수 있도록 우리 회사를 위한 전략 보고서를 작성하는 하네스를 구성해줘. xx나 xx에 더 집중해줬으면 좋겠어.
/harness 만들어진 최종 보고서를 임원 중심으로 간결하게 보고하기 위한 pdf를 생성하는 하네스를 구성해줘
예시2>
/harness 폴더의 asset.xls 파일을 로딩해서 해당 자산에 대한 중단기 투자 전략을 정리하는 보고서를 작성할 하네스를 구성해줘. 해당 자산 소유자의 정보는 personal.xls 파일을 참고해 (엑셀에 몇가지 정보를 넣고 그에 기반해 조사. 소유자의 직업이나 나이, 가족 상황 등)
예시3>
/harness https://xxx 사이트의 블로그 작가를 위해 해당 글을 전수 검사해서 평가하고 수정하고 코칭할 내용을 담은 보고서를 작성할 하네스를 구성해줘
b) 다양한 명령을 내려도 잘 대응하며, 여러가지 2차 저작물 지시에도 사용자가 별 지식이 없어도 가이드하며 진행해준다.
예시1>
/harness claude code의 최근 추가된 기능을 웹사이트 형 책으로 만들기 위한 하네스를 구성해줘...xxx
/harness 만들어진 최종 기획서 md를 가지고 실제 웹사이트를 만들 하네스를 구성해줘. html/index.html 구성으로 생성해서 내가 해당 파일을 부러우저에서 열만 브라우저를 통해 그 책이 보였으면 좋겠어
예시2>
/harness 애니메이션 프리렌의 외전 웹툰을 만들 하네스를 구성해줘. 각 인물의 개성이 잘 살아나고, 프리렌의 기본 줄거리 사상을 잘 반영하면 좋겠어. 나중에 웹툰을 만들때 인물 사진의 일관성을 유지하기 위해서 인터넷에서 해당 인물의 사진을 저장해서 인물 정보로 삼고, 이 사진들에 기반해 웹툰을 만들도록 해줘
/harness 구성한 기획안을 가지고 실제 웹사이트 콘텐츠를 만드는 하네스를 구성해줘. html/index.html 을 열면 해당 웹툰을 볼 수 있게 해줘
/harness 구성한 기획안을 가지고 실제 프리렌 외전 영상을 만드는 하네스를 구성해줘. 가지고 있는 gemini API를 활용해서 만들어줘
아래는 엉뚱하게도, 이러한 이렇게 만든 프리렌 웹툰 예시이다. Claude Code가 다양한 업무를 사용자의 별다른 지식 없이도 스스로 목적에 따라 방법을 찾아 진행하고 산출물을 만들어주는 예시 중의 하나다.
6. Harness(하네스) Engineering과 harness plugin은 어떻게 다른가?
참고로 하네스 엔지니어링이란, LLM agent가 인간의 개입없이 어떤 목적을 달성하기 위해 체계를 잡는 작업을 통칭한다고 볼 수 있다. 하네스 엔지니어링 말 자체는 오래전에 있어왔고, 하네스 엔지니어링에 어떤 고정된 법칙이나 도구가 있지는 않다. 다만 최근 에이전트에 이 개념이 더욱 부각되고 있고 이런 원칙을 대표적인 가이드로 삼는다.
1) 필요한 정보를 agent에 모두 제공하도록 하고
2) 간결하게 목적 달성을 위한 가이드를 명시하며, 맥락에 따라 정보를 만날 수 있도록 하고,
3) 불필요한 지시를 지속 제거하고
4) 일정 수준의 검증 루프가 들어가는 것들을 기본으로 한다. 완성에 대한 자가 확인이 가능한 구조이다.
여기서 소개한 harness plug-in은 하네스 엔지니어링을 지향하며 만든, 샘플로 만든 몇가지 체계를 가지고, 사용자의 요청에 따라 해당 분야의 하네스 엔지니어링 작업을 한 듯한 agent구성 및 skill을 셋팅해준다. 소위 md를 만드는 메타md라고 부를 수 있다. 따라서 이 plugin의 작동 방식과, 하네스 엔지니어링의 지향점, 하네스 엔지니어링이 무엇인지는 잘 의미구분해서 이해할 필요는 있다.
즉 이 harness plugin을 사용하는 것이 하네스 엔지니어링의 전부는 아니라는 의미다.
하네스 엔지니어링의 체계는 아마도 계속 보완발전할 것이며, plugin들도 많아지겠다. 또한 현재는 claude code가 이 개념을 잘 이행할 수 있도록 기능을 갖추고 있지만(명시적 agent 구성 가능 등), 다른 CLI(gemini CLI, openai codex) 툴들도 곧 다양하게 지원하지 않을까 예상된다. 하지만 지금은 claude code + harness plug-in 조합이 가장 빠르게 하네스 엔지니어링을 체험할 수 있다고 생각한다.
'머신러닝AI' 카테고리의 다른 글
| Claude Code를 Agent로 제대로 쓰기 위한 툴 가이드 (MacOS 중심) (0) | 2026.04.27 |
|---|---|
| Claude Code를 ollama에 설치된 LLM에 연결해서 쓰는법('26.4월) (0) | 2026.04.27 |
| 맥미니 없이도 윈도우에서 OpenClaw 설치해서 해보기 (WSL2 - 윈도우내 리눅스) (0) | 2026.03.22 |
| 맥미니 없이도 윈도우에서 OpenClaw 설치해서 해보기 (Native Windows) (0) | 2026.03.21 |
| OpenClaw, 대화를 넘어 "일하는 AI"로 만드는 법, 맥매니(macmini) (0) | 2026.03.08 |
