VS Code Agent Mode 사용 방법 (2026)
Visual Studio Code에 내장된 AI 에이전트 마스터하기
Hypereal로 구축 시작하기
단일 API를 통해 Kling, Flux, Sora, Veo 등에 액세스하세요. 무료 크레딧으로 시작하고 수백만으로 확장하세요.
신용카드 불필요 • 10만 명 이상의 개발자 • 엔터프라이즈 지원
VS Code Agent Mode 사용법 (2026)
VS Code Agent Mode는 GitHub Copilot을 단순한 인라인 자동 완성 도구에서 완전한 자율 코딩 에이전트로 변화시킵니다. 한 번에 한 줄씩 제안하는 대신, Agent Mode는 단일 자연어 프롬프트만으로 다단계 작업 계획, 여러 파일 수정, 터미널 명령 실행, 오류의 반복적 수정, 그리고 MCP를 통한 외부 도구 활용까지 수행할 수 있습니다.
본 가이드에서는 Agent Mode를 활성화하고 설정하며, 실제 개발 작업에서 효과적으로 사용하는 방법을 다룹니다.
VS Code Agent Mode란 무엇인가요?
Agent Mode는 VS Code 내 GitHub Copilot Chat의 기능으로, AI 비서에게 자율적인 능력을 부여합니다. Copilot Chat 패널에서 모드를 "Ask" 또는 "Edit"에서 "Agent"로 전환하면 AI는 다음과 같은 능력을 갖게 됩니다:
- 다단계 코딩 작업 계획 및 실행
- 프로젝트 전반에 걸친 파일 생성, 수정 및 삭제
- 터미널 명령 실행 및 출력 결과에 따른 대응
- 린트(linting) 및 컴파일 오류 자동 수정
- MCP 도구를 사용하여 외부 서비스와 상호작용
- 작업이 완료될 때까지 자체 결과물에 대한 반복 작업(Iteration)
Agent Mode와 다른 Copilot 모드 비교
| 기능 | Ask 모드 | Edit 모드 | Agent 모드 |
|---|---|---|---|
| 질문 답변 | 예 | 아니요 | 예 |
| 단일 파일 수정 | 아니요 | 예 | 예 |
| 다중 파일 수정 | 아니요 | 예 | 예 |
| 터미널 명령 실행 | 아니요 | 아니요 | 예 |
| 오류 자동 수정 | 아니요 | 아니요 | 예 |
| MCP 도구 사용 | 아니요 | 아니요 | 예 |
| 자율적 반복 작업 | 아니요 | 아니요 | 예 |
| 파일 생성/삭제 | 아니요 | 제한적 | 예 |
사전 요구 사항
| 요구 사항 | 상세 내용 |
|---|---|
| VS Code | 버전 1.99 이상 (최신 기능을 위해 Insiders 권장) |
| GitHub Copilot 구독 | Copilot Individual, Business 또는 Enterprise |
| GitHub Copilot 확장 프로그램 | VS Code Marketplace의 최신 버전 |
| GitHub Copilot Chat 확장 프로그램 | 최신 버전 (일반적으로 Copilot과 함께 번들로 제공) |
1단계: Agent Mode 활성화하기
Agent Mode는 VS Code 1.99 버전 이상에서 기본적으로 사용할 수 있습니다. 사용 방법은 다음과 같습니다:
Ctrl+Shift+I(macOS는Cmd+Shift+I)를 누르거나 액티비티 바에서 Copilot 아이콘을 클릭하여 Copilot Chat 패널을 엽니다.- 채팅 패널 상단에서 모드 선택 드롭다운을 확인합니다.
- "Ask" 또는 "Edit"에서 **"Agent"**로 전환합니다.
Agent 옵션이 보이지 않는 경우, VS Code가 최신 버전인지 확인하세요:
# VS Code 버전 확인
code --version
# VS Code 업데이트 (macOS Homebrew 사용 시)
brew update && brew upgrade --cask visual-studio-code
2단계: 모델 선택하기
Agent Mode는 여러 LLM 제공업체를 지원합니다. Copilot Chat 패널의 모델 선택기를 클릭하여 선택하세요:
| 모델 | 용도 | 속도 | 품질 |
|---|---|---|---|
| GPT-4o | 일반적인 코딩 작업 | 빠름 | 높음 |
| Claude Sonnet 4 | 복잡한 추론, 리팩토링 | 빠름 | 매우 높음 |
| Claude Opus 4 | 가장 어려운 문제, 아키텍처 | 느림 | 최고 |
| Gemini 2.5 Pro | 대규모 코드베이스, 긴 컨텍스트 | 빠름 | 높음 |
| o3-mini | 빠른 수정, 간단한 작업 | 가장 빠름 | 좋음 |
작업의 복잡도에 따라 대화 도중에 모델을 변경할 수 있습니다.
3단계: 첫 번째 에이전트 작업 실행
Agent Mode 채팅창에 자연어로 요청을 입력하세요. 실용적인 작업으로 시작해 보겠습니다:
사용자 등록을 위한 REST API 엔드포인트를 생성해줘. 다음 사항을 포함해야 해:
- /api/auth/register로 POST 요청 수락
- 이메일 형식 및 비밀번호 강도 검증
- bcrypt로 비밀번호 해싱
- 사용자를 데이터베이스에 저장
- JWT 토큰 반환
- 입력 검증 미들웨어 포함
- 중복 이메일에 대한 에러 핸들링 추가
Agent Mode는 다음과 같이 작동합니다:
- 기존 프로젝트 구조와 기술 스택을 분석합니다.
- 여러 파일(route, controller, middleware, model)을 생성하거나 수정합니다.
- 터미널 명령을 실행하여 누락된 npm 패키지를 설치합니다.
- TypeScript나 린트 오류를 확인하고 자동으로 수정합니다.
- 검토할 수 있도록 모든 변경 사항을 제시합니다.
각 변경 사항을 개별적으로 수락하거나, 거부하거나, 에이전트에게 수정을 다시 요청할 수 있습니다.
4단계: 참가자(Participants) 및 컨텍스트 활용
Agent Mode는 더욱 정밀한 지원을 위해 @ 참가자와 # 컨텍스트 참조를 지원합니다:
참가자 (Participants)
| 참가자 | 설명 |
|---|---|
@workspace |
전체 프로젝트 컨텍스트에 접근 |
@vscode |
VS Code 설정 및 구성 도움말 |
@terminal |
터미널 출력 및 명령 히스토리 |
컨텍스트 참조 (Context References)
#file:src/lib/database.ts 와 #file:src/types/user.ts 를 참고해서
CRUD 작업을 처리하는 새로운 user service를 만들어줘.
#file:, #selection, #terminalLastCommand 등을 사용하여 에이전트에게 구체적인 컨텍스트를 제공하세요.
5단계: MCP 서버 설정
Agent Mode는 에이전트의 기능을 외부 도구로 확장하는 MCP (Model Context Protocol) 서버를 지원합니다. VS Code 설정이나 .vscode/mcp.json 파일에서 설정할 수 있습니다:
// .vscode/mcp.json
{
"servers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
}
},
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"POSTGRES_CONNECTION_STRING": "postgresql://user:pass@localhost:5432/mydb"
}
}
}
}
MCP 서버가 연결되면 Agent Mode는 다음을 할 수 있습니다:
- GitHub issue 및 pull request 생성
- 데이터베이스 직접 쿼리
- 웹 페이지 브라우징 및 스크린샷 캡처
- 모든 MCP 호환 서비스와 상호작용
6단계: 커스텀 지침(Custom Instructions) 사용
저장소 루트에 .github/copilot-instructions.md 파일을 생성하여 Agent Mode에 지속적인 지침을 제공할 수 있습니다:
# 코딩 표준
- 모든 파일에 TypeScript strict 모드 사용
- hook을 사용하는 함수형 React 컴포넌트 사용
- Tailwind CSS 유틸리티 클래스로 스타일링
- 모든 새로운 함수에 대해 Vitest로 유닛 테스트 작성
- 런타임 타입 검증을 위해 Zod 사용
- src/에 있는 기존 프로젝트 구조 준수
# 명명 규칙
- 컴포넌트: PascalCase (UserProfile.tsx)
- 유틸리티: camelCase (formatDate.ts)
- 상수: UPPER_SNAKE_CASE
- 타입/인터페이스: T 또는 I 접두사를 붙인 PascalCase
# 에러 핸들링
- 비동기 작업에는 항상 try/catch 사용
- API 엔드포인트에서 구조화된 에러 응답 반환
- 프로젝트의 logger 유틸리티로 에러 기록
Agent Mode는 이 파일을 자동으로 읽고 모든 작업에 지침을 적용합니다.
실무 워크플로우
버그 수정 워크플로우
다음 TypeScript 에러가 발생하고 있어:
Type 'string | undefined' is not assignable to type 'string'.
src/components/UserCard.tsx의 42번 줄에서 발생해.
에러를 수정하고 컴포넌트 전체에 적절한 null 핸들링을 추가해줘.
에이전트는 파일을 읽고, 문제를 식별하고, 수정을 적용하며, 동일한 파일 내의 유사한 문제를 확인하고 수정 사항이 컴파일되는지 검증합니다.
테스트 생성
src/lib/validators.ts에 대한 포괄적인 유닛 테스트를 생성해줘.
다음과 같은 모든 엣지 케이스를 포함해야 해:
- 빈 입력값
- 잘못된 형식
- 경계값
- 특수 문자
- 유니코드 문자열
리팩토링
인증 모듈을 리팩토링해줘:
1. src/pages/api/auth/의 모든 인증 로직을 src/services/auth/의 서비스 레이어로 이동
2. 인증 서비스를 위한 깔끔한 인터페이스 생성
3. 프로젝트 전반의 모든 import 업데이트
4. 기존의 모든 테스트가 여전히 통과하는지 확인
에이전트는 언급하지 않은 파일의 import 업데이트를 포함하여 전체 리팩토링을 처리합니다.
문서화
src/lib/에 있는 모든 export된 함수에 JSDoc 주석을 추가해줘.
@param, @returns, @example 태그를 포함해야 해.
최상의 결과를 얻기 위한 팁
- 구체적으로 요청하세요. "코드를 더 좋게 만들어줘" 대신 "UserService 클래스가 의존성 주입을 사용하도록 리팩토링하고 모든 데이터베이스 호출에 에러 핸들링을 추가해줘"라고 말하세요.
- 명시적으로 파일을 참조하세요.
#file:path/to/file을 사용하여 에이전트에게 관련 코드를 알려주세요. - 에이전트가 반복하도록 두세요. Agent Mode는 스스로의 실수를 수정할 수 있습니다. 첫 번째 시도에 오류가 있으면 이를 감지하고 자동으로 다시 시도합니다.
- 체크포인트를 사용하세요. 일련의 변경 사항이 적용된 후에는 코드를 커밋하세요. 나중에 에이전트가 원치 않는 변경을 하면 쉽게 되돌릴 수 있습니다.
- 작업에 따라 모델을 교체하세요. 간단한 수정에는 GPT-4o나 o3-mini 같은 빠른 모델을, 복잡한 아키텍처 작업에는 Claude Opus를 사용하세요.
Agent Mode와 다른 AI 코딩 도구 비교
| 기능 | VS Code Agent Mode | Cursor Composer | Cline | Claude Code |
|---|---|---|---|---|
| 다중 파일 수정 | 예 | 예 | 예 | 예 |
| 터미널 명령 | 예 | 예 | 예 | 예 |
| MCP 지원 | 예 | 예 | 예 | 예 |
| 에디터 내장 | 예 | 예 (자체 에디터) | 확장 프로그램 | CLI |
| 모델 선택 | 다중 선택 | 다중 선택 | 다중 선택 | Claude 전용 |
| 무료 티어 | 제한적 (Copilot Free) | 아니요 | 예 (자체 키) | 아니요 |
| 자동 에러 수정 | 예 | 예 | 아니요 | 예 |
문제 해결
Agent Mode 옵션이 보이지 않음: VS Code를 1.99 버전 이상으로 업데이트하세요. 또한 GitHub Copilot 및 Copilot Chat 확장을 최신 버전으로 업데이트하세요.
에이전트가 느리거나 응답하지 않음: 간단한 작업의 경우 GPT-4o나 o3-mini와 같은 더 빠른 모델로 전환하세요. Claude Opus는 강력하지만 느립니다.
에이전트가 잘못된 수정을 수행함:
특정 파일을 참조하여 더 많은 컨텍스트를 제공하세요. 코딩 표준이 담긴 .github/copilot-instructions.md 파일을 추가하세요.
터미널 명령 실패: 에이전트가 실행하려는 명령이 PATH에 있는지 확인하세요. 실행 전 명령을 주의 깊게 검토하고 승인하세요.
MCP 서버가 표시되지 않음:
.vscode/mcp.json 구문을 확인하세요. 새 MCP 서버를 추가한 후 VS Code를 재시작하세요. Output 패널에서 MCP 관련 오류를 확인하세요.
마무리하며
VS Code Agent Mode는 Copilot 경험의 가장 중요한 업그레이드 중 하나입니다. 이는 코드 완성 도구를 코드베이스 전체에서 복잡하고 다단계인 작업을 처리할 수 있는 자율적인 개발 파트너로 변화시킵니다. MCP 지원 및 커스텀 지침과 결합하여 어떤 프로젝트와 워크플로우에도 적응할 수 있습니다.
이미지, 비디오, 오디오 또는 말하는 아바타와 같이 AI가 생성한 미디어가 필요한 애플리케이션을 구축하고 있다면, 종량제 요금제와 빠른 생성 속도를 제공하는 통합 API인 Hypereal AI를 확인해 보세요.
Hypereal AI 무료 체험하기 -- 35 크레딧 제공, 신용카드 불필요.
