Skip to main content
Visual Studio Code(줄여서 VS Code)는 Microsoft가 만든 무료 코드 편집기입니다. 코드 자동 완성, 문법 하이라이팅, 디버깅 등 개발에 필요한 기능을 지원하며, 현재 전 세계에서 가장 많이 사용되는 코드 편집기입니다.
VS Code는 “Visual Studio”와 다른 프로그램입니다. Visual Studio는 훨씬 무겁고 큰 개발 도구이고, VS Code는 가볍고 빠른 코드 편집기입니다. 여기서는 VS Code를 설치합니다.

​
사전 요구사항

  • 운영체제: Windows 10 이상
  • 디스크 공간: 약 500MB 이상의 여유 공간

​
설치 과정

1

공식 웹사이트에서 다운로드

웹 브라우저에서 code.visualstudio.com에 접속합니다.VS Code 공식 웹사이트 - Download for Windows 버튼페이지 중앙에 있는 “Download for Windows” 버튼을 클릭하여 설치 파일을 다운로드합니다.
2

다운로드 확인

버튼을 클릭하면 자동으로 다운로드가 시작되고, “Thanks for downloading VS Code!” 페이지가 표시됩니다.다운로드 시작 페이지 - Thanks for downloading VS Code!브라우저 상단 또는 하단에 다운로드 진행 상태가 표시됩니다. 다운로드가 완료되면 설치 파일을 클릭하여 실행합니다.
3

라이선스 동의

설치 프로그램이 실행되면 사용권 계약 화면이 표시됩니다. Microsoft 소프트웨어 라이선스 계약서 내용입니다.라이선스 동의 화면 - 동의합니다(A) 선택화면 아래쪽에서 **“동의합니다(A)“**를 선택한 후 다음(N) 버튼을 클릭합니다.
“동의합니다”를 선택하지 않으면 다음 버튼이 활성화되지 않습니다. 반드시 “동의합니다(A)“를 선택합니다.
4

설치 경로 선택

VS Code가 설치될 폴더를 지정하는 화면입니다.설치 경로 선택 - 기본 경로 표시됨기본 경로(보통 C:\Users\사용자이름\AppData\Local\Programs\Microsoft VS Code)를 그대로 사용하면 됩니다. 다음(N) 버튼을 클릭합니다.
5

시작 메뉴 폴더 선택

Windows 시작 메뉴에 VS Code 바로가기를 만들 폴더 이름을 정하는 화면입니다.시작 메뉴 폴더 선택 - 기본값 Visual Studio Code기본값 “Visual Studio Code”를 그대로 두고 다음(N) 버튼을 클릭합니다.
6

추가 작업 선택

VS Code 설치 시 함께 설정할 추가 옵션들을 선택하는 화면입니다. 이 설정들은 나중에 VS Code를 더 편리하게 사용할 수 있게 해줍니다.추가 작업 선택 - 바탕 화면 바로가기, 파일 연결, PATH 추가 옵션각 옵션의 의미:
  • 바탕 화면에 바로가기 만들기: 바탕 화면에 VS Code 아이콘을 추가합니다.
  • “Code(으)로 열기” 작업을 Windows 탐색기 파일의 상황에 맞는 메뉴에 추가: 파일을 마우스 오른쪽 버튼으로 클릭했을 때 “Code로 열기” 메뉴가 나타납니다.
  • Code를(을) 지원되는 파일 형식에 대한 편집기로 등록합니다: 지원되는 파일을 더블클릭하면 VS Code에서 열립니다.
  • PATH에 추가 (다시 시작한 후 사용 가능): 터미널에서 code 명령어를 입력하여 VS Code를 실행할 수 있게 합니다.
“PATH에 추가”는 반드시 체크해야 합니다. 이 옵션이 체크되어야 나중에 터미널에서 code . 명령어로 현재 폴더를 VS Code에서 열 수 있습니다. 개발 작업에 매우 자주 사용됩니다.
“Code(으)로 열기” 작업 추가 옵션도 체크하면, 파일 탐색기에서 바로 VS Code를 열 수 있어 편리합니다.
원하는 옵션을 선택한 후 다음(N) 버튼을 클릭합니다.
7

설치 준비 완료 확인

지금까지 선택한 설치 설정의 요약 정보가 표시됩니다. 설치 위치, 시작 메뉴 폴더, 추가 작업 등이 한눈에 보입니다.설치 준비 완료 요약 - 설치 위치, 시작 메뉴 폴더, 추가 작업 정보내용을 확인한 후 설치(I) 버튼을 클릭하여 설치를 시작합니다.
8

설치 진행

파일이 추출되면서 설치가 진행됩니다. 녹색 진행 바가 표시됩니다.설치 진행 중 - 파일 추출 진행 바 표시보통 1~2분 정도 소요됩니다.
9

설치 완료

설치가 완료되면 “Visual Studio Code 설치 마법사 완료” 화면이 표시됩니다.설치 완료 - Visual Studio Code 실행 체크박스와 종료 버튼“Visual Studio Code 실행” 체크박스가 체크된 상태에서 종료(F) 버튼을 클릭하면 VS Code가 바로 실행됩니다.
10

첫 실행 및 초기 설정

VS Code가 처음 실행되면 “Get started with VS Code” 워크스루(안내) 화면이 표시됩니다.첫 실행 - Get started with VS Code 워크스루 화면이 화면에서는 다음과 같은 초기 설정을 할 수 있습니다:
  • Use AI features with Copilot for free: GitHub Copilot AI 기능을 무료로 사용할 수 있습니다. 관심이 있다면 “Use AI Features” 버튼을 클릭합니다.
  • Choose your theme: VS Code의 색상 테마(밝은 배경/어두운 배경)를 선택합니다.
  • Watch video tutorials: VS Code 사용법 동영상을 볼 수 있습니다.
워크스루를 따라 설정하거나, “Mark Done”을 클릭하여 건너뛸 수 있습니다.워크스루를 닫으면 Welcome 탭이 표시됩니다.Welcome 탭 - Start 옵션과 Walkthroughs 목록여기서 새 파일 만들기, 폴더 열기, Git 저장소 복제 등의 작업을 시작할 수 있습니다.

​
설치 확인

PowerShell 또는 명령 프롬프트를 새로 열고 (이미 열려 있던 것은 닫고 다시 여세요) 다음 명령어를 입력합니다.
버전 번호가 출력되면 VS Code가 성공적으로 설치된 것입니다.
터미널에서 특정 폴더를 VS Code로 열고 싶다면, 해당 폴더로 이동한 후 code .을 입력합니다. 점(.)은 “현재 폴더”를 의미합니다.
만약 code 명령어가 인식되지 않는다면, 설치 과정에서 “PATH에 추가” 옵션을 체크하지 않았을 수 있습니다. 이 경우 VS Code를 다시 설치하면서 해당 옵션을 체크하거나, 터미널을 완전히 닫았다가 다시 열어보세요.

​
설치 점검 목록

  • 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
  • 설치 후 버전 확인 명령어(--version)를 실행해 정상 설치를 검증했습니다.
  • PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
  • 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

​
문제 해결 가이드

  • 설치 파일이 실행되지 않으면 관리자 권한으로 다시 실행합니다.
  • 명령어가 인식되지 않으면 터미널을 새로 열고 PATH 반영 여부를 확인합니다.
  • 버전이 맞지 않으면 기존 설치를 정리한 뒤 권장 버전으로 재설치합니다.
  • 설정 변경 후 동작이 이상하면 시스템 재시작 후 다시 확인합니다.

​
관련 문서

Setup 홈

운영체제별 설치 흐름을 다시 확인합니다.

다음: Node.js

다음 설치 단계를 이어서 진행합니다.