Claude Code는 PowerShell(터미널)만으로도 충분히 사용할 수 있습니다. 하지만 VS Code(Visual Studio Code)와 함께 쓰면 코드를 눈으로 보면서 AI와 대화할 수 있어 훨씬 쾌적한 개발 환경을 만들 수 있습니다.
이 글에서는 VS Code 설치부터 Git 기본 에디터 변경, Claude Code 확장 프로그램 설치까지 3단계로 완전히 설정하는 방법을 소개합니다.
사용 환경
- VS Code 최신 버전
- Git 2.53.0
- Windows 10 / 11
왜 VS Code와 함께 쓰는가?
| 터미널만 사용 | VS Code + Claude Code |
|---|---|
| 텍스트만 보임 | 코드 파일을 보면서 AI와 대화 |
| 파일 전환이 번거로움 | 같은 화면 안에서 편집·실행 |
| Git 상태 파악이 어려움 | 변경된 파일을 색상으로 즉시 확인 |
| 확장 기능 없음 | 한국어 팩·테마 등 자유롭게 커스터마이징 |
순서 1: VS Code 다운로드 & 설치
다운로드
공식 사이트(code.visualstudio.com)에 접속해서 「Download for Windows」 버튼을 클릭합니다.
💡 버튼을 클릭하면 자동으로 Windows 버전에 맞는 설치 파일이 다운로드됩니다. 파일명은
VSCodeSetup-x64-x.xx.x.exe형태입니다.
설치 옵션 설정
다운로드한 .exe 파일을 실행하면 설치 마법사가 시작됩니다.
- 라이선스 동의 화면 → 「동의함」 선택 후 「다음」 클릭
- 설치 위치 → 기본값 그대로 진행
- 시작 메뉴 폴더 → 기본값 그대로 진행
- 추가 작업 선택 (아래 두 항목은 반드시 체크)
✅ 꼭 체크해야 할 항목 2가지:
① PATH에 추가(재시작 후 사용 가능) 에 체크
이것을 체크해두면 PowerShell이나 명령 프롬프트에서 code . 명령만으로 VS Code를 바로 열 수 있게 됩니다. Claude Code와 연동할 때도 이 설정이 필요합니다.
② 탐색기의 파일 컨텍스트 메뉴에 추가 에 체크
Windows 탐색기(파일 탐색기)에서 파일이나 폴더를 마우스 오른쪽 클릭했을 때 「Code(으)로 열기」 메뉴가 나타납니다. 프로젝트 폴더를 빠르게 여는 데 매우 편리합니다.
- 설치 클릭 → 완료 후 「마침」 클릭
VS Code 첫 실행 & 작업 폴더 열기
설치 완료 후 VS Code를 실행합니다.
처음 실행하면 시작 화면이 표시됩니다. 「폴더 열기」 를 클릭합니다.
폴더 선택 대화상자가 열리면 작업하려는 프로젝트 폴더를 선택합니다.
예를 들어 C:\projects\myproject 폴더가 있다면 그 폴더를 선택하고 「폴더 선택」 을 클릭합니다.
💡 폴더가 아직 없다면?
먼저 다음 명령으로 폴더를 만들자:mkdir C:\projects\myproject cd C:\projects\myproject또는 탐색기에서 원하는 위치에 새 폴더를 만든 후 VS Code에서 열면 된다.
폴더가 열리면 왼쪽 패널(탐색기)에 폴더 이름이 대문자로 표시됩니다. 이것으로 VS Code에서 해당 프로젝트를 작업할 준비가 완료됩니다.
⚠️ "이 폴더의 파일 작성자를 신뢰하시겠습니까?" 라는 메시지가 나타날 수 있습니다.
직접 만든 폴더라면 「예, 작성자를 신뢰합니다」 를 클릭합니다.
순서 2: Git의 기본 에디터를 VS Code로 변경
Git for Windows를 설치하면 기본 에디터로 Vim이 설정됩니다. Vim은 특수한 키 조작 방식이 필요한 에디터라 처음 쓰는 분에게는 상당히 까다롭습니다.
VS Code로 변경해두면 git commit 메시지 입력 등에서 VS Code가 자동으로 열립니다.
에디터 변경 명령어
PowerShell 또는 명령 프롬프트를 열고 다음을 실행합니다.
git config --global core.editor "code --wait"설정 확인
git config --global core.editorcode --wait 라고 출력되면 변경 성공입니다.
💡
--wait옵션의 의미
Git이 에디터(VS Code)를 열고 나서 파일을 저장하고 닫을 때까지 기다린다는 옵션입니다.
이 옵션이 없으면 VS Code가 열리기도 전에 Git이 다음 단계로 넘어가 버리는 문제가 생깁니다.
💡 이 설정이 실제로 쓰이는 순간
git commit # (메시지를 -m 옵션 없이 실행하면 VS Code가 자동으로 열린다) # VS Code에서 커밋 메시지를 입력하고 저장 후 닫으면 커밋이 완료됨
순서 3: Claude Code 확장 프로그램 설치
VS Code에 Claude Code 확장 프로그램을 설치하면 VS Code 화면 안에서 바로 Claude Code를 사용할 수 있습니다. 별도로 PowerShell을 열 필요 없이 코드 편집과 AI 대화를 한 화면에서 처리할 수 있습니다.
확장 프로그램 검색 & 설치
- VS Code 왼쪽 사이드바에서 확장 프로그램 아이콘 (4개의 사각형이 모인 모양)을 클릭합니다. 단축키는
Ctrl + Shift + X입니다. - 검색창에
claude라고 입력합니다. - 검색 결과 맨 위에 「Claude Code for VS Code」 (게시자: Anthropic)가 나타납니다.
- 「설치」 버튼을 클릭합니다.
💡 설치 전 확인 사항
반드시 게시자가 Anthropic 인지 확인하자. 비슷한 이름의 서드파티 확장 프로그램과 혼동하지 않도록 주의.
설치 완료 확인
설치가 완료되면 확장 프로그램 탭의 「설치됨」 항목 아래에 「Claude Code for VS Code」 가 표시됩니다.
Claude Code 패널 열기
VS Code 오른쪽 상단에 표시되는 Claude Code 아이콘(결정체 모양 아이콘) 을 클릭하면 화면 오른쪽에 Claude Code 패널이 열립니다.
패널 하단에 Claude Code 입력창이 표시되면 VS Code와 Claude Code의 연동이 완료된 것입니다.
💡 패널이 열리지 않는다면?
- Claude Code가 설치되어 있지 않은 경우: 먼저 PowerShell에서
irm https://claude.ai/install.ps1 | iex로 Claude Code 본체를 설치하자- 인증이 완료되지 않은 경우: PowerShell에서
claude를 실행해 로그인을 먼저 완료하자- 확장 프로그램 설치 후 VS Code 재시작이 필요한 경우가 있다
추가 설정: 한국어 언어 팩 설치 (선택 사항)
VS Code의 메뉴와 안내 문구를 한국어로 표시하고 싶다면 한국어 언어 팩을 설치할 수 있습니다.
- 확장 프로그램 탭(
Ctrl + Shift + X)에서Korean Language Pack을 검색 - 「Korean Language Pack for Visual Studio Code」 (게시자: Microsoft)를 설치
- 설치 후 VS Code를 재시작하면 전체 UI가 한국어로 전환됩니다
정리: 3단계 완료 후 가능해지는 것
| 설정 | 가능해지는 것 |
|---|---|
| VS Code 설치 + PATH 추가 | code . 명령으로 어디서든 VS Code 열기 |
| Git 에디터 → VS Code | git commit 시 VS Code에서 메시지 입력 |
| Claude Code 확장 프로그램 | VS Code 안에서 Claude Code와 대화하며 개발 |
©2024-2026 MDRules dev., Hand-crafted & made with Jaewoo Kim.
이메일문의: jaewoo@mdrules.dev
AI강의/개발/기술자문, Claude Code 전문강의, AI 업무 자동화 컨설팅 문의: https://talk.naver.com/ct/w5umt5
AI 업무 자동화/에이전트/워크플로우설계 컨설팅/AI교육: https://mdrules.dev
