VS Code에서 클로드 코드 실행하기 (윈도우 화면 그대로 따라하기)

PowerShell 대신 VS Code를 쓰는 이유

클로드 코드(Claude Code) (클로드 코드가 무엇인지 설명한 글 바로가기)를 설치하고 나면 다음 질문이 따라옵니다. 어디에서 실행하느냐입니다. 윈도우 기본 도구인 PowerShell에서도 실행되지만, 며칠 써 보면 아쉬운 점이 드러납니다. 클로드 코드가 만든 파일을 확인하려면 창을 나가 파일 탐색기를 열어야 하고, 어느 폴더에서 작업 중인지도 한눈에 들어오지 않습니다.

“

VS Code에서 클로드 코드를 실행하는 방법은 폴더를 먼저 연 뒤 그 안에서 터미널을 열고 claude를 입력하는 것입니다. 왼쪽에 파일 목록, 아래에 터미널이 함께 보여 작업 상황을 한 화면에서 확인할 수 있습니다.

VS Code는 마이크로소프트가 무료로 배포하는 코드 편집기입니다. 원래는 개발자가 코드를 쓰는 도구지만, 클로드 코드 사용자에게는 다른 쓰임이 더 큽니다. 터미널과 파일 목록, 파일 미리보기가 한 화면에 들어 있어 작업 창 역할을 해 줍니다.

이 글은 윈도우 PC를 기준으로 합니다. 클로드 코드 설치는 이미 마친 상태를 전제하며, 아직이라면 윈도우 설치 가이드 (윈도우 설치 순서 바로가기)를 먼저 보시면 됩니다. 맥을 쓰시는 분은 화면 구성은 같고 메뉴 이름과 단축키만 다릅니다.

VS Code 내려받기

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

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

설치할 때 체크할 항목

내려받은 파일을 두 번 눌러 실행합니다. 약관 동의와 설치 위치는 기본값 그대로 두고 다음을 누르다가, 추가 작업 선택 화면에서 멈춥니다. 여기서 체크 항목을 확인해야 합니다.

PATH에 추가는 반드시 체크합니다. PATH는 윈도우가 명령을 찾는 경로 목록입니다. 이 항목이 빠지면 터미널에서 claude를 입력했을 때 용어가 cmdlet, 함수, 스크립트 파일 이름으로 인식되지 않습니다라는 오류가 납니다. 설치가 끝난 뒤 이 문제로 되돌아오는 사례가 있습니다.

Windows 탐색기 메뉴에 추가도 체크해 두면 편합니다. 나중에 폴더에서 마우스 오른쪽 버튼을 눌러 바로 VS Code로 열 수 있습니다.

체크를 마치면 다음과 설치를 눌러 끝까지 진행합니다. 설치가 끝나면 컴퓨터를 한 번 다시 켜는 편이 안전합니다. PATH 설정은 새로 시작한 뒤에 적용되기 때문입니다.

작업할 폴더 먼저 열기

VS Code를 실행하면 빈 화면이 나옵니다. 여기서 순서가 중요합니다. 터미널을 열기 전에 작업할 폴더를 먼저 엽니다.

클로드 코드는 실행된 위치를 기준으로 파일을 읽고 만듭니다. 폴더를 정하지 않고 터미널부터 열면 엉뚱한 위치에서 작업하게 됩니다.

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

폴더 선택 창이 뜨면 작업할 폴더를 지정합니다. 문서 안에 작업용 폴더를 하나 만들어 두고 쓰는 방식을 권합니다.

여기서 실수하기 쉬운 지점이 있습니다. 폴더를 두 번 눌러 안으로 들어가면 안 됩니다. 한 번만 눌러 선택한 상태에서 폴더 선택 버튼을 누릅니다. 안으로 들어간 상태에서 버튼을 누르면 그 아래 폴더가 열립니다.

폴더 신뢰 여부 확인

폴더를 처음 열면 파일 작성자를 신뢰하느냐고 묻는 창이 뜹니다. 직접 만든 폴더라면 신뢰합니다.

신뢰하지 않음을 고르면 제한 모드로 열립니다. 이 상태에서는 클로드 코드가 파일을 만들거나 고치지 못합니다. 같은 폴더는 한 번만 물어보고 다음부터는 묻지 않습니다.

터미널 열기

이제 클로드 코드를 실행할 터미널을 엽니다. 상단 터미널 메뉴에서 새 터미널을 고릅니다.

단축키 Ctrl + Shift + 백틱(숫자 1 왼쪽 키)으로도 열립니다. 화면 아래쪽에 검은 영역이 나타나면 준비된 것입니다.

claude 입력해 실행하기

터미널에 claude를 입력하고 엔터를 누릅니다.

claude

입력하기 전에 줄 앞에 적힌 경로를 확인합니다. 경로 끝이 방금 연 폴더 이름과 같아야 합니다. 다른 폴더 이름이 보인다면 폴더를 다시 여는 단계부터 진행합니다.

아래 화면이 나오면 준비가 끝났습니다. 이제 한글로 지시하면 됩니다.

여기까지가 기본 흐름입니다. 다음부터는 세 단계로 끝납니다. VS Code 실행, 터미널 열기, claude 입력입니다. 지난번 폴더가 그대로 열려 있으면 첫 단계도 생략됩니다.

승인 질문을 건너뛰는 bypass 모드

클로드 코드는 파일을 읽거나 고치기 전에 매번 진행 여부를 묻습니다. 실수를 막는 장치라 기본값으로는 그대로 두는 편이 좋습니다. 다만 긴 작업을 맡기고 자리를 비울 때는 중간에 멈춰 서서 답을 기다리게 됩니다.

이때 쓰는 것이 bypass 모드입니다. 한 번 실행하면 작업이 끝날 때까지 묻지 않고 진행합니다. 실행할 때 claude 뒤에 옵션을 붙입니다.

claude --dangerously-skip-permissions

명령 이름에 dangerously가 들어 있는 이유가 있습니다. 이 모드에서는 파일을 고치거나 지우는 작업까지 확인 없이 진행합니다. 잘못된 지시를 내려도 중간에 멈춰 주지 않습니다.

처음 한 번은 이 모드가 맞는지 확인하는 영문 경고문이 나옵니다.

화면에 나오는 영문의 뜻은 다음과 같습니다.

방향키로 2번을 고르고 엔터를 누릅니다. 입력란 아래에 bypass permissions on이 보이면 적용된 상태입니다.

기본 모드로 되돌리려면 터미널에서 Ctrl + C를 두 번 눌러 끄고, 다시 claude만 입력해 실행합니다. bypass 모드는 그 터미널에서만 유지됩니다.

bypass 모드를 쓸 때와 쓰지 않을 때

마지막 두 줄이 중요합니다. 외부로 나가는 작업에서는 승인 절차가 실수를 막는 마지막 장치입니다. 메일이나 메시지가 잘못 발송되면 되돌릴 수 없습니다.

모드 종류를 더 알고 싶으시면 Ultraplan, Auto 모드, bypass 모드 비교 (세 가지 실행 방식의 차이 바로가기)에 정리해 두었습니다.

잘 안 될 때 확인할 것

설치 단계에서 막히는 오류는 클로드 코드 설치 오류 해결 (설치 오류별 해결법 바로가기)에 유형별로 정리해 두었습니다.

자주 묻는 질문

터미널에 claude를 입력했더니 인식되지 않는다고 나오면 무엇을 확인하나요?

VS Code를 설치할 때 PATH에 추가 항목을 체크했는지부터 봅니다. 이 항목이 빠지면 윈도우가 명령을 찾지 못해 용어가 인식되지 않는다는 오류가 납니다. 체크했는데도 같은 오류가 난다면 설치 후 컴퓨터를 다시 켜지 않은 경우라 재시작한 뒤 다시 입력해 봅니다.

폴더를 열지 않고 터미널부터 열면 어떻게 되나요?

클로드 코드가 엉뚱한 위치에서 파일을 읽고 만듭니다. 실행된 위치를 기준으로 작업하기 때문에 폴더 열기로 작업 폴더를 먼저 지정한 다음 터미널을 열어야 합니다. 터미널 줄 앞에 적힌 경로 끝이 방금 연 폴더 이름과 같은지 보면 확인됩니다.

bypass 모드는 계속 켜 두어도 되나요?

작업 성격에 따라 나눕니다. 자료 조사나 문서 작성처럼 읽고 만들기만 하는 일이면 켜 두어도 무방하지만, 기존 파일을 고치거나 정리하는 일은 기본 방식으로 한 번씩 확인하며 진행하는 편이 안전합니다. 메일 발송이나 결제처럼 외부로 나가는 자동화와 작업 폴더 바깥을 다루는 일에는 쓰지 않습니다.