매니지드 에이전트 vs 로컬 에이전트 하네스: 무엇을 남길 것인가

Anthropic와 OpenAI는 에이전트 런타임 인프라를 제품 표면으로 전환하고 있습니다. 호스팅 세션, 샌드박스, 트레이싱, 메모리, 핸드오프, 루브릭, 이벤트 스트림이 이제 팀의 비공개 스크립트 폴더보다 모델 제공자 쪽에 더 가깝게 자리 잡고 있습니다.¹²

핵심 요약은 무엇인가요?

• 매니지드 에이전트가 런타임 계층이 되고 있습니다. 제공자가 팀의 보안 기준을 충족하는 경우, 세션, 샌드박스, 트레이스, 이벤트, 비동기 실행은 점점 더 매니지드 인프라에 속하게 됩니다.¹²
• 로컬 하네스는 여전히 중요합니다. 취향, 증거, 공개 글쓰기의 무결성, 프라이버시 경계, 출처 검증, 프로젝트 메모리를 인코딩하는 부분은 그대로 유지하세요.
• 이전(migration)의 단위는 명령이 아니라 작업(job)입니다. 슬래시 명령, Codex 스킬, SDK 핸드오프, MCP 서버, 매니지드 결과(outcome)는 수용 기준이 살아남는 한 모두 동일한 워크플로를 담을 수 있습니다.
• 비공개 메커니즘은 게시하지 마세요. 공개 게시물은 패턴과 수용 기준을 설명해야 하며, 비공개 프롬프트, 정확한 훅 본문, 계정 정보, 내부 점수 산정 규칙을 노출해서는 안 됩니다.
• 승격에는 증거가 필요합니다. 명시적으로 시작하고, 실제 작업 하나를 실행하고, 결과를 기록한 다음, 사용자에게 보이는 경로가 개선될 때만 승격하세요.

매니지드 에이전트 플랫폼은 상품화된 런타임 작업을 흡수해야 합니다. 샌드박스 실행, 상태 기반 세션, 이벤트 스트림, 트레이싱, 파일 실행, 비동기 완료가 그 대상입니다. 로컬 하네스는 여전히 중요하지만, 그 역할은 더 작아지고 더 날카로워집니다. 제품의 취향, 증거 게이트, 공개 글쓰기의 무결성, 프라이버시 경계, 출처 검증, 프로젝트별 운영 메모리를 인코딩하는 부분은 남기세요. 단지 다른 누구도 런타임을 패키징하지 않았기 때문에 존재했던 부분은 옮기세요.

잘못된 이전은 두 가지입니다. 첫째, 제공자가 매니지드 인프라를 출시했다는 이유로 로컬 하네스를 삭제하는 것. 둘째, 한때 실제 문제를 해결했다는 이유로 모든 로컬 명령, 훅, 프롬프트를 보존하는 것. 올바른 이전은 컴포넌트별로 한 가지 질문을 던집니다. 이것은 나의 기준을 인코딩하는가, 아니면 단지 기계를 작동시키는가?

전체 아키텍처에 대해서는 AI 에이전트 아키텍처 가이드를 읽어 보세요. 이 글의 배경이 되는 실제 로컬 이전 패턴은 Claude Code에서 Codex로의 이전 가이드, AGENTS.md 패턴, Jiro 품질 철학을 참고하세요.

이 분리의 로컬 도구 쪽에 대해서는 Claude Code는 인프라다에서 비공개 런타임 계층이 왜 성장하는지 설명하고, Claude Code vs Codex CLI 2026에서 활성화와 안전성 표면을 비교합니다.

매니지드 에이전트로 무엇이 달라졌나요?

Claude Managed Agents는 매니지드 인프라에서 실행되는 사전 구축된 에이전트 하네스를 개발자에게 제공합니다. Anthropic는 이를 장기 실행 작업과 비동기 작업에 적합한 것으로 설명하며, 에이전트, 환경, 세션, 이벤트라는 핵심 개념을 제시합니다.¹ 동일한 문서는 Claude이 파일을 읽고, 명령을 실행하고, 브라우징하고, 코드를 실행하고, MCP 서버를 사용하고, 이벤트 이력을 서버 측에 영속화할 수 있는 매니지드 환경을 설명합니다.¹

Anthropic의 엔지니어링 글은 제품 문서보다 아키텍처적 요점을 더 분명히 보여 줍니다. Managed Agents 팀은 세션 로그, 하네스, 샌드박스를 분리해 각 부분이 독립적으로 실패하거나 변경될 수 있도록 했습니다.³ 이러한 분리가 중요한 이유는, 깨지기 쉬운 단일 컨테이너 에이전트 루프를 복구 가능한 세션 상태, 교체 가능한 실행 환경, 자격 증명 주변의 더 좁은 보안 경계를 갖춘 시스템으로 바꿔 주기 때문입니다.³

OpenAI는 Agents SDK를 통해 같은 방향으로 이동하고 있습니다. 2026년 4월 15일 업데이트는 모델 네이티브 하네스, 네이티브 샌드박스 실행, 워크스페이스를 위한 매니페스트 추상화, 그리고 MCP, 스킬, AGENTS.md, 셸 실행, 패치 적용 같은 일반 프리미티브에 대한 지원을 추가했습니다.² SDK 문서는 또한 다중 실행 메모리를 위한 세션, LLM 생성·도구 호출·핸드오프·가드레일·커스텀 이벤트에 대한 트레이싱, 전문 에이전트 간 작업 이전을 위한 핸드오프를 노출합니다.⁴⁵⁶

여기까지가 새로운 소식입니다. 전략적 질문은 다릅니다. 플랫폼이 에이전트 런타임을 출시한 후, 로컬 하네스는 여전히 무엇을 해야 할까요?

런타임과 판단의 분리는 무엇인가요?

대부분의 로컬 에이전트 하네스는 항상 함께 있어서는 안 되는 두 가지 작업을 섞고 있습니다.

첫 번째 작업은 런타임 인프라입니다. 런타임은 세션을 시작하고, 도구를 부여하고, 워크스페이스를 준비하고, 명령을 실행하고, 이벤트를 저장하고, 인터럽트를 처리하고, 작업을 재개하고, 상태를 스트리밍하고, 트레이스를 기록합니다. 이 작업은 표준화에서 이득을 얻습니다. 또한 강력한 이유가 없는 한 대부분의 개별 팀이 다시 만들어서는 안 되는 보안 엔지니어링에서도 이득을 얻습니다.

두 번째 작업은 판단입니다. 판단은 좋은 작업이 어떤 모습인지, 어떤 공개적 주장에 1차 출처가 필요한지, 가이드가 게시하기엔 너무 오래되었는지, 훅이 시행하기엔 너무 시끄러운지, 출처 스캔이 게시물 대신 노트로 남아야 하는지, 에이전트가 기술적으로 정확하지만 부적절한 출력을 거부해야 하는지를 판가름합니다. 이 작업은 제품, 팀, 독자에게서 비롯되기 때문에 로컬에 머무릅니다.

매니지드 인프라는 더 나은 루프를 실행할 수 있습니다. 그러나 당신의 취향이 무엇이어야 하는지는 결정할 수 없습니다.

매니지드 에이전트로 무엇을 옮겨야 하나요?

제품 기준을 인코딩하지 않는 컴포넌트를 옮기세요.

Anthropic의 Outcomes 기능은 이 추세가 다음에 어디로 향하는지 보여 줍니다. 개발자가 루브릭을 정의하면 매니지드 하네스가 별도의 채점기를 프로비저닝하고, 에이전트는 채점기의 피드백에 맞춰 반복 개선합니다.⁷ 이는 로컬 기준을 없애지 않습니다. 그 기준에 런타임 슬롯을 부여합니다.

같은 패턴이 OpenAI 트레이싱에도 적용됩니다. SDK는 기본적으로 실행, 에이전트 스팬, 생성, 함수 도구 호출, 가드레일, 핸드오프를 트레이스하며, 트레이싱 비활성화 제어와 다른 목적지를 위한 프로세서를 제공합니다.⁵ 로컬 스크립트로 이를 근사화할 수는 있습니다. 그러나 운영 시스템에서는 보통 표준화된 트레이스를 선호하고, 팀이 이미 작업을 디버깅하는 곳으로 보내는 편이 낫습니다.

로컬에 남아야 할 것은 무엇인가요?

당신의 기준, 독자, 또는 비공개 운영 컨텍스트를 정의하는 컴포넌트는 남기세요.

제품 취향. 플랫폼은 작업을 실행할 수 있지만, 그 결과가 제품 전체를 개선하는지는 알 수 없습니다. 어수선하거나, 일반적이거나, 격을 떨어뜨리는 출력을 거부하는 취향 규칙은 남기세요.

증거 게이트. 현 세션의 증거, 사용자 경로 검증, 명시된 결함, 근본 원인 분석을 요구하는 규칙은 남기세요. 매니지드 트레이스는 무엇이 일어났는지를 알려 줍니다. 그 증거가 충분한지는 당신의 기준이 결정합니다.

공개 글쓰기의 무결성. 인용 규칙, 출처 등급 규칙, 비공개 경계 검사, SEO/AIO 검사, 게시 게이트는 사이트 가까이에 두세요. 어떤 비공개 워크플로 세부사항이 게시하기에 안전한지는 모델 제공자가 결정해서는 안 됩니다.

프로젝트 메모리. 간결한 프로젝트 독트린, 스타일 결정, 알려진 위험 요소, 릴리스 경계, 운영 로그는 팀이 검사할 수 있는 곳에 두세요. 매니지드 세션 저장소가 내구성을 진정으로 개선할 때만 저장 계층을 옮기세요.

출처 인텔리전스. 편집 라우팅 계층은 남기세요. 스캐너가 14개의 좋은 항목을 찾아도 올바른 행동이 모니터링, 가이드 유지보수, 비공개 노트라면 0개의 게시물을 만들 수 있습니다.

승격 정책. 스테이징 규칙은 남기세요. 스킬은 명시적 호출 전용으로 시작할 수 있고, 훅은 섀도우 모드로 실행될 수 있고, 플러그인은 실제 작업이 도움이 됨을 입증할 때까지 설치-파일럿 단계에 머물 수 있습니다.

이 목록이 진짜 하네스입니다. 파일과 명령은 그것의 한 가지 구현일 뿐입니다.

팀이 피해야 할 이전 실수는 무엇인가요?

이 이전을 망치는 가장 쉬운 방법은 작업이 아니라 형태를 보존하는 것입니다.

Claude Code 슬래시 명령, Codex 스킬, SDK 도구, 매니지드 결과, MCP 서버는 같은 것을 가리키는 호환 가능한 문법이 아닙니다. 그것들은 서로 다른 활성화 표면입니다. 슬래시 명령은 스킬이 될 수 있습니다. 스킬은 매니지드 결과 루브릭이 될 수 있습니다. 훅은 트레이스 프로세서가 될 수 있습니다. 로컬 스크립트는 플랫폼이 세션이나 웹훅을 노출하는 순간 불필요해질 수 있습니다.

Anthropic의 장기 실행 에이전트 글은 같은 요점을 반대 방향에서 짚습니다. 컴팩션만으로는 운영 품질의 작업이 만들어지지 않았으며, 효과적인 패턴은 기능 목록, 진행 아티팩트, 깨끗한 핸드오프 상태, 종단 간 테스트를 추가했습니다.⁸ 이는 UI 관습이 아닙니다. 증명 의무입니다.

이전은 “/scan-intel을 어디에 둘까?”가 아니라 “출처 인텔리전스 워크플로가 수행한 작업은 무엇이었는가?”를 물어야 합니다.

출처 스캐너의 경우, 작업은 “명령을 실행하기”가 아닙니다. 작업은 구성된 출처를 스캔하고, 출처 도달 가능성을 입증하고, 후보를 점수화하고, 광범위하고 신호가 약한 쓰기를 거부하고, 유용한 노트는 비공개로 보존하고, 공개 기회는 편집 검토로 라우팅하는 것입니다. 정확한 활성화 문구는 워크플로를 잃지 않고 바뀔 수 있습니다.

같은 규칙이 품질 독트린에도 적용됩니다. 비공개 프롬프트 묶음을 게시하지 마세요. 독트린을 관찰 가능한 완료 게이트로 변환하세요. 증거, 사용자 경로 검증, 비공개 경계 검토, 그리고 제품을 약화시키는 작업을 거부할 권리가 그것입니다.

출처 인텔리전스 스캐너에는 어떻게 적용되나요?

출처 인텔리전스 스캐너는 이 분리를 구체화합니다.

런타임 쪽은 옮길 수 있습니다. 매니지드 플랫폼은 예약된 작업을 실행하고, 세션을 저장하고, 브라우저나 피드 가져오기 도구를 실행하고, 이벤트를 발행하고, 트레이스를 보존할 수 있습니다. 스캔이 타임아웃되면, 매니지드 세션은 무엇이 실행되었는지, 어떤 출처가 실패했는지, 다음 실행이 어디서 재개되어야 하는지를 알아야 합니다.

판단 쪽은 로컬에 머물러야 합니다. 스캐너는 여전히 비공개 출처 맵, 점수 임계치, 중복 검사, 쓰기 분량 한도, 편집 경로가 필요합니다. 14개의 후보를 찾은 스캔이 자동으로 14개의 노트나 한 편의 글을 게시해서는 안 됩니다. 올바른 행동은 비공개 노트, 가이드 유지보수 작업, 모니터링 큐, 또는 어떠한 공개도 거부하는 것일 수 있습니다.

이 구분은 시끄러운 자동화를 유용한 워크플로로 바꿉니다.

같은 논리가 코딩, 가이드 유지보수, 번역, 공개 글쓰기 워크플로에도 적용됩니다. 플랫폼이 더 잘하는 실행 메커닉은 옮기세요. 출력이 존재할 자격이 있는지를 결정하는 기준은 남기세요.

하네스를 옮기기 전에 팀은 어떤 체크리스트를 사용해야 하나요?

로컬 하네스 컴포넌트를 매니지드 에이전트 플랫폼으로 옮기기 전에 다음 체크리스트를 사용하세요.

승격 경로는 지루해야 합니다.

1. 컴포넌트를 인벤토리합니다.
2. 그것이 수행하는 작업의 이름을 짓습니다.
3. 런타임, 판단, 메모리, 게시, 출처 인텔리전스, 안전성 중 무엇으로 분류합니다.
4. 가장 작고 유용한 버전을 포팅합니다.
5. 실제 작업 하나에서 실행합니다.
6. 무슨 일이 일어났는지 기록합니다.
7. 승격, 수정, 또는 제거합니다.

이보다 더 정교한 무언가는 보통 불확실성을 숨깁니다.

오늘날 팀은 실제 하네스를 어떻게 분리해야 하나요?

진지한 코딩과 글쓰기 환경이라면 저는 다음과 같이 분리하겠습니다.

제공자 또는 매니지드 계층:

• 샌드박스 생성
• 파일 실행
• 영속 세션
• 이벤트 스트림
• 웹훅
• 트레이스와 스팬
• 장기 실행 워커 복구
• 기본 멀티 에이전트 위임
• 제공자가 지원하는 경우 루브릭 실행

로컬 또는 프로젝트 계층:

• AGENTS.md 또는 동등한 프로젝트 정책
• 공개 글쓰기 기준
• 인용과 출처 등급 규칙
• 제품 품질 독트린
• 비공개 운영 메모리
• 사이트별 SEO/AIO 검사
• 출처 인텔리전스 라우팅
• 최종 게시 게이트
• 플러그인과 공유 패키지의 릴리스 경계 정책

분리선은 “매니지드 대 자체 호스팅”이 아닙니다. 분리선은 “상품화된 런타임 대 제품 판단”입니다.

매니지드 에이전트는 여전히 어디서 주의가 필요한가요?

매니지드 에이전트 플랫폼은 어려운 부분을 없애지 않습니다. 그저 옮길 뿐입니다.

도구, 파일, 네트워크 접근, 자격 증명을 위한 보안 모델은 여전히 필요합니다. Anthropic의 아키텍처는 자격 증명을 생성된 코드가 실행되는 샌드박스로부터 명시적으로 분리하는데, 이는 올바른 방향입니다. 그러나 팀은 여전히 리소스, 볼트, 접근 경계를 정확히 구성해야 합니다.³

관측 가능성도 여전히 필요합니다. 트레이스는 호출 그래프를 보여 줄 수 있지만, 그 작업이 출시될 자격이 있는지는 알려 줄 수 없습니다. 채점기는 루브릭을 평가할 수 있지만, 그 루브릭이 올바른 취향을 표현하는지는 알 수 없습니다.

콘텐츠 경계도 여전히 필요합니다. 공개 이전 글은 패턴을 설명할 수 있지만, 비공개 프롬프트, 정확한 훅 내부, 비공개 파일 경로, 출처 목록, 계정 정보, 자체 편집 점수 산정을 노출해서는 안 됩니다.

스테이징도 여전히 필요합니다. Anthropic는 Managed Agents가 베타 상태이며, 모든 엔드포인트가 managed-agents-2026-04-01 베타 헤더를 요구하고 일부 기능은 프리뷰 액세스가 필요하다고 명시합니다.¹ 베타 런타임은 모든 워크플로의 기본 경로가 되지 않고도 유용할 수 있습니다.

팀은 무엇을 가져가야 하나요?

엔지니어링 리더에게:

• 플랫폼이 보안 기준을 충족할 때 런타임 작업을 매니지드 세션, 샌드박스, 이벤트, 트레이스로 옮기세요.
• 증거, 출처 품질, 제품 취향, 릴리스 경계에 관한 로컬 기준은 유지하세요.
• 매니지드 루브릭을 자기 기준의 대체물이 아니라 그 기준을 위한 실행 슬롯으로 다루세요.

에이전트 빌더에게:

• 명령을 1대1로 포팅하지 마세요. 해야 할 작업(jobs-to-be-done)을 포팅하세요.
• 명시적 호출 전용으로 시작한 다음, 실제 작업이 가치를 입증한 뒤에 승격하세요.
• 비공개 프롬프트 고고학보다 트레이스, 세션 로그, 공개 아티팩트를 선호하세요.

공개 작가에게:

• 비공개 절차를 공개 수용 기준으로 바꾸세요.
• 현재 동작에 대해서는 공식 제품 문서를 인용하세요.
• 더 좋은 글이 의사 결정 프레임워크인 경우, 요약 정리는 거부하세요.

빠른 요약은 무엇인가요?

매니지드 에이전트 플랫폼은 로컬 하네스를 작아지게 만들 뿐, 무의미하게 만들지는 않습니다. 플랫폼이 그 신뢰를 얻는다면 런타임 작업을 매니지드 세션, 샌드박스, 트레이스, 이벤트, 오케스트레이션으로 옮기세요. 품질, 증거, 프라이버시, 공개 글쓰기의 무결성, 그리고 어떤 작업이 출시될 자격이 있는지를 정의하는 로컬 기준은 유지하세요.

FAQ: 매니지드 에이전트와 로컬 하네스

Managed Agents가 로컬 AI 에이전트 하네스를 대체하나요?

아닙니다. 매니지드 플랫폼은 런타임 계층의 더 많은 부분을 대체합니다. 세션, 샌드박스, 이벤트 스트림, 트레이싱, 도구 실행이 그것입니다. 로컬 하네스는 제품 기준, 증거 게이트, 공개 글쓰기 규칙, 프라이버시 경계, 출처 인텔리전스, 프로젝트별 메모리를 인코딩할 때 여전히 중요합니다.

AGENTS.md 또는 CLAUDE.md에 무엇을 남겨야 하나요?

지속적인 프로젝트 규칙을 남기세요. 제품이 무엇을 가치 있게 여기는지, 완료가 어떻게 검증되는지, 어떤 비공개 세부사항이 게시될 수 없는지, 공개 글쓰기가 어떻게 점검되는지, 작업이 완료로 간주되기 전에 어떤 사용자 가시 경로가 작동해야 하는지가 그것입니다. 일시적인 도구 출력이나 비공개 프롬프트 본문을 영구적인 지시 파일에 채워 넣지 마세요.

팀은 언제 매니지드 에이전트 플랫폼을 사용해야 하나요?

작업이 장기 실행, 안전한 컨테이너, 내구성 있는 세션, 이벤트 스트림, 비동기 완료, 트레이싱, 매니지드 멀티 에이전트 오케스트레이션을 필요로 하고, 제공자의 보안, 비용, 데이터 통제가 사용 사례에 맞을 때 매니지드 인프라를 사용하세요.¹²

공개 하네스 패키지로 옮겨서는 안 되는 것은 무엇인가요?

비공개 프롬프트, 정확한 훅 본문, 민감한 파일 경로, 계정 식별자, 토큰 처리, 비공개 출처 목록, 자체 점수 산정 규칙, 또는 외부인이 당신의 내부 운영 시스템을 재구성할 수 있게 하는 어떤 것도 게시하지 마세요. 패턴과 수용 기준을 게시하세요.

참고 문헌