← 다른 편은 인스타 @ai_banjang2026-10-28 기준

모델은 엔진,
하네스는 자동차

하네스(harness)의 원래 뜻은 말에 씌우는 마구예요. AI에서는 모델이 코딩하고, 실행하고, 오류를 고치도록 둘러싸 주는 장치를 말해요.

01

한 줄 정의와 비유

하네스 = AI가 답변만 하는 게 아니라 실제로 코딩하고, 실행하고, 오류를 수정하도록 만들어 주는 실행·관리 시스템. (쉬운 풀이 정의예요. 공식 문서의 문장은 아니에요.)

힘센 쪽(모델)받쳐 주는 쪽(하네스)
말마구
엔진바퀴·핸들·브레이크까지 갖춘 자동차 전체
선수코치·장비
02

모델 혼자 vs 하네스가 붙었을 때

모델 혼자하네스 붙음
파일 읽기못 함도구로 읽음
파일 고치기고칠 코드를 말로만 알려 줌파일을 직접 수정
실행못 함명령을 실행
틀렸을 때사람이 다시 물어야 함결과를 보고 다시 시도하는 반복 루프
반복 루프: Anthropic 공식 글은 에이전트를 "맥락 모으기 → 행동 → 작업 확인 → 반복"으로 설명해요.
03

반장이 직접 시험한 결과

임시 폴더에 버그 2개가 있는 파이썬 파일(평균에 +1, 음수만 있을 때 최댓값이 0)을 두고, 같은 하이쿠 모델에 똑같이 "고쳐 줘"라고 시켰어요(각 1회). 원본을 실행하면 5.0 / 0, 정답은 4.0 / -2예요.

도구 끔(--tools "")도구 켬(파일 수정·명령 허용)
버그 2개를 정확히 짚고 고친 코드를 글로 보여 줌. 파일은 그대로.파일을 직접 수정(+ 1 삭제, best = float('-inf')). 고친 파일을 제가 실행하니 4.0 / -2 정답.
주의: 도구를 켠 모델이 스스로 실행해 보려 했지만 이 PC의 파이썬 명령 문제로 실패했고, 실행 확인은 제가 직접 했어요. 1회 측정이라 시간 비교는 하지 않았어요.
04

하네스의 부품

부품비유이 시리즈
도구(파일·명령·검색)손
권한출입증
컨텍스트책상 위 자료
훅센서11편
메모리(CLAUDE.md)수첩6편
MCP · 서브에이전트외부 연결 · 일 나누기9편 · 5편
출처: Agent SDK 개요(내장 도구·훅·서브에이전트·MCP·권한·세션·메모리를 클로드 코드와 같이 제공) · Effective harnesses for long-running agents · Building agents with the Claude Agent SDK · 클로드 코드 개요
※ 반장은 AI로 그린 캐릭터예요. 직접 확인한 내용만 적어요. 기능은 바뀔 수 있으니 공식 문서도 확인하세요. 궁금한 건 @ai_banjang 댓글로.