# VS Code 설치하고 _작업 폴더 열기_ **CLAUDE CODE 준비 · 04 VS CODE — v1.0 · 2026-07-26** > 코드를 보고 고치는 편집기 VS Code를 설치합니다. 설치 중 **"PATH에 추가"** 체크 하나만 확인하면 됩니다. > 소요 시간 약 8분 · Windows 10 / 11 · 무료 · 사용자 설치 가능 · 초보자 대상 > 📌 화면 그림(목업)이 포함된 버전은 같은 폴더의 **04-vscode-guide_v1.0_20260726.html** 을 브라우저로 여세요. 명령어는 HTML에서 `복사` 버튼으로 바로 복사할 수 있습니다. --- ## VS Code 설치 전체 흐름 내려받기 → 설치(체크 1개 확인) → 한국어 설정 → 폴더 열기 → 터미널 열기 순서입니다. | 순서 | 단계 | 하는 일 | | :--: | :------------- | :------- | | 01 | ⬇️ 내려받기 | STEP 1 | | 02 | ⚙️ 설치 마법사 | STEP 2–4 | | 03 | 🇰🇷 한국어 설정 | STEP 5 | | 04 | 📁 폴더 열기 | STEP 6–7 | | 05 | ⌨️ 터미널 열기 | STEP 8–9 | **꼭 확인할 한 가지:** 설치 중 "추가 작업 선택" 화면에서 PATH에 추가 체크박스가 켜져 있는지 확인 (기본값은 켜져 있음) --- ## STEP 1 — code.visualstudio.com 에서 받기 VS CODE · 내려받기 **목표:** VS Code 설치 파일을 내려받습니다. 1. 주소창에 **code.visualstudio.com** 을 입력해 접속합니다. 2. 파란색 **Download for Windows** 버튼을 누릅니다. 3. 화면 아래에서 `VSCodeUserSetup-x64-1.9x.x.exe` 를 확인합니다. **주소** ```powershell https://code.visualstudio.com ``` > ℹ️ **User Installer 가 기본입니다** — 기본 버튼은 **User Installer**(내 계정에만 설치)입니다. **관리자 권한이 없어도 설치**되므로 기관 PC에 유리합니다. > 💬 **Stable vs Insiders** — 초록색 **Insiders**는 시험판입니다. 반드시 **파란색 Stable** 을 받으세요. ## STEP 2 — 라이선스 동의 → 설치 위치 → **다음** VS CODE · 설치 마법사 **목표:** 앞쪽 화면들을 기본값 그대로 넘어갑니다. 1. 내려받은 `VSCodeUserSetup…exe` 를 **더블클릭**합니다. 2. **사용권 계약** 화면에서 **동의합니다** 를 선택합니다. 3. **다음** 을 누릅니다. 4. **설치 위치**·**시작 메뉴 폴더** 화면도 그대로 **다음** 으로 넘깁니다. > 💬 **VS Code는 한국어 설치 마법사** — Git·Node.js와 달리 설치 화면이 **한글**로 나옵니다. 읽으면서 진행하면 됩니다. > ℹ️ **관리자 권한 창이 안 떠요** — User Installer는 **내 계정 폴더에만** 설치하므로 관리자 권한이 필요 없습니다. 정상입니다. ## STEP 3 — 추가 작업 선택 — **PATH에 추가** 확인 VS CODE · 설치 마법사 ★중요 **목표:** 터미널에서 `code` 명령을 쓸 수 있도록 PATH 등록을 확인합니다. 1. **PATH에 추가(다시 시작한 후 사용 가능)** 가 **체크**되어 있는지 확인합니다. (기본 체크) 2. **"Code(으)로 열기" 작업을…추가** 두 항목도 체크되어 있으면 편리합니다. 3. **다음** 을 누릅니다. 4. 이어지는 **설치 준비 완료** 화면에서 **설치** 를 누릅니다. > ⚠️ **PATH 체크를 빼면** — 터미널에서 `code .` 명령이 동작하지 않고, 클로드 코드와의 연동도 번거로워집니다. **반드시 체크 상태로 두세요.** > ✅ **탐색기 우클릭 메뉴가 편합니다** — "Code(으)로 열기" 를 체크하면 폴더에서 **오른쪽 클릭 → Code로 열기** 로 바로 작업할 수 있습니다. ## STEP 4 — 설치 완료 → VS Code 실행 VS CODE · 첫 실행 **목표:** 설치를 마치고 VS Code를 처음 실행합니다. 1. 설치가 끝나면 **Visual Studio Code 실행** 체크를 켠 채 **종료** 를 누릅니다. 2. 파란 로고와 함께 **시작** 탭이 열립니다. 3. 테마 선택 화면이 나오면 마음에 드는 것을 고릅니다. (나중에 변경 가능) > ✅ **첫 화면은 비어 있습니다** — "시작(Get Started)" 탭만 보이는 것이 정상입니다. 아직 아무 폴더도 열지 않았기 때문입니다. > 💬 **테마를 바꾸려면** — **Ctrl+K → Ctrl+T** 로 언제든 바꿀 수 있습니다. ## STEP 5 — 한국어 언어팩 설치 VS CODE · 한국어 설정 **목표:** 메뉴를 한글로 바꿔 초보자도 쉽게 쓸 수 있게 합니다. 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 6 — 작업 폴더 열기 (가장 중요한 습관) VS CODE · 폴더 열기 **목표:** 앞으로 클로드 코드와 함께 쓸 작업 폴더를 VS Code에서 엽니다. 1. 메뉴 **파일 → 폴더 열기…** 를 선택합니다. (**Ctrl+K → Ctrl+O**) 2. 바탕화면의 **dev** 폴더(Git 가이드에서 만든 폴더)를 고릅니다. 3. 신뢰 확인 창이 뜨면 **예, 작성자를 신뢰합니다** 를 누릅니다. 4. 왼쪽에 폴더 안 파일 목록이 나타나면 성공입니다. > ⚠️ **파일 하나만 열지 마세요** — 반드시 **폴더**를 여세요. 클로드 코드는 **열린 폴더 전체**를 보고 작업합니다. > ℹ️ **신뢰 창이 뭔가요?** — 내가 만든 폴더면 **신뢰**를 누르세요. 인터넷에서 받은 낯선 코드라면 **제한 모드**가 안전합니다. ## STEP 7 — 탐색기에서 **Code로 열기** VS CODE · 실행 확인 **목표:** 설치 때 체크한 우클릭 메뉴로 폴더를 더 빠르게 여는 방법을 익힙니다. 1. Windows 탐색기에서 작업 폴더(예: **바탕화면\dev**)를 찾습니다. 2. 폴더 위에서 **마우스 오른쪽 클릭**합니다. 3. **Code(으)로 열기** 를 선택하면 VS Code가 그 폴더로 열립니다. 4. 메뉴가 안 보이면 **추가 옵션 표시** 안에 있습니다. (Windows 11) > ✅ **이 방법이 가장 빠릅니다** — 앞으로 작업할 때마다 **폴더 우클릭 → Code로 열기** 한 번이면 준비 끝입니다. > ⚠️ **메뉴가 아예 없다면** — STEP 3의 체크를 안 한 것입니다. 설치 파일을 다시 실행해 **같은 위치에 다시 설치**하면서 체크하세요. ## STEP 8 — VS Code 안에서 터미널 열기 VS CODE · 터미널 **목표:** 창을 왔다 갔다 하지 않고 VS Code 안에서 명령을 입력할 수 있게 합니다. 1. 키보드 **Ctrl + `** 를 누릅니다. (백틱: 숫자 1 왼쪽 키) 2. 아래쪽에 **터미널** 패널이 열립니다. 3. `pwd` 를 입력해 현재 폴더 위치를 확인합니다. 4. 터미널 종류를 바꾸려면 오른쪽 **˅** 를 누릅니다. **현재 폴더 확인** ```powershell pwd ``` > ✅ **여기서 클로드 코드를 실행합니다** — 다음 가이드에서 이 터미널에 `claude` 를 입력합니다. **폴더 위치가 곧 작업 대상**입니다. ## STEP 9 — 터미널에서 **code .** 실행해 보기 VS CODE · 마지막 확인 **목표:** PATH 등록이 제대로 되었는지 마지막으로 확인합니다. 1. PowerShell을 새로 열고 작업 폴더로 이동합니다. 2. **code .** 를 입력합니다. (**code** 뒤에 **띄어쓰기 + 점**) 3. VS Code 창이 그 폴더로 새로 열리면 성공입니다. **① 작업 폴더로 이동** ```powershell cd "$HOME\Desktop\dev" ``` **② 지금 폴더를 VS Code로 열기** ```powershell code . ``` > ⚠️ **"code 용어가 인식되지 않습니다"** — PATH 등록이 안 된 것입니다. ① 터미널 새로 열기 ② PC 재부팅 ③ 설치 파일을 다시 실행해 **PATH에 추가** 체크 후 재설치. ## VS Code 명령어 · 단축키 모음 명령은 **복사** 버튼으로, 단축키는 눈으로 익히세요. 자주 쓰는 것만 모았습니다. ### ① 지금 폴더를 VS Code로 열기 ```powershell code . ``` 가장 많이 쓰는 명령입니다. **code** 와 **.** 사이 띄어쓰기 필수. ### ② 특정 폴더 열기 ```powershell code "$HOME\Desktop\dev" ``` 경로를 직접 지정해 엽니다. ### ③ 버전 확인 (설치 점검) ```powershell code --version ``` ``` → 1.9x.x ``` 이 명령이 되면 PATH 등록이 정상입니다. ### ④ 확장 설치 (한국어 언어팩) ```powershell code --install-extension MS-CEINTL.vscode-language-pack-ko ``` 화면에서 클릭하는 대신 명령으로 설치할 수 있습니다. ### ⑤ 설치된 확장 목록 보기 ```powershell code --list-extensions ``` 어떤 확장이 깔려 있는지 확인합니다. ### ⑥ VS Code 설치 위치 확인 (문제 진단) ```powershell Get-Command code | Select-Object Source ``` 아무것도 안 나오면 PATH 등록이 안 된 것입니다. ### ⑦ 자주 쓰는 단축키 — 터미널 열기/닫기 ```powershell Ctrl + ` ``` 백틱(`)은 숫자 1 왼쪽 키입니다. ### ⑧ 자주 쓰는 단축키 — 명령 팔레트 ```powershell Ctrl + Shift + P ``` 모든 기능을 이름으로 찾아 실행합니다. 길을 잃으면 이것부터. --- ## 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` 를 실행하세요. | --- ## 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` --- ### 📌 출처 (2026-07 기준) - Visual Studio Code 공식 다운로드 — https://code.visualstudio.com - VS Code Windows 설치 문서 — https://code.visualstudio.com/docs/setup/windows > ※ 본 문서의 브라우저·설치창·터미널 그림은 실제 스크린샷이 아닌 **화면을 재현한 벡터 목업**입니다. 버전에 따라 버튼 위치·문구가 다를 수 있습니다.