AI 에이전트 하네스(Harness)란 무엇인가?

 

 

 

요즘 AI 뉴스를 챙겨보다 보면 "에이전트 하네스(Agent Harness)"라는 단어를 심심찮게 마주치게 됩니다.

Claude Code, Cursor, Antigravity 같은 도구를 매일 쓰고 계신 분들이라면 이미 익숙한 개념일 수도 있지만,

정작 "하네스가 정확히 뭔데?"라고 물으면 명확하게 설명하기 쉽지 않은 용어이기도 합니다.

 

AI 스타트업 Earendil이 최근 공개한 글 "[What is a Harness?]가

이 개념을 등반 장비에 빗대어 아주 쉽게 풀어주고 있어서, 오늘은 이 내용을 바탕으로 정리해보려 합니다.

 

 

클라이밍 하네스에서 온 비유

 

하네스(harness)는 원래 등반가가 몸에 착용하는 안전벨트를 뜻합니다.

카라비너와 로프를 연결해 추락을 막아주고, 초크백이나 퀵드로 같은 장비를 걸어둘 수 있는 고리도 달려 있죠.

중요한 건 이 하네스를 등반가가 직접 소유하고, 산이나 암벽의 종류에 따라 자유롭게 커스터마이징한다는 점입니다.

 

AI 에이전트 하네스도 구조와 기능 면에서 이 비유와 꽤 닮아 있습니다.

 

 

에이전트 = 모델 + 하네스

 

Earendil은 "Agent = Model + Harness"라는 공식으로 설명합니다.

즉, AI 모델(예: Claude, GPT) 자체는 에이전트의 '두뇌'에 해당하고,

그 두뇌가 실제로 움직이며 일할 수 있는 '몸과 환경'을 만들어주는 소프트웨어가 바로 하네스입니다.

 

에이전트 하네스란, AI 모델이 그 안에서 작동할 수 있도록 환경을 제공하는 소프트웨어입니다.

일반적인 AI 모델과 달리, 사용자가 직접 자신만의 하네스를 소유하고 다룰 수 있다는 게 핵심입니다.

 

터미널에서 직접 다루는 Pi 같은 도구도 있고, 이메일이나 채팅 앱 인터페이스로 동작하는 OpenClaw, Lefos 같은 하네스도 있습니다.

인터페이스는 저마다 다르지만, 하네스는 보통 다음 네 가지 역할을 공통적으로 수행합니다.

 

1) 시스템 프롬프트

 

AI 모델은 학습 과정에서 이미 어느 정도의 규칙과 가이드라인을 내재화하고 있지만,

하네스가 제공하는 '시스템 프롬프트'는 이보다 훨씬 가볍습니다.

비유하자면 신입사원이 첫 출근일에 받는 업무 지침서와 비슷합니다.

완전히 몸에 밴 습관은 아니지만, 그 업무를 수행할 때는 반드시 따라야 하는 지침인 거죠.

이 시스템 프롬프트는 매 대화마다 함께 주입되어, 모델이 해당 하네스의 맥락에 맞게 행동하도록 이끕니다.

 

2) 도구(Tools)

 

도구는 모델이 "호출"할 수 있는 코드 형태의 기능들입니다.

웹 검색 도구, 코드를 작성하고 실행하는 도구, 이메일을 작성하는 도구 등이 대표적인 예죠.

흥미로운 점은, 하네스가 "언제 어떻게 이 도구를 써라"라고 강제하지 않는다는 것입니다.

그저 도구를 제공하고 명확히 설명해줄 뿐, 실제로 언제 어떻게 사용할지는 AI 모델 스스로 판단합니다.

 

3) 에이전틱 루프(Agentic Loop)

 

이제 모델은 지침과 도구를 갖춘 채 하네스 안에 놓여 있습니다.

예를 들어 이메일 기반 하네스에 "우리 동네 초등학교 순위와 성적을 비교해서 추천해줘"라고 요청했다고 가정해봅시다.

 

모델은 먼저 요청을 이해하고, 웹 검색으로 최신 데이터를 수집합니다.

검색 결과가 충분치 않다고 판단되면 스스로 다시 검색합니다 — 이것이 바로 '루프'의 첫 사례입니다.

데이터가 충분히 모이면 코드 작성 도구로 스프레드시트를 만들고, 다시 원래 요청과 대조해봅니다.

부족하다고 느끼면 또 검색으로 돌아가고, 충분하다고 판단되면 이메일 작성 도구로 결과를 요약해 발송합니다.

이렇게 스스로 판단하며 도구 호출을 반복하는 과정을 "에이전틱 루프"라고 부릅니다.

 

4) 번역 계층(Translation Layer)

 

마지막으로, 하네스가 서로 다른 AI 모델과 함께 작동할 수 있게 해주는 '번역 계층'이 있습니다.

같은 에이전틱 루프 안에서도 작업 성격에 따라 다른 모델을 골라 쓸 수 있는 것도 이 계층 덕분입니다.

사용자가 Anthropic 모델, OpenAI 모델, 오픈 웨이트 모델 중 무엇을 쓸지 직접 선택할 수 있다는 점에서,

이 번역 계층은 AI 랩(기업)에서 사용자 손으로 권한을 되돌려주는 장치이기도 합니다.

 

 

하네스를 '내 것'으로 만든다는 것

 

AI 모델 자체는 소유할 수 없지만, 하네스는 클라이밍 장비처럼 소유하고 취향껏 개조할 수 있습니다.

Earendil이 만드는 Pi는 미니멀한 하네스로, 시스템 프롬프트도 짧고 기본 도구도 적습니다.

하지만 사용자들이 저마다의 워크플로에 맞게 확장(extension)을 만들어 공유하면서,

지금까지 5,000개가 넘는 확장이 커뮤니티 안에서 오가고 있다고 합니다.

Pi는 무료 오픈소스이며 로컬 컴퓨터에서 구동됩니다.

 

 

왜 오픈소스 하네스가 중요한가

 

흥미롭게도 최초로 널리 알려진 에이전트 하네스인 Claude Code는 애초에 중립적인 번역 계층으로 설계된 것이 아니라,

Claude 모델로 코딩을 하기 위한 애플리케이션으로 시작했습니다.

이후 OpenClaw, OpenCode, Hermes, Pi처럼 자유롭게 열려 있는 오픈소스 하네스들이 늘어나는 추세입니다.

 

Earendil은 이 흐름을 "거대해지는 AI 기업의 영향력에 대한 우려에 대응하는 방법"으로 설명합니다.

AI를 무작정 피하기보다, 사람들이 직접 소유하고 다룰 수 있는 도구로 AI를 "길들이는" 것 — 이것이 오픈소스 하네스가 지향하는 방향이라는 거죠.

 

 

정리하며

 

정리하면, 에이전트 하네스는 ①시스템 프롬프트 ②도구 ③에이전틱 루프 ④번역 계층, 이 네 가지 요소로

AI 모델이 실제로 "일할 수 있는 몸"이 되어주는 소프트웨어입니다.

 

Claude Code나 Cursor를 매일 쓰는 개발자 입장에서 보면, 결국 우리가 체감하는 AI 코딩 경험의 상당 부분은

모델 자체의 성능보다도 이 하네스가 얼마나 잘 설계되어 있느냐에 좌우된다는 걸 새삼 느끼게 됩니다.

앞으로 어떤 하네스를 선택하고, 얼마나 나에게 맞게 커스터마이징하느냐가 AI 활용의 중요한 변수가 될 것 같습니다.

 

 

---

 

[참고 자료]

- Earendil, [What is a Harness?(2026.8.20)]

What is a Harness? | EARENDIL

 

 

#AI에이전트 #에이전트하네스 #AgentHarness #Claude #ClaudeCode #Cursor #Antigravity #AI개발 #오픈소스AI #에이전틱루프 #시스템프롬프트 #AI모델 #Pi #Lefos #OpenClaw #Earendil #AI코딩 #AI생태계