VS Code Agent Host란? 세션 지속·멀티윈도우 구조 정리
VS Code Agent Host 구조를 표현한 GPT Image 생성 대표 이미지
VS Code Agent Host는 AI 코딩 에이전트의 세션 상태와 실행 수명을 특정 편집기 창에서 분리해 전용 프로세스가 소유하도록 만든 구조입니다. 2026년 9월 1일 기준, 폴더나 시작 창을 닫아도 로컬 VS Code가 계속 실행 중이면 같은 세션을 다른 창이나 Agents window에서 이어 볼 수 있으며, 원격 호스트를 쓰면 작업공간 옆에서 명령과 파일 변경이 실행됩니다.
이 글은 GitHub의 2026년 8월 월간 변경점, Microsoft의 8월 26일 아키텍처 설명, 현재 VS Code Agent Host 문서와 Agent Host Protocol 사양을 기준으로 세션 지속·멀티윈도우 동기화·하네스 경계를 구분합니다.
- Agent Host와 agent harness의 역할 구분
- 편집기 창 종속 구조가 바뀐 이유
- AHP의 스냅샷·순서 보장 동기화 방식
- Copilot·Claude·Codex 하네스 선택 기준
- 로컬·원격 운영에서 놓치기 쉬운 경계
Agent Host는 세션을 보관하고 여러 클라이언트를 연결하는 실행 기반입니다. 하네스는 컨텍스트를 모으고 도구를 제공하며 에이전트 루프와 코드 변경을 수행하는 구현체이고, 언어 모델은 그 하네스가 호출하는 추론 엔진입니다.
공식 발표: GitHub Copilot in VS Code, August 2026 releases
1. VS Code Agent Host란 무엇인가
세션을 소유하는 전용 프로세스
현재 공식 문서는 Agent Host를 AI 코딩 에이전트를 실행하는 전용 프로세스로 정의합니다. 채팅을 표시하는 VS Code 창은 세션의 소유자가 아니라 뷰어이자 제어 클라이언트가 되고, 호스트가 대화·터미널·변경 집합을 포함한 세션 상태의 기준점이 됩니다.
하네스와 모델은 별도 층입니다
Agent Host 안에는 각 에이전트 런타임을 공통 세션 모델로 번역하는 어댑터가 놓입니다. Copilot·Claude·Codex처럼 서로 다른 하네스는 고유한 SDK, 도구, 권한 방식을 유지하면서도 VS Code에는 비슷한 세션 관리 경험을 제공할 수 있습니다.
Host는 세션의 집, harness는 일을 수행하는 엔진, model은 판단을 만드는 추론 계층입니다.
2. 기존 편집기 창 종속 방식은 무엇이 문제였나
Extension Host의 수명과 에이전트가 묶였습니다
이전 로컬 방식은 Copilot Chat 같은 확장과 함께 에이전트 로직을 각 창의 Extension Host에서 실행했습니다. 창마다 에이전트 인프라가 따로 올라가고, 시작한 창을 닫으면 해당 런타임도 끝나는 경계였습니다.
장시간 작업과 멀티윈도우에 맞지 않았습니다
에이전트가 오래 실행될수록 사용자는 다른 파일·저장소·창을 오가게 됩니다. 세션 상태와 기본 작업공간 기능을 별도 프로세스로 옮기면 여러 창이 하나의 런타임에 연결되고, 바쁜 확장이 에이전트의 기본 실행 경로를 막는 문제도 줄일 수 있습니다.
| 비교 항목 | 기존 창 중심 실행 | Agent Host |
|---|---|---|
| 세션 소유 | 각 편집기 창 | 전용 호스트 |
| 다른 창 연결 | 별도 세션이 되기 쉬움 | 같은 라이브 세션 공유 |
| 폴더 닫기 | 런타임 중단 | VS Code가 실행 중이면 계속 |
| 원격 실행 | 창 환경에 종속 | 작업공간 옆 호스트에 배치 |
3. Agent Host는 클라이언트와 하네스를 어떻게 연결하나
Microsoft VS Code Blog 공식 Agent Host 프로세스 구조도 · © Microsoft
출처: https://code.visualstudio.com/assets/blogs/2026/08/26/agent-host-arch.svg · 라이선스: © Microsoft, official VS Code documentation asset; source-linked explanatory quotation
클라이언트·호스트·하네스의 세 층
Microsoft의 공식 다이어그램에서 VS Code Editor Window와 Agents Window는 AHP를 통해 Agent Host process에 연결됩니다. 호스트 안의 SDK·어댑터가 오른쪽의 하네스 런타임과 통신하므로, 표시 창이 바뀌어도 세션의 중심은 호스트에 남습니다.
로컬과 원격의 실행 위치
로컬에서는 VS Code가 Agent Host를 유틸리티 프로세스로 관리합니다. 원격에서는 호스트가 작업공간 옆의 독립 서버로 실행되며, 파일 편집과 명령 실행도 그 원격 머신에서 일어납니다.
VS Code client → AHP → Agent Host → adapter → agent harness
VS Code client ← snapshot + ordered actions ← Agent HostAgent Host 아키텍처 공식 설명은 폴더를 닫은 뒤 다시 열어 같은 세션을 확인하는 흐름과 원격 호스트 연결을 별도로 설명합니다.
4. AHP는 여러 창의 세션을 어떻게 동기화하나
Microsoft VS Code Blog 공식 AHP 메시지 흐름도 · © Microsoft
출처: https://code.visualstudio.com/assets/blogs/2026/08/26/ahp-messages.svg · 라이선스: © Microsoft, official VS Code documentation asset; source-linked explanatory quotation
초기 스냅샷 뒤에 순서 있는 액션을 받습니다
Agent Host Protocol은 호스트를 단일 진실 공급원으로 두는 에이전트 비종속 프로토콜입니다. 클라이언트는 세션·채팅·터미널·변경 집합 같은 URI 채널을 구독하고, 초기 상태 스냅샷 뒤에 순서가 보장된 액션을 받습니다.
연결이 끊겨도 누락분을 맞춥니다
각 변경에는 단조 증가 순서가 붙고 모든 구독 클라이언트에 방송됩니다. 재연결한 클라이언트는 놓친 액션 또는 새 스냅샷을 받아 상태를 맞추며, 자신이 낙관적으로 적용한 변경은 호스트가 돌려준 origin 정보와 대조합니다.
Claude Code CLI 세션을 데스크톱 앱에서 이어가는 방법은 저장된 대화를 다시 여는 제품 기능입니다. AHP는 하나의 라이브 세션 상태를 여러 클라이언트가 동기화해 보는 통신 계층이라는 점에서 범위가 다릅니다.
5. Agent Host에서 어떤 하네스를 선택해야 하나
실행 위치·도구·변경 적용 방식이 기준입니다
현재 VS Code 문서는 Local, GitHub Copilot, Anthropic Claude, OpenAI Codex, Cloud 하네스를 구분합니다. 선택에 따라 실행 위치, 코드 접근 범위, 사용 가능한 모델과 도구, 변경 적용 방식이 달라지므로 이름보다 작업의 실행 경계를 먼저 봐야 합니다.
하네스 변경은 단순 모델 교체가 아닙니다
진행 중 세션에서 하네스를 바꾸면 VS Code는 이를 handoff로 취급해 대화 기록과 컨텍스트를 넘깁니다. 반면 Claude 세션 안에서 Anthropic API와 Copilot 구독 모델을 바꾸는 일은 다음 턴의 모델·청구 경로를 바꾸는 선택입니다.
| 하네스 | 권장 상황 | 주의할 경계 |
|---|---|---|
| Local | VS Code 확장 도구가 필요한 대화형 작업 | 활성 작업공간에 직접 변경 |
| Copilot | Copilot SDK 기반 일반 코딩 작업 | 구독·샌드박스 정책 확인 |
| Claude | Claude 고유 명령·권한 모드 활용 | 모델 공급자별 청구 구분 |
| Codex | Codex의 대화형·백그라운드 작업 | 인증과 격리 방식 확인 |
| Cloud | GitHub 저장소와 PR 중심 위임 | 원격 인프라에서 실행 |
하네스별 확장 패키지는 실행 코드와 권한을 포함할 수 있습니다. 실제 설치 전 점검은 Claude Code 플러그인 설치·마켓플레이스·보안 가이드처럼 소스와 구성 요소를 함께 보는 방식이 안전합니다.
6. 세션 지속이 실패하는 조건과 현재 한계
로컬 호스트는 VS Code 앱 종료를 넘지 못합니다
폴더나 편집기 창을 닫는 것과 VS Code 자체를 종료하는 것은 다릅니다. 공식 체험 절차는 로컬 세션의 경우 VS Code가 로컬 Agent Host를 관리하므로 앱을 계속 실행해야 한다고 명시합니다.
클라이언트가 제공한 도구는 항상 상주하지 않습니다
호스트는 독립 실행에 필요한 기본 기능을 포함하지만, 확장이 기여한 도구는 기본적으로 해당 확장이 실행되는 편집기 창의 채팅에서만 사용할 수 있습니다. 또 원격 호스트에서는 명령과 파일 변경이 원격 작업공간에서 실행되므로 로컬 경로·환경변수·자격 증명을 그대로 가정하면 안 됩니다.
Agent Host와 AHP는 활발히 개발 중입니다. 8월 월간 요약에는 `/rubber-duck`, 외부 세션 이어가기, portable agent plugins처럼 실험적이거나 점진 배포되는 항목이 섞여 있으므로 실제 설치 버전과 설정 노출 여부를 함께 확인해야 합니다.
7. 팀에 도입하기 전 무엇을 점검해야 하나
세션보다 실행 경계를 먼저 정합니다
작업공간이 로컬인지 원격인지, 변경을 현재 폴더에 적용할지 Git worktree로 격리할지 먼저 정합니다. 그다음 작업에 필요한 하네스와 모델 공급자, 승인 정책, 종료 후 복구 경로를 선택하면 세션 UI와 실제 실행 위치를 혼동할 가능성이 줄어듭니다.
두 창과 재연결을 작은 작업으로 시험합니다
- 작은 테스트 저장소에서 새 세션을 시작합니다.
- Editor Window와 Agents Window에서 같은 상태가 보이는지 확인합니다.
- 폴더를 닫되 VS Code는 종료하지 않고 작업 지속 여부를 봅니다.
- 다시 연결한 뒤 터미널·변경 집합·승인 대기 상태를 대조합니다.
- 원격 호스트라면 명령 실행 위치와 자격 증명 범위를 기록합니다.
여러 에이전트 런타임을 운영 허브에 붙이는 더 넓은 설계는 OpenClaw과 Hermes Agent의 런타임·게이트웨이 차이와 비교하면 Agent Host가 담당하는 범위를 분리해 보기 쉽습니다.
8. VS Code Agent Host Q&A와 정리
Q1. 창을 닫으면 에이전트가 무조건 계속 실행되나요?
폴더나 시작 창을 닫아도 로컬 VS Code가 계속 실행 중이면 Agent Host의 세션이 이어질 수 있습니다. VS Code 앱을 종료한 뒤에도 로컬 호스트가 계속 돈다는 뜻은 아닙니다.
Q2. 여러 창에서 동시에 같은 세션을 조작할 수 있나요?
AHP는 여러 클라이언트가 같은 세션 상태를 구독하고 순서 있는 변경을 받도록 설계됐습니다. 실제 사용에서는 동시 입력보다 한 창을 주 제어면으로 정해 승인과 변경 검토를 집중하는 편이 안전합니다.
Q3. Agent Host를 쓰면 모든 하네스 기능이 같아지나요?
아닙니다. 공통 세션 표면만 공유하며 Claude·Codex·Copilot의 도구, 명령, 모델, 권한 특성은 각 하네스에 남습니다.
Q4. 원격 Agent Host가 로컬 파일을 수정하나요?
공식 문서는 호스트가 작업공간 옆에 있고, 원격 호스트를 쓰면 파일 변경과 명령도 원격 머신에서 실행된다고 설명합니다. 연결 전에 대상 작업공간 URI와 저장소 상태를 확인해야 합니다.
Q5. Agent Host와 AHP는 안정 기능인가요?
VS Code 최신 Stable에서 Agent Host를 사용할 수 있지만 공식 문서는 Agent Host와 AHP가 계속 개발 중이라고 명시합니다. 실험 설정과 점진 배포 기능은 조직 표준에 넣기 전에 버전별 재검증이 필요합니다.
VS Code Agent Host의 핵심은 에이전트를 더 똑똑하게 만드는 데 있지 않고, 세션의 수명과 표시 창의 수명을 분리하는 데 있습니다. 도입할 때는 하네스·모델·클라이언트 도구·실행 위치를 각각 다른 경계로 관리해야 합니다.
9. 참고 자료
공식 발표와 현재 문서
- GitHub: GitHub Copilot in VS Code, August 2026 releases
- Microsoft VS Code Blog: Introducing the Agent Host for persistent, portable agent sessions
- VS Code Docs: Agent Host architecture
프로토콜과 하네스 문서
'AI Agent' 카테고리의 다른 글
| Muse Code SDK란? MSP·권한 제어 구조와 활용 조건 (0) | 2026.09.01 |
|---|---|
| Antigravity /boost란? 멀티에이전트 추론·사용 조건 정리 (0) | 2026.09.01 |
| Omarchy 사용법: 설치부터 AI 개발 환경·실전 사례까지 (0) | 2026.08.31 |
| Grok Bot 템플릿 공유 방법, 스킬·메모리·플러그인은 어디까지? (0) | 2026.08.31 |
| OpenResearch CLI 사용법: 논문 재현·병렬 에이전트 가이드 (0) | 2026.08.30 |
