GitHub Copilot in VS Code: Setup, Plan Mode, and Agent Workflow (2026)

GitHub Copilot in VS Code: How to Set It Up and Use It in 2026

GitHub Copilot을 VS Code에서 시작할 때 가장 헷갈리는 건 설치보다 어떤 작업에 어떤 모드를 써야 하는지입니다. 한 줄 설명이나 코드 질문에는 채팅이 충분하고, 여러 파일을 바꾸는 일은 먼저 계획을 검토한 뒤 Agent에 맡기는 편이 안전합니다. 이 글은 최신 VS Code 안내에 따라 가입·설정·작업 흐름을 정리하고, AI가 개발 시간을 항상 줄여 주지는 않는다는 연구 결과도 함께 살펴봅니다.

VS Code에서 Copilot으로 코드를 살펴보는 화면

시작 전에 필요한 것

  • 최신 안정 버전의 Visual Studio Code
  • 로그인할 GitHub 계정
  • 해당 계정에서 사용할 수 있는 Copilot 요금제 또는 제공 권한

VS Code에서 Copilot을 설정하고 GitHub 계정으로 로그인한 뒤, Chat 보기에서 사용 가능한 기능을 확인합니다. 조직 계정은 관리자가 Copilot 이용을 허용해야 할 수 있습니다. 메뉴나 기능이 보이지 않으면 먼저 계정·조직 권한과 VS Code 업데이트 여부를 확인하세요. 확장 프로그램 설치 여부는 현재 VS Code의 설정 안내를 따릅니다.

질문·계획·실행 모드는 이렇게 나누세요

필요한 일 권장 모드 예시와 확인 방법
개념 질문, 열린 코드 설명, 작은 수정 Chat 또는 편집기 안 채팅 “이 함수가 입력을 어떻게 처리하는지 설명해 줘.” 답변을 실제 코드와 대조
요구사항이 모호하거나 여러 파일·구조가 걸린 변경 Plan 완료 조건·제약·검증 방법을 함께 주고, 계획과 위험을 읽은 뒤 수정 여부 결정
검토가 끝난 계획을 코드에 반영 Agent 변경 범위와 테스트를 지정하고, 도구 실행과 수정 내역을 검토

Copilot의 Plan 모드는 코드를 바로 바꾸기보다 저장소를 살펴보고 실행 계획을 만드는 데 쓰입니다. VS Code의 Local 세션에서 제공되는 별도 Plan 기능과 Copilot 세션의 Plan 모드는 동작과 제어 방식이 같지 않을 수 있으니, 화면의 세션 대상과 모드를 먼저 확인하세요. 작은 수정까지 매번 계획을 만들면 오히려 시간이 늘 수 있습니다.

Agent에게 일을 맡길 때 요청을 구체화하세요

“로그인을 고쳐 줘”처럼 넓게 요청하기보다 결과와 검증 방법을 함께 적으세요. 예를 들면 “로그인 실패 시 오류 원인을 사용자에게 표시하되 토큰은 로그에 남기지 말고, 기존 로그인 성공 흐름을 유지해. 관련 테스트를 추가하고 실행 결과를 알려 줘”라고 요청할 수 있습니다.

  1. 바꿀 결과, 건드리면 안 되는 동작, 제약을 씁니다.
  2. 여러 파일이나 설계 변경이면 Plan으로 조사 결과와 변경 순서를 먼저 봅니다.
  3. Agent로 전환할 때는 바꿀 파일 범위와 통과해야 할 테스트를 다시 확인합니다.
  4. 파일 수정·터미널·외부 도구 권한은 필요한 범위만 허용합니다. 권한 설정은 도구를 사용할 수 있게 하는 것과 실행을 승인하는 것이 별개입니다.
  5. 변경 사항을 직접 검토하고 관련 테스트, 빌드, 보안 점검을 실행합니다.

Agent가 실행한 명령과 바꾼 파일을 살펴볼 수 있습니다. 도구를 켰다고 해서 승인 확인이 사라지는 것은 아닙니다. 자동 실행 권한은 편리하지만 잘못된 명령이나 과도한 수정도 빠르게 실행될 수 있으므로, 처음에는 수동 승인 방식으로 시작하는 것이 좋습니다.

프로젝트 규칙을 반복해서 알려주지 않으려면

저장소의 구조, 코딩 규칙, 테스트 방법처럼 여러 작업에서 공통으로 필요한 정보는 프로젝트 지침으로 관리할 수 있습니다. 역할을 나눠 재사용하려면 VS Code가 지원하는 사용자 지정 Agent 파일을 둘 수 있습니다. 현재 문서의 형식은 `.agent.md`이며, 프로젝트 공유용 파일은 보통 `.github/agents` 아래에 둡니다. 예를 들어 계획만 만드는 역할, 코드 검토 역할을 별도 파일로 두면 매번 긴 지시를 반복하지 않아도 됩니다.

지침 파일에 비밀번호, API 키, 사내 비밀값을 넣지 마세요. 팀 저장소에 추가할 때는 모든 구성원이 그 지침을 받게 된다는 점도 확인하세요. 사용자 지정 도구를 추가했다면 그 도구가 읽거나 바꿀 수 있는 자료의 범위를 점검합니다.

요금과 사용량은 현재 계정 화면에서 확인하세요

Copilot의 요금제와 사용량 기준은 바뀔 수 있습니다. GitHub 문서에 따르면 개인 요금제에는 요금제별 월간 AI 크레딧이 포함되며, 모델과 입력·출력 토큰 사용에 따라 소비량이 달라집니다. 구형 ‘요청 수’ 안내나 과거 요금표를 현재 기준처럼 적용하지 말고, GitHub 계정의 플랜·사용량 화면과 최신 청구 문서를 확인하세요. 추가 사용을 켜 두었다면 포함량을 넘었을 때 비용이 발생할 수 있는지도 살펴보세요.

Copilot이 항상 개발을 빠르게 해 주는 것은 아닙니다

연구 결과는 과제와 개발자 경험에 따라 다릅니다. 2023년 Copilot 통제 실험에서는 참가자들이 정해진 JavaScript HTTP 서버 구현 과제를 평균 55.8% 더 빨리 마쳤습니다. 하지만 이는 범위가 제한된 실험 과제의 결과여서 모든 실제 프로젝트에서 같은 속도 향상을 뜻하지 않습니다. 반대로 2025년 METR 무작위 대조 실험에서는 익숙한 대형 오픈소스 프로젝트를 다루던 숙련 개발자 16명이 246개 실제 작업을 수행했을 때, 당시 AI 도구를 허용한 조건의 완료 시간이 평균 19% 길었습니다. 이 연구도 Copilot이나 오늘날 도구 전체를 평가한 것은 아닙니다.

두 결과를 함께 보면 도구 선택만으로 생산성이 정해지지 않습니다. 간단하고 반복되는 코드, 초안 작성, 익숙하지 않은 API 탐색에서는 도움을 받을 수 있지만, 복잡한 기존 코드의 경계와 숨은 요구사항을 파악하고 출력물을 검토하는 시간은 별도로 듭니다. 자신의 작업 몇 건을 골라 AI 사용 전후의 전체 완료 시간, 수정 횟수, 테스트 결함을 기록해 실제 효과를 판단하세요.

처음에는 이 짧은 흐름으로 익혀 보세요

  1. Chat에 작은 질문을 하고 답이 코드와 일치하는지 확인합니다.
  2. 두세 파일이 관련된 작업은 Plan에 완료 조건과 테스트 기준을 주고 계획을 검토합니다.
  3. Agent에 승인된 범위만 구현하게 하고, 도구 요청과 차이를 살펴봅니다.
  4. 테스트를 실행하고, 변경 전후와 남은 위험을 요약하게 합니다.

Copilot은 개발자를 대신해 결과를 보증하는 기능이 아니라, 맥락을 주고 결과를 확인하며 함께 쓰는 개발 도구입니다. 작은 작업부터 흐름을 익히고, 편리함보다 완성된 변경과 검증 결과를 기준으로 계속 사용할지 판단하세요.

공식 안내와 연구

공식 문서와 연구 확인: 2026년 10월 13일. VS Code 화면, 플랜, 사용량 기준은 계정·조직·지역과 업데이트 시점에 따라 달라질 수 있습니다.