하네스 (Harness)는 힘센 말을 마차에 연결해 원하는 방향으로 끌게 하는 마구 같은 것 — AI 모델을 둘러싸고 도구·규칙·역할 분담·검증 절차를 묶어, 정해진 방식대로 일하게 만드는 실행 틀이에요.
하네스는 원래 말에 채우는 마구를 뜻해요. 말이 아무리 힘이 세도 마구 없이는 마차를 원하는 방향으로 끌 수 없죠. AI도 비슷해서, 똑똑한 모델 하나만으로는 파일을 고치고 테스트하고 결과를 검증하는 일을 안정적으로 해내기 어려워요. 그래서 모델 주변에 '어떤 도구를 쓸 수 있는지, 어떤 순서로 일하는지, 누가 검토하는지'를 정한 틀을 씌우는데, 이것을 하네스라고 불러요. Claude Code나 Codex 같은 AI 코딩 도구 자체도 모델을 감싼 하네스의 한 예예요.
1인 사업자가 AI 에이전트로 사이트나 자동화를 만들 때, 하네스는 '일하는 방식의 설계도'가 돼요. 예를 들어 "구현은 Claude Code가 하고, 리뷰는 Codex가 하고, 시작 전에 규칙 파일을 읽는다"처럼 역할과 절차를 정해 두는 거예요. 작업 유형에 따라 알맞은 모델로 보내는 스마트 라우팅, 규칙을 담은 스킬 파일, 작업 전후 자동 점검(훅)까지 묶어서 설계하는 일을 '하네스 엔지니어링'이라고 부르기도 해요. 이렇게 틀을 잡아 두면 매번 같은 품질로 결과가 나와요.
초보가 헷갈리는 점은 하네스를 특정 프로그램 이름으로 생각하는 거예요. 하네스는 제품명이 아니라 '모델을 감싼 실행 틀'이라는 개념이에요. 또 모델 성능만 바꾼다고 결과가 좋아지지 않는 경우가 많은데, 이때는 하네스, 즉 도구 권한·검증 절차·규칙 문서를 손보는 게 더 효과적일 때가 많아요. 규칙을 너무 많이 넣으면 오히려 느려지니 꼭 필요한 절차부터 정하세요.
AI 에이전트를 직접 만들고 24시간 운영하는 법을 단계별 강의로 배워보세요.