Visual Studio Code에서 에이전트 사용

에이전트는 AI 기반 자율 코딩을 가능하게 하는 요소이며, 단순한 코드 제안 및 채팅 상호 작용을 넘어선 다단계 작업을 지원합니다. Visual Studio Code를 사용하면 로컬 또는 클라우드에서 대화형 또는 백그라운드 방식으로 에이전트 세션을 만들 수 있습니다. 언제든지 각기 다른 에이전트 유형 간에 작업을 넘겨주어 고유한 강점을 활용할 수 있습니다. VS Code의 통합된 채팅 보기를 통해 에이전트 세션이 어디에서 실행되든 모든 에이전트 세션을 중앙에서 관리하고 모니터링할 수 있습니다.

이 문서는 다양한 에이전트 유형, 에이전트 세션 생성 및 관리 방법, 에이전트 간 작업 위임, 진행 상황 추적에 대한 개요를 제공합니다.

에이전트란 무엇인가요?

에이전트는 엔드투엔드 전체 코딩 작업을 처리하며, 코드 제안이나 질문 답변 이상의 작업을 수행하여 시간을 절약해 줍니다. 에이전트는 프로젝트를 이해하고, 여러 파일에 걸쳐 변경을 수행하며, 명령을 실행하고, 얻은 결과를 바탕으로 적응합니다.

예를 들어, 실패하는 테스트가 있다고 상상해 보세요. 에이전트는 단순히 수정을 제안하는 대신 오류 메시지를 읽고, 여러 파일에 걸쳐 근본 원인을 파악하고, 관련 코드를 업데이트하고, 수정을 확인하기 위해 다시 테스트를 실행하고, 심지어 변경 사항을 커밋할 수도 있습니다.

에이전트에게 높은 수준의 작업을 주면, 에이전트는 작업을 단계별로 분해하고, 다양한 도구를 사용하여 해당 단계를 실행하며, 오류나 실패한 테스트에 직면했을 때 스스로 수정합니다.

VS Code에서 에이전트는 작업 흐름에 맞게 다양한 환경에서 실행될 수 있습니다. 로컬 VS Code에서는 대화형 작업을 위해, 로컬 컴퓨터에서는 백그라운드에서 자율 작업을 위해, 또는 클라우드에서는 팀 협업을 위해 원격으로 실행됩니다. 에이전트는 코딩 작업을 수행하고, 터미널 명령을 실행하며, 목표를 달성하기 위해 도구를 함께 사용합니다. 일부 에이전트는 실시간으로 프롬프트에 응답하여 기능 계획 또는 대상 편집을 지원하는 반면, 다른 에이전트는 독립적으로 다단계 변경을 구현합니다.

에이전트 유형

VS Code는 다양한 사용 사례와 상호 작용 수준에 맞춰 설계된 네 가지 주요 에이전트 범주를 지원합니다.

로컬 에이전트

로컬 에이전트는 컴퓨터에서 VS Code 내에서 직접 실행됩니다. 로컬 에이전트와 채팅을 통해 대화형으로 상호 작용하여 프롬프트에 대한 즉각적인 결과를 얻을 수 있습니다. 로컬 에이전트는 작업 공간에서 작동하며 VS Code에서 사용 가능한 모든 도구와 모델에 액세스할 수 있습니다. 사용자 지정 에이전트 만들기를 통해 코드 검토자, 테스터, 문서 작성자와 같은 작업에 대해 에이전트가 특정 역할이나 페르소나를 가정하도록 할 수 있습니다.

로컬 에이전트는 VS Code의 채팅 인터페이스에서 작동합니다. 채팅 세션을 닫으면 로컬 에이전트는 계속 활성 상태이며 세션 보기에서 추적할 수 있습니다.

적합한 용도:

• 브레인스토밍, 계획 또는 아직 완전히 정의되지 않은 작업과 같이 즉각적인 피드백이 필요한 대화형 대화
• 다른 팀원의 협업이 필요하지 않은 작업
• 린트 오류, 스택 추적, 단위 테스트 결과와 같이 개발 환경의 컨텍스트가 필요한 작업
• VS Code 확장 프로그램 또는 MCP 서버의 특정 도구에 액세스해야 하거나 BYOK 모델과 같은 특정 모델을 사용해야 하는 작업

주요 특징:

• 로컬 컴퓨터의 VS Code 내에서 실행되며 현재 작업 공간에서 작동합니다.
• 실시간 피드백 및 반복을 위한 대화형 채팅 기반 인터페이스
• 작업 공간, 파일 및 컨텍스트에 대한 전체 액세스 권한
• VS Code에 구성된 모든 에이전트 도구(예: 내장 도구, MCP 도구, 확장 프로그램 제공 도구)에 액세스할 수 있습니다.
• BYOK 모델 및 기타 공급업체의 모델을 포함하여 VS Code에서 사용할 수 있는 모든 모델을 사용할 수 있습니다.

VS Code에서 채팅 사용에 대해 자세히 알아보세요.

백그라운드 에이전트

Copilot CLI와 같은 백그라운드 에이전트는 로컬 컴퓨터에서 백그라운드에서 비대화형으로 실행되는 CLI 기반 에이전트입니다. 백그라운드 에이전트는 Git 작업 트리(worktree)를 사용하여 코드 변경 사항이 현재 작업 공간에 영향을 미치지 않도록 격리 모드에서 작동할 수 있습니다. 백그라운드 에이전트를 현재 작업 공간에서 실행하도록 선택할 수 있지만, 동일한 파일에서 활발하게 작업 중인 경우 충돌이 발생할 수 있습니다. 백그라운드 에이전트는 MCP 또는 확장 프로그램 제공 도구를 사용할 수 없으며 CLI에서 제공하는 모델로 제한됩니다. 백그라운드 에이전트의 동작을 사용자 지정하려면 작업 공간 사용자 지정 에이전트를 재사용하여 특정 역할이나 페르소나를 가정하도록 할 수 있습니다.

적합한 용도:

• 모든 필수 컨텍스트가 포함된 잘 정의된 범위의 비대화형 작업(예: 계획 구현)
• 다른 팀원과의 협업이 필요하지 않은 작업
• VS Code 내장 도구, MCP 도구 또는 런타임 컨텍스트(예: 실패한 테스트 또는 텍스트 선택)에 액세스할 필요가 없는 작업

주요 특징:

• 로컬 컴퓨터에서 백그라운드에서 비대화형으로 자율적으로 실행
• Git 작업 트리(worktree)를 사용하여 주요 작업 공간과 격리된 상태로 작업할 수 있습니다.
• 명시적으로 추가하지 않는 한 VS Code 내장 도구 및 런타임 컨텍스트에 직접 액세스할 수 없습니다.
• MCP 서버에 액세스할 수 없습니다.
• CLI 도구를 통해 사용 가능한 모델로 제한됩니다.

VS Code에서 백그라운드 에이전트 사용에 대해 자세히 알아보세요.

클라우드 에이전트

클라우드 에이전트는 원격 인프라에서 AI 기반 코딩 작업을 수행합니다. Copilot 코딩 에이전트와 같은 클라우드 에이전트는 GitHub 리포지토리 및 풀 리퀘스트와 통합되어 팀 협업 및 코드 검토를 가능하게 합니다. 클라우드 에이전트는 간섭을 방지하기 위해 브랜치 및 풀 리퀘스트를 통해 로컬 작업 공간과 격리된 상태로 작동합니다. 클라우드 에이전트는 VS Code 내장 도구 및 런타임 컨텍스트에 액세스할 수 없지만, 원격 환경에 구성된 MCP 서버에 액세스할 수 있습니다. 작업 공간 사용자 지정 에이전트를 재사용하여 클라우드 에이전트가 작업에 대해 특정 역할이나 페르소나를 가정하도록 할 수 있습니다.

적합한 용도:

• 모든 필수 컨텍스트가 포함된 잘 정의된 범위의 비대화형 작업(예: 계획 구현)
• 다른 팀원과의 협업이 필요한 작업
• VS Code 내장 도구, MCP 도구 또는 런타임 컨텍스트(예: 실패한 테스트 또는 텍스트 선택)에 액세스할 필요가 없는 작업

주요 특징:

• 원격 인프라에서 비대화형으로 실행
• 브랜치 및 풀 리퀘스트를 통해 주요 작업 공간과 격리된 상태로 작업
• 풀 리퀘스트를 통한 팀 협업을 지원할 수 있습니다.
• VS Code 내장 도구 및 런타임 컨텍스트에 액세스할 수 없습니다.
• 원격 환경에 구성된 MCP 서버에 액세스할 수 있습니다.
• 클라우드 에이전트 서비스에서 사용 가능한 모델로 제한됩니다.

VS Code에서 클라우드 에이전트 사용에 대해 자세히 알아보세요.

타사 에이전트

타사 에이전트는 OpenAI Codex와 같은 다른 공급업체에서 개발한 백그라운드 에이전트이며 VS Code 에이전트 환경에 통합됩니다. 이러한 공급업체의 에이전트 세션은 로컬, 백그라운드 및 클라우드 에이전트와 동일한 방식으로 관리할 수 있습니다.

적합한 용도: 이미 타사 AI 에이전트를 사용 중이고 VS Code 작업 흐름에 통합하고 싶을 때

에이전트 세션 관리

VS Code의 채팅 보기는 실행 위치에 관계없이 에이전트 세션을 관리할 수 있는 통합 인터페이스를 제공합니다. 모든 에이전트 세션, 상태 및 파일 변경과 같은 주요 세부 정보, 유형(로컬, 백그라운드, 클라우드 또는 Codex)을 볼 수 있습니다. 상태 표시기는 활성, 완료, 실패한 세션 또는 사용자 입력이 필요한 세션을 빠르게 식별하는 데 도움이 됩니다.

세션 목록은 작업 공간에 범위가 지정됩니다. 작업 공간이 열려 있지 않으면 목록에 모든 작업 공간의 모든 세션이 표시됩니다.

채팅 보기는 두 가지 모드로 작동합니다.

• 컴팩트:

  컴팩트 보기에서 새 채팅 세션을 열면 최근 세션 3개가 컴팩트 목록으로 표시됩니다. **모든 세션 표시**를 선택하여 에이전트 세션의 전체 기록을 열 수 있습니다. 모든 세션을 볼 때는 검색 및 필터 옵션을 사용하여 특정 세션을 찾으세요.

  

  목록에서 세션을 선택하면 채팅 보기가 해당 세션으로 전환됩니다. 이전 보기로 돌아갈 수 있는 링크가 있습니다.

• 나란히 보기

  나란히 보기에서 채팅 보기는 채팅 보기 바로 옆에 에이전트 세션의 전체 목록을 표시합니다. 검색 및 필터 옵션을 사용하여 특정 세션을 찾으세요. 컴팩트 모드와 나란히 보기 모드 간에 전환하려면 채팅 보기의 오른쪽 상단에 있는 토글 컨트롤을 사용하세요.

  

  목록에서 세션을 선택하면 채팅 보기가 해당 세션의 세부 정보를 표시하고 세션 목록은 계속 표시됩니다.

  팁

  채팅 보기를 더 넓게 만들어 나란히 보기 모드로 자동 전환하세요. 세션 목록을 마우스 오른쪽 버튼으로 클릭하고 **세션 방향**을 선택하여 기본 동작을 변경합니다(chat.viewSessions.orientation).

목록의 세션을 마우스 오른쪽 버튼으로 클릭하면 세션 세부 정보 열기, 세션 보관, 풀 리퀘스트 확인(클라우드 에이전트 세션의 경우)과 같은 에이전트 유형별 작업 등 추가 작업을 볼 수 있습니다.

채팅 보기에서 세션 목록을 숨기려면 빈 채팅을 마우스 오른쪽 버튼으로 클릭하고 **세션 표시**를 선택 해제합니다.

전용 에이전트 보기(미리 보기)를 선호하는 경우 chat.agentSessionsViewLocation 설정을 view 또는 single-view로 설정합니다.

에이전트 세션 필터링

모든 세션이 세션 목록에 표시되면 검색 및 필터링을 사용하여 특정 에이전트 세션을 찾을 수 있습니다. 기본적으로 보관된 세션을 제외한 모든 세션이 표시됩니다. 에이전트 유형, 상태, 읽음 상태 및 보관 상태별로 세션을 필터링합니다.

재설정을 선택하여 필터를 기본값으로 재설정합니다.

에이전트 세션 보관

세션 목록을 정리하려면 완료되었거나 비활성인 세션을 보관할 수 있습니다. 보관된 세션은 기본적으로 숨겨지지만 **보관됨** 필터를 적용하여 액세스할 수 있습니다.

세션을 보관하려면 세션 목록에서 해당 세션에 마우스를 올리고 **보관**을 선택합니다. 세션을 보관한 후 목록에서 사라집니다. 반대로 동일한 방식으로 세션을 보관 해제할 수도 있습니다.

에이전트 세션 만들기

VS Code에서 새 에이전트 세션을 만드는 데는 여러 가지 방법이 있습니다.

• 특정 유형의 새 빈 에이전트 세션 만들기

• 기존 세션을 위임을 통해 다른 에이전트 유형으로 넘기기

• TODO 주석 또는 GitHub 이슈와 같이 작업을 직접 에이전트에 할당하기

새 에이전트 세션 만들기

채팅 보기를 통해 또는 명령 팔레트에서 해당 명령을 사용하여 새 에이전트 세션을 만들 수 있습니다.

1. 채팅 보기 열기

2. 새 세션 드롭다운을 선택한 다음 만들 에이전트 세션 유형을 선택합니다.

   

   • 새 채팅: 채팅 보기에서 새 로컬 에이전트 세션 시작
   • 새 채팅 편집기: 편집기 탭으로 새 로컬 에이전트 세션 시작
   • 새 채팅 창: 별도의 VS Code 창에서 새 로컬 에이전트 세션 시작
   • 새 백그라운드/클라우드/Codex 에이전트: 채팅 보기에서 새 백그라운드, 클라우드 또는 Codex 에이전트 세션 시작

언제든지 채팅 보기의 에이전트 세션을 오버플로 메뉴(...)의 작업을 통해 채팅 편집기 또는 새 창으로 이동할 수 있습니다.

또는 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 다음 명령을 사용하십시오.

• 채팅: 새 채팅 편집기/창: 채팅 편집기에서 새 로컬 에이전트 세션 시작
• 채팅: 새 백그라운드 에이전트: 채팅 편집기에서 Copilot CLI를 사용한 새 백그라운드 에이전트 세션 시작
• 채팅: 새 클라우드 에이전트: 채팅 편집기에서 Copilot 코딩 에이전트 세션 시작
• Codex: 새 Codex 에이전트: 채팅 편집기에서 OpenAI Codex 에이전트 세션 시작

세션을 다른 에이전트로 넘기기

각 에이전트 유형은 고유한 강점과 기능을 가지고 있습니다. 로컬 에이전트를 사용하면 AI와 실시간으로 상호 작용할 수 있는 반면, 백그라운드 에이전트는 잘 정의된 작업을 자율적으로 처리하는 데 좋고, 클라우드 에이전트는 풀 리퀘스트를 통한 팀 협업에 좋습니다.

VS Code를 사용하면 현재 작업의 특정 요구 사항에 따라 한 에이전트에서 다른 에이전트로 기존 작업을 넘겨(또는 위임)줄 수 있습니다. 예를 들어, 로컬 에이전트로 계획을 만드는 것부터 시작하여, 여러 가지 개념 증명(proof of concept)을 만들기 위해 백그라운드 에이전트로 넘긴 다음, 마지막으로 클라우드 에이전트와 함께 최종 버전을 풀 리퀘스트에 구현하여 팀 검토를 받습니다.

세션을 위임하면 VS Code는 전체 대화 기록과 컨텍스트를 전달하여 선택한 유형의 새 에이전트 세션을 만듭니다. 그런 다음 새 에이전트와 계속 상호 작용하여 작업을 완료할 수 있습니다. 원래 세션은 핸드오프 후 보관됩니다.

VS Code에서 채팅 중인 로컬 에이전트 세션은 **계속 사용** 컨트롤을 사용하거나, 프롬프트에 @cli, @cloud 또는 @codex를 입력하여 다른 에이전트 유형으로 작업을 전달하여 넘겨줄 수 있습니다.

백그라운드 에이전트 세션에서는 채팅 입력란에 /delegate 명령을 입력하여 클라우드 에이전트로 위임할 수 있습니다. 선택적으로 /delegate 명령 뒤에 클라우드 에이전트에 대한 추가 지침을 제공할 수 있습니다.

코딩 작업을 에이전트에 할당하기

GitHub Pull Requests 확장 프로그램을 설치한 경우, 에이전트에 TODO 주석을 구현하도록 할당할 수 있습니다.

GitHub.com에서 또는 GitHub Pull Requests 확장 프로그램을 사용하여 GitHub 이슈를 Copilot 코딩 에이전트에 할당하거나(이슈를 copilot에 할당), 이슈 댓글이나 풀 리퀘스트에서 언급하여 코드 검토를 요청할 수 있습니다.

파일 변경 검토 및 적용

에이전트 세션이 완료되고 프로젝트에 코드 변경 사항이 발생하면 세션 목록에 해당 세션의 파일 변경 통계가 표시됩니다. 에이전트가 만든 변경 사항을 검토하려면 목록에서 해당 세션을 선택하여 세션 세부 정보를 엽니다.

세션 세부 정보 보기에는 세션 중에 발생한 파일 변경 사항과 함께 에이전트와의 전체 대화 기록이 표시됩니다. 변경된 파일을 마우스 오른쪽 버튼으로 클릭하면 해당 파일의 diff 편집기가 표시되고, **모든 변경 사항 보기** 작업을 선택하면 세션 중에 발생한 모든 변경 사항을 포함하는 다중 파일 diff 편집기가 표시됩니다.

에이전트 유형에 따라 에이전트가 만든 변경 사항을 로컬 작업 공간에 적용하거나 에이전트 세션에서 브랜치를 체크아웃하는(클라우드 에이전트의 경우) 추가 옵션이 있습니다.

관련 리소스

• 로컬 에이전트: 로컬 에이전트 세션 및 채팅 기능 마스터하기
• 백그라운드 에이전트: CLI 기반 에이전트 및 자율 워크플로 탐색
• 클라우드 에이전트: GitHub Copilot 코딩 에이전트 및 원격 실행 알아보기
• 사용자 지정 에이전트: 자신만의 AI 에이전트 및 확장 프로그램 만들기