VS Code에서 클로드 코드(Claude Code) 실행하기: 윈도우 설명 그림과 첫 파일 실습

VS Code 안에서 PowerShell을 쓰는 이유

클로드 코드(Claude Code)를 터미널에 설치했다면 VS Code 안에서도 실행할 수 있습니다. VS Code는 파일 편집기이고 PowerShell은 명령을 해석하는 프로그램이어서, 둘 중 하나를 고르는 것이 아니라 VS Code 안의 터미널에서 PowerShell을 씁니다. 파일 목록과 파일 내용, AI 대화가 한 화면에 있으니 클로드 코드가 만든 파일을 바로 열어 볼 수 있습니다.

VS Code에서 클로드 코드를 실행하려면 작업 폴더를 먼저 연 뒤 그 안에서 터미널을 열고 claude --permission-mode default를 입력합니다. 왼쪽에 파일 목록, 아래에 터미널이 함께 보여 작업 상황을 한 화면에서 따라갈 수 있습니다.

VS Code는 마이크로소프트가 무료로 배포하는 코드 편집기입니다. 원래는 개발자가 코드를 쓰는 도구지만, 클로드 코드 사용자에게는 터미널과 파일 목록, 파일 미리보기를 한 창에 모아 주는 작업 창으로 더 쓸모가 있습니다.

이 글은 윈도우 PC 기준이고, 클로드 코드는 이미 설치한 상태에서 시작합니다. 아직 설치하지 않았다면 윈도우 설치 가이드부터 따라 합니다. 맥은 메뉴와 단축키, 터미널 명령이 달라서 맥 설치 안내를 함께 봅니다.

전체 순서는 여섯 단계입니다.

VS Code에서 클로드 코드를 쓰기까지

1. 11. 내려받기code.visualstudio.com
   Download for Windows
2. 22. 설치추가 작업 선택에서
   두 항목 체크
3. 33. 폴더 열기터미널보다 먼저
   작업 폴더 열기
4. 44. 폴더 신뢰직접 만든 폴더만
   작성자 신뢰
5. 55. 터미널에서 실행위치 확인 뒤
   Manual 모드로 실행
6. 66. 파일 확인만든 파일을
   왼쪽 목록에서 열기

VS Code 내려받기

브라우저 주소창에 code.visualstudio.com을 입력해 접속하고, 화면 가운데 파란 다운로드 버튼을 누릅니다.

사이트가 접속한 기기를 인식해 버튼에 Windows를 표시합니다. 다른 운영체제 이름이 보이면 버튼 옆 목록에서 Windows를 고릅니다.

설치할 때 체크할 항목

내려받은 파일을 두 번 눌러 실행합니다. 약관과 설치 위치를 확인하고 다음을 누르다가 추가 작업 선택 화면에서 멈춥니다.

두 항목 모두 체크해 두면 편합니다. Windows 탐색기 메뉴에 추가를 고르면 폴더를 오른쪽 클릭해 바로 VS Code로 열 수 있습니다. 체크하지 않아도 VS Code의 파일 메뉴로 폴더를 열 수 있습니다.

PATH는 명령을 찾는 폴더 목록입니다. PATH에 추가는 터미널에서 VS Code를 여는 code 명령을 등록하는 설정이고, 클로드 코드의 claude 명령과는 상관이 없습니다.

무엇이 어떤 명령을 등록하나

설치한 것	code 명령VS Code 열기	claude 명령클로드 코드 실행
VS Code 설치, PATH에 추가 체크	제공	제공하지 않음
VS Code의 Claude Code 확장 패널	–	제공하지 않음
Claude Code CLI 설치	–	제공

설치가 끝나면 새 터미널을 엽니다. 설치 전부터 켜 둔 VS Code는 예전 환경변수를 쓰므로 종료했다가 다시 실행합니다. PATH 변경은 프로그램을 다시 열면 반영되고, 컴퓨터를 재부팅하지 않아도 됩니다.

작업할 폴더 먼저 열기

VS Code를 실행하면 빈 화면이 나옵니다. 여기서 터미널보다 작업 폴더를 먼저 엽니다. 클로드 코드는 실행한 위치를 작업 기준으로 삼기 때문입니다.

상단 파일 메뉴에서 폴더 열기를 고릅니다.

폴더 선택 창에서 작업할 폴더를 고르고 폴더 선택을 누릅니다. 그림의 내작업은 예시 이름입니다. 처음에는 중요한 원본이 섞이지 않은 폴더, 예를 들어 이번 주 회의록 텍스트 파일만 모아 둔 폴더가 다루기 쉽습니다.

폴더가 열리면 VS Code 왼쪽 목록의 맨 위에 그 폴더 이름이 보입니다. 다른 이름이 보이면 한 단계 위나 아래 폴더를 연 것이므로 다시 엽니다.

폴더 신뢰 여부 확인

폴더를 처음 열면 이 폴더에 있는 파일의 작성자를 신뢰하느냐고 묻는 창이 뜹니다. 직접 만들었거나 내용을 아는 폴더라면 신뢰를 누릅니다.

신뢰하지 않음을 고르면 제한 모드로 열려 터미널과 확장 기능을 제대로 쓸 수 없습니다. 반대로 출처를 모르는 프로젝트나 문서 폴더 전체를 한꺼번에 신뢰하면, 그 안의 모르는 파일에도 같은 권한이 갑니다. 신뢰는 지금 작업할 폴더에만 줍니다.

터미널 열기

상단 터미널 메뉴에서 새 터미널을 고릅니다.

단축키 Ctrl + Shift + 백틱(숫자 1 왼쪽 키)으로도 열 수 있습니다. 화면 아래쪽에 터미널 영역이 나타나면 오른쪽 위 프로필 이름이 PowerShell인지 봅니다. 다른 셸이면 새 터미널 추가 버튼 옆 목록에서 PowerShell을 고릅니다.

경로를 확인하고 클로드 코드 실행하기

실행하기 전에 PowerShell 터미널에서 두 명령을 한 줄씩 입력합니다.

Get-Location은 터미널의 현재 위치를 보여 줍니다. 결과가 방금 연 작업 폴더 경로이고, claude --version에 버전 번호가 나오면 준비가 끝난 것입니다. 경로가 다른 폴더라면 VS Code에서 작업 폴더를 다시 열고 새 터미널을 만듭니다. 명령을 찾을 수 없다는 오류가 나오면 아래 문제 해결로 넘어갑니다.

그림처럼 claude만 입력해도 실행되지만, 처음에는 파일을 바꾸기 전에 승인을 묻는 Manual 모드로 시작합니다.

로그인 안내가 나오면 클로드 코드를 쓸 수 있는 계정으로 인증합니다. 아래처럼 입력란이 보이면 실행된 것입니다.

설정에 따라 기본 권한 모드가 Auto일 수 있어서, claude만 입력하면 수정 전에 묻지 않고 진행하기도 합니다. 옵션을 붙이면 이번 실행은 Manual로 시작합니다. Manual에서도 이미 허용해 둔 작업과 파일 읽기는 묻지 않고 진행됩니다.

첫 파일 만들고 직접 열어 확인하기

회의록 폴더를 열었다면 클로드 코드의 입력칸에 이렇게 보냅니다.

Manual 모드에서는 파일을 만들기 전에 아래처럼 승인을 묻습니다.

클로드 코드, Manual 모드

> 이 폴더의 회의록 파일을 읽고 할 일만 모아 todo.md를 만들어 줘.

회의록 파일 3개를 읽었습니다. 할 일 7개를 todo.md에 정리하겠습니다.

todo.md 파일을 만들까요?
1. Yes
2. No

파일 이름과 내용을 보고 승인합니다

승인한 뒤 완료 답변이 나오면 왼쪽 파일 목록에서 todo.md를 눌러 회의록과 대조합니다. 목록에 파일이 없으면 탐색기 영역의 새로 고침 버튼을 누릅니다.

이어서 같은 대화에서 "todo.md를 마감일이 빠른 순서로 정렬해 줘. 다른 내용은 그대로 둬."라고 요청합니다. 파일을 다시 열어 항목 수는 그대로이고 순서만 바뀌었는지 봅니다. 파일 탭 이름 옆에 점이 있으면 저장하지 않은 변경이 있다는 뜻이므로 Ctrl + S로 저장합니다.

작업을 멈추려면 Esc를 누르고, 대화를 끝내려면 클로드 코드 안에서 /exit를 입력합니다. 다음에는 같은 폴더에서 새 터미널을 열고 경로를 확인한 뒤 같은 실행 명령을 입력합니다. 설치는 다시 하지 않습니다.

Bypass 화면이 보이면 무엇을 뜻하나요?

Bypass는 대부분의 권한 확인을 건너뛰는 모드입니다. 문서 작업이라도 기존 파일을 덮어쓰거나 명령을 실행할 때 묻지 않으므로, 작업이 오래 걸린다거나 문서만 다룬다는 이유로 켜지 않습니다.

Manual과 Bypass의 차이

항목	Manual--permission-mode default	Bypass--dangerously-skip-permissions
파일을 바꾸기 전에 묻기	제공	제공하지 않음
명령을 실행하기 전에 묻기	제공	제공하지 않음
화면 아래 표시	–	bypass permissions on

아래 그림은 Bypass로 실행하는 명령과 경고 화면, 실행된 상태입니다. 경고 화면이 떴다면 No, exit로 나가고, 이미 실행됐다면 /exit로 종료한 뒤 PowerShell에서 claude --permission-mode default로 다시 시작합니다.

Bypass 실행 화면 3개 보기

실행할 때 붙인 옵션은 그 세션에만 적용됩니다. 설정 파일에 기본 모드를 따로 정해 두었다면 새 세션도 그 모드로 시작하므로, 다시 실행한 뒤 화면 아래 모드 표시를 봅니다. Auto, Plan과 Bypass의 차이는 권한 모드 비교 글에 정리했습니다.

잘 안 될 때 확인할 것

가장 흔한 오류는 claude 명령을 찾을 수 없다는 메시지입니다. 아래 순서로 봅니다.

claude 명령을 찾을 수 없을 때

1. 11. VS Code 다시 열기완전히 종료한 뒤 다시 실행
   새 터미널 열기
2. 22. 버전 확인claude --version 입력
   버전 번호가 나오면 해결
3. 33. 설치 파일 확인실패하면 실행 파일이
   있는지와 PATH 확인

3단계는 클로드 코드 설치 오류 해결의 파일 유무 확인부터 진행합니다. VS Code를 다시 설치하거나 Bypass로 바꿔도 없는 Claude Code 실행 파일이 생기지는 않습니다.

다른 증상은 이렇게 해결합니다.

자주 묻는 질문

PowerShell에서는 되는데 VS Code에서만 안 되면요?

Claude Code를 설치하기 전에 열어 둔 VS Code가 예전 PATH를 쓰고 있을 가능성이 큽니다. 파일을 저장하고 VS Code를 완전히 종료한 뒤 다시 엽니다. 통합 터미널의 프로필이 PowerShell인지도 봅니다. WSL이나 원격 접속 창은 별도 환경입니다.

폴더를 먼저 열면 그 밖의 파일은 못 바꾸나요?

현재 폴더는 작업을 시작하는 위치이고, 운영체제 차원에서 그 밖의 파일 접근을 막는 장치는 아닙니다. 다른 폴더의 파일을 바꾸겠다는 승인 요청이 오면 거절합니다.

Bypass를 켜야 질문이 줄어드나요?

질문은 줄지만 파일 덮어쓰기와 명령 실행도 묻지 않고 진행됩니다. 처음에는 Manual로 쓰면서 클로드 코드가 어떤 파일을 바꾸고 어떤 명령을 실행하는지 익힙니다.

Sources

• VS Code Windows 설치와 PATH
• VS Code 통합 터미널
• VS Code 폴더 신뢰
• Claude Code 권한 모드
• Claude Code 설치 오류

3줄 요약

1. VS Code에서는 작업 폴더를 먼저 열고 그 안에서 새 터미널을 연 뒤 claude --permission-mode default로 클로드 코드를 실행합니다.

2. VS Code 설치 화면의 PATH에 추가 항목은 code 명령을 등록하는 옵션이어서 claude 명령은 Claude Code CLI를 따로 설치해야 생깁니다.

3. Bypass 모드는 파일 덮어쓰기와 명령 실행도 묻지 않고 진행하므로 처음에는 수정 전에 승인을 묻는 Manual 모드로 시작합니다.