본문으로 건너뛰기
ReviewRamble

주간 브리프

AI 리뷰를 받은편지함으로.

  • 도구, 모델, MCP 서버, 저장소의 새 리뷰(결론부터)
  • 변경이 있을 때 다시 확인한 가격과 평점
  • 새로 발행된 분석 글

모델, 에이전트, MCP 서버, 그리고 정말 시간을 들일 만한 도구.

일주일에 한 통입니다. 각 브리프의 링크로 구독을 해지할 수 있습니다. 이메일 사용 방식

에이전트 하네스

에이전트 하네스(agent harness)는 모델을 실제로 동작하는 에이전트로 만드는 주변 소프트웨어입니다. 루프, 도구, 시스템 프롬프트, 권한, 컨텍스트 관리, 그리고 세션 사이에 진행 상황을 이어 주는 파일이 여기에 포함됩니다.

다른 이름: harness engineering

작성 Divya Sharma · 2026년 11월 15일 확인 · 리뷰 방식

같은 모델이라도 어떤 환경에서 실행되느냐에 따라 결과가 좋을 수도 나쁠 수도 있습니다. 하네스는 모델이 어떤 도구를 보는지, 결과를 어떻게 돌려주는지, 대화를 언제 줄이는지, 모델이 묻지 않고 무엇을 해도 되는지를 정합니다. Anthropic은 Claude Agent SDK를 범용 에이전트 하네스라고 부릅니다.

하네스가 맡는 일

- 에이전트 루프를 실행하고 멈추기. - 도구를 정의하고 결과를 돌려주기. - 컨텍스트 윈도를 관리하기. 예를 들어 컨텍스트 압축을 씁니다. - 권한, 승인 요청, 에이전트 샌드박스. - 진행 파일이나 git 기록처럼 한 세션보다 오래 남는 상태.

예시

Anthropic은 장시간 실행되는 코딩 에이전트를 연구하면서, 새 세션이 매번 이전 세션을 전혀 기억하지 못한 채 시작된다는 점을 확인했습니다. 그래서 하네스가 에이전트에게 세션을 시작할 때 진행 파일과 git 로그를 읽게 하고, 끝낼 때 작업을 커밋하고 그 파일을 갱신하게 했습니다. 모델과 도구는 그대로였고, 하네스가 결과를 바꿨습니다.

하네스 엔지니어링

하네스 엔지니어링은 이 계층, 즉 프롬프트, 도구 설계, 컨텍스트 전략, 점검을 조정하는 작업입니다. 작은 선택이 쌓이는 긴 작업에서 가장 중요합니다. 하네스 엔지니어링 가이드에서 더 자세히 다룹니다.

관련 용어

코딩 에이전트
코딩 에이전트(coding agent)는 소프트웨어를 직접 다루는 AI 에이전트입니다. 사람이 붙여 넣을 코드를 제안하는 데 그치지 않고, 코드베이스를 읽고, 파일을 수정하고, 명령과 테스트를 실행하며, 변경이 동작할 때까지 반복합니다.
에이전트 루프
에이전트 루프(agent loop)는 AI 에이전트의 중심에서 반복되는 순환입니다. 모델이 도구 호출을 요청하면 애플리케이션이 이를 실행해 결과를 돌려주고, 모델은 다음에 할 일을 정합니다.
에이전트 샌드박스
에이전트 샌드박스(agent sandbox)는 AI 에이전트가 코드와 명령을 실행하는 격리된 환경입니다. 컨테이너, 가상 머신, 운영체제 제한 등이 있으며, 정해진 한계 밖의 파일, 네트워크, 데이터에 닿지 못하게 합니다.
컨텍스트 엔지니어링
컨텍스트 엔지니어링(context engineering)은 작업 동안 언어 모델의 컨텍스트 윈도에 들어가는 모든 것을 고르고 관리하는 일입니다. 지시, 검색한 문서, 도구 정의, 도구 결과, 대화 기록이 여기에 포함됩니다.
컨텍스트 압축
컨텍스트 압축(context compaction)은 에이전트가 컨텍스트 윈도 한도에 가까워진 대화를 요약하고, 그 요약에서 시작하는 새 윈도에서 이어 가는 단계입니다. 그래서 긴 작업을 계속할 수 있습니다.

출처