VS Code에서 Claude Code 첫 실행과 대화 시작하기

VS Code 터미널에서 Claude Code 실행하기

Claude Code는 별도의 프로그램이 아닙니다. VS Code 안에 있는 터미널(terminal)에서 바로 실행됩니다. 터미널이란, VS Code 하단에 위치한 명령어 입력 창을 말합니다. 마우스로 클릭하는 게 아니라 글자를 직접 타이핑해서 컴퓨터에 명령을 내리는 공간이구요, 처음 보면 낯설 수 있지만 금방 익숙해질 겁니다.

VS Code를 열고 상단 메뉴에서 Terminal → New Terminal을 클릭합니다. 단축키는 ` Ctrl + ``입니다. 화면 아래쪽에 검은색 혹은 어두운 색의 입력 창이 나타나면 성공입니다.

 

 

터미널이 열렸다면 claude라고 입력하고 Enter를 누릅니다. 그러면 Claude Code가 실행되면서 대화를 시작할 준비가 됩니다. 화면에 입력 커서가 깜빡이면 정상적으로 실행된 것입니다. 만약 'claude' is not recognized라는 오류가 뜬다면, 설치가 제대로 되지 않은 상태이니 설치 과정을 다시 확인해야 합니다.

제가 직접 처음 실행했을 때, 터미널 자체가 낯설어서 긴장했습니다. 하지만 claude 한 단어만 치면 되니까 생각보다 간단했습니다. 터미널에 대한 두려움은 첫 실행 이후 대부분 사라집니다.

첫 번째 질문 던지기

Claude Code가 실행되면 바로 대화를 시작할 수 있습니다. 일반 채팅처럼 한국어로 질문을 입력하면 됩니다. 특별한 명령어 형식이 필요하지 않습니다.

처음에는 간단한 질문부터 시작하는 것을 추천합니다. 예를 들어 이렇게 입력합니다.

이 프로젝트 폴더에 어떤 파일들이 있는지 알려줘

Enter를 누르면 Claude Code가 현재 폴더의 파일 구조를 분석해서 알려줍니다. 여기서 중요한 점이 있습니다. Claude Code는 현재 VS Code에서 열어 놓은 폴더를 기준으로 동작합니다. 바탕화면에서 실행하면 바탕화면 파일들을 보게 되구요, 프로젝트 폴더에서 실행하면 그 프로젝트 파일들을 봅니다.

 

 

질문할 때 구체적으로 작성할수록 좋은 답변을 받습니다. "코드 봐줘"보다 "index.html 파일의 내용을 설명해줘"가 훨씬 정확한 답변을 만들어냅니다. 이것이 바로 프롬프트(prompt) 작성의 기본 원칙입니다.

제가 써보니, 첫 질문은 파일 목록 확인이 가장 무난했습니다. 결과가 눈에 바로 보이기 때문에 Claude Code가 제대로 동작하는지 확인하기 좋습니다. 너무 복잡한 질문으로 시작하면 답변이 길어져서 오히려 혼란스러울 수 있습니다.

파일 읽기와 수정 요청 실습

Claude Code의 진짜 강점은 파일을 직접 읽고 수정할 수 있다는 점입니다. 일반 AI 챗봇은 코드를 복사해서 붙여넣어야 하지만, Claude Code는 폴더 안의 파일에 직접 접근합니다.

파일 읽기를 요청하려면 이렇게 입력합니다.

README.md 파일 내용을 읽어줘

Claude Code가 해당 파일의 내용을 읽고 요약하거나 설명해줍니다. 파일이 존재하지 않으면 없다고 알려줍니다. 단순하지만 강력한 기능입니다.

 

파일 수정도 가능합니다. 예를 들어 이런 요청을 할 수 있습니다.

README.md 파일에 프로젝트 설명을 한 줄 추가해줘

이때 Claude Code는 변경 내용을 먼저 보여주고, 승인 여부를 묻습니다. y를 입력하면 수정이 반영되구요, n을 입력하면 취소됩니다. 실수로 파일이 망가질 걱정은 하지 않아도 됩니다. 항상 확인 과정을 거치기 때문입니다.

 

 

제가 직접 써보니, 이 승인 단계가 초보자에게 매우 안심이 되는 장치였습니다. 다만 수정 요청이 모호하면 의도와 다른 결과가 나올 수 있으니, "어디에 무엇을 추가할지" 구체적으로 지시하는 것이 좋습니다.

 

 

첫 대화에서 기억할 핵심 포인트

Claude Code와의 첫 대화를 마쳤다면 몇 가지 포인트를 정리해두면 좋습니다.

 

첫째, 대화를 끝내고 싶을 때는 /exit을 입력합니다. 터미널 창을 그냥 닫아도 되지만, 정식으로 종료하는 습관을 들이는 것을 권장합니다.

 

둘째, Claude Code는 대화 맥락(context)을 기억합니다. 한 세션 안에서는 이전 질문을 이어서 참고할 수 있습니다. "아까 그 파일에서"라고 말해도 알아듣습니다.

 

셋째, 모든 작업은 현재 폴더 범위 안에서 이루어집니다. 다른 폴더의 파일을 수정하려면 VS Code에서 해당 폴더를 열고 다시 claude를 실행해야 합니다.

 

자주 사용하게 될 기본 명령어도 알아두면 편리합니다. /help를 입력하면 사용 가능한 명령어 목록을 볼 수 있구요, /clear를 입력하면 대화 내용을 초기화할 수 있습니다.

제가 처음 사용했을 때 가장 좋았던 점은, 틀린 명령어를 입력해도 컴퓨터가 고장 나지 않는다는 것이었습니다. Claude Code는 잘못된 요청에 대해 친절하게 안내해주기 때문에, 마음 편하게 이것저것 시도해보는 것이 가장 빠른 학습법입니다.