에이전틱 하네스(종종 그냥 "하네스"라고 함)는 원시 언어 모델을 작동하는 에이전트로 바꿔주는 소프트웨어 환경이다. 즉, 모델에 컨텍스트를 공급하고, 도구 호출을 실행하며, 결과를 반환하고, 작업이 완료될 때까지 반복하는 루프이다. 이 용어는 2025-2026년에 AI 엔지니어링의 핵심이 되었는데, 그 이유는 에이전트의 실제 능력 중 상당 부분이 모델 자체가 아니라 주변 하네스의 품질에서 비롯된다는 사실이 분명해졌기 때문이다 - 동일한 모델도 실행되는 하네스에 따라 평범해 보이거나 탁월해 보일 수 있다.
하네스가 제공하는 것
- 에이전트 루프. 모델에 프롬프트를 주고, 그 동작을 파싱하고, 실행하며, 결과를 컨텍스트에 추가하고, 반복한다. 종료 조건, 재시도 및 오류 처리는 여기에 있다.
- 도구. 파일 편집, 셸 실행, 브라우징, 코드 실행, 검색 - 함수 호출 또는 Model Context Protocol 같은 프로토콜을 통해 노출된다.
- 컨텍스트 관리. 각 턴에 모델이 보는 것: 시스템 프롬프트, 컨텍스트 엔지니어링, 컨텍스트 창이 가득 찰 때의 요약 또는 압축, 세션 간 메모리.
- 하위 에이전트 및 오케스트레이션. 병렬 또는 전문화된 작업을 위해 하위 에이전트를 생성하고, 그 결과를 병합한다 - 멀티 에이전트 시스템과 건틀릿 루프 같은 패턴의 기반이다.
- 안전 장치. 권한, 샌드박싱, 인간 승인 게이트 및 감사 로그; 2026년 OpenAI-Hugging Face 사건(2026 OpenAI agent cyberattacks 참조)은 하네스 수준의 격리를 최우선 안전 주제로 만들었다.
예시
코딩 하네스가 가장 눈에 띈다: Claude Code, OpenAI의 Codex CLI, Cursor의 에이전트 모드, 그리고 OpenHands와 Aider 같은 오픈 소스 프로젝트. 평가 하네스(SWE-bench 같은 벤치마크를 실행하는 데 사용되는 스캐폴드)는 측정에 적용된 동일한 개념이므로, 벤치마크 결과는 종종 "하네스 X 사용"으로 보고된다: 점수는 모델뿐만 아니라 하네스에 따라 움직인다.
용어가 중요한 이유
"하네스"는 이전에 혼동되던 두 계층을 분리한다: 모델 능력(가중치)과 에이전트 능력(가중치 + 환경). 모델 발표는 점점 하네스 의존적 결과를 인용하고, 프롬프트 패턴은 하네스를 위해 작성되며(건틀릿 루프는 명시적으로 하네스를 요구한다), 연구소는 자체 하네스에 맞춰 모델을 튜닝한다 - Anthropic의 Claude 모델과 Claude Code가 대표적인 짝이다. 관련 용어인 에이전트 스캐폴딩은 때때로 상호 교환적으로 사용되지만, 스캐폴딩은 일반적으로 프롬프트 및 워크플로 구조를 가리키는 반면 하네스는 전체 런타임을 가리킨다.