VS
CLAUDE CODE 준비 · 04 VS CODE

VS Code 설치하고
작업 폴더 열기

코드를 보고 고치는 편집기 VS Code를 설치합니다. 설치 중 "PATH에 추가" 체크 하나만 확인하면 됩니다.

소요 시간 약 8분Windows 10 / 11무료 · 사용자 설치 가능초보자 대상v1.0 · 2026-07-26
한눈에 보기

VS Code 설치 전체 흐름

내려받기 → 설치(체크 1개 확인) → 한국어 설정 → 폴더 열기 → 터미널 열기 순서입니다.

01 ⬇️ 내려받기 STEP 1 02 ⚙️ 설치 마법사 STEP 2–4 03 🇰🇷 한국어 설정 STEP 5 04 📁 폴더 열기 STEP 6–7 05 ⌨️ 터미널 열기 STEP 8–9 꼭 확인할 한 가지 설치 중 "추가 작업 선택" 화면에서 PATH에 추가 체크박스가 켜져 있는지 확인 (기본값은 켜져 있음)
STEP 1VS CODE · 내려받기

code.visualstudio.com 에서 받기

https://code.visualstudio.com Visual Studio Code Docs Updates Blog Extensions Your code editor. 무료로 제공되는 코드 편집기입니다. ⬇ Download for Windows Stable Build Other platforms · Insiders · All downloads VSCodeUserSetup-x64-1.9x.x.exe 1 2 3
이 단계의 목표

VS Code 설치 파일을 내려받습니다.

  1. 주소창에 code.visualstudio.com 을 입력해 접속합니다.
  2. 파란색 Download for Windows 버튼을 누릅니다.
  3. 화면 아래에서 VSCodeUserSetup-x64-1.9x.x.exe 를 확인합니다.
주소 
https://code.visualstudio.com
User Installer 가 기본입니다

기본 버튼은 User Installer(내 계정에만 설치)입니다. 관리자 권한이 없어도 설치되므로 기관 PC에 유리합니다.

Stable vs Insiders

초록색 Insiders는 시험판입니다. 반드시 파란색 Stable 을 받으세요.

STEP 2VS CODE · 설치 마법사

라이선스 동의 → 설치 위치 → 다음

Visual Studio Code 설치 – ✕ < 뒤로 다음 > 취소 사용권 계약 계속하기 전에 다음 중요 정보를 읽어 보십시오. 🧩 Visual Studio Code에 대한 사용권 계약 이 라이선스는 Microsoft Corporation과 귀하 간의 계약입니다. 본 소프트웨어를 사용함으로써 이 조건에 동의하는 것입니다. 1. 설치 및 사용 권한 … 2. 데이터 수집 … 동의합니다 동의하지 않습니다 .exe 더블클릭 다운로드한 설치 파일을 두 번 클릭해 실행합니다. 1 남은 화면도 다음 설치 위치 · 시작 메뉴 폴더 그대로 두고 넘어갑니다. 4 2 3
이 단계의 목표

앞쪽 화면들을 기본값 그대로 넘어갑니다.

  1. 내려받은 VSCodeUserSetup…exe 를 더블클릭합니다.
  2. 사용권 계약 화면에서 동의합니다 를 선택합니다.
  3. 다음 을 누릅니다.
  4. 설치 위치·시작 메뉴 폴더 화면도 그대로 다음 으로 넘깁니다.
VS Code는 한국어 설치 마법사

Git·Node.js와 달리 설치 화면이 한글로 나옵니다. 읽으면서 진행하면 됩니다.

관리자 권한 창이 안 떠요

User Installer는 내 계정 폴더에만 설치하므로 관리자 권한이 필요 없습니다. 정상입니다.

STEP 3VS CODE · 설치 마법사 ★중요

추가 작업 선택 — PATH에 추가 확인

Visual Studio Code 설치 – ✕ < 뒤로 다음 > 취소 추가 작업 선택 Visual Studio Code를 설치하는 동안 수행할 추가 작업을 선택한 후 다음을 클릭하십시오. 🧩 바탕 화면에 바로가기 만들기 기타: "Code(으)로 열기" 작업을 Windows 탐색기 파일 상황에 맞는 메뉴에 추가 "Code(으)로 열기" 작업을 Windows 탐색기 디렉터리 상황에 맞는 메뉴에 추가 지원되는 파일 형식에 대한 편집기로 Code 등록 PATH에 추가(다시 시작한 후 사용 가능) 이 체크만 꼭 확인하세요 PATH에 추가 → 터미널에서 code . 로 폴더를 엽니다. 다음 화면에서 [설치] 설치 준비 완료 화면이 나오면 설치 버튼을 누르면 됩니다. 4 1 2 3
이 단계의 목표

터미널에서 code 명령을 쓸 수 있도록 PATH 등록을 확인합니다.

  1. PATH에 추가(다시 시작한 후 사용 가능) 가 체크되어 있는지 확인합니다. (기본 체크)
  2. "Code(으)로 열기" 작업을…추가 두 항목도 체크되어 있으면 편리합니다.
  3. 다음 을 누릅니다.
  4. 이어지는 설치 준비 완료 화면에서 설치 를 누릅니다.
PATH 체크를 빼면

터미널에서 code . 명령이 동작하지 않고, 클로드 코드와의 연동도 번거로워집니다. 반드시 체크 상태로 두세요.

탐색기 우클릭 메뉴가 편합니다

"Code(으)로 열기" 를 체크하면 폴더에서 오른쪽 클릭 → Code로 열기 로 바로 작업할 수 있습니다.

STEP 4VS CODE · 첫 실행

설치 완료 → VS Code 실행

파일 편집 선택 보기 이동 실행 터미널 도움말 🗂 🔍 ⑂ ▷ ⊞ 시작 Visual Studio Code 코드 편집을 다시 정의합니다 시작 새 파일… 파일 열기… 폴더 열기… 색 테마 Dark Modern Light Modern ⑂ main ⊗ 0 ⚠ 0 줄 1, 열 1 UTF-8 설치 마지막 화면 "Visual Studio Code 실행" 체크 → [종료] 1 2 3
이 단계의 목표

설치를 마치고 VS Code를 처음 실행합니다.

  1. 설치가 끝나면 Visual Studio Code 실행 체크를 켠 채 종료 를 누릅니다.
  2. 파란 로고와 함께 시작 탭이 열립니다.
  3. 테마 선택 화면이 나오면 마음에 드는 것을 고릅니다. (나중에 변경 가능)
첫 화면은 비어 있습니다

"시작(Get Started)" 탭만 보이는 것이 정상입니다. 아직 아무 폴더도 열지 않았기 때문입니다.

테마를 바꾸려면

Ctrl+K → Ctrl+T 로 언제든 바꿀 수 있습니다.

STEP 5VS CODE · 한국어 설정

한국어 언어팩 설치

파일 편집 선택 보기 이동 실행 터미널 도움말 🗂 🔍 ⑂ ▷ ⊞ 확장: 마켓플레이스 korean 한 Korean Language Pack Microsoft ⬇ 30M ★ 4.5 Install Korean Spell Checker 기타 확장 Korean Language Pack for VS Code VS Code의 메뉴·설정을 한국어로 표시합니다. 표시 언어를 변경하려면 다시 시작해야 합니다. Change Language and Restart 1 2 3 4
이 단계의 목표

메뉴를 한글로 바꿔 초보자도 쉽게 쓸 수 있게 합니다.

  1. 왼쪽 세로 막대의 네모 4개 아이콘(확장) 을 클릭합니다. (또는 Ctrl+Shift+X)
  2. 검색창에 korean 을 입력합니다.
  3. Korean Language Pack 의 Install 을 누릅니다.
  4. 오른쪽 아래 Change Language and Restart 를 누르면 한글로 바뀝니다.
영어가 편하면 건너뛰세요

필수는 아닙니다. 다만 강의 실습에서는 한글 메뉴가 훨씬 따라오기 쉽습니다.

다시 영어로 돌리려면

Ctrl+Shift+P → Configure Display Language → English 선택.

STEP 6VS CODE · 폴더 열기

작업 폴더 열기 (가장 중요한 습관)

파일 편집 선택 보기 이동 실행 터미널 도움말 🗂 🔍 ⑂ ▷ ⊞ 탐색기 ▾ DEV ▾ 📁 my-first-app 📄 README.md 📄 index.html 이 폴더에 있는 파일 작성자를 신뢰합니까? 코드 실행은 컴퓨터에 영향을 줄 수 있습니다. 신뢰하지 않으면 제한 모드로 열립니다. C:\Users\hufs\Desktop\dev 예, 작성자를 신뢰합니다 아니요 ⑂ main ⊗ 0 ⚠ 0 1 2 3 4
이 단계의 목표

앞으로 클로드 코드와 함께 쓸 작업 폴더를 VS Code에서 엽니다.

  1. 메뉴 파일 → 폴더 열기… 를 선택합니다. (Ctrl+K → Ctrl+O)
  2. 바탕화면의 dev 폴더(Git 가이드에서 만든 폴더)를 고릅니다.
  3. 신뢰 확인 창이 뜨면 예, 작성자를 신뢰합니다 를 누릅니다.
  4. 왼쪽에 폴더 안 파일 목록이 나타나면 성공입니다.
파일 하나만 열지 마세요

반드시 폴더를 여세요. 클로드 코드는 열린 폴더 전체를 보고 작업합니다.

신뢰 창이 뭔가요?

내가 만든 폴더면 신뢰를 누르세요. 인터넷에서 받은 낯선 코드라면 제한 모드가 안전합니다.

STEP 7VS CODE · 실행 확인

탐색기에서 Code로 열기

📁 바탕 화면 C:\Users\hufs\Desktop 📁 dev 📁 문서 열기 새 창에서 열기 Code(으)로 열기 Git Bash Here 터미널에서 열기 이름 바꾸기 추가 옵션 표시 앞으로의 작업 순서 ① 작업 폴더를 우클릭 ② Code(으)로 열기 ③ VS Code에서 터미널 열기 ④ claude 입력 → 작업 시작 이 4단계만 익히면 됩니다 🖱 오른쪽 클릭 1 2 3 4
이 단계의 목표

설치 때 체크한 우클릭 메뉴로 폴더를 더 빠르게 여는 방법을 익힙니다.

  1. Windows 탐색기에서 작업 폴더(예: 바탕화면\dev)를 찾습니다.
  2. 폴더 위에서 마우스 오른쪽 클릭합니다.
  3. Code(으)로 열기 를 선택하면 VS Code가 그 폴더로 열립니다.
  4. 메뉴가 안 보이면 추가 옵션 표시 안에 있습니다. (Windows 11)
이 방법이 가장 빠릅니다

앞으로 작업할 때마다 폴더 우클릭 → Code로 열기 한 번이면 준비 끝입니다.

메뉴가 아예 없다면

STEP 3의 체크를 안 한 것입니다. 설치 파일을 다시 실행해 같은 위치에 다시 설치하면서 체크하세요.

STEP 8VS CODE · 터미널

VS Code 안에서 터미널 열기

파일 편집 선택 보기 이동 실행 터미널 도움말 🗂 🔍 ⑂ ▷ ⊞ 탐색기 ▾ DEV 📁 my-first-app Ctrl + ` 숫자 1 왼쪽의 키 문제 출력 디버그 콘솔 터미널 터미널 ＋ ˅ ⊞ 🗑 PS C:\Users\hufs\Desktop\dev> pwd Path ---- C:\Users\hufs\Desktop\dev PS C:\Users\hufs\Desktop\dev> _ ⑂ main ⊗ 0 ⚠ 0 1 2 3 4
이 단계의 목표

창을 왔다 갔다 하지 않고 VS Code 안에서 명령을 입력할 수 있게 합니다.

  1. 키보드 Ctrl + ` 를 누릅니다. (백틱: 숫자 1 왼쪽 키)
  2. 아래쪽에 터미널 패널이 열립니다.
  3. pwd 를 입력해 현재 폴더 위치를 확인합니다.
  4. 터미널 종류를 바꾸려면 오른쪽 ˅ 를 누릅니다.
현재 폴더 확인 
pwd
여기서 클로드 코드를 실행합니다

다음 가이드에서 이 터미널에 claude 를 입력합니다. 폴더 위치가 곧 작업 대상입니다.

STEP 9VS CODE · 마지막 확인

터미널에서 code . 실행해 보기

Windows PowerShell ✕ PS C:\Users\hufs> cd "$HOME\Desktop\dev" PS C:\Users\hufs\Desktop\dev> code . (VS Code 창이 새로 열립니다) PS C:\Users\hufs\Desktop\dev> _ 1 2 3 code . 의 의미 code = VS Code 실행 .(점) = 지금 있는 폴더 → "지금 폴더를 VS Code로 열어라" code 와 . 사이 띄어쓰기 필수!
이 단계의 목표

PATH 등록이 제대로 되었는지 마지막으로 확인합니다.

  1. PowerShell을 새로 열고 작업 폴더로 이동합니다.
  2. code . 를 입력합니다. (code 뒤에 띄어쓰기 + 점)
  3. VS Code 창이 그 폴더로 새로 열리면 성공입니다.
① 작업 폴더로 이동 
cd "$HOME\Desktop\dev"
② 지금 폴더를 VS Code로 열기 
code .
"code 용어가 인식되지 않습니다"

PATH 등록이 안 된 것입니다. ① 터미널 새로 열기 ② PC 재부팅 ③ 설치 파일을 다시 실행해 PATH에 추가 체크 후 재설치.

명령어 모음COPY & PASTE · 1/2

VS Code 명령어 · 단축키 모음 (1/2)

명령은 복사 버튼으로, 단축키는 눈으로 익히세요. 자주 쓰는 것만 모았습니다.

① 지금 폴더를 VS Code로 열기
code .
가장 많이 쓰는 명령입니다. code 와 . 사이 띄어쓰기 필수.
② 특정 폴더 열기
code "$HOME\Desktop\dev"
경로를 직접 지정해 엽니다.
③ 버전 확인 (설치 점검)
code --version
→ 1.9x.x
이 명령이 되면 PATH 등록이 정상입니다.
④ 확장 설치 (한국어 언어팩)
code --install-extension MS-CEINTL.vscode-language-pack-ko
화면에서 클릭하는 대신 명령으로 설치할 수 있습니다.
⑤ 설치된 확장 목록 보기
code --list-extensions
어떤 확장이 깔려 있는지 확인합니다.
⑥ VS Code 설치 위치 확인 (문제 진단)
Get-Command code | Select-Object Source
아무것도 안 나오면 PATH 등록이 안 된 것입니다.
명령어 모음COPY & PASTE · 2/2

VS Code 명령어 · 단축키 모음 (2/2)

명령은 복사 버튼으로, 단축키는 눈으로 익히세요. 자주 쓰는 것만 모았습니다.

⑦ 자주 쓰는 단축키 — 터미널 열기/닫기
Ctrl + `
백틱(`)은 숫자 1 왼쪽 키입니다.
⑧ 자주 쓰는 단축키 — 명령 팔레트
Ctrl + Shift + P
모든 기능을 이름으로 찾아 실행합니다. 길을 잃으면 이것부터.
문제 해결TROUBLESHOOTING

VS Code — 문제가 생겼을 때

증상별 해결 순서입니다.

이런 화면·메시지가 나오면 원인 이렇게 해결하세요
'code' 용어가 … 인식되지 않습니다 PATH 미등록 또는 미반영 ① 터미널을 모두 닫고 새로 열기 ② PC 재부팅 ③ 설치 파일을 다시 실행해 같은 위치에 재설치하며 "PATH에 추가" 체크.
우클릭 메뉴에 "Code(으)로 열기"가 없음 설치 시 해당 체크 해제 설치 파일을 다시 실행 → 추가 작업 선택 화면에서 두 개의 "Code(으)로 열기" 체크 → 재설치. Windows 11은 추가 옵션 표시 안에 있을 수도 있습니다.
메뉴가 계속 영어로 나옴 언어팩 미설치 또는 재시작 안 함 Ctrl+Shift+X → korean 검색 → 설치 → Change Language and Restart. 안 되면 Ctrl+Shift+P → Configure Display Language → 한국어.
한글 입력이 이상하게 깨짐 글꼴 문제 Ctrl+, (설정) → font family 검색 → Consolas, D2Coding, Malgun Gothic 처럼 한글 글꼴을 뒤에 추가.
"제한 모드"라 실행이 막힘 폴더 신뢰 설정 위쪽 노란 띠의 신뢰 클릭, 또는 파일 → 폴더 신뢰 관리. 내가 만든 폴더면 신뢰해도 안전합니다.
터미널이 Git Bash로 열려 명령이 다름 기본 프로필 설정 터미널 오른쪽 ˅ → 기본 프로필 선택 → PowerShell. 이 가이드의 명령은 PowerShell 기준입니다.
기관 PC라 설치가 막힘 관리자 권한 제한 VS Code는 User Installer 라서 보통 권한 없이 설치됩니다. 그래도 막히면 공식 사이트의 .zip 무설치판을 내려받아 압축을 풀고 Code.exe 를 실행하세요.
마무리CHECKLIST & NEXT

VS Code 설치 완료 확인

아래가 모두 되면 준비 끝입니다. 마지막은 Claude Code 설치입니다.

✅ 완료 체크리스트

  • 설치를 마치고 VS Code가 실행된다파란 로고 + 시작 탭
  • "PATH에 추가"를 체크하고 설치했다code --version 으로 확인 가능
  • 한국어 언어팩을 설치했다(선택)메뉴가 한글로 보임
  • 폴더를 열 줄 안다파일 → 폴더 열기 또는 우클릭 → Code로 열기
  • Ctrl + ` 로 터미널을 열 수 있다여기서 claude 를 실행하게 됩니다
  • code . 명령이 동작한다터미널에서 폴더 열기 성공

➡️ 다음 단계 & 참고

  • ⑤ Claude Code 설치 가이드드디어 마지막입니다. (05-claude-code-guide)
  • 앞으로의 작업 루틴① 작업 폴더 우클릭 → Code로 열기 ② Ctrl + ` 터미널 ③ claude ④ 한국어로 요청
  • 추천 확장(선택)Korean Language Pack · Live Server(HTML 미리보기) · Prettier(코드 정리)
  • 알아 두면 좋은 단축키Ctrl+Shift+P 명령 팔레트 · Ctrl+S 저장 · Ctrl+` 터미널
최종 확인 명령code --version