[한빛] 하네스 엔지니어링 클로드 코드로 내 일을 대신하는 AI 에이전트 만들기 - 나를 도와주는 나만의 에이전트를 만들고 싶은 분들을 위한 교과서
“한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 강의를 협찬받아 작성된 서평입니다.”
'클로드 코드'와 같은 AI 에이전트는 S/W개발자의 전유물이 아니라 모든 사람들이 사용할 수 있는 범용성 있는 도구이다.
최근 AI 에이전트들은 상당히 똑똑해져서 간단한 프롬프트만으로도 훌륭한 결과를 보여주지만,
내가 원하는대로 내 몸과 같이 다루기 위해서는 `하네스(Harness)`에 대한 공부가 필요하다.
하네스 엔지니어링 실습 준비
이 책의 실습을 위한 환경은 다음과 같다.
- AI 코딩 에이전트: Claude Code
- 추천 구독 요금제: Claude Pro
- 추천 운영환경: Windows
나는 현재 ChatGPT, Gemini를 구독하고 있고,
개인적으로 선호하는 AI 코딩 에이전트는 OpenCode이며 개발환경은 Linux를 사용하고 있기에
책의 내용을 이 환경에서도 실습 가능한지도 같이 알아보면서 공부해봤다.
사실 그냥 책에 나오는 대로 편하게 공부하는 방법은
시키는대로 Claude Pro 구독하고 Claude Code를 사용하는 것을 추천한다.
회의록 작성 에이전트 작성
회의 녹취 텍스트를 입력하면 자동으로 회의록을 정리해주는 에이전트를 만들어보자.
나는 앞서 말한대로 OpenCode에서 실습을 진행했고, 모델은 OpenAI의 GPT-6 Sol을 사용해서 해봤다.
디렉토리 생성 및 system_prompt.md 파일을 생성했다고 나온다.
당연하게도 실제 잘 생성된 결과를 확인할 수 있다.
이후 4개 섹션에 적절한 프롬프트들을 채워 넣으면 된다.
직접 타이핑이 어렵다면, 저자가 제공해주는 `프롬프트 모음` 파일을 내려 받아서 copy & paste 하면 된다.
시스템 프롬프트를 모두 작성했으면,
그 다음으로 에이전트를 만들어야 하는데 무료 API를 사용하도록 하기 위해서 책에서 제공하는 프롬프트를 살짝 수정했다.
| specs/system_prompt.md를 읽어서 그 스펙대로 동작하는 회의록 자동화 에이전트를 agents/meeting-notes/ 폴더 아래에 만들어줘. 다음 파일들을 만들어줘: 1. agents/meeting-notes/prompts.py - SYSTEM_PROMPT 변수에 specs/system_prompt.md의 내용을 읽어서 저장 2. agents/meeting-notes/run.py - 표준 입력 또는 파일에서 회의 녹취를 받아 - NVIDIA Build에서 제공해주는 deepseek-ai/deepseek-v4.1-flash API를 호출하고 - 결과를 화면에 출력하는 스크립트 모델 API 호출은 OpenAI 라이브러리를 사용해줘. 코드 샘플은 https://build.nvidia.com/deepseek-ai/deepseek-v4.1-flash 참고해줘. 패키지 관리는 uv를 사용해줘. |
NVIDIA Build 회원 가입 및 무료 API 사용은 다음 포스팅을 참고하기 바란다.
Key 생성까지 진행하여 Key 값을 적어놓자.
- https://www.whatwant.com/entry/NVIDIA-Build (엔비디아에서 제공해주는 무료 LLM API 사용하기 - NVIDIA Build)
회의록 작성 에이전트 실행
테스트를 위한 회의 녹취록은 책에서 제공해주는 프롬프트를 이용해서 tests/sample_meeting.txt 파일로 만들먄 된다.
실행을 위해서는 NVIDIA API Key값이 필요하므로, 다음과 같은 프롬프트로 실행하면 된다.
| agents/meeting-notes/run.py를 실행해서 tests/sample_meeting.txt 회의록을 처리해줘. 처리된 회의록 결과를 화면에 보여줘. NVIDIA Key 값은 "***"를 사용하면 돼. |
그러면, 다음과 같이 회의록이 잘 생성된 것을 확인할 수 있다.
실행 결과 확인
실행된 것으로 끝이 아니다.
결과가 잘 나왔는지 확인을 해야한다.
- 메타 정보(날짜, 참석자, 안건)가 정확한다
- 결정 사항에 "5월 캠페인은 인스타와 틱톡 집중"이 포함되어 있는가
- 액션 아이템에 이재현(시안 1차, 다음 주 금)과 박민수(예산 배분, 5월 5일)가 표 형식으로 정리되어 있는가
- 다음 회의 일정 (5월 6일 10시)이 포함되어 있는가
- 회의록에 없는 사실 (예. 임의로 생성된 마감일)이 추가되지 않았는가
이런 검토를 통해 에이전트가 잘 만들어진 것인지 확인할 수가 있는 것이다.
결론
이 책은 Claude Code를 가지고 업무에 필요한 다양한 에이전트를 직접 만드는 방법을 알려주는 책이다.
AI 코딩 에이전트 및 Skill이나 MCP 등 다양한 지식을 이미 갖고 있는 분들은 물론이고
그러한 지식이 없는 초보자들도 하나씩 따라할 수 있도록 너무나 친절하게 잘 설명해주고 있다.
직접 책을 보면서 따라해본 위의 내용을 보면 알겠지만,
Claude Code가 아닌 다른 AI 코딩 에이전트로도 충분히 따라할 수 있고
Claude Code Pro 요금제 가입 없이 무료로 제공해주는 NVIDIA Build 서비스를 이용해도 충분히 따라할 수 있다.