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

에이전트 하네스 (Agent Harness)

타임라인 18건업데이트 3건갱신 2026-11-05별칭: 코딩 에이전트, 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)

[업데이트 2026-10-10] GitHub Copilot for JetBrains에서 기업 관리자가 managed settings로 새 대화의 기본 모델을 지정할 수 있고, Copilot·Claude의 MCP 서버 자동 시작을 끄는 설정도 생겼다. 진단 메뉴의 Fix 액션이 에이전트 모드로 문제 해결을 요청하며, JetBrains IDE 2025.1 지원은 종료됐다. (New controls and chat improvements in Copilot for JetBrains)

[업데이트 2026-10-27] Anthropic의 Claude Platform 엔지니어들은 Latent Space 인터뷰에서 모델(brain)과 에이전트가 실제로 일하는 부분(hands)을 분리해 설계한다고 설명했다. 쇼노트 기준으로 brain, 하네스, 샌드박스를 나눠 managed agents의 안정성과 확장을 확보하는 구조다. (How Anthropic ships the #1 LLM in the World safely)

벤더별 비교

구분 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

잘 쓰는 법

  • 하네스를 고를 때는 "어떤 도구까지 기본 내장인지"(파일시스템, 셸, 브라우저, 원격 실행)를 먼저 확인 — 기본 제공 범위가 다르면 같은 작업도 설정 비용이 크게 갈립니다.
    • 예: Claude Code는 파일·셸 접근이 기본 내장돼 있어 바로 코드 수정·테스트 실행이 가능하지만, 브라우저 조작이 필요한 E2E 테스트 작업이라면 별도 MCP 서버나 확장을 추가로 연결해야 합니다.
  • research preview 단계 제품은 rate limit·요금 정책이 자주 바뀌므로, 프로덕션에 붙이기 전 GA 여부를 확인하는 습관이 필요합니다(예: Codex는 CLI 공개 후 GA까지 약 6개월 걸렸습니다).
    • 예: 2025년 5월 리서치 프리뷰로 나온 Codex 클라우드 에이전트를 그대로 CI 파이프라인에 붙였다면, 10월 GA 전환 시점에 요금제·레이트리밋이 바뀌어 예상 못한 비용 변동을 겪었을 수 있습니다.
  • SDK형 하네스(Claude Agent SDK 등)를 쓸 때는 "코딩 전용 가정"이 남아있는 디폴트 프롬프트/도구가 있는지 점검 — 원래 코딩 하네스에서 파생된 경우가 많습니다.
    • 예: Claude Agent SDK로 고객 상담 봇을 만들 때, 기본 시스템 프롬프트에 "코드를 수정하고 테스트를 실행하라"는 류의 코딩 특화 지시가 남아있으면 엉뚱한 동작을 유발할 수 있어 프롬프트를 점검·교체해야 합니다.
  • 여러 에이전트를 병렬로 돌리는 기능(Cursor 2.0류)을 쓸 때는 결과 선택 기준(비용 대비 품질)을 먼저 정해두지 않으면 API 비용이 선형이 아니라 곱으로 늘어납니다.
    • 예: Cursor 2.0에서 같은 버그 수정 작업을 4개 에이전트에 동시에 맡기면, 단일 에이전트 대비 토큰 비용이 대략 4배로 늘어나므로 "최고 결과 하나만 채택"처럼 선택 기준을 미리 정해두지 않으면 비용만 늘고 가치는 그대로일 수 있습니다.
  • CLI 하네스는 "한 세션 안에서 컨텍스트를 얼마나 오래 유지하는지"가 제품마다 다르므로, 장시간 작업에는 세션 유지/재개 기능 지원 여부를 확인할 것.
    • 예: 하루 종일 걸리는 대규모 리팩터링 작업이라면, 세션을 끊었다 이어서 재개할 수 있는 기능(Claude Code의 웹 버전처럼 비동기로 실행되는 방식)을 지원하는 하네스를 고르는 편이 중간에 컨텍스트를 통째로 잃는 위험을 줄입니다.

타임라인

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)

2026-10-01 · GitHub Copilot, computer use 퍼블릭 프리뷰

  • 이전 대비: 터미널·코드 중심이던 Copilot 에이전트가 데스크톱 앱 화면까지 직접 조작할 수 있게 됨.
  • Copilot CLI와 macOS·Windows용 Copilot 앱에서 프리뷰로 제공된다.
  • 출처: GitHub changelog

2026-09-29 · DeepSeek Harness 데스크톱, 오픈소스 퍼블릭 프리뷰 [정정 2026-10-12: (추정) 10-02 → v0.2 rc 릴리스·보도 기준 09-29. 1차 출처로 날짜 단정은 못 함]

  • 이전 대비: 코딩 에이전트 하네스가 주로 미국 벤더의 CLI·IDE 제품이던 흐름에 DeepSeek이 오픈소스 데스크톱 하네스로 합류.
  • DeepSeek이 "모든 것이 플러그인" 구조의 오픈소스 하네스를 macOS·Windows 데스크톱 앱(웹 UI 포함)으로 퍼블릭 프리뷰 공개. 문서 정리·데이터 분석·코딩·리서치·백그라운드 자동화를 다루며 Creator 모드로 플러그인을 직접 만들 수 있다.
  • 출처: DeepSeek Harness Desktop

2026-10-07 · GitHub Copilot CLI, 로컬 모델 탐색 지원

  • 이전 대비: 이전에는 Copilot CLI에서 클라우드 모델·수동 설정 모델 위주였는데, 이제 실행 중인 로컬 Ollama 모델을 /model에서 찾아 추가할 수 있다.
  • CLI 1.0.94-0부터 /model이 로컬 모델을 보여주며, 자동 추가는 되지 않고 사용자가 제공자·엔드포인트를 확인한 뒤 추가한다. 도구 호출·스트리밍을 지원하는 모델만 대상이고, 로컬 모델을 골라도 오프라인 모드는 자동으로 켜지지 않는다(COPILOT_OFFLINE=true 필요).
  • 출처: Discover local models in GitHub Copilot CLI

2026-10-23 · GitHub Copilot, Teams에서 이슈→PR 처리

  • 이전 대비: 직전 Copilot 이벤트(CLI 로컬 모델 탐색, computer use)가 개발 환경 안의 기능이었다면, 이번엔 협업 채팅 앱이 에이전트 호출 창구가 됨.
  • 기존 GitHub 알림 앱이 Teams용 GitHub 앱으로 통합되어, 채널·그룹/개인 채팅에서 알림을 받고 @GitHub를 불러 Copilot에게 버그 조사·수정·PR 생성을 맡길 수 있다. 구 앱은 "GitHub (deprecated)"로 바뀌어 11-16 종료 예정. 프리뷰/GA 여부는 원문에 명시 없음.
  • 출처: Turn notifications into code with GitHub Copilot in Teams

2026-10-27 · GitHub Copilot, 서버 간 인증 퍼블릭 프리뷰

  • 이전 대비: 사용자 토큰 중심이던 Copilot 호출에, 조직에 설치된 GitHub App이 단기 설치 토큰으로 직접 요청하는 경로가 추가됨.
  • Copilot SDK로 만든 서비스·에이전트가 조직을 대신해 요청하고 사용량은 해당 조직에 청구된다. AI 사용량 CSV의 app_client_id로 추적하고, 앱 정지·삭제로 접근을 끊을 수 있다.
  • 출처: GitHub Copilot supports server-to-server authentication

2026-10-28 · GitHub Copilot Fusion 정식 출시(GA)

  • 이전 대비: 사용자가 작업마다 모델을 고르던 방식에서, Fusion을 고르면 Copilot이 모델을 자동 라우팅·조합하는 방식이 추가됐다.
  • 모든 Copilot 플랜에서 VS Code, Copilot 앱, Copilot CLI, JetBrains IDE로 쓸 수 있고 사용자는 Standard·High·Max 노력 수준만 고른다. 프롬프트마다 단일 모델 처리, 저비용 모델 초안 후 상위 모델 승격, 한 모델이 쓰고 다른 모델이 검토하는 흐름 중 하나를 고른다.
  • 출처: Route and orchestrate models with GitHub Copilot Fusion

2026-10-28 · GitHub Copilot 앱, 프로젝트·컴퓨터 사용 프리뷰

  • 이전 대비: 단일 저장소·세션 중심이던 작업이, 여러 저장소와 비코드 자료를 묶는 '프로젝트' 단위로 확장됐다.
  • 목표를 주면 필요한 만큼 에이전트를 돌려 PR 등 결과물을 가져오고, 반복 작업은 프로젝트 자동화로 처리한다. Slack·Figma 등 연결 도구의 맥락, 자연어 이미지 생성·편집, macOS/Windows 데스크톱 앱 조작(컴퓨터 사용, 사용자 승인 필요·조직 비활성화 가능)이 추가됐다. 프로젝트와 컴퓨터 사용은 퍼블릭 프리뷰.
  • 출처: GitHub Copilot app, Universe releases

2026-11-03 · GitHub Copilot, JetBrains Air에 출시

  • 이전 대비: 직전 이벤트(2026-10-28 Copilot 앱 프리뷰)가 자체 앱 중심이었다면, 이번에는 외부 에이전트 IDE(JetBrains Air)에서 ACP로 Copilot을 에이전트로 고를 수 있게 됐다.
  • Air의 에이전트 선택기에서 기존 Copilot 구독으로 코딩 작업을 위임하고 여러 세션을 병렬 관리하며 결과를 검토한다. 로컬 작업은 계정 연결만 필요하고, 클라우드 작업은 Air Teams 비즈니스 조직과 관리자의 Copilot 활성화가 필요하며 JetBrains AI 크레딧 대신 Copilot 플랜으로 과금된다.
  • 출처: GitHub Copilot is now available in JetBrains Air

2026-11-04 · GitHub Copilot, Xcode 내장 코딩 어시스턴트에 출시

  • 이전 대비: 직전 이벤트(JetBrains Air)에 이어, 이번에는 Apple Xcode가 자체 내장한 코딩 어시스턴트 안에서 Copilot을 쓸 수 있게 됐다.
  • 퍼블릭 프리뷰. Xcode 27.3 베타와 macOS Tahoe 26.6 이상이 필요하고 모든 Copilot 요금제를 지원하며, 기존 Copilot for Xcode 확장과는 별개다.
  • 출처: GitHub Copilot is now available in Xcode's coding assistant

출처

관련 주제

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