wikiline.dev
·
Wikiline › AI (인공지능) › AI 에이전트 스택 › 에이전트 하네스 (Agent Harness)

에이전트 하네스 (Agent Harness)

타임라인 9건업데이트 1건갱신 2026-09-28별칭: 코딩 에이전트, CLI 에이전트, agent harness, coding agent CLI

한 줄 정의

모델 주위에 "실행 루프 + 도구(파일·터미널·브라우저 등) + 컨텍스트 관리"를 묶어, 모델이 실제 작업 환경에서 반복적으로 행동할 수 있게 해주는 실행 프레임(제품 형태로는 CLI·SDK·IDE 통합 등).

지금 상태 (2026-09 기준)

2025년 2월 Anthropic의 Claude Code가 터미널 기반 "에이전틱 코딩" 하네스를 연 이후, 두 달 안에 OpenAI Codex CLI(4월), GitHub Copilot 코딩 에이전트(5월), Google Gemini CLI(6월)가 잇따라 출시되며 "터미널/CLI형 코딩 에이전트"가 하나의 제품군으로 자리잡았습니다. 2025년 9월 Anthropic은 Claude Code의 내부 엔진을 범용 "Claude Agent SDK"로 명명해 코딩 외 영역까지 하네스를 재사용할 수 있게 개방했고, 같은 시기 GitHub Copilot 코딩 에이전트가 GA로 전환됐습니다. 2025년 말~2026년에는 Cursor 2.0의 다중 에이전트 병렬 실행, OpenAI Codex의 데스크톱 앱화처럼 "하나의 하네스에서 여러 에이전트를 동시에 굴리는" 방향으로 진화 중입니다.

개념

  • 하네스의 구성 요소: (1) 모델을 호출하는 반복 루프, (2) 파일 읽기/쓰기·셸 실행·웹 검색 등 도구 계층, (3) 컨텍스트 창을 관리하는 로직(무엇을 남기고 무엇을 요약·삭제할지). 이 세 가지를 한 데 묶은 실행 계층을 "하네스"라 부릅니다.
  • CLI형 vs SDK형 vs IDE 통합형: Claude Code·Codex CLI·Gemini CLI는 터미널에서 직접 실행하는 CLI형, Claude Agent SDK는 개발자가 자기 애플리케이션에 하네스를 임베드하는 SDK형, Cursor·GitHub Copilot은 에디터/플랫폼에 통합된 형태입니다. 세 형태 모두 "루프+도구+컨텍스트 관리"라는 동일한 하네스 개념을 다른 제품 표면에 얹은 것.
  • "SDK 이름 변경"의 의미(2025-09): Anthropic은 Claude Code를 구동하던 SDK를 "Claude Code SDK"에서 "Claude Agent SDK"로 개명했습니다. 이는 같은 하네스 엔진이 코딩 작업 전용이 아니라 범용 에이전트 구축에도 쓰인다는 것을 공식화한 것으로, 하네스와 특정 도메인(코딩)을 분리해서 보는 관점을 보여줍니다.
  • research preview → GA 흐름: 대부분의 하네스 제품은 "제한적 연구 프리뷰 → 퍼블릭 프리뷰 → GA"의 단계를 거쳤습니다. Claude Code(2025-02 리서치 프리뷰), GitHub Copilot 코딩 에이전트(2025-05 퍼블릭 프리뷰 → 2025-09 GA), Codex(2025-04 CLI 오픈소스 → 2025-05 클라우드 리서치 프리뷰 → 2025-10 GA)가 같은 패턴을 보였습니다.
  • 다중 에이전트 병렬 실행으로의 확장(2025-10 이후): Cursor 2.0은 여러 에이전트를 git worktree/원격 머신 기반으로 동시에 돌려 같은 문제에 대해 여러 결과를 비교하는 방식을 도입했습니다. 이는 단일 하네스 루프를 여러 개 동시에 오케스트레이션하는 방향으로, 하네스 개념이 "1루프 1작업"에서 "다중 루프 병렬 작업"으로 확장된 사례입니다.

[업데이트 2026-09-28] Google은 SWE-bench류 종단 벤치마크가 느리고 비싸며 에이전트가 어디서 실패했는지 근본 원인을 짚어주지 못한다고 지적하고, 하네스를 검증할 때 빠르고 로컬에서 도는 "행동 평가(behavioral evaluation)"를 함께 쓰라고 제안했다 — 하네스 품질을 반복 개선·검증하는 실무 방법론에 대한 보강. (The Anatomy of Harness Engineering)

벤더별 비교

구분 Anthropic OpenAI Google Cursor GitHub
제품명 Claude Code / Claude Agent SDK Codex CLI / Codex Gemini CLI Cursor Agent Mode / Composer Copilot Coding Agent
형태 터미널 CLI + 임베드형 SDK 터미널 CLI + 클라우드/데스크톱 앱 오픈소스 터미널 CLI IDE 통합 + 클라우드 에이전트 GitHub 플랫폼 통합 에이전트
최초 공개 2025-02-24 (리서치 프리뷰) 2025-04-16 (CLI) 2025-06-25 (에이전트 모드 자체는 이전부터, 2.0에서 멀티에이전트로 확장) 2025-05-19 (퍼블릭 프리뷰)
GA/주요 전환 2025-09-29 SDK 개명(Agent SDK) 2025-10-06 GA — 2025-10-29 Cursor 2.0(병렬 멀티에이전트) 2025-09-25 GA

잘 쓰는 법

  • 하네스를 고를 때는 "어떤 도구까지 기본 내장인지"(파일시스템, 셸, 브라우저, 원격 실행)를 먼저 확인 — 기본 제공 범위가 다르면 같은 작업도 설정 비용이 크게 갈립니다.
  • research preview 단계 제품은 rate limit·요금 정책이 자주 바뀌므로, 프로덕션에 붙이기 전 GA 여부를 확인하는 습관이 필요합니다(예: Codex는 CLI 공개 후 GA까지 약 6개월 걸렸습니다).
  • SDK형 하네스(Claude Agent SDK 등)를 쓸 때는 "코딩 전용 가정"이 남아있는 디폴트 프롬프트/도구가 있는지 점검 — 원래 코딩 하네스에서 파생된 경우가 많습니다.
  • 여러 에이전트를 병렬로 돌리는 기능(Cursor 2.0류)을 쓸 때는 결과 선택 기준(비용 대비 품질)을 먼저 정해두지 않으면 API 비용이 선형이 아니라 곱으로 늘어납니다.
  • CLI 하네스는 "한 세션 안에서 컨텍스트를 얼마나 오래 유지하는지"가 제품마다 다르므로, 장시간 작업에는 세션 유지/재개 기능 지원 여부를 확인할 것.

타임라인

2025-02-24 · Claude Code 리서치 프리뷰 공개

  • 이전 대비: 최초 등장 — Anthropic이 "에이전틱 코딩"을 위한 터미널 CLI 하네스를 처음 상품화. 코드 검색·수정·테스트 실행·git 커밋까지 하나의 루프에서 처리.
  • Claude 3.7 Sonnet 발표와 함께 제한적 리서치 프리뷰로 공개, 이후 코딩 하네스 제품군 경쟁의 기준점이 됨.
  • 출처: Claude 3.7 Sonnet and Claude Code (Anthropic)

2025-04-16 · OpenAI Codex CLI 오픈소스 공개

  • 이전 대비: Claude Code와 동일한 "터미널 기반 에이전틱 코딩" 카테고리에 OpenAI가 오픈소스 CLI로 진입.
  • 로컬에서 실행되며 OpenAI 모델을 코드/커맨드라인 작업에 연결하는 오픈소스 도구로 출시.
  • 출처: OpenAI debuts Codex CLI (TechCrunch 경유, Wikipedia 정리)

2025-05-16 · Codex 클라우드 리서치 프리뷰(codex-1)

  • 이전 대비: CLI(로컬 실행)에서 클라우드 기반 웹 에이전트로 확장, 코드 특화 추론 모델(codex-1)을 별도로 얹음.
  • ChatGPT 유료 등급 일부에 웹 기반 리서치 프리뷰로 제공 시작.
  • 출처: OpenAI Codex (AI agent), Wikipedia

2025-05-19 · GitHub Copilot 코딩 에이전트 퍼블릭 프리뷰

2025-06-25 · Google Gemini CLI 오픈소스 공개

  • 이전 대비: Claude Code·Codex CLI에 이어 Google도 오픈소스 터미널 에이전트로 3사 CLI 경쟁 구도를 완성.
  • 오픈소스로 공개되어 터미널에서 Gemini 모델을 코딩·자동화 작업에 연결.
  • 출처: Google announces Gemini CLI (blog.google, 2025-06-25)

2025-09-25 · GitHub Copilot 코딩 에이전트 GA

2025-09-29 · "Claude Code SDK" → "Claude Agent SDK" 개명

  • 이전 대비: 하네스 엔진이 코딩 전용이라는 이름을 벗고, 범용 에이전트 구축용 SDK로 재포지셔닝.
  • Claude Code를 구동하던 SDK를 Claude Agent SDK로 명명 변경, 코딩 외 다양한 에이전트 구축에 동일 하네스를 재사용하도록 개방.
  • 출처: Building agents with the Claude Agent SDK (Anthropic/Claude, 2025-09-29)

2025-10-06 · OpenAI Codex GA

2025-10-29 · Cursor 2.0 — 멀티 에이전트 병렬 실행

  • 이전 대비: 단일 세션·단일 에이전트 루프에서, git worktree/원격 머신 기반으로 여러 에이전트를 동시에 돌려 결과를 비교하는 구조로 확장.
  • Composer 모델과 함께 다중 에이전트 병렬 실행, 에이전트 중심 UI를 도입.
  • 출처: Cursor 2.0 (cursor.com/blog/2-0, 2025-10-29)

출처

관련 주제

AI 에이전트 (AI Agent)MCP (Model Context Protocol)에이전트 스킬 (Agent Skills)서브에이전트 & 멀티에이전트 (Subagents & Multi-Agent Systems)훅 & 권한/샌드박스 (Hooks, Permissions & Sandboxing)