Windows에서 VS Code 설치하기

1 설치 파일 내려받기

웹 브라우저에서 공식 다운로드 페이지 code.visualstudio.com/download를 엽니다. 화면 왼쪽에 Windows 칸이 있습니다.

큰 Windows 버튼을 그냥 눌러도 됩니다. 그 버튼은 User Installer의 x64 버전을 내려받습니다. 대부분의 PC에서 이것이 맞습니다.

내 PC가 x64인지 Arm64인지 모르겠다면? Windows + Pause를 누르거나 설정 > 시스템 > 정보를 열어 시스템 종류를 보세요. “x64 기반 프로세서”면 x64, “ARM 기반 프로세서”면 Arm64입니다. Surface Pro X 같은 일부 기기만 Arm64이고, 나머지는 거의 x64입니다.

2 설치 프로그램 실행

내려받은 파일은 보통 다운로드 폴더에 있습니다. 더블클릭해 실행합니다.

“Windows의 PC 보호” 파란 창이 뜨면 당황하지 않아도 됩니다. 새로 내려받은 실행 파일에 Windows가 흔히 보여 주는 SmartScreen 화면입니다. 추가 정보를 누르면 아래에 실행 버튼이 나타납니다. 그 버튼을 누르면 설치가 진행됩니다.

설치 마법사는 다음 순서로 지나갑니다. 앞의 세 화면은 특별히 바꿀 것이 없으니 그대로 다음을 누릅니다.

1. 사용권 계약 화면에서 동의합니다를 고르고 다음.
2. 설치 위치 선택 화면은 기본값 그대로 다음.
3. 시작 메뉴 폴더 선택 화면도 기본값 그대로 다음.

그다음 추가 작업 선택 화면이 나옵니다. 이 가이드에서 유일하게 기본값을 바꾸는 곳이니 잠깐 멈춰서 읽어 주세요. 체크박스 다섯 개입니다.

체크를 마쳤으면 다음, 이어서 설치를 누릅니다. 설치는 보통 1분 안에 끝납니다.

마지막 화면에서 “Visual Studio Code 실행”에 체크한 채 종료를 누르면 바로 열립니다. 버튼 이름이 “마침”이 아니라 “종료”라서 잘못 누른 것처럼 보이지만, 설치 프로그램을 끝낸다는 뜻입니다.

3 첫 실행

처음 열면 색 테마 화면보다 GitHub 로그인 창이 먼저 뜹니다. GitHub Copilot을 쓰라는 안내인데 이 가이드에서는 필요 없습니다. 오른쪽 아래 Continue without Signing In을 누르고 넘어가세요. 계정은 나중에 필요해질 때 연결하면 됩니다.

그다음 Make It Yours 화면에서 색 테마를 고르라고 합니다. 지금 아무거나 골라도 되고 나중에 언제든 바꿀 수 있습니다. 어두운 배경이 눈이 편하면 Dark 2026, 밝은 쪽이 좋으면 Light 2026을 고른 다음 Continue를 누릅니다. 이 두 테마 이름은 원문(2026년 8월)에 적힌 그대로입니다.

테마는 언제든 바꿉니다. Ctrl + K를 누르고 이어서 Ctrl + T를 누르면 테마 목록이 열립니다. 방향키로 옮길 때마다 화면이 바로 바뀌니 눈으로 고르면 됩니다.

시작 화면은 닫아도 됩니다. 탭의 x를 눌러 닫으면 그만입니다. 다시 보고 싶으면 나중에 명령 팔레트에서 시작을 검색하면 됩니다.

4 한국어로 바꾸기

VS Code는 기본이 영어입니다. Microsoft가 만든 무료 한국어 언어 팩을 설치하면 메뉴와 버튼이 전부 한국어로 바뀝니다.

Windows 표시 언어가 한국어라면, 설치 직후 오른쪽 아래에 한국어로 바꾸겠냐고 묻는 알림이 저절로 뜹니다. 떴다면 설치 및 다시 시작을 누르는 것으로 끝입니다.

알림이 안 떴다면 직접 설치합니다.

1. Ctrl + Shift + X를 눌러 확장 탭을 엽니다.
2. 검색창에 Korean Language Pack을 입력합니다.
3. Microsoft가 만든 Korean Language Pack for Visual Studio Code를 찾아 Install을 누릅니다.
4. 설치가 끝나면 다시 시작하겠냐고 묻습니다. Restart를 누릅니다.

다시 시작해도 영어 그대로라면 표시 언어를 직접 지정하면 됩니다. Ctrl + Shift + P를 눌러 명령 팔레트를 열고 Configure Display Language(한국어로 바뀐 뒤에는 표시 언어 구성)를 입력해 실행한 다음, 목록에서 한국어를 고릅니다.

영어 그대로 쓰는 것도 나쁘지 않습니다. 개발 문서와 오류 메시지는 대부분 영어라서, 메뉴 이름이 영어면 검색해서 답을 찾기가 쉽습니다. 이 가이드는 한국어 기준으로 쓰되 중요한 메뉴는 영어 이름을 함께 적었습니다.

5 화면 구성 이해하기

버튼을 아무거나 눌러 보기 전에, 화면이 어떤 칸으로 나뉘어 있는지 30초만 보고 가면 이후가 훨씬 수월합니다. VS Code 화면은 여섯 덩어리입니다. 원문의 번호 자리를 CSS로만 옮겼습니다.

1. 활동 표시줄 (Activity Bar) — 맨 왼쪽 세로 아이콘 줄. 탐색기, 검색, 소스 제어, 확장 사이를 오갑니다.
2. 기본 사이드 바 (Primary Side Bar) — 활동 표시줄에서 고른 것이 펼쳐지는 칸. 보통은 폴더 안 파일 목록인 탐색기가 떠 있습니다.
3. 편집기 (Editor) — 실제로 글을 쓰는 가운데 영역. 파일을 여러 개 열면 위에 탭으로 쌓입니다.
4. 패널 (Panel) — 편집기 아래 칸. 터미널, 출력, 오류와 경고가 여기 나옵니다. 평소엔 접혀 있습니다.
5. 보조 사이드 바 (Secondary Side Bar) — 오른쪽 칸. 기본으로 채팅 화면이 들어갑니다. 안 쓰면 닫아 두어도 됩니다.
6. 상태 표시줄 (Status Bar) — 맨 아래 가로 줄. 지금 커서가 몇 번째 줄인지, 파일 인코딩과 종류가 무엇인지 보여 줍니다.

사이드 바가 사라졌다면 Ctrl + B를 누르세요. 같은 키로 다시 접힙니다. 패널은 Ctrl + J입니다. 화면이 갑자기 이상해졌을 때 대부분 이 두 키로 돌아옵니다.

6 폴더 열고 첫 파일 만들기

VS Code는 파일 하나가 아니라 폴더 하나를 여는 방식으로 씁니다. 폴더를 열면 그 안의 모든 파일이 왼쪽 탐색기에 나열되고, 검색도 그 폴더 전체에서 됩니다.

여는 방법은 둘 중 편한 쪽으로 하면 됩니다.

• 탐색기에서 폴더를 오른쪽 클릭하고 Code(으)로 열기. (2단계에서 체크한 그 항목입니다.)
• VS Code 메뉴에서 파일 > 폴더 열기를 고르고 폴더를 선택.

“이 폴더에 있는 파일 작성자를 신뢰합니까?” 창이 뜨면, 내가 만든 폴더이므로 예, 작성자를 신뢰합니다를 누릅니다. 인터넷에서 내려받은 남의 코드 폴더라면 아니요를 골라 제한된 모드로 여는 편이 안전합니다. 제한된 모드에서는 그 폴더의 코드가 자동 실행되지 않습니다.

이제 파일을 하나 만들어 봅니다. 탐색기의 폴더 이름 옆에 마우스를 올리면 새 파일 아이콘이 나타납니다. 그것을 누르고 파일 이름을 index.html로 입력한 뒤 Enter를 칩니다.

<!doctype html>
<html lang="ko">
<head>
  <meta charset="utf-8">
  <title>첫 페이지</title>
</head>
<body>
  <h1>설치 성공</h1>
  <p>VS Code로 만든 첫 파일입니다.</p>
</body>
</html>

붙여 넣었으면 Ctrl + S로 저장합니다. 탭 이름 옆의 흰 점이 사라지면 저장된 것입니다. 코드에 색이 입혀지면 VS Code가 파일 종류를 제대로 인식한 것입니다.

만든 파일을 브라우저로 보려면, 탐색기에서 index.html을 오른쪽 클릭하고 파일 탐색기에 표시를 고른 뒤 그 파일을 더블클릭하면 됩니다.

7 설치가 제대로 됐는지 확인하기

여기까지 왔다면 VS Code가 정상 설치됐고, 한국어로 바뀌었고, 폴더를 열어 파일을 만들고 저장하는 기본 흐름까지 익힌 것입니다. 아래 세 가지만 더 알면 당분간 막힐 일이 없습니다. 원문 본문은 “아래 네 가지만 더”라고 한 뒤 항목은 셋입니다. 네 번째 항목은 [확인 필요]입니다.

1. 명령 팔레트를 열어 봅니다

Ctrl + Shift + P를 누르면 위쪽에 입력창이 열립니다. 여기에 하고 싶은 일을 적으면 해당 기능이 검색됩니다. 메뉴 위치를 외울 필요가 없어서, VS Code에서 가장 먼저 익힐 단축키입니다.

2. 터미널에서 설치를 확인합니다

Ctrl + `(숫자 1 왼쪽의 물결 키)를 누르면 아래쪽에 터미널이 열립니다. 지금 연 폴더가 이미 현재 위치로 잡혀 있어서, 폴더를 찾아 들어갈 필요가 없습니다.

code --version

버전 번호 세 줄이 나오면 2단계의 PATH에 추가가 제대로 적용된 것입니다. “명령을 찾을 수 없습니다”가 나오면 아래 자주 막히는 곳을 보세요. 세 줄의 구체 숫자는 원문에 없습니다. [확인 필요]

3. 자동 저장을 켭니다

메뉴에서 파일 > 자동 저장을 켭니다. “고쳤는데 왜 안 바뀌지?”의 절반은 저장을 안 한 것입니다.